클로드 코드 출력 스타일 바꾸는 법: Explanatory·Learning 으로 설명 받기, 내 스타일 파일까지

이 글 순서

1. 출력 스타일이 뭔가요
2. 처음이라면: 다섯 가지
3. 하나 골라 바꾸기
4. 설명·연습 스타일
5. 익숙해졌다면: 저장 위치
6. 모든 폴더에 같은 스타일
7. 더 깊이: 내 스타일 만들기
8. 프론트매터 필드 네 가지
9. 비개발자용 스타일 예
10. 어떻게 움직이나
11. CLAUDE.md·스킬·훅과 차이
12. 막힐 때
13. 코덱스·안티그래비티는
14. 한국에서 되나
15. 다음에 볼 글
16. 참고한 자료

클로드 코드를 쓰다 보면 “답이 너무 길다”, “왜 그렇게 고쳤는지도 알려 주면 좋겠다”, “다 해 주지 말고 나도 좀 짜 보게 해 달라” 같은 바람이 생겨요. 요청할 때마다 같은 말을 덧붙여도 되지만, 출력 스타일을 한 번 정해 두면 그 세션의 모든 답에 그 바람이 들어가요.

클로드 코드 공식 문서의 출력 스타일(Output styles), 명령 목록, 설정, 프롬프트 캐시, 환경 변수 문서를 2026년 10월 8일에 읽고 옮겼어요. 캡처는 한국어 문서에서 했고, 버전 숫자는 영어 문서와 맞춰 봤어요. 터미널 그림은 클로드 코드 2.1.292 가 깔린 윈도우 PC 에서 같은 날 돌린 출력이에요. 실제 설정을 건드리지 않으려고 따로 만든 테스트 폴더 안에서만 돌렸고, 로그인이 필요한 화면(스타일을 바꾼 뒤 실제로 달라진 답)은 문서에 적힌 대로 옮겨요. 끝난 뒤 테스트 폴더는 지웠어요.

출력 스타일이 뭔가요

클로드 코드는 터미널(마우스 대신 글자로 컴퓨터에 일을 시키는 까만 창)이나 VS Code 같은 편집기 안에서, 내가 말로 요청한 일을 AI 가 대신 해 주는 도구예요. 파일을 읽고 고치고 명령도 돌려요.

AI 는 내 요청을 받기 전에 “너는 이런 일을 하는 도우미고, 이렇게 일해라” 하는 기본 지시문을 먼저 받아요. 이걸 시스템 프롬프트(system prompt)라고 해요. 프롬프트는 AI 에게 주는 글, 시스템 프롬프트는 내가 보기 전에 깔려 있는 기본 지시라고 보면 돼요.

출력 스타일은 이 기본 지시에 “답은 이런 말투, 이런 길이, 이런 형식으로” 하는 지시를 더하거나 바꾸는 기능이에요. 문서는 출력 스타일을 “세션의 모든 응답에 대해 Claude 의 역할, 톤, 응답 형식을 정하는 지침”이라고 적었어요. 세션은 클로드 코드를 켜서 끌 때까지의 대화 한 묶음이에요. 식당에 빗대면, 주문할 때마다 “맵지 않게요”라고 말하는 대신 단골 메모에 한 번 적어 두는 것과 비슷해요.

개발자만 쓰는 기능이 아니에요. 문서는 사용자 정의 스타일로 Claude 를 글쓰기 도우미나 데이터 분석가처럼 소프트웨어 개발이 아닌 역할로 바꿀 수도 있다고 적었어요. 메모 폴더를 정리하거나 CSV 표를 묶는 일을 시키는 분이라면 “어려운 말 빼고, 바꾼 내용은 표로” 같은 스타일이 쓸모 있어요.

다만 출력 스타일은 “따르라는 지시”일 뿐, 반드시 그렇게 된다는 보장은 아니라고 문서에 적혀 있어요. 매번 꼭 일어나야 하는 일(고친 뒤 자동 검사, 명령 막기)은 훅이 맡고, 프로젝트에 대해 알아야 할 것은 CLAUDE.md 가 맡아요. 이 차이는 아래 “CLAUDE.md·스킬·훅과 차이”에서 다시 봐요.

