output-style 이름으로 바로 켜기 · NOTES

무엇이 바뀌었나

확인 Claude Code 공식 변경 로그 기준, 2.1.269(2026-09-11 공개)에 "Added /output-style [name] to list and switch output styles, including over Remote Control and in cloud and other headless sessions" 항목이 들어갔다. 대괄호 안 이름은 선택이라, 이름 없이 치면 고를 수 있는 스타일 목록이 뜨고 지금 켜져 있는 것에 표시가 남는다.

확인 output-style 자체는 그 전부터 있던 기능이다 — Claude Code가 매 답변에 붙이는 "역할·말투·형식" 지시를 통째로 바꾸는 것이다. 공식 문서에 적힌 내장 스타일은 다섯이다.

스타일	하는 일
Default	지금까지의 기본 — 소프트웨어 작업에 맞춘 지시
Concise	결과부터 말하고 군더더기를 줄인다. 작업 성실도는 그대로, 대답만 짧아진다(2.1.237 이상 필요)
Explanatory	작업 중간중간 "왜 이렇게 짰는지" 설명(Insights)을 끼워 넣는다
Learning	설명에 더해 `TODO(human)` 표시를 남기고 일부를 직접 채우게 시킨다
Proactive	웬만한 판단은 묻지 않고 먼저 실행한다. 권한 모드는 그대로 두고 지시 쪽만 바꾸는 것

확인 바꾸는 법은 /output-style <스타일> 한 줄, 또는 /config에서 "Output style" 메뉴로 고르는 것 두 가지다. 어느 쪽으로 골라도 프로젝트 로컬 설정 파일 .claude/settings.local.json에 저장된다. 이번에 새로 된 것은 이름을 알면 메뉴를 열지 않고 한 줄로 끝나고, 그게 원격 제어(Remote Control)· 헤드리스·클라우드 세션에서도 먹힌다는 점이다.

왜 중요한가

이 사이트 교육 과정 L1·05 반복을 스킬로 굳히기에서 "세 번 이상 시킨 일은 절차로 박아 둔다"고 적었다. output-style도 같은 종류다 — "짧게 답해", "설명 좀 붙여서" 같은 걸 매 턴 다시 안 적으려고 만든 자리다. 다만 스킬은 특정 작업 절차를 저장하는 것이고, output-style은 대화 전체의 말투·형식을 바꾼다는 점이 다르다. 매번 "짧게 대답해줘"를 쳐야 했던 사람이라면 이번에 이름으로 바로 켜는 게 그 반복을 줄여 준다.

직접 해 보기 — 5분

버전부터 확인한다. 이름으로 바로 켜는 기능은 2.1.269 이상이 필요하다.
```
claude --version
```
낮으면 /config 메뉴로 골라도 결과는 같다.
목록을 본다. 이름을 몰라도 된다.
```
/output-style
```
다섯 개 스타일과 지금 켜진 것이 나온다.
하나 골라 켜 본다. 평소 답이 길게 느껴졌다면 Concise부터.
```
/output-style concise
```
바로 다음 메시지부터 적용된다. /clear나 새 세션을 안 열어도 된다.
같은 질문을 두 번 시켜 비교한다.
```
지금 이 폴더 구조를 설명해줘
```
Default로 한 번, Concise로 한 번 — 길이와 서두 인사말 유무가 갈리는지 본다.
마음에 들면 프로젝트에 고정한다. .claude/settings.local.json에 직접 적어도 된다.
```
{ "outputStyle": "Concise" }
```

이 글의 한계

확인 못 함 스타일을 바꾸면 그 스타일의 지시문만큼 입력 토큰이 늘어난다고 문서에 적혀 있는데, 정확히 몇 % 늘어나는지 숫자는 없었다. 첫 요청 이후로는 캐시로 줄어든다는 설명뿐이다.

확인 서브에이전트에는 안 먹힌다. 서브에이전트는 자기 시스템 프롬프트로 따로 돈다고 문서에 명시돼 있다. 메인 대화나 fork로 이어지는 세션에만 적용된다.

이 글은 공개 당일에 쓴 것이 아니다. 나중에 공식 문서를 다시 열어 확인하고 채웠다.

한 줄 정리

9월 11일(2.1.269) /output-style 이름으로 목록 보기·전환이 한 줄로 됐다.
내장 스타일은 Default·Concise·Explanatory·Learning·Proactive 다섯이다.
메인 대화에만 적용된다 — 서브에이전트에는 안 먹힌다.

이어 읽기 L1 · 05 반복을 스킬로 굳히기 — 절차를 저장하는 스킬과, 말투·형식을 통째로 바꾸는 output-style이 어떻게 다른지. →

SOURCES

Claude Code Docs — Output styles (내장 스타일 다섯 개 · 전환 방법 · 서브에이전트 적용 범위)
Claude Code — Changelog (v2.1.269, 2026-09-11, /output-style [name] 항목)

말투를 매번 다시 안 시켜도 된다

무엇이 바뀌었나

왜 중요한가

직접 해 보기 — 5분

한 줄 정리