muaco Tech Note

Claude Codecode.claude.com

Claude Code 출력 스타일 바꾸기내장 스타일 고르기와 직접 만들기

Claude Code의 답변 방식을 내장 출력 스타일로 바꾸고, 업무용 스타일을 직접 만들어 적용합니다.

안녕하세요, muaco입니다.

이 글로 할 수 있는 일

이 글을 따라 하면 Claude Code가 답하는 방식을 업무에 맞게 바꿀 수 있습니다. 결과만 짧게 받을 수도 있고 이유까지 들을 수도 있습니다. 아예 보고서 도우미로 바꿔 쓰기도 합니다.

단골 식당에서는 "덜 맵게"를 매번 말하지 않아도 됩니다. 처음 한 번 일러 두면 다음부터 알아서 맞춰 줍니다. Claude Code에서 이 일을 맡는 기능을 출력 스타일(output style)이라고 부릅니다.

공식 문서는 출력 스타일을 세션 전체의 역할, 말투, 답변 형식을 정하는 지침 묶음으로 설명합니다. 세션은 Claude Code를 켜서 끌 때까지 이어지는 대화 한 판입니다. 기본 스타일 말고도 내장 스타일이 넷 있고 직접 만들어 쓸 수도 있습니다.

미리 갖춰야 할 준비

  • Claude Code가 설치되어 터미널에서 켜지는 상태. 터미널은 글자로 명령을 쳐서 컴퓨터를 다루는 창입니다.
  • 버전. 기능마다 필요한 버전이 다릅니다. Concise 스타일은 v2.1.237 이상이 필요합니다. 비대화형 모드, Agent SDK, 원격 제어에서 /output-style 명령을 쓰려면 v2.1.269 이상이어야 합니다.
  • 세션 중 전환. 스타일을 바꾸면 바로 다음 메시지부터 적용되며 이 동작은 v2.1.251부터입니다. 그보다 낮은 버전은 /clear를 치거나 새 세션을 열어야 바뀝니다.
  • 텍스트 편집기. 메모장이면 충분합니다. 스타일을 직접 만들 때 마크다운 파일 하나를 씁니다.

내장 스타일 다섯 가지

무엇을 고를지부터 정해 봅니다. Default를 뺀 네 스타일은 Default의 기본 지침을 그대로 두고 저마다 지침을 더합니다.

스타일바뀌는 점이럴 때 고릅니다
Default스타일 지침을 더하지 않습니다. 소프트웨어 작업용 기본 지침만 씁니다특별히 바꿀 이유가 없을 때
Proactive자잘한 결정은 묻지 않고 합리적으로 짐작해 바로 작업합니다일단 진행시키고 틀리면 바로잡고 싶을 때
Concise첫 문장에 결과를 말하고 서론, 진행 중계, 마무리 요약을 뺍니다기본 답변이 너무 길다고 느낄 때
Explanatory작성한 코드의 선택 이유를 Insight 블록으로 덧붙입니다낯선 코드베이스를 익히는 중일 때
Learning설명에 더해 코드 몇 줄을 사용자에게 직접 쓰게 합니다일을 끝내면서 손으로 익히고 싶을 때

Proactive로 바꿔도 권한 모드는 그대로입니다. 그래서 허락을 묻는 창은 전과 똑같이 뜹니다. 데이터를 지우거나 공유 시스템을 바꾸기 전에는 대화로 먼저 확인하라는 지침도 들어 있습니다.

Concise도 생략하지 않는 부분이 있습니다. 직접 자세히 물으면 길게 답합니다. 오류 보고, 실패한 테스트 결과, 보안 경고, 되돌리기 어려운 작업 확인도 줄이지 않습니다.

따라 하기

내장 스타일로 바꾸기

따라 하기
  1. 작업할 폴더에서 Claude Code를 켜세요. 바꾼 결과가 그 폴더의 .claude/settings.local.json에 저장되므로, 어느 폴더에서 켰는지가 중요합니다.
  2. 입력창에 /output-style만 치고 엔터를 누릅니다. 고를 수 있는 스타일이 줄지어 뜨고 지금 쓰는 스타일에 표시가 붙어 있으면 정상입니다.
  3. 원하는 이름을 붙여 다시 칩니다. 예를 들면 /output-style concise입니다. 이 명령은 대소문자를 가리지 않습니다.
  4. 메뉴가 편하다면 /config를 치고 Output style을 고르세요. 결과는 명령으로 바꿀 때와 같습니다.
  5. 평소처럼 질문 하나를 보내 봅니다. 답변 모양이 달라졌다면 제대로 바뀐 상태입니다.

모든 프로젝트의 기본값으로 정하기

