Claude Code의 응답 스타일: 전환하고 직접 만드는 방법

Claude Code의 출력 스타일이 무엇이며 CLAUDE.md와 어떻게 다른지 알아봅니다. 기본 제공 스타일 네 가지, /config를 통한 전환 방법, 사용자 지정 스타일 작성 방법을 설명합니다.

전체 글 읽기

Claude Code에 두어 메시지마다 “더 짧게 답해 줘”, “더 자세히 설명해 줘” 또는 “프로그래머가 아니라 편집자처럼 행동해 줘”라고 요청하게 된다면, 이 설정을 한 번만 해두면 됩니다. 이를 위한 별도 설정이 있는데, 인터페이스에서는 출력 스타일이라고 부르는 응답 스타일입니다. 스타일을 바꾸면 이후 모든 응답의 역할, 어조, 형식이 달라지며, 다른 스타일로 전환할 때까지 유지됩니다.

스타일은 Claude가 프로젝트에 대해 아는 내용이 아니라 응답하는 방식을 바꿉니다. 프로젝트 맥락은 CLAUDE.md 파일에 설정할 수 있습니다. Claude를 나에게 맞게 설정하는 방법 가이드도 참고하세요.

Ailoot 사용 방법은 문서에서 확인할 수 있습니다.

Claude Code의 응답 스타일이란?

핵심 내용

응답 스타일(출력 스타일)은 Claude Code가 사용자의 모든 요청에 추가하는 지침 모음입니다. 응답의 역할, 어조, 형식을 정하지만 모델이 알고 있는 내용은 바꾸지 않습니다. 기본 스타일 외에 Proactive, Concise, Explanatory, Learning의 네 가지 기본 제공 스타일이 있습니다. /config → Output style에서 스타일을 전환할 수 있습니다.

Claude Code는 보통 엔지니어 역할을 하도록 설정되어 있습니다. 단계를 자세히 설명하고, 수정 사항을 계획하며, 무엇을 하고 있는지 설명합니다. 이것이 기본 스타일이며, 코드 작업을 위한 표준 지침 모음입니다.

응답 스타일을 선택하면 이 지침 모음이 해당 스타일의 지침으로 대체됩니다. 요청할 때마다 Claude Code는 활성 스타일의 지침을 모델에 전달합니다. 기본 스타일이 아닌 스타일을 선택한 경우에는 대화가 진행되는 동안 Claude에게 해당 스타일을 따르도록 다시 알려 줍니다. 따라서 원하는 응답 방식을 반복해서 요청할 필요가 없습니다.

항상 같은 방식의 응답을 원한다면 스타일을 사용하세요. 예를 들어 더 짧은 답변이나 설명을 원하거나, 프로그래머 대신 교정자 또는 데이터 분석가 역할을 원할 수 있습니다. Claude가 특정 프로젝트의 규칙과 구조를 기억하게 하려면 CLAUDE.md 파일을 사용하세요.

응답 스타일은 CLAUDE.md와 어떻게 다른가요?

핵심 내용

응답 스타일은 Claude Code의 기본 지침을 대체하며 모든 응답에 적용됩니다. CLAUDE.md는 프로젝트 맥락을 담은 메시지를 추가합니다. 스타일은 응답 방식을 정하고, CLAUDE.md는 프로젝트 작업에서 고려해야 할 내용을 정합니다. 두 도구는 서로 간섭하지 않습니다.

Claude Code의 동작에 영향을 주는 방법은 여러 가지이며, 각각 목적이 다릅니다.

도구	기능	사용 시점
응답 스타일	기본 지침을 대체하며 모든 응답에 적용됩니다	매번 다른 역할, 어조 또는 응답 형식을 원할 때
`CLAUDE.md`	시스템 메시지 다음에 프로젝트 맥락을 추가합니다	Claude가 프로젝트의 규칙과 구조를 항상 알고 있어야 할 때
`--append-system-prompt`	실행 시 시스템 메시지에 내용을 추가합니다	실행 플래그를 통해 한 번만 내용을 추가하고 싶을 때
서브에이전트	별도의 시스템 메시지와 도구를 가진 도우미를 실행합니다	특정 작업을 위한 별도의 도우미가 필요할 때