처음이라면: 다섯 가지

클로드 코드에는 기본으로 다섯 가지 스타일이 들어 있어요. 처음에는 아무것도 고르지 않은 Default 로 시작하고, 나머지 넷은 Default 의 지시를 그대로 두고 자기 지시를 더하는 방식이에요. 그래서 스타일을 바꿔도 일을 하는 솜씨 자체가 떨어지지는 않아요.

• Default: 스타일을 고르지 않은 상태예요. 개발 일에 맞춰 쓰인 클로드 코드의 기본 지시만으로 움직여요.
• Proactive: 일을 보내자마자 시작하고, 자잘한 결정은 묻지 않고 알맞게 짐작해서 진행해요. 계획을 요청하지 않으면 계획 모드로 넘어가지 않아요. 다만 데이터를 지우거나 함께 쓰는 시스템을 바꾸기 전에는 대화로 확인하라는 지시가 들어 있어요.
• Concise: 답의 첫 문장에 결과부터 말하고, 앞말·과정 설명·끝맺음 요약을 뺀 짧은 답을 줘요. 간단한 질문에는 한두 문장으로 답해요. 오류 보고, 실패한 테스트 결과, 보안 경고, 지우기 확인은 짧게 줄이지 않아요. 클로드 코드 2.1.237 부터 있어요.
• Explanatory: 일은 Default 와 똑같이 하고, 왜 그렇게 골랐는지 두세 가지를 짧은 설명 상자(Insight)로 대화에 덧붙여요. 이 설명은 파일에 주석으로 들어가지 않아요.
• Learning: Explanatory 의 설명에 더해, 정답이 여럿인 부분(오류 처리, 자료 구조 같은 곳)은 몇 줄을 내가 직접 짜도록 비워 둬요.

Proactive 는 이름 때문에 “허락도 안 묻고 다 해 버리나” 싶을 수 있는데, 문서는 Proactive 로 바꿔도 권한 모드는 바뀌지 않는다고 적었어요. 어떤 명령을 묻지 않고 돌릴지는 여전히 권한 모드가 정하고, 권한 확인 창도 바꾸기 전과 똑같이 떠요. 권한 모드는 권한 설정 글에 있어요.

하나 골라 바꾸기

가장 쉬운 방법은 클로드 코드 대화 창에 명령을 치는 거예요. 클로드 코드를 켠 뒤 입력 칸에 아래처럼 치고 Enter 를 눌러요.

/output-style

고를 수 있는 스타일 목록과 지금 쓰는 스타일을 보여 주는 명령이에요. 아무것도 바뀌지 않아요. 목록을 봤으면 이름을 붙여 다시 쳐요.

/output-style learning

Learning 스타일로 바꾸라는 줄이에요. 명령에서는 대소문자를 가리지 않아서 learning 이라고 써도 돼요. 문서는 바꾼 스타일이 다음 메시지부터 들어간다고 적었어요.

명령 말고도 길이 셋 더 있어요.

• 터미널 메뉴: /config 를 치고 Output style 을 고르면 메뉴에서 고를 수 있어요.
• VS Code 확장: 입력 칸에 / 를 쳐서 명령 메뉴를 열고 Output styles 를 골라요. 2.1.257 부터예요. VS Code 확장은 VS Code 확장 글에 있어요.
• 데스크톱 앱: 메뉴가 없어서 설정 파일에 outputStyle 필드를 직접 적어요(아래 “익숙해졌다면”). 데스크톱 앱에서 /config 를 치면 메뉴 대신 설정 화면이 열린다고 적혀 있어요.

/output-style 명령은 2.1.269 부터예요. 버전 숫자는 터미널에서 claude --version 으로 볼 수 있어요. 이 PC 에서 돌린 출력은 아래 그림 맨 위에 있어요.

설명·연습 스타일

초심자에게 가장 쓸모 있는 건 Explanatory 와 Learning 이에요. 클로드 코드가 고친 내용을 그냥 수락하기만 하면 왜 그렇게 됐는지 남는 게 없는데, 이 두 스타일은 고르는 이유를 같이 말해 줘요.

