クロードコードのオートメモリー

問題です：CLAUDE.mdにはプロジェクトのルールが書かれていますが、Claudeがビルドコマンドやテスト規約、奇妙なデバッグの癖について同じことを尋ね続けています。指示はクロードにやってほしいことをカバーしている。クロードがあなたのリポジトリについてすでに学んだことを見逃している。

クイックウィン：自動メモリーがすでに実行されているかどうかを確認します。Claude Code セッションで /memory を実行してください。CLAUDE.mdファイルと自動メモリーのトグルが表示されます。このトグルはデフォルトでオンになっており、クロードがあなたのために静かにプロジェクトのメモを取っていることを意味します。

# Find your project's auto memory directory
ls ~/.claude/projects/

ディレクトリが表示されましたか？Claude はノートを用意しています。その中に何が入っているのか、どのように作業するのか、CLAUDE.mdシステムとどのように並んでいるのか、読み進めてください。何度もセッションを重ねるうちにメモリーファイルが肥大化してきたと感じたら、オートメモリーが書き込んだものを整理して再編成する統合機能、オートドリームを見てください。

オートメモリーの実際

オートメモリーは、クロードが作業中に学習、パターン、洞察を記録する永続的なフォルダである。以下に重要な分割を示す： **CLAUDE.mdはClaudeへの指示。MEMORY.mdは、あなたのプロジェクトに関するクロード自身へのメモです。

CLAUDE.mdは、"npmではなくpnpmを使う "とか、"コードの前にテストを書く "といったことを書く場所だ。Auto memoryは、Claudeが自分自身の観察を書き留める場所だ：「ビルドコマンドは pnpm build、テストは __tests__/、APIはExpressでミドルウェアは src/middleware/。

これをセッションメモリと混同しないでほしい。セッションメモリは、セッションをまたいで呼び出すために会話レベルのサマリを保存する。オートメモリーはもう一段階深いレベルで機能する。これは、どの会話が作成したかに関係なく残る、耐久性のあるプロジェクト知識を保持します。

3つの記憶システム、隣り合わせ

クロード・コードは現在、3つの別々の記憶システムを運用している。どれに手を伸ばせばいいかを知っていれば、同じ作業を2度やったり、間違ったツールを選んだりせずに済む。

最適なセットアップは、この3つを一緒に実行することです。CLAUDE.mdがルールを定めます。オートメモリーはクロードが途中で学んだことを記録する。セッションメモリーはセッション間のスレッドを保持する。

ファイルの保存場所

すべてのプロジェクトは、git リポジトリのルートに固定された独自のメモリフォルダを取得します：

~/.claude/projects/<project>/memory/
├── MEMORY.md          # Main index, loaded every session
├── debugging.md       # Detailed debugging patterns
├── api-conventions.md # API design decisions
└── ...                # Any topic files Claude creates

知っておくべきストレージの詳細

**git リポジトリのルートはプロジェクトのパスを定義するものである。src/api/`からClaudeを実行すると、リポジトリルートから実行するのと同じメモリにヒットします。
**Gitのワークツリーは、それぞれ独自のフォルダを取得します。異なるワークツリーは通常、異なる状態のブランチを保持します。
git リポジトリの外では、作業ディレクトリがリポジトリルートの役割を果たします。

書き留められるもの

Claude はプロジェクトで作業している間、いくつかのカテゴリに分類してメモをファイルします：

プロジェクトのパターン：ビルドコマンド、テスト規約、コードスタイルの選択。テストスイートを一度実行すると、Claude はそのコマンドと必要な特別なフラグを記録します。

Debugging insights: 厄介なバグや一般的なエラーの根源に対する修正。CORSの問題やwebpackの設定の結び目を追うのに時間を費やしていませんか？Claude が解決策を書き留めます。

アーキテクチャに関するメモ: 重要なファイル、モジュールの関連性、重要な抽象化。Claude が一度マップを作成するので、セッションごとにレイアウトを再確認する必要がありません。

あなたの好み：コミュニケーション方法、ワークフローの習慣、ツールの選択。クロードはあなたが傾倒しているパターンに気づきます。

MEMORY.mdは短いインデックスとして機能する。メモがたまると、Claude は詳細を debugging.mdやpatterns.md` のようなトピックファイルに移動する。起動時にロードされるのは最初の200行だけなので、メインファイルは200行以下に抑えられる。

使い方

実行させる

最も簡単な方法は、放っておくこと。自動メモリーはデフォルトでオンになっています。Claude は作業中にバックグラウンドでメモリファイルを読み書きします。セッション中、Claude がメモリフォルダ内のファイルを触ったときに気づくでしょう。

特定の何かを保存する

何を保存するか、クロードにはっきりと伝えてください：

"remember that we use pnpm, not npm"
"save to memory that the API tests require a local Redis instance"
"note that the staging environment uses port 3001"

クロードはこれらを正しいメモリーファイルにすぐにドロップする。

閲覧・編集

