CLAUDE.mdはもう重要ではない？Claude CodeのAuto Memoryとは｜違いと使い分けを解説

Claude Codeで作業を続けていると、「前のセッションで決めたことが、新しいセッションに引き継がれていない」と感じることがあります。

前回は、どこまで作業が終わったか、何を変更してはいけないか、次に何をするかまで話していた。ところが新しいセッションを始めると、Claudeはその会話をすべて覚えているわけではありません。完了した作業をもう一度提案したり、決めた方針と違う方向へ進んだりすることがあります。

CLAUDE.mdにルールを書けば、毎回守ってほしい方針は伝えられます。しかし、「今回はどこまで進んだか」という作業の現在地まで、自動で正確に引き継げるわけではありません。私たちも、引き継ぎファイルや作業台帳を別に用意して、この問題を補ってきました。

そこへ新しく加わったのが、Claude CodeのAuto Memoryです。Claudeが作業中に見つけた知見や、何度も伝えられた好みを保存し、次のセッションで再利用します。

ただし、Auto Memoryも過去の会話を丸ごと記憶する機能ではありません。 何を自動で覚えられ、何を人が残さなければならないのか。その境界を整理します。

この記事の要点

新しいセッションで前の会話が伝わらない理由

Claude Codeの各セッションは、新しいコンテキストウィンドウで始まります。前の会話全文が、そのまま次のセッションへ入るわけではありません。

同じセッション内でも、会話やツールの出力が増えるとコンテキストが埋まります。Claude Codeは古い出力を整理し、必要に応じて会話を要約します。このとき、序盤だけで伝えた細かな条件が薄れることがあります。

`CLAUDE.md`は、この問題を一部解決します。プロジェクト直下の`CLAUDE.md`はセッション開始時に読み込まれ、コンパクション後にも再読込されます。ただし、向いているのは「公開記事の数値は正本で確認する」「変更後はこのテストを実行する」といった恒常ルールです。

今どの記事を処理しているか、どの案を承認したか、次に何をするかは恒常ルールではありません。 進行状態まで`CLAUDE.md`へ詰め込むと、すぐに古くなり、ファイルも膨らみます。

Claude CodeのAuto Memoryとは

Claude Codeの公式ドキュメントでは、セッションをまたいで知識を運ぶ仕組みを2つに分けています。

1つは、人が書く`CLAUDE.md`。もう1つが、Claude自身が書くAuto Memoryです。

Auto Memoryは、作業中に見つけたビルドコマンド、デバッグの知見、設計上の注意、文章やコードの好み、繰り返し修正された内容をClaudeが記録します。毎回必ず保存するのではなく、将来のセッションでも役立つと判断した内容だけを残します。

現在のClaude Codeでは初期設定で有効です。画面に「Saved 2 memories」「Recalled 2 memories」のような表示が出たときは、Claudeが記憶を書いたり読み戻したりしています。

保存先はプロジェクト別のMarkdown

Auto Memoryは、利用中の端末にある次のディレクトリへ保存されます。

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

`MEMORY.md`は索引です。短い要点と、詳細を保存したトピックファイルへの案内が置かれます。

Gitリポジトリ内では、同じリポジトリのサブディレクトリやworktreeが1つのAuto Memoryを共有します。一方、別のパソコンやクラウド環境には自動同期されません。 デスクトップで学んだ内容が、ノートパソコンのClaude Codeへそのまま移るわけではありません。

毎回読み込まれる量には上限がある

新しいセッションの開始時に読み込まれるのは、`MEMORY.md`の先頭200行または25KBまでです。詳細なトピックファイルは最初から全部入らず、必要になったときにClaudeが読みます。

この設計により、記憶が増えてもコンテキストを圧迫しにくくなります。一方で、索引に載っていない情報や、Claudeが関連性に気づかなかったトピックは参照されない可能性があります。

`/memory`で人が確認できる

Auto Memoryは中身の見えない学習ではありません。`/memory`を実行すると、`CLAUDE.md`、rules、Auto Memoryの保存先を一覧し、ファイルを開いて編集できます。実際にどのファイルが読み込まれたかは`/context`で確認します。