Explanatory 는 일하는 모습은 그대로고, 코드 앞이나 뒤에 별표가 붙은 Insight 상자가 나와요. 문서 예시는 “이 저장소의 모든 길은 withAuth 감싸개를 거쳐서 새 주소도 따로 검사 코드가 필요 없다”처럼, 그 폴더의 구조에 대한 설명 두세 줄이에요. 처음 보는 프로젝트를 익힐 때나 고친 이유까지 알고 싶을 때 맞는다고 적혀 있어요.

Learning 은 한 걸음 더 나가요. 뻔한 부분은 클로드가 짜고, 방법이 여럿인 부분에 이르면 파일에 TODO(human) 이라는 주석을 남기고 멈춰요. 그리고 “이미 만든 것(Context), 내가 짤 것(Your Task), 생각할 점(Guidance)”을 적은 요청을 보내요. 그 자리에 코드를 짜고 다 됐다고 말하면, 내가 짠 코드에 대한 설명 하나를 달고 일을 이어 가요.

제 생각에는 코딩을 배우는 중인 초급 개발자라면 Learning 을, 코드는 몰라도 무엇이 왜 바뀌는지 알고 싶은 분이라면 Explanatory 를 먼저 켜 보는 게 맞아요. 다만 문서는 두 스타일이 일부러 답을 길게 쓰게 만들어서 출력 토큰(AI 가 쓴 글의 양을 세는 단위)이 늘어난다고 적었어요. 요금제 한도를 아끼고 싶은 날에는 Concise 가 반대로 답을 짧게 해 줘요.

익숙해졌다면: 저장 위치

명령이나 메뉴로 고른 스타일은 그 폴더의 .claude\settings.local.json 파일에 적혀요. 문서는 이 파일을 “로컬 프로젝트 수준” 설정이라고 불러요. 내 PC 의 그 폴더에서만 쓰는 개인 설정이라는 뜻이에요.

위 그림은 테스트 폴더에서 스타일을 바꾸고 그 파일을 열어 본 출력이에요. 바꾼 뒤 목록을 다시 보면 고른 스타일 옆에 (current) 가 붙어요. 대화 창 대신 claude -p 로 돌린 건 로그인하지 않은 테스트 폴더라서예요. -p 는 화면 없이 한 번 시키고 답만 받는 방식인데, 문서에 이 명령이 -p 에서도 된다고 적혀 있고 실제로 로그인 없이도 목록과 바꾸기가 됐어요. -p 는 claude -p 글에 있어요.

메뉴 없이 설정 파일에 직접 적어도 돼요. 문서 예시는 이래요.

{
  "outputStyle": "Explanatory"
}

outputStyle 필드에 스타일 이름을 적는 줄이에요. 여기서 조심할 게 대소문자예요. 문서는 이 값이 대소문자를 가린다고 적었어요. Proactive, Concise, Explanatory, Learning 처럼 첫 글자를 대문자로 써야 하고, explanatory 처럼 조금이라도 다르면 오류 없이 기본 스타일로 움직여요.

캡처 아래쪽 “프로젝트 전체에서 스타일을 기본값으로”는 영어 문서로는 “여러 프로젝트에 걸쳐 기본값으로”라는 뜻이에요. 아래 “모든 폴더에 같은 스타일”에서 다시 다뤄요.

이 PC 에서 일부러 소문자로 적어 봤더니, 맨 윗줄엔 “Output style: explanatory”라고 나와서 바뀐 것처럼 보였어요. 그런데 목록에는 (current) 표시가 어디에도 없었어요. 맞는 스타일을 못 찾았다는 뜻이에요. 첫 글자를 대문자로 고치니 Explanatory 옆에 (current) 가 붙었어요. 손으로 적었다면 목록에서 (current) 가 붙었는지 꼭 보세요.

모든 폴더에 같은 스타일

settings.local.json 은 그 폴더에서만 먹어요. 어느 폴더에서 켜든 같은 스타일을 쓰고 싶다면 사용자 설정 파일(~\.claude\settings.json, 윈도우라면 C:\Users\사용자이름\.claude\settings.json)에 outputStyle 을 적으라고 문서에 적혀 있어요. ~ 는 내 사용자 폴더를 줄여 쓰는 기호예요.

