Claude Code output styles: 팀 답변 형식을 한 번에 맞추는 법 | DAKER 커뮤니티
Claude Code output styles란, Claude Code가 매번 어떤 역할, 말투, 출력 형식으로 답할지 정하는 응답 스타일 설정입니다. 2026년 7월 2일 기준 공식 문서에서 /config와 .claude/output-styles 흐름을 확인했고, 반복해서 "표로 답해줘", "교육형으로 설명해줘"를 붙이는 팀은 이 설정으로 프롬프트 낭비를 줄일 수 있습니다.
한 줄 요약: 프로젝트 규칙은 CLAUDE.md, 매 턴의 답변 형식은 output styles, 특정 작업 절차는 skills로 나누면 팀 운영이 덜 꼬입니다.
이미지: Claude Code output styles로 반복 프롬프트를 줄이고 팀 답변 형식을 맞추는 대표 카드.
문제 상황: 왜 Claude Code 답변 형식이 매번 흔들릴까?
Claude Code를 팀에서 쓰면 같은 요청도 사람마다 다른 형식으로 받습니다. 어떤 사람은 바로 패치를 원하고, 어떤 사람은 근거와 학습 설명을 원하며, 리뷰어는 변경 요약과 테스트 증거를 먼저 보고 싶어 합니다. 이 차이를 매 프롬프트에 붙이면 길어지고, 세션 중간에 빠뜨리기도 쉽습니다.
DAKER의 Claude Code 계획 모드 글은 코드 수정 전 계획 경계를 잡는 문제를 다룹니다. 오늘 글의 초점은 계획 이전과 이후에 Claude가 어떤 형식으로 말하게 할지를 팀 설정으로 고정하는 일입니다.
핵심 개념: Output styles는 무엇을 바꾸고 무엇을 바꾸지 않을까?
Output styles는 모델 지식이 아니라 Claude Code의 응답 방식과 기본 역할 지시를 바꿉니다. 공식 문서 기준 built-in style에는 Default, Proactive, Explanatory, Learning이 있으며, custom style은 Markdown 파일로 만들 수 있습니다. 팀 실무에서는 "코딩 능력을 바꾸는 설정"이 아니라 "응답 계약을 고정하는 설정"으로 이해하는 편이 안전합니다.
비교하면 이렇게 나눌 수 있습니다.
구분 | 쓰는 곳 | 적합한 상황 |
|---|---|---|
| 프로젝트 규칙 | 코드 컨벤션, 테스트 명령, 금지 행동 |
Output styles | 매 턴 답변 형식 | 설명형, 학습형, 표 우선, 검증 우선 |
Agents | 분리된 역할 | 리뷰어, 디버거, 문서 작성자 |
Skills | 반복 절차 | 릴리스 점검, QA 루틴, 보안 체크 |
단계별 사용법: 팀 output style은 어떻게 만들까?
반복되는 요청 문장을 모읍니다.
/config에서 Output style 메뉴를 열고 built-in style로 충분한지 먼저 봅니다.팀 전용 형식이 필요하면
.claude/output-styles폴더에 Markdown 파일을 둡니다.계속 코딩 작업을 맡길 스타일이면
keep-coding-instructions: true를 넣습니다./clear를 실행하거나 새 세션을 열어 스타일 적용을 확인합니다.PR 템플릿이나 온보딩 문서에 "언제 이 스타일을 쓰는지"를 한 줄로 남깁니다.
이미지: 문제 정의, 스타일 선택, Markdown 작성, 새 세션 검증으로 이어지는 output styles 워크플로.
짧은 예시: 리뷰 우선 스타일은 어떻게 설계할까?
팀 코드 리뷰용 스타일은 "예쁘게 말하기"보다 순서가 중요합니다. 예를 들어 매 답변을 핵심 위험, 변경 제안, 검증 방법, 남은 리스크 순서로 요구하면 리뷰어가 빠르게 판단할 수 있습니다. 반대로 비개발 문서 작성용 스타일이라면 Claude Code의 기본 소프트웨어 엔지니어링 지시를 유지하지 않는 편이 더 맞을 수 있습니다.
팀 적용 체크리스트: 실수는 어디서 가장 자주 날까?
프로젝트 규칙을 output style에 넣지 않았습니다.
코드 수정 스타일에는
keep-coding-instructions: true필요 여부를 확인했습니다.style 변경 후
/clear또는 새 세션으로 적용을 확인했습니다.Learning style을 팀 기본값으로 강제하기 전에
TODO(human)흐름이 맞는지 확인했습니다.DAKER의 Claude Code 알림 설정 글처럼 긴 작업 운영 글과 함께 팀 온보딩에 묶었습니다.
공식 출처: 어떤 문서를 확인했나?
이 글은 2026년 7월 2일 기준 Claude Code Output styles, CLI reference, Model configuration 공식 문서와 Claude Sonnet 5 공개 공지를 확인해 작성했습니다. DAKER/DACON 공개 링크 정책에 따라 본문에는 외부 공식 URL을 직접 노출하지 않았습니다.
FAQ
Output styles와 CLAUDE.md는 같은 역할인가요?
아닙니다. CLAUDE.md는 프로젝트 규칙과 맥락을 알려주고, output styles는 Claude Code가 어떤 형식으로 답할지를 정합니다.
Proactive style을 쓰면 권한 확인도 사라지나요?
아닙니다. Proactive style은 더 즉시 실행하는 응답 방식을 유도하지만, permission mode 자체를 바꾸지는 않습니다.
Custom output style은 어디에 저장하나요?
사용자 단위는 ~/.claude/output-styles, 프로젝트 단위는 .claude/output-styles에 둡니다. 팀 공유 목적이면 프로젝트 폴더에 두는 편이 좋습니다.
변경했는데 바로 안 보이면 어떻게 확인하나요?
Output style은 세션 시작 시 읽히므로 /clear를 실행하거나 새 세션을 열어 적용 여부를 확인합니다.
오늘 팀에서 반복하는 Claude Code 답변 형식 하나를 골라 output style 후보로 적어두면, 다음 세션부터 프롬프트가 짧아집니다.