따라 하기
  1. 편집기로 ~/.claude/settings.json을 엽니다. ~는 내 사용자 폴더를 줄여 쓴 표시입니다.
  2. 파일에 이미 다른 설정이 들어 있다면 통째로 덮어쓰지 말고 항목 하나만 추가하세요. 덮어쓰면 원래 설정이 사라집니다. 비어 있는 파일이라면 아래처럼 씁니다. 
    {
  "outputStyle": "Explanatory"
}
  3. 값은 정확한 이름으로 적습니다. Proactive, Concise, Explanatory, Learning처럼 첫 글자를 대문자로 씁니다.
  4. 저장한 다음 다른 폴더에서 Claude Code를 켜고 /output-style을 칩니다. 방금 적은 스타일에 표시가 붙어 있으면 됩니다. 그 폴더에 프로젝트 설정이 따로 있으면 그쪽 값이 먼저 보이니, .claude 폴더가 없는 곳에서 확인하세요.

나만의 스타일 만들기

사내 보고서 초안을 돕는 스타일을 예로 들어 보겠습니다. 이번에는 코딩을 시키지 않는 스타일입니다.

따라 하기
  1. 사용자 폴더의 .claude 안에 output-styles 폴더를 만드세요. 여기에 두면 어느 프로젝트에서든 쓸 수 있습니다. 한 프로젝트에서만 쓰려면 그 프로젝트의 .claude/output-styles에 둡니다.
  2. 그 폴더에 report.md 파일을 만들고 아래 내용을 넣습니다. 머리말에 name을 따로 적지 않으면 파일 이름이 스타일 이름이 됩니다. 
    ---
description: 사내 보고서 초안을 돕는 문서 도우미
---

    당신은 회사원의 보고서 작성을 돕는 도우미입니다.
답은 결론 한 문장으로 시작합니다.
근거는 세 줄 이내의 목록으로 정리합니다.
숫자는 출처를 확인한 경우에만 씁니다.
정중체로 쓰고, 영어 약어는 처음 나올 때 풀어 씁니다.

  3. 맨 위 --- 두 줄 사이가 머리말(frontmatter)입니다. 여기에 keep-coding-instructions를 넣지 않았습니다. 코딩을 맡기지 않을 스타일이라 기본 코딩 지침을 빼는 편이 맞습니다.
  4. Claude Code를 완전히 끄고 다시 켜세요. 터미널에서 쓰는 Claude Code는 스타일 파일을 켤 때만 읽습니다.
  5. /output-style report를 칩니다. 다음 답변이 결론 한 문장으로 시작하면 성공입니다.

코딩하는 방식은 그대로 두고 말투만 바꾸고 싶을 수도 있습니다. 그럴 때는 머리말에 keep-coding-instructions: true를 한 줄 더합니다.

막히기 쉬운 곳

설정 파일에 적었는데 그대로 기본 스타일입니다

파일에 explanatory처럼 소문자로 적은 경우에 자주 생깁니다. outputStyle 값은 대소문자를 구분하므로, 이름과 정확히 맞지 않으면 Default로 돌아갑니다. Explanatory처럼 정확한 이름으로 고치세요.

직접 만든 스타일이 목록에 없습니다

Claude Code가 켜져 있는 동안 파일을 만들었다면 이렇게 보입니다. 터미널판은 켤 때만 스타일 파일을 읽기 때문입니다. 껐다 켜도 안 보이면 폴더 이름이 output-styles가 맞는지, .claude 안에 있는지 확인합니다.

목록에는 있는데 설명이 안 뜹니다

머리말을 잘못 적으면 이렇게 됩니다. 필드 이름에 오타가 있으면 오류 없이 무시됩니다. 머리말 형식이 깨지면 스타일이 파일 이름으로만 읽히고 필드는 하나도 적용되지 않습니다. claude --debug로 켜면 어디가 깨졌는지 볼 수 있습니다.

사용자 설정에 정한 값이 어떤 프로젝트에서만 안 먹힙니다

그 프로젝트에도 설정 파일이 있으면 이렇게 됩니다. 프로젝트 설정이 사용자 설정보다 우선합니다. 그 폴더의 .claude/settings.local.json과 .claude/settings.json에서 outputStyle을 찾아보세요.

여기서 더 나아가려면

출력 스타일은 Claude가 따르는 지침일 뿐 반드시 지켜진다는 보장은 없습니다. 꼭 일어나야 하는 일은 훅(hook)에, 프로젝트 사정은 CLAUDE.md에, 특정 작업 절차는 스킬에 맡기라고 문서는 권합니다. 따로 도는 서브에이전트에는 스타일이 적용되지 않는다는 점도 알아 두세요. 다만 포크(fork)는 부모 대화의 스타일을 이어받습니다.

이상으로 글 마치겠습니다.

출처

#Claude Code#출력 스타일#output style#커스텀 스타일#AI 업무 활용#설정 파일#터미널

같은 분류의 글