둘 다 적혀 있으면 프로젝트 쪽 설정이 우선 적용돼요. 평소엔 Concise 로 쓰다가 공부용 폴더에서만 Learning 을 쓰는 식으로 나눌 수 있어요. 설정 파일이 여러 겹인 이유는 클로드 코드 사용법 글의 “설정 파일” 절에 있어요.

대화 중간에 바꿔도 돼요. 문서는 2.1.251 부터 대화 중에 바꾸면 다음 메시지부터 새 스타일이 들어가고, 그 전 버전에서는 /clear 하거나 새 세션을 열어야 들어갔다고 적었어요. 프롬프트 캐시(앞 대화를 다시 읽을 때 싸게 읽게 해 주는 저장)도 깨지지 않아요. 프롬프트 캐시 문서는 바꾼 스타일의 지시를 대화 속 메시지로 넣어서, 그 요청도 앞의 시스템 프롬프트와 대화를 캐시에서 읽는다고 적었어요. 캐시는 프롬프트 캐시 글에 있어요.

더 깊이: 내 스타일 만들기

기본 다섯 가지가 마음에 안 들면 직접 만들 수 있어요. 사용자 정의 스타일은 마크다운 파일 하나예요. 마크다운(.md)은 # 이나 – 같은 기호로 제목과 목록을 표시하는 텍스트 파일이고, 메모장으로 열고 고칠 수 있어요.

파일을 두는 위치는 셋이에요.

• 사용자: ~\.claude\output-styles. 내 PC 의 모든 폴더에서 보여요.
• 프로젝트: 그 폴더 안의 .claude\output-styles. 그 폴더(와 그 안쪽)에서만 보여요. 같은 이름이 여러 겹이면 지금 작업 폴더에 가장 가까운 것을 써요.
• 관리형 정책: 회사가 관리 설정 폴더에 넣어 배포하는 것이에요.

연습 폴더에서 해 봐요. 터미널에서 연습 폴더로 들어간 뒤 아래 두 줄을 쳐요.

mkdir .claude\output-styles
notepad .claude\output-styles\easy.md

첫 줄은 스타일 파일을 둘 폴더를 만드는 줄이고, 둘째 줄은 그 안에 easy.md 를 메모장으로 여는 줄이에요. 메모장에 아래처럼 적고, 저장할 때 아래쪽 인코딩 칸이 UTF-8 인지 보고 저장해요. 인코딩은 글자를 파일에 담는 방식인데, 이게 맞지 않으면 한글이 깨져요(아래 “막힐 때”).

---
name: 쉬운 말
description: 개발을 모르는 사람도 알아듣게 풀어서 답한다
keep-coding-instructions: true
---

낯선 단어는 처음 나올 때 한 문장으로 풀어 줘.
명령을 알려 줄 때는 그 줄이 무엇을 하는지 바로 아래 한 줄로 적어 줘.

맨 위 — 두 줄 사이가 프론트매터(frontmatter)이에요. 이 스타일의 라벨 같은 부분이고, 그 아래가 클로드에게 주는 지시예요. 이름은 “쉬운 말”, 목록에 보일 설명 한 줄, 그리고 개발 일 하는 기본 지시는 그대로 두라는 필드(keep-coding-instructions)을 적었어요.

저장한 뒤 /output-style 로 목록을 보면 기본 다섯 가지 뒤에 “쉬운 말”이 붙어요. 문서는 터미널에서 클로드 코드가 켜질 때 스타일 파일을 읽는다고 적었어요. 그래서 이미 켜 둔 세션에서 파일을 만들거나 고쳤다면 클로드 코드를 껐다가 다시 켜야 목록에 나와요.

VS Code 확장에서는 Output styles 메뉴에서 “Build a custom style”을 고르면 이 파일을 대신 만들어 준다고 적혀 있어요(2.1.261 부터). 플러그인도 output-styles 폴더에 스타일을 담아 나눠 줄 수 있어요. 플러그인은 플러그인 글에 있어요.

