출력 스타일

내장된 Concise 또는 Explanatory와 같은 출력 스타일이나 사용자 정의 스타일로 Claude Code의 역할, 톤, 응답 형식을 변경합니다.

출력 스타일은 Claude의 역할, 톤, 응답 형식을 세션의 모든 응답에 대해 설정하는 일련의 지침입니다. Claude Code는 기본값 외에 4가지 내장 스타일을 포함하고 있으며, 사용자 정의 스타일을 작성할 수 있습니다.

출력 스타일을 사용하여 Claude가 응답하고 전체 세션 동안 사용자와 함께 작업하는 방식을 변경하므로 각 프롬프트에서 요청을 반복할 필요가 없습니다. 예를 들어, 내장 스타일은 응답을 더 짧게 만들거나, 각 변경 사항에 대한 설명을 추가하거나, Claude가 일상적인 질문을 하지 않고 작업을 시작하도록 할 수 있습니다. 사용자 정의 스타일은 Claude를 소프트웨어 엔지니어 이외의 것(예: 작성 어시스턴트 또는 데이터 분석가)으로 변환할 수도 있습니다.

• 내장 스타일을 사용하려면 내장 출력 스타일에서 하나를 선택하고 스타일로 전환합니다.
• 자신의 지침을 작성하려면 사용자 정의 출력 스타일 만들기를 참조합니다.

기본 제공 출력 스타일

Claude Code는 Default 스타일로 시작하며, 이는 소프트웨어 엔지니어링 작업을 완료하기 위한 표준 지침입니다. 다른 네 가지 기본 제공 스타일은 이러한 지침을 유지하면서 자신만의 지침을 추가합니다.

이 표는 각 스타일이 세션을 어떻게 변경하는지와 언제 사용하면 좋은지 보여줍니다:

Default

Default는 출력 스타일이 선택되지 않음을 의미합니다. Claude Code는 스타일 지침을 추가하지 않으며, Claude는 소프트웨어 엔지니어링 작업을 위해 작성된 Claude Code의 표준 시스템 프롬프트에서 작동합니다.

default는 다른 스타일과 함께 /output-style 목록에 나타나므로, 같은 방식으로 선택합니다.

Proactive

Proactive 스타일에서 Claude는 작업을 보내자마자 구현을 시작합니다. 일상적인 결정에 대해 합리적인 가정을 하며 묻지 않으며, 계획을 요청하지 않는 한 계획 모드로 전환하지 않습니다. 언제든지 방향을 바꿀 수 있습니다.

스타일의 지침은 또한 Claude에게 데이터를 삭제하거나 공유 또는 프로덕션 시스템을 변경하는 작업 전에 대화에서 사용자와 확인하도록 지시합니다. 이 확인은 Claude가 따르는 지침이며 권한 프롬프트와는 별개입니다.

Proactive 스타일로 전환해도 권한 모드는 변경되지 않습니다. 권한 모드는 여전히 사용자에게 묻지 않고 실행되는 도구 호출을 결정하므로, 권한 프롬프트는 전환 전과 같은 방식으로 나타납니다.

Concise

Concise 스타일에서 응답의 첫 번째 문장은 무엇이 일어났는지 또는 답이 무엇인지를 나타냅니다. Claude는 도입부, 단계별 설명, 마무리 요약을 생략하고 간단한 질문에 1~3개 문장으로 답변합니다. Default 스타일과 동일하게 엔지니어링 작업을 철저히 수행합니다. Claude Code v2.1.237 이상이 필요합니다.

Claude는 다음의 경우 전체 길이로 작성합니다:

• 요청하는 모든 것: 설명이나 더 많은 세부 정보를 요청할 때, Claude는 완전히 답변합니다.
• 안전하게 행동하기 위해 필요한 모든 것: 오류 보고서, 실패한 테스트 출력, 보안 경고, 파괴적인 작업에 대한 확인은 전체 내용을 유지합니다.

Explanatory

Explanatory 스타일에서 Claude는 Default 스타일과 동일한 방식으로 작업을 수행하고 선택한 이유에 대한 짧은 설명을 추가합니다. 각 설명은 대화에서 관련 코드 앞이나 뒤에 Insight라는 레이블이 붙은 블록으로 나타납니다. 설명은 파일에 주석으로 작성되지 않습니다.

Insight 블록은 코드베이스 또는 Claude가 작성한 코드에 대한 2~3개의 포인트를 포함하며, API 엔드포인트를 추가한 후의 다음과 같은 예시가 있습니다:

★ Insight ─────────────────────────────────────
- Every route in this repo goes through the withAuth wrapper, so the new endpoint gets session checks without its own middleware.
- Rate limits are set per route in limits.ts, which is why this change adds an entry there rather than a global default.
─────────────────────────────────────────────────

Learning

