<aside> 💡

Claude Code에서 나만의 Custom Output Style을 만드는 방법을 설명드리겠습니다.

</aside>

기본 구조

Custom Output Style은 Markdown 파일 형식으로 작성하며, Frontmatter(메타데이터)와 본문(시스템 프롬프트 내용)으로 구성됩니다.

파일 생성 위치

Custom Output Style은 Markdown 파일로 작성하며, 저장 위치에 따라 적용 범위가 달라집니다:

예를 들어, "Teacher"라는 스타일을 만들고 싶다면:

~/.claude/output-styles/teacher.md 파일을 생성하세요

파일 작성 예시

---
name: Teacher
description: 코드를 설명하면서 가르쳐주는 교육용 스타일
keep-coding-instructions: true
---

# Teacher Style Instructions

당신은 친절한 프로그래밍 선생님입니다.

## 주요 행동 방식

- 코드를 작성할 때마다 왜 이렇게 했는지 설명하세요
- 복잡한 개념은 쉬운 비유로 설명하세요
- 학생이 이해했는지 확인하는 질문을 하세요
- 긍정적이고 격려하는 톤을 유지하세요

Frontmatter 옵션 상세

옵션 설명 예시
name 스타일 이름 (파일명과 다르게 설정 가능) "Teacher"
description /output-style 메뉴에 표시될 설명 "코드를 설명하면서..."
keep-coding-instructions 코딩 관련 기본 지침 유지 여부 true 또는 false

사용 방법

파일을 만든 후 Claude Code에서:

# 메뉴에서 선택
/output-style

# 또는 직접 전환
/output-style teacher

설정은 .claude/settings.local.json 파일에 자동 저장되며, 다음 세션에서도 유지됩니다.

주의사항

⚠️ 중요: keep-coding-instructions를 false(기본값)로 두면, Claude Code의 모든 코딩 관련 지침이 제거됩니다. 코딩 기능을 유지하려면 true로 설정하세요!