스타일은 응답 방식을 정하고, CLAUDE.md는 프로젝트 맥락을 저장합니다. 한쪽이 다른 쪽의 역할을 대신하도록 바꿀 필요는 없습니다.

기본 제공 스타일에는 어떤 것이 있으며 각각 언제 사용하나요?

핵심 내용

기본 스타일 외에 기본 제공 스타일이 네 가지 있습니다. Proactive는 Claude가 즉시 행동하고 후속 질문을 줄입니다. Concise는 도입부 없이 짧게 답합니다. Explanatory는 작업하면서 설명을 덧붙입니다. Learning은 함께 작업하면서 사용자가 완성할 작은 코드 조각을 남깁니다. Concise는 Claude Code 버전 2.1.237 이상에서 사용할 수 있습니다.

Proactive. Claude가 즉시 작업을 수행하고, 사소한 불확실성은 합리적으로 가정하며, 논의하기보다 행동하는 방식을 선호합니다. 이 동작은 자동 모드보다 독립적이며 액세스 모드를 바꾸지 않고 사용할 수 있습니다. 액세스 모드는 여전히 어떤 작업을 사용자 확인 없이 실행할 수 있는지 결정합니다. 이 스타일은 Claude가 더 과감하게 행동하도록 하지만 위험한 명령에 대한 보호 장치를 없애지는 않습니다. 도구를 신뢰하고 사소한 사항을 확인하느라 매번 멈추지 않기를 바랄 때 적합합니다.

Concise. Claude는 결과부터 제시하고 도입부와 작업 과정 설명은 생략하며 답변을 짧게 유지합니다. 기본 스타일과 같은 수준으로 꼼꼼히 작업하며, 설명을 요청하면 자세히 답합니다. 오류 보고, 안전 경고, 위험한 작업 전 확인은 빠짐없이 제공됩니다. 이 스타일은 이런 내용을 줄이지 않습니다. 짧고 직접적인 답변을 원할 때 적합합니다.

Explanatory. Claude는 작업하면서 해결책을 선택한 이유와 프로젝트 코드의 구조를 설명합니다. 답변은 기본 스타일보다 길어집니다. 결과를 얻는 것뿐 아니라 진행 상황도 이해하고 싶을 때 적합합니다.

Learning. 협업 모드입니다. Claude는 결정을 설명할 뿐 아니라 사용자가 직접 작성할 수 있도록 파일에 TODO(human) 표시가 있는 작은 코드 조각을 남깁니다. 직접 해보며 배우고 코드 일부를 직접 작성하고 싶을 때 적합합니다.

팁

어디서 시작할지 모르겠다면 짧은 답변에는 Concise를, 결정의 근거를 이해하려면 Explanatory를 선택하세요. 둘 다 직접 코드를 작성하지 않는 경우에도 유용합니다.

응답 스타일은 어떻게 전환하나요?

핵심 내용

Claude Code에서 /config 명령을 실행하고 Output style을 선택한 다음 원하는 스타일을 고르세요. 선택한 스타일은 프로젝트의 .claude/settings.local.json 파일에 저장됩니다. 버전 2.1.251 이상에서는 다음 메시지부터 새 스타일이 적용됩니다. VS Code 확장에서는 Output styles 메뉴에서 스타일을 고를 수 있으며, 이 기능은 버전 2.1.257부터 제공됩니다.

이전 안내에서 스타일 전용 명령어를 볼 수도 있습니다. 여기서 설명하는 문서는 /config 경로를 안내합니다.

설정 열기
```
/config
```
Claude Code 채팅에 명령을 입력하세요. 설정 메뉴가 열립니다.
Output style 선택
메뉴에서 Output style 항목을 찾아 엽니다. Default와 기본 제공 스타일 네 가지, 그리고 만든 사용자 지정 스타일이 목록에 표시됩니다.
스타일을 선택하고 작업 계속하기
원하는 스타일을 선택하세요. Claude Code는 현재 프로젝트의 .claude/settings.local.json에 선택 사항을 저장합니다. 버전 2.1.251 이상에서는 다음 메시지부터 새 스타일이 적용됩니다.

