메인 콘텐츠로 건너뛰기
출력 스타일을 사용하면 Claude Code의 핵심 기능(예: 로컬 스크립트 실행, 파일 읽기/쓰기, TODO 추적)을 유지하면서 모든 유형의 에이전트로 Claude Code를 사용할 수 있습니다.

기본 제공 출력 스타일

Claude Code의 기본 출력 스타일은 기존 시스템 프롬프트이며, 소프트웨어 엔지니어링 작업을 효율적으로 완료하도록 도와주도록 설계되었습니다. 코드베이스와 Claude의 작동 방식을 가르치는 데 중점을 두는 두 가지 추가 기본 제공 출력 스타일이 있습니다:
  • 설명적(Explanatory): 소프트웨어 엔지니어링 작업을 완료하는 동안 교육용 “인사이트”를 제공합니다. 구현 선택 사항과 코드베이스 패턴을 이해하는 데 도움이 됩니다.
  • 학습(Learning): 협업 학습 중심 모드로, Claude는 코딩하면서 “인사이트”를 공유할 뿐만 아니라 작은 전략적 코드 조각을 직접 기여하도록 요청합니다. Claude Code는 구현할 코드에 TODO(human) 마커를 추가합니다.

출력 스타일의 작동 방식

출력 스타일은 Claude Code의 시스템 프롬프트를 직접 수정합니다.
  • 기본이 아닌 출력 스타일은 Claude Code에 기본 제공되는 코드 생성 및 효율적인 출력에 특정한 지침(예: 간결하게 응답하고 테스트로 코드 검증)을 제외합니다.
  • 대신, 이러한 출력 스타일에는 시스템 프롬프트에 추가된 자체 사용자 정의 지침이 있습니다.

출력 스타일 변경

다음 중 하나를 수행할 수 있습니다:
  • /output-style을 실행하여 메뉴에 액세스하고 출력 스타일을 선택합니다(/config 메뉴에서도 액세스할 수 있음).
  • /output-style [style](예: /output-style explanatory)을 실행하여 스타일로 직접 전환합니다.
이러한 변경 사항은 로컬 프로젝트 수준에 적용되며 .claude/settings.local.json에 저장됩니다.

사용자 정의 출력 스타일 만들기

Claude의 도움으로 새 출력 스타일을 설정하려면 다음을 실행합니다: /output-style:new I want an output style that ... 기본적으로 /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. 사용자 정의 슬래시 명령

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