producttalk.org

セッションが終わっても覚えている — Claude Codeの永続記憶装置

Claude Code의 두 가지 메모리 시스템(CLAUDE.md + Auto Memory)으로 매 세션 맥락 반복을 없애는 완전 가이드. 설정법Claude Code Auto Memory

Manage Claude's memory — Claude Code Docs

The Complete Guide to AI Agent Memory Files (CLAUDE.md, AGENTS.md, and Beyond)

Automatic Memory Is Not Learning

Claude Codeを使うたびに「うちはpnpm使ってるよ」「テストコマンドはmake test-integrationだよ」と繰り返していますか？今は一度教えれば永遠に覚えています。セッションが終わっても、翌日起動しても、そのまま残っています。

3秒まとめ

CLAUDE.mdに規則を書く→Auto Memoryが自動記録→セッションをまたいで記憶

FAQ

Auto Memoryが間違った情報を覚えてしまったらどうやって修正しますか？

MEMORY.mdは普通のマークダウンファイルなのでどんなテキストエディターでも直接編集できます。/memoryコマンドでファイルの場所を確認して、間違った項目を削除または修正してください。次のセッションから修正した内容が反映されます。

Auto Memoryが機密情報（APIキー、パスワード）を記録するリスクはないですか？

Claude Codeはセキュリティに敏感な情報をメモリに記録しないよう設計されています。ただし100%保証は難しいので、定期的にMEMORY.mdをレビューして機密情報が含まれていないか確認する習慣が良いです。このファイルはgitignoreに含まれてリモートリポジトリにはアップロードされません。

チームメンバーとAuto Memoryを共有できますか？

Auto Memory（~/.claude/projects/以下）は個人のローカルファイルなので基本的に共有されません。チーム全体で共有する必要があるルールはプロジェクトルートのCLAUDE.mdに書いてGitで管理するのが正解です。CLAUDE.mdはチームWiki、Auto Memoryは個人業務日記として区別してください。

CLAUDE.mdが長くなりすぎると性能に影響がありますか？

はい、CLAUDE.md全体が毎セッション開始時にコンテキストウィンドウにロードされるため、長すぎると実際の作業に使えるトークンが減ります。Claudeが間違えそうなことだけ残して、当たり前の内容は思い切って削除してください。詳細内容はdocs/以下のファイルに分離して必要なときに参照させるのが効率的です。