VS Code 확장을 사용 중이라면 / 명령으로 메뉴를 열고 Output styles를 선택하세요. 선택 사항은 같은 파일에 저장됩니다. 확장의 스타일 메뉴는 버전 2.1.257부터 사용할 수 있습니다.

메뉴를 사용하지 않고 설정 파일에 스타일을 입력해 설정할 수도 있습니다.

{
  "outputStyle": "Explanatory"
}

주의

세션 도중 스타일을 바꾸면 다음 메시지부터 적용됩니다. 이 기능은 Claude Code 버전 2.1.251 이상에서 작동합니다. 이전 버전에서는 /clear 명령을 실행하거나 새 세션을 시작해야 새 스타일이 적용됩니다. 스타일이 “전환되지 않으면” 먼저 버전을 확인하세요.

나만의 응답 스타일은 어떻게 만드나요?

핵심 내용

사용자 지정 스타일은 짧은 헤더와 지침이 담긴 일반 Markdown 파일입니다. 모든 프로젝트에서 사용하려면 홈 폴더에, 특정 프로젝트에서만 사용하려면 프로젝트 안에 .claude/output-styles 폴더를 만들고 파일을 넣으세요. 헤더에 name을 설정하지 않으면 파일 이름이 스타일 이름이 됩니다. 터미널 세션 중 파일을 만들었다면 Claude Code를 다시 시작한 뒤 /config에서 스타일을 선택하세요.

프로그래밍할 필요는 없습니다. 쉬운 말로 작성하면 됩니다. 파일은 세 개의 대시 사이에 놓인 헤더(메타데이터)와 그 아래의 지침 텍스트로 구성됩니다.

스타일을 사용할 위치에 따라 파일을 둘 곳이 달라집니다.

~/.claude/output-styles — 모든 프로젝트에서 스타일을 사용할 수 있습니다.
프로젝트 안의 .claude/output-styles — 해당 프로젝트에서만 스타일을 사용할 수 있습니다.

Claude가 프로그래머 대신 비즈니스 문서 편집자처럼 답하도록 요청하는 스타일의 예입니다.

---
name: 텍스트 편집자
description: 프로그래머가 아니라 비즈니스 문서 편집자처럼 답변하기
---

당신은 비즈니스 문서 편집자입니다. 사용자가 선호하는 언어로 짧은 문단을 사용해 답변하세요.
먼저 수정한 버전을 제시한 다음, 수정 이유와 함께 변경 사항을 목록으로 작성하세요.
요청받지 않는 한 코드를 제안하거나 기술적 세부 사항을 논의하지 마세요.

헤더의 name은 /config 메뉴에서 보게 될 스타일 이름입니다. 이를 생략하면 파일 이름이 사용됩니다. description은 메뉴에도 표시되는 짧은 설명입니다.

keep-coding-instructions 필드도 있습니다. 기본적으로 사용자 지정 스타일은 주석 작성 방법, 작업 검증, 수정 범위 제한과 같은 Claude Code의 기본 엔지니어링 지침을 제거합니다. 응답 스타일을 사용하면서도 Claude가 엔지니어처럼 행동하기를 원한다면, 예를 들어 항상 다이어그램부터 제시하도록 하려면 헤더에 keep-coding-instructions: true를 설정하세요. 위의 교정자 예처럼 해당 스타일에서 Claude가 코드 작업을 하지 않는다면 이 필드는 필요하지 않습니다.

스타일 폴더 만들기
```
mkdir -p ~/.claude/output-styles
```
이렇게 하면 모든 프로젝트에서 스타일을 사용할 수 있습니다. 단일 프로젝트에만 사용하려면 프로젝트 안에 .claude/output-styles를 만드세요.
Markdown 파일 저장하기
폴더에 redaktor.md와 같은 파일을 만들고 헤더와 지침을 추가하세요. 위의 예를 참고해 작업에 맞게 수정할 수 있습니다.
스타일을 선택하고 확인하기
터미널 세션 중에 파일을 만들었다면 먼저 Claude Code를 다시 시작하세요. /config를 열고 Output style 목록에서 스타일을 찾아 선택합니다. 스타일과 관련된 작업을 Claude에게 맡기고 원하는 방식으로 답하는지 확인하세요.