프론트매터 필드 네 가지

프론트매터 필드는 모두 적지 않아도 되고, 필드 이름은 소문자와 – 로 써요. 문서는 필드 이름을 잘못 쓰면 오류 없이 무시된다고 적었어요.

필드	하는 일	안 적으면
name	목록에 보일 이름	파일 이름
description	목록에 보일 설명	설명 없음
keep-coding-instructions	개발 일 기본 지시를 남김	false(뺌)
force-for-plugin	플러그인을 켜면 이 스타일로 고정	false

출처: 클로드 코드 문서 Output styles 의 Frontmatter 참조. 10월 8일 확인.

name 을 비워 두면 정말 파일 이름이 스타일 이름이 되는지 이 PC 에서 봤어요. plain-words.md 에 description 만 적었더니 목록에 “plain-words”로 나왔어요. 한글 이름을 쓰고 싶다면 파일 이름은 영어로 두고 name 필드에 한글을 적는 게 편해요. 명령으로 고를 때도 /output-style 쉬운 말 처럼 name 필드의 이름을 써요.

force-for-plugin 은 플러그인에 든 스타일에만 쓰는 필드예요. true 면 그 플러그인을 켜는 순간 내가 고른 스타일보다 앞서 적용돼요. 남이 만든 플러그인을 깔았는데 답 말투가 바뀌었다면 이 필드를 의심해 볼 만해요.

비개발자용 스타일 예

개발이 아닌 일을 시킬 때는 keep-coding-instructions 를 빼는 게 맞다고 문서에 적혀 있어요. 빼면 코드 짜는 요령에 관한 기본 지시가 빠지고 내 지시만 남아요. 예를 들어 회의록·보고서 폴더를 다듬게 할 때는 이렇게 써 볼 수 있어요.

---
name: 글 다듬기
description: 문서 폴더의 글을 고치고 바꾼 곳을 표로 알려 준다
---

너는 한국어 글을 다듬는 편집자다.
고치기 전에 무엇을 고칠지 세 줄로 먼저 말한다.
고친 뒤에는 파일마다 바꾼 문장을 "전 / 후" 두 칸 표로 보여 준다.
어려운 외래어는 쉬운 우리말로 바꾼다.

지시는 짧고 분명하게, “무엇을 하지 말라”보다 “이렇게 하라”로 적는 편이 따르기 쉬워요. 이건 제 생각이고, 문서는 지시를 어떻게 쓰라는 요령까지는 적지 않았어요. 한 가지 일에만 필요한 순서(예: 보고서 검토 순서)라면 스타일보다 스킬이 맞아요. 스킬은 스킬 만들기 글에 있어요.

어떻게 움직이나

문서가 적은 작동 방식을 쉬운 말로 옮기면 이래요.

• 고른 스타일의 지시는 요청마다 같이 보내져요. 그만큼 입력 토큰이 늘지만, 세션의 첫 요청 뒤로는 프롬프트 캐시가 그 값을 줄여 준다고 적혀 있어요.
• 사용자 정의 스타일은 keep-coding-instructions 를 true 로 두지 않으면, 바꾸는 범위 정하기·주석 쓰기·고친 뒤 확인하기 같은 기본 개발 지시 부분을 빼요.
• 그런데 이 필드는 “전체 시스템 프롬프트”에서만 뜻이 있어요. 클로드 코드에는 도구 설명을 줄인 짧은 시스템 프롬프트도 있는데, 거기엔 그 부분이 처음부터 없어서 이 필드가 아무 일도 하지 않아요.
• 환경 변수 문서를 보면, 따로 정하지 않았을 때 Haiku 4.5, Sonnet 5, Opus 4.7 과 그 앞 모델은 전체 프롬프트를, 그보다 새 모델은 짧은 프롬프트를 써요. 이 필드를 꼭 먹게 하려면 환경 변수 CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT 를 0 으로 두라고 적혀 있어요. 환경 변수는 프로그램이 켜질 때 읽는 바깥 설정값이에요.
• 스타일은 지금 대화와 그 대화를 통째로 물려받는 포크에만 들어가요. 다른 서브에이전트(일을 나눠 맡는 작은 에이전트)는 자기 시스템 프롬프트로 움직여서 스타일의 영향을 받지 않아요. 서브에이전트는 서브에이전트 글에 있어요.