記憶は平文のMarkdownなので、誤りがあれば修正でき、不要なら削除できます。Auto Memory自体を無効にすることも可能です。

{
  "autoMemoryEnabled": false
}

「これを覚えて」と明示すればAuto Memoryへ保存できます。反対に、組織の正式ルールとして残したい場合は「CLAUDE.mdへ追加して」と保存先まで指定した方が明確です。

Auto Memoryは何を覚え、何を覚えないのか

Auto Memoryが得意なのは、何度も使う可能性がある学びです。

逆に、保存を期待しすぎない方がよい情報もあります。

Auto Memoryは「前回の続きを完全復元する仕組み」ではなく、作業を重ねるほど同じ説明や訂正を減らす仕組みと捉えると正確です。

CLAUDE.mdは不要になるのか

結論は、不要にはなりません。ただし、何でも書く場所ではなくなります。

公式ドキュメントでも、`CLAUDE.md`とAuto Memoryは補完関係として説明されています。`CLAUDE.md`は人がClaudeの動きを案内するもの、Auto MemoryはClaudeが作業から得た学びを蓄積するものです。

問題は、巨大な`CLAUDE.md`です。公式ドキュメントは1ファイル200行未満を目安とし、長すぎるとコンテキストを消費して指示への追従が落ちると説明しています。

現在の`/doctor`には、Git管理された`CLAUDE.md`の整理案を出す機能もあります。ディレクトリ構成や依存関係などコードから読み取れる内容を減らし、注意点、判断理由、標準と異なる規約を残す考え方です。

今後の`CLAUDE.md`は、プロジェクトの百科事典ではなく、短いルールと正本への入口になります。特定のファイルやディレクトリだけで使う規則は`.claude/rules/`へ、複数工程の手順はSkillsへ、実行を強制したい処理はhooksへ分けます。

CLAUDE.mdの重要性が下がるのではなく、責任範囲が狭く、はっきりします。

6つの仕組みをどう使い分けるか

Claude周辺には「メモリ」と呼ばれる仕組みが複数あります。同じ名前でも、保存場所と用途が違います。

Claudeアプリのメモリ

ClaudeのWeb、Desktop、Mobileでは、過去チャットの検索と、会話から生成するMemoryが提供されています。役割、仕事上の背景、好み、進行中のプロジェクトなどを記憶し、プロジェクトごとに分けて管理できます。

これはClaude CodeのローカルなAuto Memoryとは別です。Claudeアプリで覚えた会話が、そのままClaude Codeの`MEMORY.md`へ入るわけではありません。

Coworkプロジェクトのメモリ

Claude Coworkのプロジェクトにもメモリがあります。プロジェクト内で実行したタスクの文脈を、同じプロジェクトの次回タスクで利用します。

現在のCoworkプロジェクトはデスクトップへローカル保存され、他の端末へ同期されません。Team・Enterpriseでもプロジェクト共有には対応していません。

APIのmemory tool

Claude APIには、会話をまたいで情報を保存・取得するmemory toolがあります。Claudeがファイル操作を要求し、実際の保存は利用企業のアプリケーションが行います。

保存先、利用者ごとの分離、削除、保持期間を開発者側で制御できる反面、実装と安全管理も必要です。Claude API入門で解説した通常のAPI呼び出しに、記憶を扱う仕組みを追加する位置づけです。

Managed AgentsのMemory Store

Managed AgentsのMemory Storeは、ワークスペース単位のテキスト文書として保存されます。セッションへ接続すると、エージェントがファイルとして読み書きできます。

変更ごとに改変できないバージョンが作られ、監査履歴と特定時点への復元が可能です。個人のClaude Codeが使うAuto Memoryより、組織的なエージェント運用を想定した設計です。

私たちが人力で引き継ぎを設計してきた理由

私たちはClaude Codeで多数の記事を整理するなかで、Auto Memoryが登場する前から、セッションをまたぐための仕組みを作ってきました。

