클로드 코드가 자꾸 까먹는다고요? /memory와 CLAUDE.md로 한 번만 적고 평생 기억시키기

Claude한테 "한국어로 답해줘", "존댓말 써줘", "우리는 npm 말고 pnpm 써"라고 매번 말해본 적 있나요? 새 대화를 켜면 또 까먹습니다. AI는 대화창을 닫으면 기억이 리셋되거든요. 그래서 있는 게 바로 CLAUDE.md, 그리고 그걸 다루는 /memory입니다. 두 번 설명할 말은 여기 한 줄로 적어두면 됩니다.

왜 새 대화에선 까먹을까

AI는 한 대화 안에서만 맥락을 기억합니다. 대화창을 닫고 새로 켜면(또는 /clear로 비우면) 그동안 했던 말은 사라져요. 그래서 매번 "한국어로 답해줘"를 다시 입력하게 되는 거죠.

이걸 해결하는 게 CLAUDE.md라는 파일입니다. Claude한테 주는 '신입사원 업무 매뉴얼' 같은 거예요. 여기 적힌 내용은 매 대화 시작 때 자동으로 읽힙니다. 한 번만 적어두면 새 대화에서도, 내일 켠 대화에서도 그대로 지킵니다.

/memory는 이 매뉴얼 파일을 다루는 명령입니다.

CLAUDE.md가 없다면? 처음 만드는 법

아직 CLAUDE.md 파일이 없어도 걱정하지 마세요. 직접 빈 파일을 만들 필요 없이, Claude한테 이렇게 말하면 됩니다.

CLAUDE.md 만들어줘

또는 프로젝트 폴더에서 /init을 입력하면 Claude가 코드베이스를 살펴보고 기본 CLAUDE.md를 알아서 만들어줍니다. 일단 파일이 생기면, 아래 방법으로 규칙을 채워 넣으면 돼요.

★ 흔한 함정 — /memory는 인자를 안 받습니다

여기서 입문자가 제일 많이 헷갈리는 걸 먼저 짚고 갈게요.

/memory 존댓말로

이렇게 /memory 뒤에 규칙을 붙여 쓰면 아무 일도 안 일어납니다. /memory는 규칙을 저장하는 명령이 아니라, '규칙 파일을 열어주는 버튼'일 뿐이에요. 뒤에 뭘 붙여도 그냥 파일 목록을 열어 편집기로 띄워줍니다.

그럼 규칙은 어떻게 넣느냐? 두 가지 방법이 있습니다. 바로 다음에서 봅니다.

규칙 넣는 2가지 방법 (난이도별)

기초 — 그냥 대화로 말하기

앞으로 답변은 항상 존댓말로 해줘

이렇게 평소처럼 말로 부탁하면 Claude가 알아서 메모리에 저장합니다. 제일 쉬운 방법이에요.

기초 — 파일 목록 열기

/memory

/memory를 입력하면 다음 순서로 진행됩니다.

1. 화면에 지금 적용 중인 규칙 파일 목록이 뜹니다(개인용, 프로젝트용 등).
2. 방향키로 편집할 파일을 고른 뒤 엔터를 누릅니다.
3. 그 파일이 기본 편집기로 열립니다.
4. 거기에 규칙을 적고 저장하면, 다음 대화부터 그대로 적용됩니다.

응용 — CLAUDE.md에 콕 집어 적기

"커밋 전 npm test 실행" 규칙을 CLAUDE.md에 추가해줘

팀과 공유하는 규칙 파일에 직접 기록하라고 시킬 수 있습니다.

심화 — 규칙을 범위별로 분리

/memory → .claude/rules/testing.md 로 테스트 규칙만 분리

규칙이 많아지면 주제·파일별로 쪼개서 관리하면 깔끔합니다.

실전 사례

테스트 없이 커밋이 올라가는 게 반복돼서, CLAUDE.md에 이 한 줄을 적어뒀습니다.

커밋하기 전에는 항상 npm test를 먼저 실행한다

그 뒤로는 새 세션을 켜도 Claude가 커밋 작업을 할 때마다 알아서 테스트를 먼저 돌렸습니다. 매번 "테스트 먼저!"라고 잔소리할 필요가 없어진 거죠. 한 번 적은 한 줄이 두고두고 일을 줄여준 셈입니다.

이렇게 더 씁니다

• 위치를 나눠 쓰기: 개인 취향 규칙은 ~/.claude/CLAUDE.md(내 PC 전역, 윈도우는 C:\Users\사용자명\.claude\CLAUDE.md), 팀 공유 규칙은 프로젝트 루트의 ./CLAUDE.md에 둡니다. 전자는 나만, 후자는 팀원 모두가 함께 읽어요. 위치를 헷갈리면 "내 규칙인 줄 알았는데 팀에 공유됐다" 같은 사고가 나니 구분해두세요.
• 실수 방지 노트로 키우기: Claude가 같은 실수를 두 번 하면 "방금 실수 CLAUDE.md에 적어줘"라고 시키세요. CLAUDE.md가 우리 프로젝트의 '살아있는 실수 방지 노트'로 점점 똑똑해집니다.
• 규칙이 많아지면 분리: .claude/rules/에 testing.md, style.md처럼 주제별로 쪼개면 관리가 쉬워집니다.
• 꼭 지켜야 하는 규칙은 훅으로: CLAUDE.md는 '강제'가 아니라 '안내'예요. 안 지켜질 수도 있습니다. 반드시 실행돼야 하는 규칙은 /hooks(훅 — 특정 시점에 명령을 자동 실행하는 기능)로 거는 게 확실합니다.

팁: 규칙은 짧고 구체적일수록 잘 지켜집니다. CLAUDE.md는 200줄 이하로 짧게 유지하는 게 적중률이 높아요.

다른 사람들은 이렇게 씁니다 (웹 사례)

• Claude가 실수하면 그 교정을 CLAUDE.md에 적게 해서, 코드베이스의 특이점을 담은 '살아있는 기록'으로 키운다. — Writing a good CLAUDE.md (HumanLayer)
• CLAUDE.md는 '무엇을·왜·어떻게'를 짧게 적고, 200줄 이하로 유지하는 게 적중률이 높다. — CLAUDE.md Best Practices (UX Planet)
• '메모리'와 '컨텍스트'를 함께 관리해 클로드 코드를 200% 써먹는 법. — Claude Code 200% 써먹기 (gpters)

더 알아보기: 이미 AGENTS.md를 쓰고 있다면 @AGENTS.md import로 같은 규칙을 함께 읽힐 수도 있습니다(필요할 때만).

직접 해보기

지금 바로 따라해보세요. 먼저 이렇게 말합니다.

앞으로 한국어 존댓말로 답해줘

그다음 /clear로 새 대화를 켜고도 존댓말이 유지되는지 확인해보세요. 기억이 저장됐다는 걸 직접 느낄 수 있습니다.

정리

핵심은 한 문장입니다. 두 번 설명할 말은 CLAUDE.md에 적어라. AI가 대화마다 까먹는 건 버그가 아니라 원래 그런 거고, CLAUDE.md는 그 한계를 넘는 첫걸음이에요. 함정 하나만 기억하세요 — /memory는 규칙을 붙여 쓰는 명령이 아니라 파일을 여는 버튼일 뿐입니다. 규칙은 대화로 말하거나, 파일을 열어 직접 적습니다.

기준: Claude Code v2.1.154 (2026.05)