# 클로드 코드 규칙 파일 (CLAUDE.md) — 내 코드 건드리기 전에 지킬 것 17줄 > 파일 하나 넣어 두면 클로드가 새 대화마다 내 규칙을 먼저 읽고 일한다 — 같은 말 반복 끝 > 📋 영상에서 말한 규칙 16개 + 1, 클로드 코드가 **내 코드를 건드리기 전에** 지킬 규칙이에요. 아래 상자를 통째로 복사해 파일 하나로 저장해 두면, 새 대화마다 클로드가 먼저 읽고 일해요. 매번 같은 말을 반복할 필요가 없어요. ## 넣는 법 3단계 1. 클로드 코드를 쓰는 프로젝트 폴더 맨 위에 `CLAUDE.md` 라는 이름으로 새 파일을 만들어요. (내 컴퓨터 전체에 적용하려면 `~/.claude/CLAUDE.md`) 2. 아래 상자 내용을 복사해 붙여 넣고 저장해요. 이미 CLAUDE.md가 있으면 그 파일 맨 아래에 덧붙이면 돼요. 3. 새 대화를 열면 끝이에요. 클로드 코드는 대화를 시작할 때마다 이 파일을 먼저 읽어요. ## 규칙 파일 (복사해서 CLAUDE.md로 저장) ```markdown # 내 코드 규칙 — 클로드가 코드를 건드리기 전에 지킬 것 > 이 파일을 프로젝트 폴더 맨 위에 `CLAUDE.md`라는 이름으로 두면, 클로드 코드가 새 대화를 시작할 때마다 먼저 읽습니다. > 잘 안 지키는 줄이 있으면 그 줄을 더 짧고 구체적으로 고쳐 쓰세요. ## 시작하기 전에 - 먼저 코드 전체부터 읽어. - 계획 세워서 나한테 보여 줘. - 지우기 전에 나한테 물어봐. - env 파일엔 손대지 마. ## 고칠 때 - 한 번에 하나만 바꿔. - 이미 있는 코드에 맞춰. - 새 패키지 그만 추가해. - 잘 돌아가는 코드는 그냥 둬. - 「나중에 할 일」 남기지 마. - 비밀값은 코드에 넣지 마. ## 테스트 - 테스트 써. - 진짜로 테스트 돌려. - 통과하려고 테스트 조작하지 마. ## 끝낼 때 - 바꿀 때마다 커밋해. - 뭘 바꿨는지 정확히 말해. - 모르면 솔직히 말해. - 그리고 「죄송합니다」 소리 좀 그만해. ``` > ✏️ 잘 안 지키는 줄이 있으면 그 줄을 **더 짧고 구체적으로** 고쳐 쓰세요. 규칙 파일은 강제 설정이 아니라 클로드가 참고하는 맥락이라, 짧고 분명할수록 잘 따라요. 한 파일은 200줄 아래로 두는 걸 권해요. ## 규칙 16개 한눈에 - ✓ 코드 먼저 읽기 · 계획 보여 주기 · 지우기 전에 묻기 · 한 번에 하나씩 · 기존 코드에 맞추기 · 테스트 쓰기 · 테스트 돌리기 · 바꿀 때마다 커밋 · 바꾼 것 말하기 · 모르면 솔직히 말하기 - ✗ .env 건드리기 · 새 패키지 · 테스트 조작 · 잘 되는 코드 다시 쓰기 · 「나중에 할 일」 남기기 · 코드에 비밀값 - +1 「죄송합니다」 소리 좀 그만해 — 농담 반, 진담 반이에요. - 여러분이 클로드한테 꼭 넣는 규칙이 있으면 인스타 댓글로 한 줄 알려 주세요. 모아서 다음 편에 소개할게요. 규칙 파일 위치·동작은 클로드 코드 공식 문서 기준(2026-11). 규칙 내용은 영상 속 16개를 한국어로 옮긴 것이에요. 대니의 AI 비즈니스 스쿨 [@dannyoff.ai](https://www.instagram.com/dannyoff.ai/) --- AI 비즈니스 스쿨 자료실 5번 · 사진·영상은 사이트에서: https://yourclass.co.kr/library/5