Claude Codeに同じ調査を繰り返させないためのメモの残し方
Anthropicは2026年11月6日、AIエージェントが作業で得た知識を次のセッションへ残す仕組みについて、技術解説「The components of agent memory」を公開しました。会話の記録、そこから作るメモ、後で読み直して訂正する処理を分けて説明しています。 Anthropicの技術解説
開発でも、調査に時間をかけて分かったことを次の作業へ引き継ぎたい場面があります。ただ、「このエラーはRedisが原因」とだけ残すと、別の原因で同じエラーが出たときにも、そのメモを頼りに調査を進めてしまいそうです。
今回は公式解説の考え方をもとに、Claude Codeへ残すメモを見直してみます。この研究記事を、Claude Codeに新しい自動整理機能が追加されたという告知として扱うものではありません。以下の開発例と依頼文は、筆者が説明用に組み立てたものです。実測で効果を確認した事例ではありません。
調査で分かったことと、まだ疑っていることを分ける
Anthropicの解説では、未検証の推測が散らばったメモと、確認済みの事実や根拠を整理したメモの違いが紹介されています。また、メモは最初から間違っていることも、環境の変化で古くなることもあるため、元の記録に戻って訂正する考え方を示しています。 メモの検証と訂正について
たとえば、ローカルのブラウザテストでログインに失敗し、Redisを起動したら通るようになったとします。次のメモだけでは、どこまで調べたかが分かりません。
ログインのテストが失敗したらRedisを起動する。
この例なら、次のように残せます。ファイル名やテスト名は架空のものです。
ローカルのログインE2Eを調べるときのメモ
確認したこと:
- tests/e2e/login.spec.ts は、ログイン後のセッション保存まで確認する。
- src/session/store.ts はRedisを使ってセッションを保存する。
- Redis停止中は接続エラーになり、起動後に同じE2Eが通った。
まだ確認していないこと:
- CIでも同じ原因で失敗するかは未確認。
次に使うとき:
- まず実際のエラーを確認する。
- Redis接続エラーなら、起動状態と接続先を調べる。
- セッション保存の実装が変わっていたら、このメモを見直す。
「Redisを起動したら直った」という結果に、確認した処理と適用できる条件を添えました。これなら次のセッションで、最初からログイン処理を全部調べ直すか、接続先の確認から始めるかを判断する材料になります。
パスワードや接続URLの実値は書かず、確認すべき設定名やコードの場所を残しましょう。
その場の状態より、調べ方や判断理由を残す
「今のブランチ名」「テストは全部成功」「PRはレビュー待ち」といった情報は、次に作業するときには変わっているかもしれません。こうした状態を長く使うメモへ混ぜると、過去の結果を現在の状態として扱う原因になります。
メモに残す内容を選ぶなら、次の違いを意識してみてください。これは開発作業向けの整理例です。
| 残したくなる情報 | 次の作業へ渡す形 |
|---|---|
| テストが成功した | 必要な場合は確認したコミットと実行条件を作業記録に残し、次回の成功は再確認する |
| このAPIは遅い | 測った条件、該当処理、未確認の仮説を残す |
| この実装は変更しない | 互換性などの判断理由と、判断を見直す条件を残す |
| あのファイルに書いてある | ファイルの場所と、そこで何を確かめられるかを残す |
すぐ調べ直せる状態を大量に転記するよりも、「なぜそう判断したか」があると、実装を変更してよいか考える際にも使えます。
チームの指示と、作業で得たメモの置き場所を選ぶ
Claude Codeの公式ドキュメントでは、人が継続的な指示を書く CLAUDE.md と、Claudeが訂正や好みなどを記録するauto memoryを分けています。どちらもモデルが参照する文脈であり、強制的に実行を制御する設定ではありません。 Claude Codeのメモリの仕組み
たとえば「認証を変更したときはログイン・ログアウトのE2Eを確認する」というチームで合意した方針は、共有する CLAUDE.md の候補です。一方、今回の調査で分かった注意点は、まずメモとして整理し、全員に適用するルールへ広げてよいかを別に判断します。
ターミナル版Claude Codeでは、セッション内で /memory を開くと指示ファイルやメモリの場所を確認できます。auto memoryのフォルダを開き、何が保存されているかを見てみましょう。チームで共有するつもりなら、個人のメモへ保存しただけで共有できたとせず、共有先のファイルと差分も確認します。 公式のメモリ確認手順
調査の終わりにClaudeへ整理を頼むなら、たとえば次の依頼文が使えます。
今回の調査から、次のセッションでも役立ちそうなことを整理してください。
まず保存せず、メモの候補を見せてください。
確認できたことは根拠のコードや検証条件と結びつけ、仮説と区別してください。
現在のブランチやテストの成否など、次回変わり得る状態は
継続的なルールにしないでください。
既存メモと矛盾する場合は、どちらをどう確認すべきか示してください。
秘密情報の実値は含めないでください。
候補を読んでから保存先を指定します。CLAUDE.md へ追記してほしい場合は、そのファイル名を明示すると意図が伝わります。
次のセッションで、メモが使えるか確かめる
保存できたかだけでなく、次の作業で参照できるかも確認してみましょう。先ほどの例なら、新しいセッションで次のように頼めます。
このプロジェクトでログインE2Eが失敗した場合の調査手順を提案してください。
関連するメモと現在のコードを確認し、根拠の場所も示してください。
まだコードの変更やテストの実行はしないでください。
メモを根拠として挙げたうえで、現在の実装を確認し、「Redis接続エラーの場合」という条件を保てているかを見ます。過去のテスト成功を現在の成功として答えたり、すべてのログイン失敗をRedisのせいにしたりするなら、メモの表現を直す余地があります。
これは応答を一度確認するための例で、以後の動作を保証するものではありません。実際の修正に入るときは、その時点のエラーとテスト結果で判断してください。
おわりに
まずは直近の調査メモを一つ開き、「何を根拠にしたのか」「どんなときに見直すのか」が読めるか確認してみてください。調査をやり直さずに済む情報を残しつつ、次の作業で改めて確認する部分も分かるメモにしておきましょう。