入口には、必ず読むプロジェクトルールを置く。別のファイルに記事の状態を集め、現在の優先順位を1本だけ示す。セッションを終えるときは、完了したこと、保留した判断、次の作業を引き継ぎファイルへ残す。数値や事例の正本は、作業状況と分けて管理する。

手間はかかります。しかし、会話だけに頼ると、新しいセッションで「なぜその判断をしたか」が抜けます。巨大な`CLAUDE.md`へ全部入れると、今度は古い情報と新しい情報が衝突します。

実際にこのプロジェクトのAuto Memoryを確認すると、記事の書き方やWeb検証など、繰り返し役立つ知見が多く残っていました。一方、進行中の記事、直前に承認した処置、次に扱う1本までは完全には保存されていませんでした。

以前は有効だった記事方針が記憶に残り、その後決めた新方針とずれ始めた例もあります。Auto Memoryは学びを残しますが、学びがいつまで正しいかまでは保証しません。

ここから得た結論は、次の4層に分けることです。

Auto Memoryによって、毎回の訂正を人が記録する負担は減ります。それでも、作業状態と組織の正式判断は人が残す。この分担が、今のところ最も安定します。

具体的な手順をSkillsへ分ける方法は、Claude Skills完全ガイドで解説しています。

Auto Memoryを使う前に確認したい4つのこと

何が保存されたか定期的に見る

月に一度、または大きな方針変更の後に`/memory`を開きます。古い手順、誤った推測、重複した記憶を修正・削除してください。

機密情報を記憶させない

Auto Memoryは端末上のMarkdownへ保存されます。APIキー、パスワード、顧客の個人情報などを「覚えて」と頼まないでください。保存ファイルのアクセス権とバックアップ範囲も確認します。

複数端末とチーム共有を前提にしない

Auto Memoryはマシンローカルです。チーム全員が守るルールは、Git管理する`CLAUDE.md`やrulesへ置きます。個人のAuto Memoryを正式な業務標準にしないことが重要です。

強制したい処理を文章だけに任せない

`CLAUDE.md`もAuto Memoryも、Claudeへ渡されるコンテキストです。必ずテストを実行する、特定ファイルへの書き込みを止めるといった強制が必要な処理は、hooksや権限設定を使います。

AIエージェントの記憶は今後どうなるか

ここからは公式発表ではなく、現在の各製品から読み取れる予想です。

記憶に根拠と期限が付く

AIが覚えた内容は、保存した瞬間には正しくても、コードや業務ルールの変更で古くなります。今後は、いつ、どの作業から学んだか、現在も有効か、いつ見直すかを記憶へ持たせる方向へ進むでしょう。

その動きは一部始まっています。Claude Code v2.1.214以降では、YAML frontmatterがあるメモリファイルを更新すると、`modified`フィールドへ更新日時を記録します。ただし、更新日時だけで内容の正しさを判定できるわけではありません。

GitHub Copilot Memoryでは、リポジトリの事実にコード上の根拠を付け、利用時に現在のコードと突き合わせて再検証します。使われない記憶を28日後に削除する設計も採用しています。長く残すことより、現在も正しい記憶だけを使うことが重視され始めています。

個人の記憶と組織の記憶が分かれる

文章の好みは個人に属します。セキュリティや設計ルールは組織に属します。Claude Codeのサブエージェントでは、すでに記憶をuser、project、localの範囲へ分けられます。

Auto Memoryにも、個人だけで使う学び、チームが承認した知見、管理者が固定するルールを分ける要求が強まるはずです。

セッション引き継ぎが状態管理へ進む

会話を要約するだけでは、長い仕事を正確に再開できません。未完了タスク、承認済み判断、変更したファイル、次の操作を構造化し、新しいセッションが必要な部分だけ読む形へ進むと予想します。

Auto Memoryが経験則を覚え、別の仕組みが現在地を渡す。人間の仕事でも、業務マニュアルと案件の進捗表が別であるように、この分離は残るでしょう。

