출력 스타일

중급

What you'll learn

출력 스타일이 무엇인지 — 그리고 Claude가 아는 것을 바꾸는 것과 어떻게 다른지
네 가지 내장 스타일: Default, Proactive, Explanatory, Learning
/config로 스타일을 전환하는 법 — 그리고 왜 변경에 새 세션이 필요한지
커스텀 스타일을 Markdown 파일로 직접 작성하는 법
출력 스타일 vs CLAUDE.md vs Claude.ai 커스텀 인스트럭션을 언제 써야 하는지

출력 스타일은 Claude Code가 어떻게 소통하는지 — 역할, 어조, 상세함, 추론을 설명하는지 여부 — 를 시스템 프롬프트를 직접 수정해 바꿉니다. Claude가 아는 것(무엇)이 아니라 응답하는 방식(어떻게)을 바꿉니다. 매 턴 같은 목소리나 형식을 반복해서 프롬프트하고 있다면 하나를 쓰세요.

왜 쓰나

워크플로에 맞추기. 빠르게 움직일 땐 간결하고 행동 우선; 배울 땐 설명적으로.
교육 모드. 일부 스타일은 교육적 해설을 더합니다 — 코드베이스나 기법을 익힐 때 좋습니다.
일관성. 선호 스타일을 한 번 설정하면 모든 세션이 원하는 방식으로 읽힙니다.

내장 스타일

Claude Code는 네 가지를 제공합니다:

스타일	하는 일
Default	표준 소프트웨어 엔지니어링 시스템 프롬프트 — 효율적이고 행동 우선.
Proactive	즉시 실행하며 일상적 결정을 멈춰 묻는 대신 합리적 가정을 합니다. auto 모드보다 강한 자율 실행 안내지만, 도구 실행 전 권한 프롬프트는 여전히 봅니다.
Explanatory	단계 사이에 교육적 "인사이트"를 더해 구현 선택과 코드베이스 패턴을 설명합니다.
Learning	협업적, 실습으로 배우기: 인사이트를 공유하고 동시에 작은 부분을 직접 쓰게 하며 코드에 `[TODO(human)]` 마커를 남깁니다.

Watch out

Explanatory와 Learning은 설계상 더 긴 응답을 만들므로 Default보다 출력 토큰이 더 듭니다.

Enter 또는 스페이스 키를 눌러 카드를 뒤집습니다. 좌우 화살표 키로 카드를 이동할 수 있습니다.용어가 표시되었습니다.

1 / 4

전환하는 법

/config를 실행하고 출력 스타일(Output style) 아래에서 스타일을 고르세요. 선택은 프로젝트 레벨의 .claude/settings.local.json에 저장됩니다. 메뉴 없이 설정하려면 아무 설정 파일에서 outputStyle 필드를 편집하세요.

Guided walkthrough1 of 4

세션에서 /config를 실행하고 출력 스타일 옵션을 찾습니다.

{
  "outputStyle": "Explanatory"
}

:::warning 변경에는 새 세션이 필요합니다 출력 스타일은 Claude Code가 세션 시작 시 한 번 읽는 시스템 프롬프트의 일부입니다. 변경은 /clear 또는 새 세션 이후에만 적용됩니다. (독립 /output-style 명령은 v2.1.91에서 제거되었습니다 — /config나 위의 설정을 쓰세요.) :::

커스텀 스타일 만들기

커스텀 스타일은 Markdown 파일입니다: 프론트매터, 그다음 시스템 프롬프트에 덧붙일 지시. 사용자 레벨(~/.claude/output-styles/) 또는 프로젝트 레벨(.claude/output-styles/)에 저장하세요; name을 설정하지 않으면 파일 이름이 스타일 이름이 됩니다.

커스텀 스타일 예제 — 다이어그램 우선

---
name: Diagrams first
description: Lead every explanation with a diagram
keep-coding-instructions: true
---

When explaining code, architecture, or data flow, start with a Mermaid
diagram showing the structure, then explain in prose.

Pro tip

Claude가 *어떻게* 소통하는지만 바꾸고 여전히 정상적으로 코딩하길 원할 땐 keep-coding-instructions: true를 설정하세요.
Claude가 소프트웨어 엔지니어링을 전혀 하지 않을 때 — 예를 들어 순수 글쓰기나 데이터 분석 도우미 — 는 이를 생략하세요(기본값)라서 내장 코딩 지시가 제거됩니다.