출력 스타일이란 무엇인가
Anthropic의 문서는 이를 다음과 같이 정의합니다: "출력 스타일은 세션의 모든 응답에서 Claude의 역할, 톤, 응답 형식을 설정하는 지침 세트입니다."
핵심은 반복을 멈추는 것입니다. 모든 프롬프트에서 짧은 답변을 요구하는 대신, 스타일을 한 번 설정하면 전체 세션에 적용됩니다. 커스텀 스타일을 통해 Claude에게 작가 어시스턴트나 데이터 분석가와 같은 다른 역할을 부여할 수도 있습니다.
Anthropic은 스타일이 아닌 것에 대해 주의를 줍니다: "출력 스타일은 Claude가 따를 지침을 제공합니다. 어떤 일이 항상 발생하거나 절대 발생하지 않음을 보장하지는 않습니다."
출력 스타일이 사라질 것이라는 예전 게시물을 보셨을 수도 있지만, 현재 문서에서는 4가지 내장 스타일과 커스텀 스타일을 지원하는 정식 기능으로 설명하고 있습니다.
내장 스타일
"Claude Code에는 기본값 외에 4가지 내장 스타일이 포함되어 있으며, 직접 작성할 수도 있습니다." Default(기본값)는 그 자체로 스타일이 아닙니다: "Default는 출력 스타일이 선택되지 않았음을 의미합니다." Claude는 소프트웨어 엔지니어링을 위해 작성된 Claude Code의 표준 시스템 프롬프트를 기반으로 작동합니다.
4가지 내장 스타일은 각각 표준 지침을 유지하면서 자체 지침을 추가합니다:
- Proactive (주도적). Claude는 즉시 작업을 시작하며, 일상적인 결정에 대해 묻는 대신 합리적인 가정을 내립니다. 사용자가 계획을 요청하지 않는 한 계획 모드로 전환하지 않습니다. Anthropic은 "Proactive 스타일로 전환해도 권한 모드(permission mode)는 변경되지 않는다"고 명시합니다.
- Concise (간결함). 응답은 결과부터 시작하며 서론, 서술, 요약을 생략합니다. "Default 스타일만큼 철저하게 엔지니어링 작업을 수행합니다." 상세 내용을 요청하거나 오류 보고서, 테스트 실패, 보안 경고, 파괴적 작업에 대한 확인 시에는 여전히 전체 내용을 작성합니다.
- Explanatory (설명형). Claude는 자신의 선택을 설명하는 짧은 Insight 블록을 추가합니다. "설명은 파일에 주석으로 작성되지 않습니다."
- Learning (학습형). Claude는 동일한 설명을 추가하고, 사용자가 작성할 코드 조각을
TODO(human)주석으로 남겨둔 뒤 사용자를 기다립니다.
이러한 스타일들은 표준 지침을 유지하므로, 내장 스타일을 선택하면 Claude가 사용자와 대화하고 협업하는 방식이 바뀌는 것이지, 그 밑바탕이 되는 엔지니어링 가이드가 바뀌는 것은 아닙니다.
스타일 전환 방법
/output-style <style>을 실행하세요. 예: /output-style concise. 인자 없이 명령어를 실행하면 스타일 목록을 보여주고 현재 스타일을 표시합니다. /config를 실행하고 Output style을 선택하거나, VS Code 확장 프로그램의 Output styles 메뉴를 사용할 수도 있습니다.
여러 프로젝트에서 작업하는 경우 선택 사항이 저장되는 위치가 중요합니다. "명령어와 두 메뉴 모두 선택 사항을 로컬 프로젝트 수준의 .claude/settings.local.json에 저장합니다." 모든 곳에서 스타일을 기본값으로 만들려면 ~/.claude/settings.json에서 outputStyle을 설정하세요. 단, 프로젝트 자체 설정이 우선합니다.
사람들이 자주 놓치는 두 가지 세부 사항이 있습니다. "값은 대소문자를 구분합니다." 따라서 Explanatory와 같이 정확한 이름을 설정해야 합니다. "explanatory처럼 스타일 이름과 정확히 일치하지 않는 값은 Default 스타일로 적용됩니다." 반면 /output-style 명령어는 대소문자를 무시합니다.
타이밍 문제도 있습니다: "세션 중간에 스타일을 전환하면, Claude는 다음 메시지부터 새 스타일을 사용합니다."
커스텀 스타일 작성 방법
커스텀 스타일은 frontmatter와 지침이 포함된 Markdown 파일입니다. 다음 세 위치 중 하나에 저장합니다:
- 사용자:
~/.claude/output-styles - 프로젝트:
.claude/output-styles - 관리 정책: 관리형 설정 디렉토리 내의
.claude/output-styles
"frontmatter에서 name을 설정하지 않으면 파일 이름이 스타일 이름이 됩니다." 프로젝트 스타일은 작업 디렉토리와 리포지토리 루트 사이의 모든 .claude/output-styles/ 폴더에서 로드되며, 이름이 충돌할 경우 가장 가까운 것이 우선합니다.
주의할 점 두 가지가 있습니다. "오타가 있는 필드는 오류 없이 무시됩니다." 또한 터미널에서 Claude Code는 시작할 때 스타일 파일을 읽으므로, 세션 중에 파일을 생성하거나 편집했다면 Claude Code를 재시작해야 변경 사항이 반영됩니다.
플러그인도 스타일을 제공할 수 있습니다. 플러그인 스타일은 force-for-plugin을 설정하여 플러그인이 활성화될 때 자동으로 적용되게 할 수 있습니다. 레퍼런스에 따르면 이는 "사용자의 outputStyle 설정을 덮어씁니다."
커스텀 스타일이 시스템 프롬프트에서 제거하는 것
도입부의 예시 상황에서 확인해야 할 설정이 바로 이것입니다.
Anthropic의 설명: "전체 시스템 프롬프트에서 커스텀 출력 스타일은 keep-coding-instructions가 true로 설정되지 않는 한, 변경 범위 지정, 주석 작성, 작업 검증 방법과 같은 Claude Code의 내장 소프트웨어 엔지니어링 지침 섹션을 제외합니다."
따라서 말투만 바꾸는 커스텀 스타일이라도 기본적으로는 변경 범위 지정 및 작업 검증에 대한 가이드를 제거하게 됩니다. 내장 스타일은 표준 지침을 유지하므로 이런 일이 발생하지 않지만, 커스텀 스타일은 명시적으로 거부하지 않는 한 지침을 제거합니다.
해결 방법은 frontmatter에 한 줄을 추가하는 것입니다. Anthropic의 조언: "Claude의 소통 방식은 바꾸되 코딩 방식은 그대로 유지하고 싶다면 keep-coding-instructions: true를 설정하세요." Claude가 소프트웨어 엔지니어링을 하지 않을 때만 이 설정을 생략하세요.
한 가지 더 복잡한 점이 있습니다. "짧은 시스템 프롬프트(shorter system prompt)에는 해당 섹션이 포함되어 있지 않으므로 이 필드는 효과가 없습니다." 짧은 시스템 프롬프트에서는 유지할 코딩 섹션 자체가 없기 때문입니다. Anthropic은 이 필드에 의존하려면 CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT를 0으로 설정하여 모든 모델에서 전체 프롬프트를 선택할 수 있다고 말합니다.
CLAUDE.md가 여전히 로드되는 이유
스타일은 Claude가 응답하는 방식을 바꿉니다. Claude가 프로젝트에 대해 알고 있는 내용을 바꾸지는 않습니다. Anthropic의 비교표는 CLAUDE.md를 이렇게 설명합니다: "Claude가 코드베이스에 대해 알아야 할 내용을 담고 있으며, 어떤 스타일을 선택하든 로드된 상태를 유지합니다."
이것이 올바른 역할 분담입니다:
- CLAUDE.md는 컨벤션, 명령어, 프로젝트 구조를 담습니다.
- 출력 스타일은 목소리, 길이, 형식, 역할을 담습니다.
스타일을 바꾼다고 프로젝트 지침이 언로드되지 않으며, 스타일 파일에 프로젝트 규칙을 작성하는 것도 말이 되지 않습니다. 스타일은 사용하는 모든 프로젝트에 적용되기 때문입니다. 코드베이스의 특정 부분에만 적용되어야 하는 규칙의 경우, Claude Code에는 규칙 파일이 별도로 있으며, 이는 Claude Code 규칙이란 무엇인가 가이드에서 다룬 바 있습니다.
스타일을 따르는 하위 에이전트
스타일은 메인 대화에 적용되지만, 모든 작업 영역에 적용되는 것은 아닙니다.
"출력 스타일은 메인 대화와 부모의 전체 대화 및 시스템 프롬프트를 상속받는 포크(fork)에 적용됩니다."
그 외의 모든 하위 에이전트에 대해서는: "다른 하위 에이전트들은 자체 시스템 프롬프트를 실행하므로 스타일이 응답 방식을 바꾸지 않습니다."
이것이 도입부 예시의 리뷰어 에이전트 현상을 설명해 줍니다. 하위 에이전트가 특정 형식으로 답변하길 원한다면, 해당 하위 에이전트의 정의에 이를 포함시켜야 합니다. 포크는 대화와 함께 부모의 시스템 프롬프트를 상속받기 때문에 예외입니다.
스타일이 적절한 도구가 아닌 경우
Anthropic의 자체 가이드: "출력 스타일은 세션의 모든 응답에 적용됩니다. 이는 Claude가 따르는 지침일 뿐이며, 강제하는 장치는 없습니다." 비교표에서는 더 좁거나 엄격한 요구 사항을 위해 다른 기능을 제안합니다:
- 항상 발생해야 하는 작업, 예: 편집 후 매번 포맷팅하거나 특정 명령어 차단: Claude Code가 직접 실행하는 훅(hook)을 사용하세요.
- 한 종류의 작업을 위한 지침, 예: 릴리스 체크리스트: 관련이 있을 때만 로드되는 스킬(skill)을 사용하세요.
- 자체 지침과 도구를 가진 헬퍼: 하위 에이전트를 사용하세요.
- 아무것도 제거하지 않고 지침을 추가: Claude Code를 시작할 때
--append-system-prompt를 사용하세요.
그리고 Claude가 프로젝트에 대해 알아야 할 내용은 CLAUDE.md를 사용하세요.
토큰 사용량은 부수적인 요소입니다. 스타일 지침은 입력 토큰을 추가하지만, 세션의 첫 요청 이후에는 프롬프트 캐싱이 이를 줄여줍니다. Explanatory와 Learning은 설계상 더 긴 응답을 생성하는 반면, Concise는 더 짧은 응답을 생성합니다.
사람들이 처음에 겪는 실수
커스텀 스타일을 작성하면서 실수로 코딩 가이드를 누락함. keep-coding-instructions: true를 추가하세요.
스타일에 프로젝트 규칙을 넣음. 이는 어떤 스타일을 선택하든 로드되는 CLAUDE.md에 있어야 합니다.
하위 에이전트가 스타일을 따를 것이라 기대함. 메인 대화와 포크만 스타일을 따릅니다.
설정에서 스타일 이름을 소문자로 입력함. 설정값은 대소문자를 구분합니다.
세션 중간에 스타일을 편집함. 터미널에서 Claude Code를 재시작해야 반영됩니다.
항상 발생해야 하는 일을 위해 스타일에 의존함. 훅(hook)을 사용하세요.
해결책: 각 지침을 적절한 위치에 배치하기
1단계: 커스텀 스타일에서 코딩 지침 유지하기
소프트웨어 작업에 사용되는 모든 커스텀 스타일에 keep-coding-instructions: true를 추가하세요.
2단계: 프로젝트 지식은 CLAUDE.md로 이동하기
컨벤션, 명령어, 구조는 스타일이 아닌 CLAUDE.md에 작성합니다.
3단계: 하위 에이전트에게 자체 형식 규칙 부여하기
하위 에이전트의 출력 형식이 중요하다면, 해당 하위 에이전트의 정의에서 설정하세요.
4단계: 스타일 뒤에 숨겨진 선호도 기록하기
특정 형식을 선택한 이유와 의존하는 프로젝트 규칙을 기록하여, 한 도구의 설정 밖에서도 사용할 수 있게 하세요.
MemoryLake에서 설정하기
출력 스타일은 도구별 설정이고, CLAUDE.md는 프로젝트별 설정입니다. 변경 사항을 설명하는 방식이나 가장 중요한 컨벤션과 같은 선호도 및 프로젝트 결정 사항은 함께 작업하는 모든 어시스턴트에서 유용합니다.
MemoryLake는 선호도, 컨벤션, 프로젝트 결정 사항과 같은 작업 context를 한 곳에서 관리하고 ChatGPT, Claude Code, Codex 등 연결된 어시스턴트에서 사용할 수 있게 해주는 기억 계층(memory layer)입니다.
사용자는 자신의 언어로 직접 항목을 작성합니다. 출력 스타일 파일, 설정 파일, CLAUDE.md, 하위 에이전트 정의, 세션 또는 벤더의 저장소에서 어떤 내용도 읽거나 쓰거나 삭제하지 않습니다. 출력 스타일과 CLAUDE.md는 Anthropic이 설명한 방식 그대로 작동합니다.
1단계: API 키 생성
로그인 후 대시보드에서 키를 생성하세요. 다른 자격 증명과 마찬가지로 리포지토리 외부에 보관하세요.