CLAUDE.mdは小さくなるが消えない

AIが自動で学ぶ範囲は広がります。それでも、何を公開してよいか、どのデータを正とするか、誰が最終判断するかは、人が決めなければなりません。

CLAUDE.mdは、細かな知識を大量に置く場所から、短いルールと参照先を示す場所へ変わります。量は減っても、役割はむしろ重くなります。

AIworkerが支援できること

AIネイティブX研修｜Claude Codeの記憶を設計する

Claude Codeの操作だけでなく、`CLAUDE.md`、Auto Memory、rules、Skills、引き継ぎファイルの役割を、自社業務を題材に整理します。何を毎回読ませ、何を必要時に呼び出し、何を人が承認するかを決めます。研修後には、対象業務で試せる初期構成と運用チェックリストが残ります。

AIネイティブX伴走｜使いながら記憶を棚卸しする

現場でClaude Codeを使い、保存された記憶、繰り返した訂正、引き継ぎ漏れを確認します。古い記憶を削り、正式ルールを`CLAUDE.md`やSkillsへ移し、作業状態は台帳へ分けます。相談を待たず現場の運用を見て、その場で記憶設計を直します。

業務AIプロ｜組織で管理できる記憶基盤へ広げる

個人端末のAuto Memoryでは足りず、利用者別の記憶、権限、監査、保持期間、社内データ連携が必要になった段階で、APIのmemory toolやManaged Agentsを含む業務特化AIを構築します。小さな対象業務で検証し、運用保守まで設計します。

Claude Codeを組織へ導入する全体設計は、Claude Code導入・研修の完全ガイドも参考にしてください。部署展開と定着の考え方は、Claudeを全社へ定着させる90日設計でまとめています。

FAQ

Q. Auto Memoryは過去の会話をすべて覚えますか？

覚えません。将来役立つとClaudeが判断した知見をMarkdownへ保存します。前の会話全文や未完了作業が完全に復元されるわけではありません。

Q. Auto Memoryは最初から有効ですか？

現在のClaude Codeでは初期設定で有効です。`/memory`で状態を確認し、設定や環境変数で無効化できます。

Q. 何が保存されたか確認できますか？

確認できます。`/memory`からAuto Memoryのフォルダを開くと、`MEMORY.md`とトピック別のMarkdownを閲覧・編集・削除できます。

Q. CLAUDE.mdとAuto Memoryのどちらへ書けばよいですか？

間違えると困る正式ルールは`CLAUDE.md`、作業から分かった好みや知見はAuto Memoryへ置きます。特定業務の複数工程はSkills、現在の進捗は引き継ぎファイルへ分けます。

Q. Auto Memoryをチームで共有できますか？

通常のAuto Memoryはマシンローカルで、自動共有されません。チーム共通ルールはGit管理する`CLAUDE.md`やrules、共有したい手順はSkillsへ移してください。

Q. 別のパソコンでも同じ記憶を使えますか？

自動では同期されません。保存先を変更する設定はありますが、機密、競合、同時更新を考慮した管理が必要です。

Q. 古い記憶を使い続ける危険はありますか？

あります。業務方針やコードが変わっても、記憶が自動で必ず削除されるわけではありません。方針変更後は`/memory`で確認し、古い内容を修正・削除してください。

最後まで読んでいただきありがとうございます。励みになりますので、参考になったらスキをお願いします。

▶️ サービス資料のダウンロード（資料請求）

▶️ 無料カウンセリング・AI活用診断のご予約

#ClaudeCode #AutoMemory #ClaudeMemory #CLAUDEmd #Claude #Anthropic #生成AI #AI活用 #AI導入 #AIエージェント #エージェントメモリ #セッション管理 #コンテキスト管理 #引き継ぎ #業務効率化 #業務改善 #業務自動化 #ClaudeSkills #AgentSkills #MCP #AI研修 #企業研修 #法人AI #DX推進 #社内AI #ナレッジ管理 #暗黙知 #業務標準化 #AIリテラシー #働き方改革