memory claude codeの使い方｜自動メモリと設定・保存場所

memory claude codeとは？セッションをまたぐ2つの記憶

Claude Codeの各セッションは新しいコンテキストウィンドウから始まり、前回の会話全文はそのまま残りません。知識を引き継ぐ仕組みは次の2つです。

両方とも会話開始時のコンテキストですが、設定を機械的に強制するものではありません。固定したいルールほど、矛盾を避けて短く具体的に書きます。

出典: Claude Code公式ドキュメント「Claudeがあなたのプロジェクトを記憶する方法」

CLAUDE.mdに残す情報と配置場所

CLAUDE.mdは、何度も説明する内容をファイルに移す場所です。ビルドやテストのコマンド、コード規約、設計方針など、複数のセッションで使う情報を範囲ごとに置き分けます。

チームのルールはプロジェクトのCLAUDE.mdへ、コミットしたくない個人情報はCLAUDE.local.mdへ置き、後者は.gitignoreに追加します。APIやテストの規約を分けたい場合は、.claude/rules/とpathsで対象を絞ります。

たとえば、プロジェクトのルートに次のような短いファイルを作ります。

# 開発ルール
- パッケージ管理には pnpm を使う
- コミット前に pnpm test を実行する
- API の変更には対応するテストを追加する

出典: CLAUDE.mdファイルの設定と配置（Claude Code公式）

自動メモリの保存先とMEMORY.mdの役割

自動メモリは、作業中に「次回も役立つ」と判断した情報を保存します。毎回記録するわけではなく、ビルドコマンド、デバッグの解決策、設計上の判断、繰り返し伝えた好みなどが対象です。

標準の保存先は次のディレクトリです。

~/.claude/projects/<project>/memory/
├── MEMORY.md
├── debugging.md
├── api-conventions.md
└── その他のトピックファイル

MEMORY.mdは一覧や入口の役割を持ち、詳細はdebugging.mdのようなトピックファイルへ分けて保存できます。起動時に読み込まれるのは、MEMORY.mdの先頭200行または25KBのうち、先に達した範囲です。長くなりすぎると後半が最初から読まれないため、入口には短い要点と詳細ファイルへのリンクだけを残すのが安全です。トピックファイルは必要になったときに読み込まれます。

この場所はマシン内の保存先です。同じGitリポジトリのワークツリーやサブディレクトリは共有しますが、別のマシンやクラウド環境へ自動同期されません。端末を替える場合は、必要なルールをプロジェクトのCLAUDE.mdへ移します。

出典: 自動メモリの保存場所と仕組み（Claude Code公式）

/memoryで記憶を確認・編集する方法

何が読み込まれているか分からないときは、ファイルを直接探すより/memoryを使うと確認しやすくなります。基本の手順は次のとおりです。

1. プロジェクトのディレクトリでClaude Codeを起動する。
2. セッション中に/memoryを実行する。
3. 一覧からCLAUDE.md、CLAUDE.local.md、ルールファイル、自動メモリの保存先を確認する。
4. 内容を直したいファイルを選び、エディタで不要な記述を削除または修正する。
5. 固定ルールを残すなら「この内容をCLAUDE.mdに追加して」と依頼し、作業中の発見を任せるなら「次回も使うので覚えておいて」と依頼する。

/memoryでは自動メモリのオン・オフも切り替えられます。何を保存したか分からないときはフォルダを開き、Markdownを読んでから編集・削除します。

なお、過去の会話そのものを戻す「セッション再開」は、次回以降へ知識を残すメモリとは別の仕組みです。

出典: Claude Code公式チートシート（Claude Help Center）

自動メモリをオフにする設定と削除方法

自動で記録されたくない場合は、次のいずれかで停止できます。プロジェクト単位で止めたいか、環境変数で実行時に止めたいかで選びます。

1. セッション内で/memoryを実行し、自動メモリのトグルをオフにする。
2. プロジェクト設定に次の値を追加する。

{
  "autoMemoryEnabled": false
}

3. 環境変数で無効にする場合は、CLAUDE_CODE_DISABLE_AUTO_MEMORY=1を設定してからClaude Codeを起動する。

停止と削除は別操作です。すでに作られたメモを消す場合は、/memoryからフォルダを開き、MEMORY.mdと詳細ファイルを確認して削除します。

保存先を変える場合は、settings.jsonのautoMemoryDirectoryに絶対パスまたは~/から始まるパスを指定します。アクセス権や機密情報の扱いを確認し、自動メモリがクラウド同期になるわけではない点にも注意してください。

出典: 自動メモリの有効化・無効化と保存先（Claude Code公式）

記憶されない・反映されないときの確認順

「覚えて」と頼んだのに反映されない場合は、故障と決めつける前に読み込み範囲と保存場所を確認します。

1. /memoryを実行し、対象のファイルが一覧にあるか調べる。
2. プロジェクトの起動場所が想定どおりか確認する。別のディレクトリで起動すると、別プロジェクトの設定や自動メモリが選ばれることがある。
3. CLAUDE.mdが長すぎないか、同じ項目に矛盾する指示がないか見直す。
4. 個人用とチーム用のファイルを取り違えていないか、自動メモリがオフになっていないか確認する。

指示は「きれいに書く」より「コミット前にpnpm testを実行する」のように確認できる形にします。毎回必ず実行する処理は、メモリではなく権限設定やフックで管理するのが安全です。

用途別に選ぶClaude Codeのメモリ設定

最後に、迷いやすい情報の置き場所をまとめます。

• チーム全員が守るコマンドや規約は、プロジェクトのCLAUDE.mdに書く。
• 自分だけの好みやローカル環境の情報は、CLAUDE.local.mdに書いてGit管理から外す。
• 特定の拡張子だけに必要なルールは、.claude/rules/へ分ける。
• Claudeが作業中に見つけたデバッグ知識や繰り返しの好みは、自動メモリに任せる。
• 次回も確実に守ってほしい重要事項は、自動メモリ任せにせずCLAUDE.mdへ明示する。

memory claude codeの使い方で大切なのは、すべてを1つの記憶へ詰め込まないことです。ルールと自動メモを分け、/memoryで定期的に点検すれば、必要な前提を残しつつ古い情報の混入も抑えられます。

出典: Claude Code公式ドキュメント「Claudeがあなたのプロジェクトを記憶する方法」