AI가 자꾸
까먹는 이유?
기억 목차부터.

01 / AI가 못 읽은 규칙

분명 말했는데,
새 세션은 처음 듣는 이야기였습니다.

안녕하세요. 여러분의 AI/AX 파트너, 최gpt(최성훈)입니다.

“그 규칙, 저번에 정했잖아.”
“그 파일은 건드리지 말랬는데.”
“왜 같은 걸 또 물어봐?”

Claude Code로 일을 하다 보면 이런 말을 반복하게 됩니다. 저도 그랬습니다. 그래서 규칙을 더 적었습니다. 그런데 뒤에 적은 규칙을 다음 세션이 계속 놓쳤습니다.

확인해 보니 규칙을 적는 일과 새 세션이 그 규칙을 읽는 일은 달랐습니다. Claude Code의 자동 메모리는 MEMORY.md라는 목차를 먼저 불러옵니다. 이때 시작 시 읽는 범위에는 한도가 있습니다.

여기서 말하는 한도는 CLAUDE.md나 전체 대화의 길이가 아니라, 자동 메모리 목차 MEMORY.md의 한도입니다. 주제별 메모 파일은 필요한 때 따로 읽습니다.

모든 망각의 원인이 목차 초과라는 뜻도 아닙니다. 하지만 제 사례에서는 뒤쪽 규칙을 새 세션이 읽지 못한 것이 중요한 원인이었습니다.

기준 확인: Claude Code 공식 메모리 문서 · 2026.10.12 확인

02 / 규칙은 있었는데, 장치가 빗나갔습니다

청소 명령은 빈 폴더를 보고,
경보는 AI에게 들리지 않았습니다.

① 실제로 쓰는 기억 경로가 달랐습니다.

저는 이미 청소 명령을 만들어 두었습니다. 그런데 세션을 전환하는 동안 이름과 경로가 바뀌었고, 명령은 예전 폴더를 보고 있었습니다.

검사할 데이터가 없으니 결과도 조용했습니다. ‘이상 없음’이 아니라 ‘검사할 곳을 잘못 찾음’이었던 셈입니다.

그래서 현재 작업 폴더와 Git 저장소 기준 경로를 확인한 뒤, 실제 기억 목차를 찾도록 점검 방식을 바꿨습니다.

② 경보가 누구에게 보이는지도 확인했습니다.

파일을 쓸 때마다 목차 용량을 검사해도, 경고가 로그에만 남으면 Claude가 대응하기 어렵습니다.

이 키트의 PostToolUse 훅은 경고를 표준 오류로 내보내고 종료 코드 2를 사용합니다. 이 이벤트에서는 이미 실행된 쓰기를 취소하는 것이 아니라, 경고를 Claude에게 피드백으로 전달합니다.

세션 시작 점검은 방식이 다릅니다. SessionStart에서는 표준 출력으로 안내하고 정상 종료합니다. 종료 코드 2의 의미는 이벤트마다 다릅니다.

이벤트별 동작: Claude Code 공식 훅 문서

처음 정리한 결과도 기록해 뒀습니다.

이 숫자는 당시 제 작업 환경의 결과입니다. 키트를 설치하면 누구나 같은 만큼 줄어드는 수치는 아닙니다. 정리 뒤에도 목차 여유가 넉넉하지 않아, 한 번 청소하고 끝내기보다 계속 감시하는 장치가 필요했습니다.

03 / 제가 쓰는 구성 그대로

/gc는 직접 만든 점검 명령입니다.

Claude Code의 기본 명령이 아닙니다. 파일을 설치한 뒤 사용하는 사용자 정의 명령입니다. 이름은 청소지만, 처음부터 파일을 지우는 방식으로 만들지 않았습니다.

항상 따라야 할 핵심 규칙은 CLAUDE.md 등 매번 읽는 규칙 파일에 남기고, 완료된 작업의 긴 기록은 별도 주제 파일로 옮기는 식으로 정리합니다. 목차를 줄인다고 중요한 규칙까지 없애면 안 됩니다.

04 / 설치는 세 단계

다운로드하고, 설치하고,
실제로 찾는지 확인하세요.

1. ZIP을 풀고 네 파일을 확인합니다.

AI 책상 청소 키트 ZIP가입하고 AI 책상 청소 키트 ZIP 받기을 받은 뒤 압축을 풉니다. 먼저 설치 안내를 읽어 주세요. 이 키트는 macOS에서 점검한 구성입니다. Python 3가 필요하며, Windows·다른 환경은 경로와 명령 실행을 먼저 확인해야 합니다.

2. 프로젝트에 설치합니다.

Claude Code에서 압축을 푼 폴더의 경로를 알려 주고, 아래 요청을 함께 전달하세요. 기존 설정과 훅을 보존하는 것이 핵심입니다.

압축을 푼 청소 키트 폴더를 확인해 줘.
이 폴더의 gc.md, memory_index_guard.py, settings_예시.json을
README_설치방법.md대로 내 프로젝트에 설치해 줘.

기존 .claude/settings.json은 먼저 백업하고,
기존 훅을 지우지 말고 필요한 항목만 추가해 줘.
설치 후 실제 MEMORY.md를 찾는지 점검해 줘.
점검 결과를 보고하고, 메모리나 규칙 파일 변경은 먼저 내 확인을 받아.

.claude/commands/gc.md
.claude/hooks/memory_index_guard.py
.claude/settings.json ← 기존 hooks에 예시 항목만 병합

3. /gc로 점검 결과를 확인합니다.

새 세션을 열어 /gc를 실행합니다. 결과의 ‘검사한 목차 경로’가 실제 프로젝트와 맞는지, 남은 용량·줄 수가 얼마인지 먼저 확인하세요. 다른 세션이나 worktree를 쓰는 경우에도 검사 대상부터 확인합니다.

• 01실제 MEMORY.md를 찾았는가?
• 02끊긴 링크와 목차에 빠진 메모가 있는가?
• 03정리 제안이 핵심 규칙·원문·링크를 보존하는가?
• 04정리 뒤 다시 재측정했는가?

감시 훅은 Claude Code의 Write·Edit 뒤에 동작합니다. 외부 스크립트나 Bash로 파일을 바꾸면 이 쓰기 훅이 매번 실행되는 것은 아닙니다. 세션 시작 점검과 수동 /gc로 다시 확인해 주세요.

05 / 적용 전에 알아둘 점

자주 묻는 질문

카드뉴스 10장 · 50초 영상으로 다시 보기

옆으로 넘기며 보세요. 원본 카드의 내용과 순서를 유지했습니다.