Memory (メモリ)

中心は 2 つあり、利用者が書く指示ファイルの CLAUDE.md と、利用者の修正や好みをもとに Claude 自身が書くメモである Auto memory (自動メモリ) です。どちらも毎回の会話の開始時に読み込まれ、Claude はこれらを強制される設定ではなく文脈として扱います。プロジェクトの規約や個人の作業の流れ、組織全体の指示を Claude Code に継続して伝える場面に関わる機能です。

Claude Code は、現在の作業ディレクトリとその上のすべてのディレクトリから CLAUDE.md と CLAUDE.local.md を読み込みます。見つかったファイルは互いに上書きせず、すべて連結されて文脈に入ります。

• サブディレクトリの CLAUDE.md は起動時ではなく、Claude がそのサブディレクトリ内の別のファイルを読む・書く・編集した時点で読み込まれます。
• CLAUDE.md 内のブロックレベルの HTML コメント (<!-- maintainer notes -->) は、文脈に入る前に取り除かれます。
• @path/to/import で読み込んだファイルはさらに別のファイルを読み込めます。深さの上限は 4 段です。
• --add-dir で追加したディレクトリのメモリファイルも読み込むには、環境変数 CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD を設定します。
• /compact の後、プロジェクトルートの CLAUDE.md はディスクから読み直され、セッションに再び入ります。

.claude/rules/ ではシンボリックリンクが使えるため、共通のルール群を複数のプロジェクトにリンクできます。~/.claude/rules/ に置いた個人用のルールは、そのマシン上のすべてのプロジェクトに適用されます。

Auto memory はローカルのセッションでは既定でオンです。プロジェクトごとに ~/.claude/projects/<project>/memory/ という保存先があり、同じ git リポジトリ内のすべての worktree とサブディレクトリが 1 つの保存先を共有します。保存先は settings.json の autoMemoryDirectory で変更できます。自動メモリはマシンローカルで、ファイルは他のマシンやクラウド環境とは共有されません。

会話の開始時には MEMORY.md の先頭 200 行または先頭 25KB のどちらか先に達した分が読み込まれます。user_role.md のようなトピックファイルは起動時には読み込まれず、Claude が必要なときに通常のファイルツールで読みます。

Claude に何かを覚えるよう頼むと、自動メモリに保存されます。CLAUDE.md に加えたい場合は「CLAUDE.md に追加して」と直接頼むか、/memory から自分でファイルを編集します。自動メモリのファイルは通常の Markdown で、いつでも編集・削除できます。/memory では CLAUDE.md や CLAUDE.local.md などの場所の一覧、自動メモリのオン・オフ、自動メモリのフォルダを開く操作が使えます。

Claude Code は AGENTS.md をプロジェクトの指示として読めます。他のコーディングエージェント向けに設定済みのリポジトリは、CLAUDE.md・インポート・設定を追加しなくても動きます。既定では、作業ディレクトリとその上に CLAUDE.md が無い場合にだけ AGENTS.md を読みます。

読み込む指示ファイルは、/config の Project instructions (プロジェクトの指示) で claude-md-or-agents-md、claude-md-and-agents-md、claude-md、managed-only のいずれかに設定して変更します。AGENTS.md が直接読まれない設定でも、隣の CLAUDE.md に @AGENTS.md のインポートを書けば、1 つのファイルを各ツールで共有できます。

/init は Cursor や Copilot のルールなど他ツールの指示ファイルを読み、関連する部分を生成する CLAUDE.md に取り込みます。なお、AGENTS.md のサポートは Bedrock・Vertex・Foundry ではまだ使えません。

• 組織全体の CLAUDE.md: 管理ポリシーの場所 (macOS: /Library/Application Support/ClaudeCode/CLAUDE.md、Linux と WSL: /etc/claude-code/CLAUDE.md、Windows: C:\Program Files\ClaudeCode\CLAUDE.md) に作成し、MDM、Group Policy、Ansible などで開発者の端末に配布します。別ファイルを配布する代わりに、managed-settings.json の claudeMd キーに内容を直接書くこともできます。
• 除外の設定: claudeMdExcludes で特定の CLAUDE.md をパスや glob パターンで読み込み対象から外せます。管理ポリシーの CLAUDE.md は除外できません。
• サブエージェント: エージェントの frontmatter と --agents JSON の omitClaudeMd で、サブエージェントをユーザー・プロジェクト・ローカルの CLAUDE.md なしで実行できます。この場合も管理ポリシーのファイルは読み込まれます。
• 自動メモリの無効化: プロジェクト単位ではそのプロジェクトの設定で autoMemoryEnabled を false にし、環境変数では CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 を設定します。バックグラウンドセッションや Claude Code 自身のツールが開始したセッションからは Auto-memory をオンにできません (オフにはできます)。
• 読み込み時の無害化: 自動メモリの読み込み時、MEMORY.md と呼び出されたメモ内の不可視文字や Claude Code のマークアップを模したタグは、Claude に届く前に無害化されます。
• 切り分け: --safe-mode フラグ (または CLAUDE_CODE_SAFE_MODE) で、CLAUDE.md、plugins、skills、hooks、MCP servers をすべて無効にして起動できます。
• 指示ファイルの点検: /doctor prompt-audit で、指示ファイルの古い内容や矛盾する内容を確認したレポートと修正案を得られます。適用を頼むまでファイルは変更されません。

対象プランは公式のリリースノートには記載がありません。

プロジェクトの CLAUDE.md を用意する流れです。

1. ./CLAUDE.md または ./.claude/CLAUDE.md にプロジェクトの CLAUDE.md を作成し、プロジェクトで作業する全員に当てはまる指示を書きます。
2. 一から書く代わりに /init を実行すると、Claude がコードベースを解析し、見つけたビルドコマンド、テスト手順、プロジェクトの慣習を含むファイルを生成します。CLAUDE.md が既にある場合は、上書きせずに改善案を出します。
3. セッションで /context all を実行し、Memory files (メモリファイル) の一覧にファイルが含まれていることを確認します。