그래서 새 모델에서는 keep-coding-instructions 를 적어도 달라지는 게 없을 수 있다는 뜻이에요. 지금 내가 어떤 모델을 쓰는지는 /model 로 볼 수 있어요. 이 부분은 버전마다 바뀔 수 있으니 문서를 다시 보세요.

CLAUDE.md·스킬·훅과 차이

클로드 코드에는 “지시를 적어 두는 곳”이 여럿이라 처음엔 헷갈려요. 문서가 직접 표로 나눠 놓았어요.

바라는 것	쓸 것	이유
모든 답의 말투·길이·형식	출력 스타일	세션 전체에 들어감
이 폴더의 규칙·명령	CLAUDE.md	어떤 스타일이든 늘 읽힘
한 가지 일의 순서	스킬	그 일일 때만 읽힘
매번 꼭 일어나야 할 일	훅	클로드가 아니라 프로그램이 돌림
켤 때 지시 한 줄 더하기	--append-system-prompt	기본 지시를 지우지 않음

출처: 클로드 코드 문서 Output styles 의 “출력 스타일과 다른 기능 중에서 선택하기”. 10월 8일 확인.

문서는 이것들을 섞어 쓰라고 해요. 알아야 할 것은 CLAUDE.md 에, 답하는 방식은 출력 스타일에, 반드시 지켜야 할 것은 훅에 두는 식이에요. CLAUDE.md 는 CLAUDE.md 쓰는 법 글, 훅은 훅 글에 있어요.

설정 파일을 바꾸지 않고 한 번만 다른 스타일로 돌리고 싶을 때는 --settings 로 설정을 덧얹을 수 있어요. 이 PC 의 PowerShell 5.1 에서 해 보니, 작은따옴표 안에 JSON 을 그대로 넣으면 “Invalid JSON provided to --settings” 오류가 났어요. 5.1 은 바깥 프로그램에 인수를 넘길 때 안쪽 큰따옴표를 지우기 때문이에요. 큰따옴표 앞에 백슬래시를 붙여 \” 로 쓰거나, 설정을 concise.json 같은 파일에 적어 그 경로를 넘기니 됐어요. 윈도우 11 에 들어 있는 PowerShell 은 보통 5.1 이에요.

막힐 때

스타일 목록에 한글이 깨져 나와요. PowerShell 5.1 로 파일을 만들었다면 인코딩을 먼저 의심하세요. 이 PC 에서 같은 내용을 세 가지로 저장해 봤어요.

• Set-Content 를 그냥 쓰면 이름과 설명이 알아볼 수 없는 글자로 나왔어요. 5.1 의 Set-Content 는 따로 정하지 않으면 시스템 기본 문자 방식으로 저장해요.
• > 로 파일에 넣으면 프론트매터를 아예 못 읽어서 파일 이름 b 가 스타일 이름이 됐어요. 5.1 의 > 는 UTF-16 이라는 다른 방식으로 저장해요.
• -Encoding UTF8 을 붙이니 “쉬운 말”이 제대로 나왔어요.

가장 쉬운 방법은 메모장으로 만들고 UTF-8 로 저장하는 거예요. 이미 깨진 파일이라면 메모장으로 열어 다른 이름으로 저장할 때 인코딩을 UTF-8 로 골라 다시 저장하면 돼요.

파일을 만들었는데 목록에 안 나와요. 이미 켜 둔 세션이라면 클로드 코드를 껐다 다시 켜요. 폴더 이름이 .claude\output-styles(끝에 s)인지, 파일 끝이 .md 인지도 보세요. 프로젝트 스타일은 지금 작업 폴더부터 저장소 맨 위 폴더 사이에서만 찾아요.

바꿨는데 답이 그대로예요. 설정 파일에 손으로 적었다면 대소문자부터 보세요(위 “익숙해졌다면”). 2.1.251 보다 옛 버전이면 /clear 나 새 세션 뒤에야 들어가요. 문서의 “Debug your configuration” 페이지가 스타일이 안 먹는 이유 찾기를 따로 다뤄요.

