빠른 비교

동작 방식

output style은 Claude Code의 응답 방식을 바꾼다

Output style은 Claude가 무엇을 아는지를 바꾸는 기능이 아니라, 어떻게 응답하고 어떤 역할을 기본으로 잡을지를 바꾸는 설정입니다. 매번 "다이어그램 먼저", "교육적으로 설명", "데이터 분석가처럼 답변" 같은 지시를 반복하고 있다면 output style이 맞습니다.

{
  "outputStyle": "Explanatory"
}

설정은 /config에서 고르거나 settings 파일의 outputStyle 필드로 관리할 수 있습니다. 선택된 스타일은 local project 설정에 저장될 수 있으므로, 팀 공통 규칙인지 개인 실험인지 구분해야 합니다.

built-in style은 작업 태도를 바꾸지만 권한 모드는 바꾸지 않는다

Claude Code에는 기본 스타일 외에 Proactive, Explanatory, Learning 같은 built-in style이 있습니다. Proactive는 더 적극적으로 실행하고, Explanatory는 구현 판단을 설명하며, Learning은 사용자가 일부 코드를 직접 채우도록 유도할 수 있습니다.

중요한 점은 output style이 permission mode 자체를 바꾸지는 않는다는 것입니다. 더 적극적인 응답 스타일을 골라도 도구 실행 권한, 파일 수정 승인, 차단 규칙은 별도 permission 설정을 따릅니다.

custom output style은 system prompt에 추가되는 파일이다

Custom output style은 Markdown 파일로 관리합니다. 사용자 범위는 ~/.claude/output-styles, 프로젝트 범위는 .claude/output-styles에 둘 수 있습니다. 파일 이름이나 frontmatter의 name이 스타일 이름이 됩니다.

---
name: Diagrams first
description: Lead explanations with a compact diagram.
keep-coding-instructions: true
---

When explaining code or architecture, start with a short Mermaid diagram.
Keep the diagram small and then explain the tradeoffs in prose.

코딩 작업을 계속 맡길 스타일이라면 keep-coding-instructions: true를 검토해야 합니다. 이 값을 빼면 기본 소프트웨어 엔지니어링 지침 일부가 빠질 수 있어, 일반 글쓰기나 분석용 스타일에는 적합하지만 코드 변경 작업에는 부작용이 생길 수 있습니다.

변경은 새 세션이나 clear 이후에 보는 편이 안전하다

Output style은 system prompt와 연결되므로 이미 진행 중인 긴 세션에서 바로 기대한 대로 보이지 않을 수 있습니다. 스타일을 바꾼 뒤에는 /clear나 새 세션으로 확인하면 적용 범위를 분명히 볼 수 있습니다.

선택 기준

주의할 점

스타일 지시가 길어질수록 입력 토큰과 응답 길이가 늘 수 있습니다. 특히 Explanatory나 Learning처럼 설명량이 많은 스타일은 코드 변경 속도보다 학습과 이해가 중요할 때 선택하는 것이 맞습니다.