セッション中に /memory を実行するとメモリファイルセレクタが開きます。これは全てのメモリファイル(CLAUDE.md, auto memory, local config)をリストアップし、システムエディタで開くことができます。

シェルから読み込むこともできます：

# List all memory files for a project
ls ~/.claude/projects/<project>/memory/
 
# Read the main memory index
cat ~/.claude/projects/<project>/memory/MEMORY.md
 
# Read a specific topic file
cat ~/.claude/projects/<project>/memory/debugging.md

これらはプレーン・マークダウン・ファイルです。いつでも編集してください。古くなったエントリーは削除する。プロジェクトの成長に合わせて再編成する。

設定と管理

オートメモリーはデフォルトでオンになっています。以下は、あなたが回せるすべてのノブです：

セッションごとのトグル

memory`を実行し、自動メモリーのトグルを切り替える。現在のワークフローに合わせてオン/オフを切り替える最も簡単な方法です。

プロジェクトごとに殺す

これをユーザー設定に追加する：

// ~/.claude/settings.json
{ "autoMemoryEnabled": false }

キル・イット・フォー・ワン・プロジェクト

プロジェクト設定でこれをドロップします：

// .claude/settings.json
{ "autoMemoryEnabled": false }

環境変数のオーバーライド

CLAUDE_CODE_DISABLE_AUTO_MEMORY`は他のどの設定よりも優れている。CIパイプライン、自動化、マネージドデプロイメントに最適です：

export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1  # Force off
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=0  # Force on

これは/memoryトグルとsettings.jsonの両方を上書きするので、ハードキルスイッチとして機能する。

いつ何に手を伸ばすか

3つのメモリシステム、1つの決定フレームワーク：

**CLAUDE.mdにたどり着くのは、**厳密なルールが必要なときだ。コーディング標準、アーキテクチャの呼び出し、必要なコマンド、チームの規約。CLAUDE.mdは起動時に完全にロードされ、高い優先順位に置かれる。毎回従うパターンが必要な場合は、ここに置く。

Claudeにいろいろなものを拾ってきてほしいときはオートメモリーを使う。実際の作業中に表面化するパターン、デバッグの修正、静かな好み。事前にすべてを計画する必要はない。

**会話の継続性が必要なときは、セッションメモリーに手を伸ばそう。セッション・メモリーは、各セッションで議論し決定したことの糸を保つ。それは「昨日何をしたか」の層である。

***CLAUDE.mdが1つのファイルからはみ出したら、rulesディレクトリに手を伸ばしてください。.claude/rules/`の下にあるファイルに指示を分割することで、優先順位を落とさずにすっきりとした構成にすることができます。

重複しているのはわざとです。オートメモリーはCLAUDE.mdに書き忘れたものをピックアップしてくれます。セッションメモリーは、プロジェクトレベルのノートにはない文脈を運びます。これらを重ねることで、ルール、プロジェクト知識、会話履歴をカバーするレイヤーメモリを得ることができる。

ベストプラクティス

MEMORY.mdを200行以下に保つ 起動時にロードされるのは最初の200行だけ。Claudeは、詳細をトピックファイルに押し込むことで、簡潔さを保つように言われている。手作業で編集する場合は、同じ制限を守ってください。

**他のメモと同じように、それらは古くなる。大きなリファクタリングやアーキテクチャの変更の後は、ファイルをざっと見て、もはや真実でないものは削除すること。

**CLAUDE.mdとオートメモリーの間で二重の作業をしないこと。ずれる可能性のあるパターンなら、オートメモリーに持たせる。

クリティカルなものは明示的に保存しておく。 厄介なバグをクラックしたり、大きなアーキテクチャの呼び出しでロックしたりしたら、Claudeにそれを覚えておくように言う。クロードが自分ですべてをキャッチすることに賭けてはいけない。

**自動化には、クロードがビルドボックスに関するメモを積み重ねる必要はない。CI 設定で CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 を設定する。

**オートメモリーは、より大きなコンテキスト・エンジニアリング戦略の1つのレイヤーである。起動時にクロードが何を知っているかに注意を払えば払うほど、すべてのセッションがより多くのものを返してくれるようになる。

次のステップ

CLAUDE.mdメモリシステムをセットアップして、プロジェクトの指示を持続させる。
セッション間の会話継続のためのセッションメモリを理解する
トークンの制限内で作業するためのコンテキスト管理ストラテジーを学ぶ
モジュール化されたプロジェクト指示のためのルールディレクトリを探る
プロダクションAIメモリシステムのためのコンテキストエンジニアリングについて読む

オートメモリーは、あなたがクロードに指示したことと、クロードが自分で解決したことのギャップを埋める。CLAUDE.mdは「こうしてください」というルールを所有する。オートメモリーは「あなたのプロジェクトについて気づいたこと」の知識を所有する。この2つを一緒に使うことで、自分自身への説明を減らし、より多くのものを出荷することができる。

クロードコードのオートメモリー

On this page