Claude Codeのメモリ機能 ― 会話をまたいだ記憶の活用法

メモリ機能とは ― 会話をまたぐ「記憶」

Claude Codeのメモリ機能は、会話が終了しても重要な情報を記憶し続ける仕組みです。通常、AIとの会話は毎回リセットされますが、メモリ機能を使うことで、プロジェクト固有の知識や決定事項を次の会話に引き継げます。

例えば「FTPアップロードにはこのコマンド形式を使う」「デプロイ前にDEPLOY_GUIDE.mdを必ず読む」といった情報を一度記憶させれば、以降の会話で自動的に適用されます。

メモリ機能の3つのメリット

繰り返し説明が不要: 一度伝えた手順やルールを毎回説明する必要がない
ミス防止: 重要な注意事項を忘れずに守らせることができる
チーム知識の蓄積: プロジェクト固有のノウハウを永続化できる

/memory コマンドの使い方

メモリの管理には、Claude Code内で /memory コマンドを使います。

操作	方法	説明
メモリの確認	会話中に「メモリを確認して」と依頼	現在記憶されている内容を表示
メモリの追加	「これを覚えておいて：〜」と指示	新しい情報をMEMORY.mdに追加
メモリの編集	MEMORY.mdファイルを直接編集	手動でメモリ内容を修正
メモリの削除	MEMORY.mdから該当行を削除	不要になった記憶を消去

メモリの保存先

メモリは以下の場所にMarkdownファイルとして保存されます。

# グローバルメモリ（全プロジェクト共通）
~/.claude/CLAUDE.md

# プロジェクト固有メモリ（自動生成）
~/.claude/projects/<プロジェクトパス>/memory/MEMORY.md

# サブディレクトリ別メモリ
~/.claude/projects/<プロジェクトパス>/memory/<サブパス>.md

MEMORY.mdの構造と書き方

MEMORY.mdは通常のMarkdownファイルです。セクションごとに情報を整理すると管理しやすくなります。

実際のMEMORY.mdの例

# プロジェクト メモリ

## デプロイ・アップロード【最重要ルール】
- FTPアップロード前に必ず DEPLOY_GUIDE.md を読み込むこと
- 読み込まずにアップロードすることは絶対に禁止
- アップロード完了後はチェックリストに沿って確認

## FTPアップロード方法（確認済み）
- `curl -s --ftp-create-dirs -T` でアップロード
- 形式: `curl -s --ftp-create-dirs -T "ローカル" "ftp://user:pass@host/パス"`
- 並列で複数ファイル同時アップロード可能

## 技術メモ
- CSS/JSはminify版を本番使用
- sitemap.xmlはsitemap.phpで動的生成

プロジェクト固有メモリ vs グローバルメモリ

項目	プロジェクト固有メモリ	グローバルメモリ
保存先	~/.claude/projects/下	~/.claude/CLAUDE.md
適用範囲	特定のプロジェクトのみ	全プロジェクト共通
用途	DB接続情報、デプロイ手順等	コーディングスタイル、好みの設定等
推奨内容	プロジェクト固有のルール・手順	個人の作業スタイル・共通ルール

auto-memoryの仕組み

Claude Codeは会話中に重要と判断した情報を自動的にメモリに保存する機能を持っています。これを「auto-memory」と呼びます。

自動保存されやすい情報

ユーザーが明示的に「覚えておいて」と言った情報
試行錯誤の結果わかった正しい手順（例：「このコマンドが正しかった」）
プロジェクトの重要な制約（例：「このAPIにはレートリミットがある」）
環境固有の設定（例：「このサーバーではSSL不要」）

メモリを手動で編集するベストプラクティス

MEMORY.mdはただのテキストファイルなので、エディタで直接編集できます。以下のポイントを押さえましょう。

編集のコツ

見出しで分類: 「## デプロイ」「## DB」「## API」のようにセクション分けする
箇条書きで簡潔に: 長文ではなく、要点を箇条書きで記述する
最重要ルールを目立たせる: 「【最重要】」などのラベルを付ける
古い情報は削除: 不要になった記憶は定期的に掃除する
具体的なコマンドを記載: 「FTPでアップロード」ではなく実際のコマンド形式を書く

記憶させると便利な情報の例

開発環境の情報

## 開発環境
- Node.js v20.11.0を使用
- npmではなくpnpmを使う
- ポート3000は別プロジェクトで使用中、3001を使うこと

デプロイの注意事項

## デプロイ注意事項
- mainブランチへの直接pushは禁止
- ステージング環境で確認後に本番デプロイ
- デプロイ後にヘルスチェックエンドポイントを確認すること
- /api/health が200を返せばOK

プロジェクト固有の制約

## 制約・注意事項
- 顧客データのログ出力は禁止（個人情報保護）
- 外部API呼び出しは必ずリトライ処理を入れる
- 画像ファイルは最大2MB、WebP形式推奨
- IE11対応不要（2024年に対応終了済み）

まとめ

メモリ機能は会話をまたいで情報を記憶する仕組み
MEMORY.mdファイルに自動または手動で情報が保存される
プロジェクト固有メモリとグローバルメモリを使い分ける
重要なルール・手順・制約を記憶させると効率が大幅に向上
定期的に古い情報を整理して最新の状態を保つ