출력 스타일을 사용하면 로컬 스크립트 실행, 파일 읽기/쓰기, TODO 추적과 같은 핵심 기능을 유지하면서 Claude Code를 모든 유형의 에이전트로 사용할 수 있습니다.

​
내장 출력 스타일

Claude Code의 기본 출력 스타일은 기존 시스템 프롬프트로, 소프트웨어 엔지니어링 작업을 효율적으로 완료하는 데 도움이 되도록 설계되었습니다.

코드베이스와 Claude의 작동 방식을 가르치는 데 중점을 둔 두 가지 추가 내장 출력 스타일이 있습니다:

  • 설명형: 소프트웨어 엔지니어링 작업을 완료하는 데 도움을 주는 사이사이에 교육적인 “인사이트”를 제공합니다. 구현 선택과 코드베이스 패턴을 이해하는 데 도움이 됩니다.

  • 학습형: Claude가 코딩하면서 “인사이트”를 공유할 뿐만 아니라 작은 전략적 코드 조각을 직접 기여하도록 요청하는 협력적이고 실습을 통한 학습 모드입니다. Claude Code는 구현할 수 있도록 코드에 TODO(human) 마커를 추가합니다.

​
출력 스타일 작동 방식

출력 스타일은 Claude Code의 시스템 프롬프트를 직접 수정합니다.

  • 기본이 아닌 출력 스타일은 일반적으로 Claude Code에 내장된 코드 생성 및 효율적인 출력에 특정한 지침(간결한 응답 및 테스트를 통한 코드 검증 등)을 제외합니다.
  • 대신, 이러한 출력 스타일은 시스템 프롬프트에 자체 사용자 정의 지침을 추가합니다.

​
출력 스타일 변경

다음 중 하나를 수행할 수 있습니다:

  • /output-style을 실행하여 메뉴에 액세스하고 출력 스타일을 선택합니다(/config 메뉴에서도 액세스할 수 있음)

  • /output-style explanatory와 같이 /output-style [스타일]을 실행하여 스타일로 직접 전환합니다

이러한 변경 사항은 로컬 프로젝트 수준에 적용되며 .claude/settings.local.json에 저장됩니다.

​
사용자 정의 출력 스타일 생성

Claude의 도움으로 새로운 출력 스타일을 설정하려면 /output-style:new 다음과 같은 출력 스타일을 원합니다...를 실행하세요

기본적으로 /output-style:new를 통해 생성된 출력 스타일은 ~/.claude/output-styles의 사용자 수준에서 마크다운 파일로 저장되며 프로젝트 전반에서 사용할 수 있습니다. 다음과 같은 구조를 가집니다:

---
name: My Custom Style
description:
  A brief description of what this style does, to be displayed to the user
---

# Custom Style Instructions

You are an interactive CLI tool that helps users with software engineering
tasks. [Your custom instructions here...]

## Specific Behaviors

[Define how the assistant should behave in this style...]

사용자 수준(~/.claude/output-styles) 또는 프로젝트 수준(.claude/output-styles)에서 자체 출력 스타일 마크다운 파일을 생성하고 저장할 수도 있습니다.

​
관련 기능과의 비교

​
출력 스타일 vs. CLAUDE.md vs. —append-system-prompt

출력 스타일은 소프트웨어 엔지니어링에 특정한 Claude Code의 기본 시스템 프롬프트 부분을 완전히 “끕니다”. CLAUDE.md나 --append-system-prompt 모두 Claude Code의 기본 시스템 프롬프트를 편집하지 않습니다. CLAUDE.md는 Claude Code의 기본 시스템 프롬프트 다음에 사용자 메시지로 내용을 추가합니다. --append-system-prompt는 시스템 프롬프트에 내용을 추가합니다.

​
출력 스타일 vs. 에이전트

출력 스타일은 메인 에이전트 루프에 직접 영향을 미치며 시스템 프롬프트에만 영향을 줍니다. 에이전트는 특정 작업을 처리하기 위해 호출되며 사용할 모델, 사용 가능한 도구, 에이전트를 언제 사용할지에 대한 컨텍스트와 같은 추가 설정을 포함할 수 있습니다.

​
출력 스타일 vs. 사용자 정의 슬래시 명령

출력 스타일을 “저장된 시스템 프롬프트”로, 사용자 정의 슬래시 명령을 “저장된 프롬프트”로 생각할 수 있습니다.