프론트매터가 이상하게 읽혀요. 문서는 YAML(프론트매터에 쓰는 적는 법)을 못 읽으면 필드를 모두 비운 채 파일 이름으로 불러온다고 적었고, claude --debug 로 그 오류를 볼 수 있다고 했어요.

스타일이 안 지켜질 때가 있어요. 출력 스타일은 지시라서 보장되지 않아요. 꼭 지켜야 하는 일이라면 훅으로 옮기세요.

코덱스·안티그래비티는

같은 일을 OpenAI 의 코덱스 CLI 와 구글의 안티그래비티 CLI(예전 제미나이 CLI)에서 하면 어떨까요. 공식 문서를 같은 날 찾아보니, 말투를 고르는 명령은 코덱스에만 있었고 안티그래비티는 “늘 따르는 규칙 파일” 쪽으로 풀어요.

무엇	클로드 코드	코덱스 CLI	안티그래비티 CLI
말투 고르는 명령	/output-style	/personality	CLI 문서에서 못 찾음
고를 수 있는 것	기본 다섯 + 내 파일	friendly·pragmatic·none	미확인
설정 파일 필드	outputStyle	personality(config.toml)	미확인
내 스타일 파일	.claude\output-styles\*.md	공식 안내 없음	공식 안내 없음
설명·연습 모드	Explanatory·Learning	공식 안내 없음	공식 안내 없음
늘 따르는 지시 파일	CLAUDE.md	AGENTS.md	AGENTS.md·GEMINI.md, always_on 규칙

출처: 클로드 코드 문서 Output styles, OpenAI 코덱스 문서 Developer commands·Configuration Reference·Custom instructions with AGENTS.md, 안티그래비티 문서 Rules·CLI reference. 10월 8일 확인.

코덱스는 /personality 로 말투를 골라요. 대화 중에 /personality 를 치고 뜨는 창에서 friendly, pragmatic, none 가운데 하나를 고르면 그 뒤 답부터 바뀐다고 적혀 있어요. none 은 말투 지시를 끄는 거예요. 쓰는 모델이 이 기능을 지원하지 않으면 명령이 아예 숨는다고 해요. 기본값은 config.toml 의 personality 필드에 적을 수 있어요. 기본 지시를 다른 파일로 바꾸는 model_instructions_file 필드도 설정 참고 문서에 한 줄로 있지만, 클로드 코드처럼 스타일 파일을 여러 개 두고 골라 쓰는 방법은 찾지 못했어요.

“늘 이렇게 답해 줘” 같은 지시는 코덱스에서 AGENTS.md 에 적어요. 내 홈의 .codex 폴더에 둔 AGENTS.md 는 모든 폴더에, 프로젝트의 AGENTS.md 는 그 폴더에 들어가요. 코덱스 쓰는 법은 코덱스 CLI 사용법 글에 있어요.

안티그래비티 CLI 문서에서는 말투를 고르는 명령을 찾지 못했어요. 가까운 건 규칙(Rules)이에요. 규칙 파일 프론트매터의 trigger 를 always_on 으로 두면 매 차례 그 내용을 통째로 시스템 프롬프트에 넣는다고 적혀 있고, 프론트매터가 필요 없다면 AGENTS.md 에 바로 적으라고 해요. 내 홈의 .gemini\AGENTS.md 나 GEMINI.md 는 모든 프로젝트에 늘 켜지는 규칙이에요. CLI 설정 참고 문서에 verbosity 필드도 있지만, 이건 생각 과정과 도구 출력을 화면에 얼마나 보여 줄지(high·low) 정하는 필드라 답의 말투와는 달라요. 안티그래비티 쓰는 법은 안티그래비티 CLI 사용법 글에 있어요.

