클로드 코드에 우리 프로젝트 규칙 기억시키기

1단계/init으로 초안 만들기

1. 프로젝트 폴더에서 클로드 코드를 켭니다.
   복사

   claude

2. 아래 명령을 입력하면 클로드가 코드를 훑어보고 빌드 명령·테스트 방법·규칙을 모아 CLAUDE.md 초안을 써 줘요.
   복사

   /init

• 이미 CLAUDE.md가 있으면 덮어쓰지 않고 고칠 점을 제안해요.
• 커서(.cursorrules)나 코파일럿 규칙 파일이 있으면 그 내용도 참고해서 가져옵니다.

2단계어디에 둘지 고르기

파일 위치에 따라 적용 범위가 달라져요.

1. 팀 전체가 쓸 규칙: 프로젝트 맨 위 폴더의 CLAUDE.md (또는 .claude/CLAUDE.md). 깃에 올려 공유해요.
2. 나만 쓸 이 프로젝트 메모: 프로젝트 맨 위의 CLAUDE.local.md. .gitignore에 꼭 넣으세요.
3. 모든 프로젝트에 적용할 내 취향: 홈 폴더의 ~/.claude/CLAUDE.md

• 여러 파일이 있으면 덮어쓰지 않고 전부 이어 붙여서 읽어요. 두 파일이 서로 다른 말을 하면 클로드가 아무거나 고를 수 있으니 겹치지 않게 정리하세요.

3단계잘 먹히게 쓰는 요령

1. 파일 하나는 200줄 안쪽으로. 길어질수록 자리를 많이 차지하고 잘 안 지켜져요.
2. 확인할 수 있게 구체적으로 씁니다. '코드 깔끔하게' 대신 '들여쓰기 2칸', '테스트해' 대신 'npm test를 커밋 전에 실행'처럼요.
3. 다른 파일을 끌어오려면 @경로를 적어요. 아래처럼 쓰면 README와 package.json이 함께 읽혀요.
   복사

   See @README for project overview and @package.json for available npm commands for this project.

• 여러 단계짜리 절차는 CLAUDE.md 말고 스킬로 빼는 게 좋아요. 스킬은 필요할 때만 읽혀서 자리를 덜 먹어요.
• '반드시 매번 실행'돼야 하는 일은 CLAUDE.md가 아니라 훅으로 거세요. CLAUDE.md는 권고라 100% 지켜진다는 보장이 없어요.

4단계잘 읽혔는지 확인하고 고치기

1. 지금 대화에 어떤 기억 파일이 읽혔는지 봅니다. 목록의 Memory files에 내 파일이 있어야 해요.
   복사

   /context

2. 기억 파일을 열어 고치거나, 클로드가 스스로 적는 자동 메모(auto memory)를 켜고 끌 때 씁니다.
   복사

   /memory

• 자동 메모는 기본으로 켜져 있어요. 내가 고쳐 준 것·취향을 클로드가 알아서 ~/.claude/projects/<프로젝트>/memory/ 에 적어 둡니다.
• '앞으로 pnpm만 써'처럼 말하면 자동 메모에, 'CLAUDE.md에 추가해'라고 하면 CLAUDE.md에 적어요.

CLAUDE.md에 적을 타이밍