← 다른 편은 인스타 @ai_banjang2026년 10월 27일 기준

클로드에게
규칙 기억시키기

클로드는 새 대화를 열 때마다 기억이 처음으로 돌아가요. 매일 새로 출근하는 신입 직원 같은 거죠. 그래서 필요한 게 인수인계 노트, 이름이 CLAUDE.md예요. 규칙을 적어 두면 클로드가 대화를 시작할 때마다 먼저 읽고 일해요.

📄 PDF로 받기

왜 같은 말을 또 해야 할까?

새 대화마다 클로드는 이전 대화를 기억하지 못해요. 어제 "답은 한국어로"라고 말해도, 오늘 새 대화에선 처음 보는 신입이에요. 그래서 한 번 적어 두면 매번 읽게 하는 노트를 쓰는 거예요.

CLAUDE.md = 인수인계 노트

프로젝트 폴더에 CLAUDE.md라는 글 파일을 두면, 클로드가 대화를 시작할 때마다 먼저 읽어요. 예를 들면 "답은 항상 한국어로", "커밋하기 전에 꼭 물어보기" 같은 한 줄 규칙이에요.

규칙 예시

- 답은 항상 한국어로 해 줘.
- 커밋하기 전에 꼭 먼저 물어봐 줘.

노트는 두 종류

프로젝트 노트는 그 폴더(프로젝트)에서만 적용돼요 — ./CLAUDE.md.
내 전체용 노트는 모든 프로젝트에 적용돼요 — ~/.claude/CLAUDE.md. 말투처럼 어디서든 지켜 줬으면 하는 건 전체용에, 프로젝트마다 다른 건 프로젝트 노트에 적으세요.

/init으로 초안 만들기

입력창에 /init을 치면 클로드가 폴더를 살펴보고 프로젝트 노트 초안을 써 줘요. 그걸 읽어 보고 내 규칙을 더해 다듬으면 돼요.

명령어

/init

200줄 안쪽으로 짧고 구체적으로

노트가 너무 길면 클로드가 안 읽은 것처럼 굴 수 있어요. 공식 문서는 200줄 이하를 권해요. "코드를 깔끔하게"보다 "들여쓰기는 2칸"처럼 확인할 수 있게 구체적으로 쓰세요.

노트는 부탁이지 강제가 아니에요

CLAUDE.md는 클로드가 읽는 맥락이지, 꼭 지키게 하는 장치가 아니에요. 절대 안 되는 일(예: 특정 파일 건드리기)은 노트에만 적지 말고, 클로드 코드의 권한·훅 같은 설정으로 따로 막아 두세요.

➕

클로드가 스스로 적는 메모(자동 메모리)

노트와 별개로, 클로드가 내가 고쳐 준 것을 스스로 메모해 두는 기능이 있어요. 켜져 있으면 알아서 기억해 둬요. (설정은 앱·버전에 따라 달라요.)

📋

복붙용 CLAUDE.md 템플릿

그대로 복사해서 CLAUDE.md 파일로 저장하고, [대괄호] 부분만 내 것으로 바꾸세요. 짧게 시작해서 클로드가 자꾸 틀리는 것만 한 줄씩 더하면 돼요.

CLAUDE.md 템플릿

# 프로젝트 규칙 (CLAUDE.md)

## 말투
- 답은 항상 한국어로 해 줘.
- 어려운 용어는 쉬운 말로 한 번 풀어 줘.

## 작업 방식
- 파일을 고치거나 커밋하기 전에 꼭 먼저 물어봐 줘.
- 한 번에 한 가지 일만 해 줘.
- 모르면 추측하지 말고 물어봐 줘.

## 프로젝트 정보
- 이 프로젝트는 [무엇을 하는 프로젝트인지 한 줄].
- 주요 폴더: [예: src/ 코드, docs/ 문서]
- 테스트는 [명령어]로 돌려 줘.

## 하지 말 것
- [예: .env 파일은 열지 말기]

※ 반장·율은 AI로 그린 캐릭터예요. 2026년 10월 27일 클로드 코드 공식 문서(code.claude.com/docs/en/memory) 기준이고, 메뉴 이름은 앱 버전에 따라 조금 다를 수 있어요. 궁금한 건 @ai_banjang 댓글로.

클로드에게규칙 기억시키기