Claude Code 상세 사용법 70: Output Style로 답변 형식과 톤 고정하기 | DAKER 커뮤니티
Claude Code 상세 사용법 70: Output Style로 답변 형식과 톤 고정하기
Claude Code에 매번 “짧게 말해줘”, “왜 그런지 설명해줘”, “보고서 형식으로 정리해줘”를 붙이고 있다면 프롬프트가 아니라 응답 스타일 문제입니다. 공식 Output styles 문서는 이 기능이 Claude가 아는 내용이 아니라 답변 방식, 역할, 톤, 출력 형식을 바꾸며 시스템 프롬프트에 적용된다고 설명합니다.
문제 상황
팀에서 AI 코딩을 쓰면 결과물보다 말투가 먼저 흔들립니다. 어떤 사람은 짧은 실행 보고를 원하고, 어떤 사람은 학습용 설명을 원합니다. 이 차이를 매 프롬프트에 붙이면 실제 작업 지시가 길어지고, Claude가 어떤 형식으로 보고해야 하는지 일관성이 떨어집니다.
핵심 개념
Output style은 모든 응답에 적용되는 기본 응답 방식입니다. 내장 스타일에는 기본값인 Default, 설명을 더하는 Explanatory, 사용자가 일부 코드를 직접 채우게 하는 Learning, 더 적극적으로 실행하는 Proactive가 있습니다. 프로젝트 규칙이나 코드베이스 사실은 CLAUDE.md에 두고, 말투와 출력 형식은 Output style에 둡니다.
따라 하는 단계
먼저
/config를 열고 Output style을 바꿉니다.
/config메뉴 없이 고정하려면 설정에
outputStyle을 넣습니다.
{
"outputStyle": "Explanatory"
}직접 스타일을 만들 때는 Markdown 파일을 둡니다.
~/.claude/output-styles/review-brief.md
.claude/output-styles/review-brief.md코딩 작업을 계속할 스타일이면 frontmatter에
keep-coding-instructions: true를 넣습니다.
---
name: Review brief
description: Report code changes as concise review notes.
keep-coding-instructions: true
---
항상 변경 요약, 위험, 검증 결과 순서로 답한다.실수 방지 체크리스트
Output style 변경은 시스템 프롬프트 성격이라 새 세션이나
/clear뒤 적용을 확인합니다.코드 작업용 스타일은
keep-coding-instructions: true를 빼먹지 않습니다.프로젝트 사실, 빌드 명령, 금지 파일은 Output style이 아니라
CLAUDE.md나 settings에 둡니다.Explanatory와 Learning은 출력이 길어져 토큰이 늘 수 있습니다.
팀 표준 보고 형식은 프로젝트
.claude/output-styles/에 두고 버전 관리합니다.
선임 엔지니어 takeaways
Output style은 Claude Code의 “성격 설정”이 아니라 반복되는 응답 형식을 시스템 레벨로 고정하는 장치입니다. 작업 지시는 짧게 유지하고, 보고 형식은 스타일로 분리하세요. 그래야 같은 세션에서도 구현, 리뷰, 학습 모드를 명확히 나눌 수 있습니다.
공식 출처: Anthropic Claude Code Output styles, Settings 문서를 2026-06-18 Asia/Seoul 기준으로 확인했습니다.