TL;DR — output styles 한눈에
- output style은 세션의 모든 응답에서 Claude Code의 전달 방식 — 역할, 톤, 형식 — 을 다시 만듭니다. 바뀌는 건 시스템 프롬프트지 모델이 아닙니다.
- 내장은 다섯 가지: Default, Proactive, Concise, Explanatory, Learning. /output-style 또는 /config → Output style로 전환합니다.
- 커스텀 스타일은 markdown 파일로 ~/.claude/output-styles(사용자) 또는 .claude/output-styles(프로젝트)에 둡니다. 기본적으로 내장 코딩 지시를 대체하므로 남겨 두려면 keep-coding-instructions: true.
- 영상의 고수 기술: ASD-STE100 규칙 — 한 단어 한 의미, 짧은 문장 — 으로 독자별 스타일을 설계하면 PM, 번역자, 엔지니어가 각자 읽을 수 있는 답을 받습니다.
Claude Code Output Styles Made Opus 5 Readable Again
채널:Eric Tech15:40
Opus 5 Is Exhausting. Anthropic Reveals The Fix.
채널:Ray Amjad5:56
You Think Claude Got Dumber? You Are Actually Just Missing This Setting
채널:Gary Chen11:41
Output styles — Claude Code documentation
문서:code.claude.com
프레임은 Eric Tech의 output styles 심층 해설에서 왔습니다. 워크스루 글은 독자적으로 작성됐고 공식 output styles 문서(내장 스타일 목록과 keep-coding-instructions 동작 포함)와 대조해 검증했습니다.
스크린샷의 저작권은 제작자에게 있으며, 시각 문서로 출처를 밝혀 사용합니다. 각 단계는 원본 영상의 해당 시점으로 딥링크됩니다.
Claude의 말투, 단계별로 바꾸기
1 · 문제와 해법
- 1
문제 인식: 똑똑한데 읽을 수 없다
영상은 커뮤니티의 불만을 스케치 한 장으로 꺼냅니다: 모델은 일을 합니다 — 작업은 끝납니다 — 그런데 답변은 전문 용어의 벽이 됐죠. Matt Pocock도 Opus 5를 써 보고 무슨 말을 하는지 전혀 몰랐다고 공개적으로 토로했습니다. 이번 주의 당신도 같다면, 해답은 다른 모델이 아닙니다.
'되긴 하는데, 못 읽겠다.' — output style이 존재하는 이유.0:20에 시청 - 2
해법은 Anthropic 엔지니어에게서
Lydia Hallie의 게시물은 메커니즘 전체를 두 줄로 보여 줍니다: 스타일 지시를 ~/.claude/output-styles에 넣고, /config를 실행해 스타일을 고른다. 그녀는 퇴근 후 열람용 애착 스타일 — '5살에게 설명하듯' 스타일 — 도 공유하는데, 다음 단계에서 전문을 읽어 봅니다.
원 게시물: 지시는 ~/.claude/output-styles에, 그다음 /config → Output style.2:00에 시청 - 3
실제 스타일 파일 처음부터 끝까지 읽기
스타일 파일은 markdown입니다: name, description, keep-coding-instructions: true가 담긴 frontmatter — 이 플래그가 대체가 아니라 코딩 지시 유지를 만듭니다 — 뒤에 소박한 지시가 이어집니다. 이 스타일은 지친 독자와의 계약입니다: 쉬운 단어, 짧은 문장, 결정이 필요하면 선택지는 최대 2개, 경로와 명령어는 정확하게 — '나머지에 쓸 뇌세포가 없어서요.'
ELI5 스타일: frontmatter + 지쳐도 실행 가능한 규칙.2:20에 시청
2 · 내장 스타일과 첫 커스텀 스타일
- 4
다섯 내장 스타일 만나기
/config → Output style을 열면 Claude Code가 기본 동봉 스타일과 각자의 계약을 나열합니다: Default는 간결한 응답으로 효율적으로 작업 완료. Proactive는 즉시 실행, 중단 최소화. Concise는 결과를 먼저 짧게. Explanatory는 구현 선택과 코드베이스 패턴을 설명. Learning은 잠시 멈추고 직접 해 볼 작은 코드 조각을 여러분에게 맡깁니다.
preferred-output-style 메뉴 — 내장마다 한 줄 설명이 붙습니다.5:20에 시청 - 5
Claude 도움으로 커스텀 스타일 초안 뽑기
처음부터 쓸 필요 없습니다. 영상의 워크플로: 출력이 마음에 안 들면 같은 답의 세네 가지 변형을 Claude에게 생성시키고, 가장 읽기 좋은 걸 고른 뒤, 그 승자를 재사용 가능한 output style로 저장시킵니다.
레시피: 출력 → 3-4개 변형 → 최고를 스타일로 저장.4:20에 시청 - 6
커스텀 스타일이 사는 곳 보기
실물 하나 소개합니다: 'Map First' — 모든 설명을 아키텍처 다이어그램으로 여는 스타일. 파일은 프로젝트의 .claude/output-styles 폴더에 있고 ~/.claude/output-styles로 심볼릭 링크돼 모든 프로젝트에서 쓸 수 있습니다 — 저장소로 팀과 스타일을 나누는 깔끔한 패턴이죠.
Map First: 프로젝트 폴더가 원본, 사용자 디렉터리로 심볼릭 링크.5:00에 시청 - 7
선택하고, 자리 잡게 하기
/config에서 'output'으로 거르면 Output style 설정이 바로 보입니다 — Map First로 바뀌어 있죠. 한 번만 설정하면 재시작 후에도 유지됩니다: 새 세션이 처음부터 그 스타일로 말합니다. /output-style <이름>으로 즉석 전환도 되고, settings에 'outputStyle' 필드를 넣어 프로젝트 전반 기본값으로 만들 수도 있습니다.
Output style: Map First — 한 번 설정, 이후 모든 세션에 적용.5:48에 시청
3 · 프로처럼 스타일 설계하기
- 8
스타일과 스킬의 차이 알기
Matt Pocock의 /wait-what 스킬은 에이전트가 직전 메시지를 쉬운 영어로 다시 말하게 합니다 — 호출했을 때, 온디맨드로. output style은 반대 계약입니다: 모든 응답의 첫 토큰부터 활성화되어 요청받지 않아도 톤과 형식을 만듭니다. 스킬은 필요할 때 집는 도구, 스타일은 말하는 목소리입니다.
/wait-what — 스킬은 호출 시 실행, 스타일은 상시 켜짐.6:09에 시청 - 9
1980년대 항공 표준을 스타일에 훔치기
영상에서 가장 좋은 스타일 작성 조언은 ASD-STE100, Simplified Technical English에서 나옵니다 — 항공 정비사가 정비 절차를 절대 오독하지 않도록 만들어진 언어죠. 규칙: 한 단어에는 정확히 한 가지 의미만, 동의어 없음('시작'의 승인 단어를 하나 정하면 끝까지 사용), 지시문은 20단어 미만, 한 문장에 동작 하나. 좋은 output style에 필요한 계약 그 자체입니다.
STE100: 단어당 의미 하나, 동의어 금지, 지시문은 20단어 이하.6:20에 시청 - 10
역할별로 스타일 배포하기
작성자의 팀은 페르소나마다 스타일을 만들었고 메뉴에 그대로 나타납니다: API, 프런트엔드, 백엔드, 데이터베이스는 알지만 코드는 안 쓰는 기술 PM을 위한 TPM — 전제를 명시하고 결정은 추천이 붙은 트레이드오프로 제시. 기술이 전혀 없는 독자를 위한 Technical Translator — 답변마다 하나의 일상 비유, 위험 작업은 체크포인트 뒤로. 군더더기를 잘라 달라는 엔지니어를 위한 SDE.
메뉴가 자랍니다: TPM, Technical Translator, SDE — 역할마다 하나의 목소리.6:00에 시청 - 11
모드 바꾸듯 스타일 바꾸기
Output style: TPM — /config에서 선택되고 다음 인사부터 활성화됩니다. 영상이 말하는 보상: 스타일을 일에 맞추면(코드베이스를 배울 땐 Explanatory, 밤새 실행엔 Proactive, 결과만 원할 땐 Concise) 팀 전체가 읽을 수 있는 답을 얻습니다 — 흔히 token도 덜 듭니다. 스타일이 군더더기를 금지해 두니까요.
Output style: TPM — 코드를 안 쓰는 동료에게 전용 목소리를.11:04에 시청
다섯 내장 스타일, 정확히
공식 문서에 따르면 Claude Code는 다섯 스타일을 동봉합니다 — Default와 네 가지 추가분:
- 1Default — 스타일 지시를 추가하지 않음. Claude가 표준 소프트웨어 엔지니어링 시스템 프롬프트를 사용합니다. 효율적인 작업 완료, 간결한 응답.
- 2Proactive — 바로 작업을 시작하고 일상적 결정을 묻는 대신 합리적인 가정을 세움. 파괴적이거나 프로덕션에 영향을 주는 작업 전에는 여전히 확인합니다.
- 3Concise — 응답이 결과로 시작하며 머리말, 해설, 요약을 건너뜁니다. Claude Code v2.1.237 이상 필요.
- 4Explanatory — 작업 중 설계 선택을 설명하는 짧은 Insight 블록을 삽입(채팅에만 남고 파일에는 쓰지 않습니다).
- 5Learning — 같은 Insight 블록에 더해, TODO(human) 주석으로 표시된 작은 코드 조각을 남겨 여러분이 쓰기를 기다립니다.
언제든 전환 가능: /output-style <이름>(인수 없으면 나열), /config → Output style, VS Code의 / 메뉴, 또는 settings에 "outputStyle" 필드로 영구 지정. 문서의 주의 한 가지: 서브에이전트는 각자의 시스템 프롬프트로 실행되므로 스타일이 빚는 건 메인 대화이지 서브에이전트 출력이 아닙니다.