주의

Claude Code 터미널은 시작할 때 스타일 파일을 읽습니다. 세션이 실행 중일 때 스타일 파일을 만들거나 수정했다면 Claude Code를 다시 시작하세요. 그렇지 않으면 새 파일을 인식하지 못합니다.

사용자 지정 스타일은 도구의 응답 방식을 정합니다. 한 번 설명해 두면 도구가 이후에도 그 방식을 유지합니다.

응답 스타일은 어떤 것에 영향을 주지 않나요?

핵심 내용

스타일은 응답 방식을 바꾸지만 모델에 새로운 지식을 제공하거나 CLAUDE.md를 대체하지 않습니다. 메인 대화와 그 분기(fork)에 적용되지만, 자체 시스템 메시지를 사용하는 서브에이전트의 동작은 바꾸지 않습니다. 플러그인도 자체 스타일을 추가할 수 있습니다.

스타일은 모델에 새로운 사실을 추가하지 않습니다. Claude가 프로젝트에 대해 모르는 내용이 있다면 스타일을 바꿔도 해결되지 않습니다. CLAUDE.md를 통해 프로젝트 맥락을 제공할 수 있습니다.

스타일은 전체 대화를 이어받는 메인 대화와 그 분기에서 작동합니다. 특정 작업을 위한 별도의 도우미인 서브에이전트는 각자의 시스템 메시지로 실행되므로 스타일이 응답에 영향을 주지 않습니다.

플러그인이 자체 output-styles 폴더에 스타일을 넣어 제공할 수도 있습니다. 이러한 스타일도 사용자의 스타일과 같은 목록에 표시됩니다.

스타일에 드는 토큰은 얼마나 되나요?

핵심 내용

스타일 지침은 모든 요청에 추가되므로 입력 토큰이 약간 늘어납니다. Explanatory와 Learning은 더 긴 응답을 생성해 출력 토큰이 늘고, Concise는 출력 토큰을 줄입니다. 요청 캐싱을 사용하면 세션의 첫 메시지 이후 이 추가 비용이 줄어듭니다.

스타일 지침 자체가 입력 토큰을 추가하지만, 요청 캐싱을 사용하면 세션의 첫 요청 이후 비용이 줄어듭니다. 출력 토큰 차이가 더 눈에 띕니다. Explanatory와 Learning은 긴 응답을 제공하도록 설계되었고 Concise는 답변을 짧게 유지합니다. 사용자 지정 스타일의 출력 토큰 사용량은 지침에 무엇을 지정하느냐에 따라 달라집니다.

정확한 절감량을 약속할 수는 없습니다. 작업과 모델에 따라 달라집니다. 더 짧고 저렴한 응답을 원한다면 Concise를, 더 자세한 답변을 원한다면 Explanatory를 선택하세요.

무엇부터 하면 좋을까요?

핵심 내용

/config에서 기본 제공 스타일 하나를 선택하고 하루 동안 사용해 평소 응답과 비교해 보세요. 그런 다음 평소 원하는 응답 스타일을 쉬운 말로 설명해 .claude/output-styles 폴더의 파일에 저장하고 실제 작업에 적용해 보세요.

/config를 열고 Concise 또는 Explanatory를 선택해 평소 하는 작업에 사용해 보세요. 같은 요청을 계속 반복하고 있다면 위의 단계에 따라 사용자 지정 스타일을 만드세요.

다음으로 이 주제를 더 알아보려면 Claude가 프로젝트 맥락을 기억하도록 하는 CLAUDE.md로 Claude를 나에게 맞게 설정하는 방법과 Claude Code를 확장하는 다른 방법을 알아보는 Claude Code에서 무엇을 선택할까: Skills, Subagents, MCP 또는 Plugins을 참고하세요. Claude가 필요한 파일을 볼 수 없다면 Claude Code가 프로젝트 파일을 볼 수 없는 이유를 확인하세요.

출처

Ailoot에 대해 알아보세요.