09장. CLAUDE.md 설계

CLAUDE.md는 Claude Code에게 프로젝트·개인·조직 단위의 지속적 지시를 주입하는 메모리 파일이다. 모든 세션 시작 시 자동으로 컨텍스트에 로드되므로, CLAUDE.md를 어떻게 설계하느냐가 곧 에이전트의 기본 행동 규약을 결정한다. 잘 설계된 CLAUDE.md는 매 세션 반복 지시를 없애 토큰을 절약하고, 팀 전체의 작업 일관성을 보장하며, 조직 정책을 강제한다. 반대로 비대하거나 충돌하는 CLAUDE.md는 컨텍스트를 낭비하고 예측 불가능한 동작을 유발한다.

CCA-F 시험의 "Claude Code 설정과 워크플로우" 도메인(20%)에서 CLAUDE.md와 설정 스코프는 가장 빈출되는 주제다. 시험은 "어떤 위치에 어떤 내용을 두어야 하는가", "여러 설정이 충돌할 때 무엇이 이기는가", "CLAUDE.md(메모리)와 settings.json(설정)은 무엇이 다른가"를 의사결정 관점에서 묻는다. 이 장은 그 세 축을 정확한 우선순위 규칙과 함께 다룬다.

이 장을 마치면 CLAUDE.md의 역할과 메모리 계층 구조, Progressive Disclosure 기반의 파일 분리 설계, 프로젝트·개인·조직별 커스터마이징 전략, 그리고 settings.json을 포함한 전체 설정 스코프의 우선순위를 정확히 설명하고 시험의 함정 문항을 가려낼 수 있다.