클로드가 말을 안 듣는 게 아니라, 적는 위치가 틀린 겁니다

Claude에게 뭔가를 기억시키는 방법은 네 가지나 됩니다. CLAUDE.md, 스킬, 오토 메모리, 그리고 그냥 프롬프트에 매번 쓰는 것. 전부 적어두는 곳처럼 보이지만 로드되는 시점과 조건이 다릅니다.

여기를 헷갈리면 Claude가 지시를 무시하는 것처럼 보입니다.

한 장으로 정리하면

판단 기준: 질문 세 개

1. 항상 지켜져야 하는 내용인가요?

그렇다면 CLAUDE.md에 적습니다.

• 메인 브랜치에 직접 푸시하지 마
• 커밋 메시지는 한글로 써
• 새 라이브러리를 추가하기 전에 물어봐
• 테스트가 실패하면 테스트가 아니라 코드를 고쳐

세션마다 무조건 읽히는 자리입니다. 예외 없이 지켜야 하는 것만 넣는 게 좋습니다.

2. 특정 작업을 할 때만 필요한가요?

그렇다면 스킬로 만듭니다.

• 블로그 글 쓰는 방식
• PDF 만드는 절차
• 배포 체크리스트
• 디자인 시스템

CLAUDE.md와 스킬의 차이는 여기서 나옵니다. CLAUDE.md는 프로젝트 전체에 적용되는 규칙이고, 스킬은 특정 작업을 위한 사용법입니다. 스킬은 필요할 때만 불러오기 때문에, CLAUDE.md에 넣기엔 긴 내용을 옮겨두면 됩니다.

3. 바뀔 수 있는 정보인가요?

그렇다면 오토 메모리에 맡기면 됩니다.

• 이 프로젝트의 빌드 명령어
• 지난주에 잡은 버그의 원인
• 반복해서 고쳐준 취향
• 지금 진행 중인 작업 상태

Claude가 알아서 적습니다. 직접 손댈 필요는 없고, 중요한 게 있으면 “이거 기억해”라고 한마디만 하면 됩니다.

가장 흔한 실수 세 가지

1. CLAUDE.md에 다 몰아넣기

200줄이 넘어가면 컨텍스트를 더 먹고, 오히려 지시를 덜 따르게 됩니다. 길어질수록 정작 중요한 규칙이 묻힐 가능성이 커집니다. 절대 규칙만 남기고 나머지는 스킬로 옮기는 게 좋습니다.

2. CLAUDE.md와 메모리에 같은 내용을 중복해서 적기

둘 다 매 세션 로드됩니다. 같은 내용이 양쪽에 들어가면 컨텍스트만 두 배로 씁니다. 반드시 지킬 규칙이면 CLAUDE.md에, 바뀔 수 있는 패턴이면 오토 메모리에, 한 곳에만 적으면 됩니다.

3. 스킬을 설치해놓고 부르지 않기

스킬은 슬래시 커맨드와 달리 직접 실행할 수 없습니다. Claude가 알아서 써주길 기대해야 하는 구조라서, 그냥 “만들어줘”라고만 하면 안 쓰고 지나갈 수 있습니다. 프롬프트에 스킬 이름을 직접 넣어서 “○○ 스킬을 사용해서 ~해줘”라고 요청하는 게 확실합니다.

처음 세팅하는 순서

1. 1.프로젝트 폴더에서 /init을 실행합니다. CLAUDE.md가 만들어집니다.
2. 2.생성된 CLAUDE.md를 열어서 200줄 안쪽으로 다듬습니다.
3. 3.오토 메모리는 그냥 둡니다. 기본으로 켜져 있고 알아서 쌓입니다.
4. 4.2~3주 정도 쓰다 보면 반복하는 작업이 눈에 띕니다. 그때 그것만 스킬로 만듭니다.
5. 5.가끔 /memory를 열어서 틀린 메모는 고치고, 필요 없는 건 지웁니다.

점검할 때 쓰는 명령어

컨텍스트가 70~80%를 넘어가면 /compact로 압축하거나 /clear로 비우면 됩니다. compact할 때 “웹사이트 헤더 관련 내용은 남겨줘”처럼 방향을 알려주면 훨씬 나은 요약이 나옵니다.

한 줄 요약

“항상 지킬 건 CLAUDE.md, 작업할 때만 필요한 건 스킬, 바뀔 수 있는 건 오토 메모리에 맡기면 됩니다. 위치만 나눠도 Claude가 갑자기 말을 잘 듣기 시작합니다.”