제 생각에는 말투만 살짝 바꾸고 싶다면 세 도구 모두 늘 읽히는 지시 파일(CLAUDE.md·AGENTS.md·GEMINI.md)에 한 줄 적는 것으로 충분해요. 다만 “설명을 붙여 줘”, “몇 줄은 내가 짜게 해 줘”처럼 배우는 쪽으로 쓰고 싶다면, 문서로 갖춘 모드가 있는 건 셋 중 클로드 코드였어요. 세 도구를 한 번에 비교한 글은 클로드 코드·코덱스·제미나이 CLI 비교 글이에요.

한국에서 되나

질문	답
한국에서 되나	됨(Anthropic 지원 국가 목록에 South Korea)
무슨 요금제	클로드 코드를 쓰는 요금제. 출력 스타일만 따로 막는 요금제 안내는 문서에 없음
한국어 문서	있음(code.claude.com/docs/ko/output-styles)
버전 숫자	/output-style 명령 2.1.269, Concise 2.1.237, VS Code 메뉴 2.1.257 부터
휴대폰·웹에서	원격 제어로 명령은 되나 기본 스타일만 고를 수 있음

출처: 클로드 코드 문서 Output styles·Commands, anthropic.com 지원 국가 목록. 10월 8일 확인.

스타일 이름(Learning, Concise 등)과 목록의 설명은 영어로 나오지만, 내가 만든 스타일은 이름·설명·지시를 모두 한글로 적어도 이 PC 에서 제대로 읽혔어요(UTF-8 로 저장했을 때).

다음에 볼 글

클로드 코드를 아직 깔지 않았다면 윈도우 설치 글, 대화 창 쓰는 법은 클로드 코드 사용법 글부터 보면 돼요. 프로젝트에 대해 알려 둘 것은 CLAUDE.md 글, 한 가지 일의 순서는 스킬 글, 매번 꼭 돌아야 할 일은 훅 글이에요. 나머지 요령은 사용량 아끼는 법 모음에 차례로 있어요.

이 글의 내용은 2026년 10월 8일, 클로드 코드 2.1.292 기준이에요. 기본 스타일의 종류와 버전 숫자는 최근 버전에서 여러 번 바뀌었으니, 글과 다르게 움직이면 공식 문서의 지금 내용을 먼저 보세요.

같이 보면 좋은 글: 클로드 코드 CLAUDE.md 쓰는 법: /init 으로 만들고 어디에 두고 무엇을 적나

같이 보면 좋은 글: 클로드 코드 사용량 아끼는 법: 대화·캐시·서브에이전트부터 스킬·훅·권한 설정까지

같이 보면 좋은 글: AI 비교 2026: 클로드·챗GPT·제미나이 요금제·한도·기능 표

같이 보면 좋은 글: 챗GPT 공부 모드 사용법: 제미나이 가이드 학습·클로드 학습 모드와 켜는 곳·무료·나이 조건 비교하기

참고한 자료

2026년 10월 8일에 확인했어요. 클로드 코드 문서는 영어 문서와 한국어 문서(/docs/ko/)를 같이 봤어요.

• Output styles (클로드 코드 공식 문서, 기본 스타일·바꾸는 법·사용자 정의 스타일·프론트매터·작동 방식)
• 출력 스타일 (클로드 코드 공식 한국어 문서, 캡처한 페이지)
• Commands (클로드 코드 공식 문서, /output-style·/config)
• VS Code (클로드 코드 공식 문서, Output styles 메뉴·Build a custom style)
• Prompt caching (클로드 코드 공식 문서, Changing output style)
• Environment variables (클로드 코드 공식 문서, CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT)
• Settings (클로드 코드 공식 문서, 설정 파일 위치와 우선순위)
• Supported countries (Anthropic, South Korea)
• Developer commands (OpenAI 코덱스 공식 문서, /personality)
• Configuration Reference (OpenAI 코덱스 공식 문서, personality·model_instructions_file)
• Custom instructions with AGENTS.md (OpenAI 코덱스 공식 문서)
• Rules (안티그래비티 공식 문서, always_on·전역 규칙·CLI 규칙 자리)
• CLI reference (안티그래비티 공식 문서, verbosity)
• about_Parsing (마이크로소프트 공식 문서, 바깥 프로그램에 넘기는 인수의 따옴표)
• about_Character_Encoding (마이크로소프트 공식 문서, PowerShell 5.1 의 인코딩)