터미널에서 Claude Code를 쓰다 보면 매번 빌드 명령어나 코딩 스타일을 일일이 다시 알려줘야 해서 번거로울 때가 있죠. Claude Code는 완전히 초기화된 무상태 세션으로 시작하기 때문인데요. 이 귀찮은 반복 과정을 한 번에 해결해 주는 영혼의 짝꿍이 바로 프로젝트 루트 폴더에 두는 CLAUDE.md 파일입니다.

설정하는 방법도 생각보다 엄청 간단해요. 터미널에서 Claude Code를 켠 뒤 /init 명령어만 입력하면 가이드라인 템플릿이 자동으로 뚝딱 만들어집니다. 여기에 사용하는 기술 스택이나 자주 쓰는 빌드, 테스트 명령어, 코드 스타일 규칙만 몇 줄 적어두면 준비 끝입니다.

# CLAUDE.md
## Build & Test
- Build: `npm run build`
- Test: `npm test`

## Code Style
- Use TypeScript & functional components
- Keep functions short and clean

에이전트가 코드를 고치거나 테스트할 때 이 파일을 먼저 읽고 알아서 명령어들을 실행해주니 개발 흐름이 끊기지 않아서 정말 편하더라고요. 한 가지 팁을 드리자면, 이 파일은 너무 장황하게 적기보다 핵심만 명확하게 적는 게 좋습니다. 쓰다가 Claude가 자꾸 헷갈려하거나 같은 실수를 반복할 때마다 조금씩 규칙을 다듬어 가며 나만의 찰떡 에이전트로 길들여보세요. 5분만 투자해서 파일 하나 만들어 두면 생산성이 엄청나게 올라갑니다 ㅎㅎ