Claude Code

11장. CLAUDE.md로 나만의 설정 만들기

매번 설명하는 기준은 파일로 남깁니다

매달 같은 운영 리포트를 만들고 있습니다. 매번 "원본 파일은 수정하지 마", "한국어로 써줘", "숫자에는 출처를 붙여줘", "확인되지 않은 원인은 쓰지 마"라고 말합니다. 처음에는 괜찮지만 세 번째부터는 같은 기준을 계속 타이핑하는 일이 됩니다.

이럴 때 CLAUDE.md를 씁니다. 이 파일은 작업 폴더에서 Claude Code가 참고할 지속적인 지침입니다. 단, 강제 설정이나 보안 장치가 아닙니다. 위험한 행동을 막아야 한다면 권한, 설정, Hook 같은 별도 장치를 함께 봐야 합니다.

이번 장에서는 CLAUDE.md를 다음 기준으로 다룹니다.

  • 반복해서 말하는 기준을 파일로 남긴다.
  • CLAUDE.md는 맥락이지 강제 장치가 아님을 이해한다.
  • 개인용, 프로젝트용, 팀용 기준을 나눈다.
  • 짧고 구체적인 규칙만 남긴다.
  • auto memory와 역할을 구분한다.
  • 공유 전 민감 정보와 오래된 규칙을 점검한다.
CLAUDE.md에 적은 원본 보존, 저장 위치, 숫자 출처, 확인 필요 기준이 결과물에 반영되는 흐름.
예시 목업: `CLAUDE.md`는 명령어 모음이 아니라 작업 기준을 반복해서 전달하는 맥락 파일입니다.

반복 기준을 프로젝트 안에 둡니다

CLAUDE.md는 "이 프로젝트에서는 이렇게 일한다"를 적어두는 파일입니다. 매번 대화에 붙여넣는 지시를 줄이는 용도입니다.

예를 들어 월간 리포트 폴더라면 이런 기준이 반복됩니다.

  • data/ 폴더의 원본은 수정하지 않는다.
  • 결과물은 reports/에 저장한다.
  • 보고서는 한국어로 쓴다.
  • 핵심 숫자에는 원본 파일명과 계산식을 남긴다.
  • 확인할 수 없는 원인, 담당자, 마감일은 확인 필요로 표시한다.
  • 외부 공유 전 개인정보와 내부 전용 정보를 점검한다.

이 기준을 매번 대화창에 쓰는 대신 CLAUDE.md에 남깁니다.

이 작업 폴더에서 반복해서 적용할 CLAUDE.md 초안을 만들고 싶어.
아직 파일을 만들지 말고 먼저 넣을 내용만 제안해줘.

우리 작업:
- 매월 운영 리포트를 만든다.
- 원본 데이터는 `data/`에 있다.
- 결과 보고서는 `reports/`에 저장한다.
- 숫자는 원본 파일명과 계산 기준을 남겨야 한다.
- 확인되지 않은 원인 분석은 본문에 넣지 않는다.

처음부터 직접 파일을 만들기보다 초안을 먼저 받아보고, 오래 유지될 기준만 남기는 편이 낫습니다.

CLAUDE.md가 하는 일과 하지 않는 일

CLAUDE.md는 Claude Code가 세션을 시작할 때 읽는 지속 맥락입니다. 공식 문서도 CLAUDE.md와 auto memory를 "context"로 설명합니다. 즉, Claude Code가 참고하는 지침이지 반드시 지켜지는 강제 정책은 아닙니다.

구분은 분명해야 합니다.

원하는 일적절한 방법
매번 같은 작성 기준을 알려주기CLAUDE.md
특정 작업 절차를 필요할 때 불러오기Skill
위험한 명령이나 파일 수정을 자동으로 막기Hook 또는 권한 설정
이번 주 할 일 남기기작업 메모나 이슈
비밀번호와 토큰 보관비밀 관리 도구나 환경변수

예를 들어 CLAUDE.md에 "원본 파일을 수정하지 마"라고 쓰는 것은 적절한 기준입니다. 하지만 그것만으로 원본 수정이 기술적으로 차단되는 것은 아닙니다. 정말 차단해야 하는 폴더라면 읽기 전용 권한, 승인 흐름, Hook 같은 장치가 필요합니다.