Learning 스타일에서 Claude는 Explanatory 스타일과 동일한 Insight 블록을 추가하고 코드의 일부를 작성하도록 요청합니다. Claude는 일상적인 구현을 자체적으로 처리합니다. 오류 처리, 데이터 구조, 또는 유효한 접근 방식이 여러 개인 비즈니스 로직과 같은 실제 설계 결정이 있는 부분에 도달하면, 몇 줄을 남깁니다.

Claude는 파일의 TODO(human) 주석으로 위치를 표시한 다음, 이미 구축된 것, 작성할 것, 고려할 것을 설명하는 요청을 보냅니다:

● Learn by Doing

Context: The upload form is in place and calls validateFile() before accepting a file. Size and type checks work for images, but the switch statement has no handling for documents yet.

Your Task: In upload.js, implement the case "document" branch inside validateFile(). Look for TODO(human).

Guidance: Decide on a size limit for documents and whether the file extension has to match the MIME type. Return {valid: boolean, error?: string}.

Claude는 멈추고 기다립니다. TODO(human) 주석에서 코드를 작성하고 완료했을 때 Claude에게 알립니다. Claude는 코드에 대한 하나의 Insight로 응답하고 작업을 계속합니다.

출력 스타일 변경

명령, 메뉴 또는 설정 파일로 스타일을 선택합니다. 명령과 두 메뉴 모두 선택 사항을 로컬 프로젝트 수준의 .claude/settings.local.json에 저장합니다.

• /output-style 명령: /output-style <style>을 실행하여 전환합니다. 예를 들어 /output-style concise입니다. 인수 없이 실행하면 선택할 수 있는 스타일을 나열하고 현재 스타일을 표시합니다.

  이 명령은 비대화형 모드 및 Agent SDK 세션에서도 작동하며, 모바일 앱 또는 웹에서 원격 제어를 통해 사용할 수 있습니다. 여기서는 기본 제공 스타일만 나열하고 선택할 수 있습니다. Claude Code v2.1.269 이상이 필요합니다.

• Terminal 메뉴: /config를 실행하고 Output style을 선택하여 메뉴에서 스타일을 선택합니다.

• VS Code extension: /로 명령 메뉴를 열고 Output styles을 선택하여 사용자 정의 스타일을 포함한 스타일을 선택합니다. Claude Code v2.1.257 이상이 필요합니다.

• Desktop app: 설정 파일(예: .claude/settings.local.json, 터미널 메뉴가 작성하는 파일)에서 outputStyle 필드를 설정합니다. /config를 실행하면 Claude Code는 메뉴 대신 Settings > Claude Code를 엽니다.

메뉴 없이 스타일을 설정하려면 설정 파일에서 outputStyle 필드를 직접 편집합니다:

{
  "outputStyle": "Explanatory"
}

값은 대소문자를 구분하므로 기본 제공 이름을 Proactive, Concise, Explanatory, Learning으로 작성합니다. explanatory와 같이 스타일 이름과 정확히 일치하지 않는 값은 기본 스타일을 제공합니다. /output-style 명령은 대소문자를 무시합니다.

프로젝트 전체에서 스타일을 기본값으로 설정하려면 ~/.claude/settings.json에서 outputStyle을 설정합니다. 프로젝트의 자체 설정 파일은 해당 값보다 우선합니다.

세션 중에 스타일을 전환하면 Claude는 다음 메시지부터 새로운 스타일을 사용합니다. 첫 번째 메시지의 prompt caching 비용에 대해서는 출력 스타일 변경을 참조하십시오. v2.1.251 이전에는 새로운 스타일이 /clear를 실행하거나 새 세션을 시작한 후에만 적용되었습니다.

사용자 정의 출력 스타일 만들기

사용자 정의 출력 스타일은 Markdown 파일입니다: frontmatter는 메타데이터용이고, 그 다음에 Claude를 위한 지침이 있습니다.

VS Code 확장 프로그램에서는 직접 작성하는 대신 출력 스타일 메뉴에서 파일을 만들 수도 있습니다. 이 기능은 Claude Code v2.1.261 이상이 필요합니다.

---
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.

## Diagram conventions

Use `flowchart TD` for control flow and `sequenceDiagram` for request paths. Keep diagrams under 15 nodes.

플러그인도 output-styles/ 디렉토리에 출력 스타일을 포함할 수 있습니다.

Frontmatter 참조

YAML frontmatter를 사용하여 출력 스타일을 구성합니다. 파일 맨 위의 --- 마커 사이에 위치합니다. 모든 필드는 선택 사항이며, 필드 이름은 하이픈으로 구분된 소문자 단어를 사용합니다. 오타가 있는 필드는 오류 없이 무시됩니다. YAML이 파싱되지 않으면 스타일은 여전히 파일 이름으로 로드되며 필드가 설정되지 않습니다. claude --debug를 실행하여 파싱 오류를 확인합니다.