CLAUDE.md는 문서가 아니라 작업 지시서로 써야 한다
전역 와 프로젝트별 를 나눠 쓰면 Claude Code를 더 안정적으로 사용할 수 있다. 핵심은 에 코드 설명을 길게 적는 것이 아니라, Claude가 어떻게 행동해야 하는지에 대한 지시를 적는 것이다.
전역 파일에는 모든 프로젝트에 공통으로 적용되는 작업 방식과 선호 규칙을 두고, 프로젝트별 파일에는 해당 저장소에서만 필요한 명령, 규칙, 주의점을 둔다. 이렇게 나누면 같은 지시가 겹치거나 서로 충돌하는 일을 줄일 수 있다.
오래된 코드 설명이 남아 Claude를 헷갈리게 하는 문제도 줄어든다. 불필요한 내용이 문맥을 차지하는 도 막을 수 있다.
핵심 포인트
- 는 코드 설명서보다 Claude의 행동 지시서로 쓰는 것이 좋다.
- 전역 에는 모든 프로젝트에 공통인 작업 방식과 선호 규칙을 둔다.
- 프로젝트별 에는 해당 저장소에서만 필요한 명령과 주의점을 둔다.
- 지시를 분리하면 충돌하는 규칙과 오래된 설명으로 인한 혼선을 줄일 수 있다.
- 짧고 명확한 지시는 를 줄여 Claude Code 사용을 더 효율적으로 만든다.