내 Claude Code 세팅

Claude Code를 처음 켜면 아무 설정 없이도 꽤 잘 돈다. 그래서 대부분 세팅을 안 한다. 그게 실력 차이가 벌어지는 지점이다.

CLAUDE.md에 들어가는 것

내 CLAUDE.md는 길지 않다. 대신 다음 네 가지는 반드시 들어 있다.

• 프로젝트 한 줄 요약 — 이게 뭘 하는 서비스인지
• 절대 건드리면 안 되는 것 — 마이그레이션 파일, 결제 로직, 환경 설정
• 검증 명령 — 테스트, 린트, 빌드를 어떻게 돌리는지
• 작업 완료 기준 — "빌드 통과 + 테스트 통과 + 변경 요약"

AI는 모르면 추측한다. 추측을 줄이는 게 세팅의 전부다.

에이전트를 나누는 기준

한 세션에 다 시키지 않는다. 역할별로 나눈다.

역할	하는 일	권한
탐색	코드베이스 읽고 요약	읽기만
구현	기능 작성	쓰기
검수	구현 결과를 모르는 상태에서 리뷰	읽기만

검수 에이전트가 구현 과정을 못 보게 하는 게 핵심이다. 자기 코드를 자기가 채점하면 늘 100점이다.

자료

실제 CLAUDE.md 템플릿은 자료 페이지에서 받을 수 있다.