LLM AI Agent

Claude Code를 이용한 여러 writing style 고정

ybjeon.today 2026. 7. 22. 23:58

 Claude Code에서 writing style을 고정하고 싶다면 보통은 CLAUDE.md에 writing format을 입력하면 되지만, 여러 skill이나 폴더마다 서로 다른 writing style을 쓰고 싶다면 마냥 CLAUDE.md에 작성하게 되면 내용이 불필요하게 많아지고 성능이 떨어진다. Claude Code 공식문서에는 아래와 같은 방법들이 있다.

 

1. CLAUDE.md를 여러 파일로 쪼개기 (@import)

See @docs/style-guide.md for writing conventions.
  • 경로는 그 파일 기준 상대경로
  • 최대 4단계까지 재귀 import 가능
  • 세션 시작 시 바로 로드됨 (컨텍스트 사용)

2. 하위 디렉토리별 CLAUDE.md

<folder A>/CLAUDE.md, <folder B>/CLAUDE.md처럼 하위 폴더에도 둘 수 있고, 해당 폴더 파일을 다룰 때 온디맨드로 로드. 루트 CLAUDE.md와 병합(override 아님, 이어붙이기)

 

3. 포맷/스타일 전용 폴더

공식적으로 권장되는 위치는 .claude/rules/

.claude/rules/
  ├── writing-style.md
  ├── document-structure.md
  └── link-management.md

 

YAML frontmatter로 특정 경로에만 적용되게 스코프도 가능:

---
paths: ["security/**/*.md"]
---

 

*skills와 rules

  • .claude/rules/ = 수동 개입 없이 항상/온디맨드로 로드되는 "규칙"
  • .claude/skills/ = /명령어로 명시적으로 호출해야 실행되는 "동작"