2단계: 첫 번째 기억 업로드
해결책 4단계에서 작성한 내용부터 시작하세요: 포맷팅 선호도, 그 이유, 의존하는 프로젝트 컨벤션 등입니다. 항목당 하나의 선호도나 컨벤션을 작성합니다.

3단계: AI 및 에이전트 연결
Claude Code, Codex, ChatGPT 또는 사용하는 다른 어시스턴트를 연결하세요. 각 도구는 자체 스타일 설정을 유지하면서 동일한 선호도를 활용할 수 있습니다.

실제로 바뀌는 점
첫 번째 차이점은 도구 간의 일관성입니다. 작업 설명 방식이 각 어시스턴트마다 다르게 설정되는 것이 아니라 한 번만 작성됩니다.
두 번째는 더 깔끔한 스타일입니다. 컨벤션은 다른 곳에 보관되므로 스타일은 목소리와 형식에만 집중할 수 있습니다.
세 번째는 더 쉬운 온보딩입니다. 팀원은 스타일 파일을 역공학하는 대신 설정 뒤에 숨겨진 이유를 읽을 수 있습니다.
Claude Code 출력 스타일 모범 사례
내장 스타일로 시작하세요. 내장 스타일은 Claude Code의 표준 지침을 유지합니다.
커스텀 스타일에 keep-coding-instructions를 추가하세요. 그렇지 않으면 전체 시스템 프롬프트에서 코딩 섹션이 제외됩니다.
설정에서 정확한 이름을 사용하세요. 설정값은 대소문자를 구분합니다.
스타일 파일 편집 후 재시작하세요. 터미널은 시작 시 스타일 파일을 읽습니다.
프로젝트 지식은 CLAUDE.md에 보관하세요. 어떤 스타일을 선택하든 로드된 상태를 유지합니다.
하위 에이전트 형식은 해당 정의에서 설정하세요. 스타일은 메인 대화와 포크에만 적용됩니다.
보장이 필요한 경우 훅(hook)을 사용하세요. 스타일은 지침일 뿐이며 강제되지 않습니다.
결론
출력 스타일은 세션 전반에 걸쳐 Claude의 역할, 톤, 형식을 설정하는 지침 세트입니다. Claude Code에는 Proactive, Concise, Explanatory, Learning의 4가지 내장 스타일이 있으며, 이들은 모두 표준 엔지니어링 지침을 유지합니다. 커스텀 스타일은 Markdown 파일이며, keep-coding-instructions: true를 설정하지 않으면 전체 시스템 프롬프트에서 Claude Code의 소프트웨어 엔지니어링 섹션을 제외합니다.
스타일은 어떤 스타일을 선택하든 로드되는 CLAUDE.md를 대체하지 않으며, 다른 하위 에이전트가 아닌 메인 대화와 포크에만 적용됩니다. 스타일은 Claude가 응답하는 방식을 위해 사용하고, Claude가 알아야 할 내용이나 매번 발생해야 하는 일은 그에 맞게 설계된 기능을 사용하세요.