Claude があなたのプロジェクトを記憶する方法

CLAUDE.md ファイルで Claude に永続的な指示を与え、自動メモリで Claude が自動的に学習を蓄積できるようにします。

Claude Code の各セッションは、新しいコンテキストウィンドウで始まります。2 つのメカニズムがセッション間で知識を保持します。

• CLAUDE.md ファイル: Claude に永続的なコンテキストを与えるために書く指示。Claude はリポジトリの AGENTS.md ファイルも読むことができます。CLAUDE.md と一緒に使用することも、単独で使用することもできます
• 自動メモリ: あなたの修正と好みに基づいて Claude が自分自身で書くメモ

このページでは、以下の方法について説明します。

• CLAUDE.md ファイルを書いて整理する
• 既存の AGENTS.md をプロジェクト指示として使用する。CLAUDE.md と一緒に使用することも、単独で使用することもできます
• .claude/rules/ で特定のファイルタイプにルールをスコープする
• 自動メモリを設定するので Claude が自動的にメモを取ります
• 指示が従われていない場合のトラブルシューティング

CLAUDE.md と自動メモリ

Claude Code には 2 つの相互補完的なメモリシステムがあります。どちらも各会話の開始時に読み込まれます。Claude はこれらをコンテキストとして扱い、強制的な設定ではありません。アクションをブロックするには、Claude の判断に関わらず PreToolUse hook を使用してください。より具体的で簡潔な指示ほど、Claude はそれに従う可能性が高くなります。

Claude の動作をガイドしたい場合は CLAUDE.md ファイルを使用します。自動メモリにより、Claude は手動の作業なしにあなたの修正から学習できます。

Subagent も独自の自動メモリを保持できます。詳細については、subagent 設定を参照してください。

CLAUDE.md ファイル

CLAUDE.md ファイルは、プロジェクト、個人的なワークフロー、または組織全体に対して Claude に永続的な指示を与えるマークダウンファイルです。これらのファイルはプレーンテキストで記述し、Claude はすべてのセッションの開始時にそれらを読みます。リポジトリが代わりに AGENTS.md を使用している場合は、AGENTS.md を参照してください。

CLAUDE.md に追加するタイミング

CLAUDE.md を、そうでなければ何度も説明し直すことになる内容を記述する場所として扱ってください。以下の場合に追加してください。

• Claude が同じ間違いを 2 回目に犯した場合
• コードレビューで Claude がこのコードベースについて知っておくべきだったことが指摘された場合
• 前回のセッションで入力した同じ修正または説明をチャットに再度入力する場合
• 新しいチームメンバーが生産性を高めるために同じコンテキストが必要な場合

すべてのセッションで Claude が保持すべき事実に限定してください。ビルドコマンド、規約、プロジェクトレイアウト、「常に X を実行する」ルールなどです。エントリが複数ステップの手順である場合、またはコードベースの 1 つの部分にのみ関連する場合は、代わりに skill または パススコープ付きルール に移動してください。拡張機能の概要 では、各メカニズムをいつ使用するかについて説明しています。

CLAUDE.md ファイルの配置場所を選択する

CLAUDE.md ファイルはいくつかの場所に配置でき、それぞれ異なるスコープを持ちます。以下の表は、読み込み順序でそれらをリストしており、最も広いスコープから最も具体的なスコープまでなので、プロジェクト指示はユーザー指示の後のコンテキストに表示されます。

作業ディレクトリより上のディレクトリ階層内の CLAUDE.md および CLAUDE.local.md ファイルは起動時に読み込まれます。サブディレクトリ内のファイルは、Claude がそれらのディレクトリ内のファイルを読むときにオンデマンドで読み込まれます。完全な解決順序については、CLAUDE.md ファイルの読み込み方法 を参照してください。

大規模なプロジェクトの場合、プロジェクトルール を使用して指示をトピック固有のファイルに分割できます。ルールを使用すると、指示を特定のファイルタイプまたはサブディレクトリにスコープできます。

プロジェクト CLAUDE.md をセットアップする

プロジェクト CLAUDE.md は ./CLAUDE.md または ./.claude/CLAUDE.md に保存できます。このファイルを作成し、プロジェクトで作業する誰もが適用される指示を追加してください。ビルドおよびテストコマンド、コーディング標準、アーキテクチャの決定、命名規約、一般的なワークフローなどです。これらの指示はバージョン管理を通じてチームと共有されるため、個人的な設定ではなくプロジェクトレベルの標準に焦点を当ててください。ファイルが読み込まれたことを確認するには、セッションで /context を実行し、Memory files の下のリストを確認してください。

効果的な指示を書く

CLAUDE.md ファイルはすべてのセッションの開始時にコンテキストウィンドウに読み込まれ、会話と一緒にトークンを消費します。コンテキストウィンドウの可視化 は、CLAUDE.md が起動コンテキストの残りの部分に対してどこに読み込まれるかを示しています。これらはコンテキストであり、強制的な設定ではないため、指示の書き方は Claude がそれらに従う信頼性に影響します。具体的で簡潔で、よく構造化された指示が最も効果的です。

サイズ: CLAUDE.md ファイルあたり 200 行以下を目標にしてください。より長いファイルはより多くのコンテキストを消費し、遵守を減らします。指示が大きくなっている場合は、パススコープ付きルール を使用して、Claude が一致するファイルで作業するときにのみ指示が読み込まれるようにしてください。また、コンテンツを インポート に分割して整理することもできますが、インポートされたファイルは起動時に読み込まれてコンテキストウィンドウに入ります。

構造: マークダウンヘッダーと箇条書きを使用して関連する指示をグループ化してください。Claude は読者と同じ方法で構造をスキャンします。整理されたセクションは密集した段落よりも従いやすいです。

具体性: 検証できるほど具体的な指示を書いてください。例えば：

• 「コードを適切にフォーマットする」ではなく「2 スペースのインデントを使用する」
• 「変更をテストする」ではなく「コミット前に npm test を実行する」
• 「ファイルを整理しておく」ではなく「API ハンドラーは src/api/handlers/ に存在する」

一貫性: 2 つのルールが矛盾している場合、Claude は 1 つを任意に選択する可能性があります。CLAUDE.md ファイル、サブディレクトリ内のネストされた CLAUDE.md ファイル、および .claude/rules/ を定期的に確認して、古い指示または矛盾する指示を削除してください。モノレポでは、claudeMdExcludes を使用して、作業に関連のない他のチームの CLAUDE.md ファイルをスキップしてください。

追加ファイルをインポートする

CLAUDE.md ファイルは @path/to/import 構文を使用して追加ファイルをインポートできます。インポートされたファイルは展開され、それらを参照する CLAUDE.md と一緒に起動時にコンテキストに読み込まれます。

相対パスと絶対パスの両方が許可されます。相対パスは、作業ディレクトリではなく、インポートを含むファイルに対して相対的に解決されます。インポートされたファイルは他のファイルを再帰的にインポートでき、最大深度は 4 ホップです。

インポート解析は Markdown コードスパンとフェンスコードブロックをスキップします。パスを CLAUDE.md で言及するがインポートしないようにするには、バッククォートでラップしてください。`@README` を書くとテキストはリテラルのままですが、バッククォートの外の @README はファイルをインポートします。

README、package.json、ワークフローガイドを取り込むには、CLAUDE.md の任意の場所で @ 構文で参照してください。

See @README for project overview and @package.json for available npm commands for this project.

# Additional Instructions
- git workflow @docs/git-instructions.md

バージョン管理にチェックインすべきではない個人的なプロジェクト固有の設定については、プロジェクトルートに CLAUDE.local.md を作成してください。これは CLAUDE.md と一緒に読み込まれ、同じ方法で扱われます。CLAUDE.local.md を .gitignore に追加して、コミットされないようにしてください。CLAUDE_CODE_NEW_INIT=1 が設定されている場合、/init を実行して個人オプションを選択するとこれが自動的に行われます。

同じリポジトリの複数の git worktrees で作業する場合、gitignored CLAUDE.local.md は作成した worktree にのみ存在します。worktree 全体で個人的な指示を共有するには、代わりにホームディレクトリからファイルをインポートしてください。

# Individual Preferences
- @~/.claude/my-project-instructions.md

CLAUDE.md ファイルの読み込み方法

Claude Code は、現在の作業ディレクトリとそれより上のすべてのディレクトリから CLAUDE.md および CLAUDE.local.md を読み込みます。Claude Code を foo/bar/ で実行すると、foo/bar/CLAUDE.md、foo/CLAUDE.md、およびそれらの横にある CLAUDE.local.md ファイルから指示を読み込みます。

発見されたすべてのファイルは、互いにオーバーライドするのではなく、コンテキストに連結されます。ディレクトリツリー全体で、コンテンツはファイルシステムルートから作業ディレクトリまで順序付けられます。foo/bar/ の例では、foo/CLAUDE.md は foo/bar/CLAUDE.md の前にコンテキストに表示されるため、Claude を起動した場所に近い指示が最後に読まれます。各ディレクトリ内では、CLAUDE.local.md は CLAUDE.md の後に追加されるため、個人的なメモはそのレベルで Claude が読む最後のものです。

Claude はまた、現在の作業ディレクトリの下のサブディレクトリ内の CLAUDE.md および CLAUDE.local.md ファイルを発見します。起動時に読み込む代わりに、Claude がそれらのディレクトリ内のファイルを読むときに含まれます。

大規模なモノレポで他のチームの CLAUDE.md ファイルが取得される場合は、claudeMdExcludes を使用してそれらをスキップしてください。ルートおよびディレクトリごとの CLAUDE.md ファイルとルールの完全なレイアウトについては、モノレポと大規模リポジトリ を参照してください。

CLAUDE.md ファイル内のブロックレベル HTML コメント（<!-- maintainer notes -->）は、コンテンツが Claude のコンテキストに注入される前に削除されます。コンテキストトークンを費やさずに人間のメンテナーのためのメモを残すために使用してください。コードブロック内のコメントは保持されます。Read ツールで CLAUDE.md ファイルを直接開くと、コメントは表示されたままになります。

追加ディレクトリから読み込む

--add-dir フラグは、メイン作業ディレクトリの外の追加ディレクトリへのアクセスを Claude に与えます。デフォルトでは、これらのディレクトリからの CLAUDE.md ファイルは読み込まれません。

追加ディレクトリからメモリファイルも読み込むには、CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD 環境変数を設定してください。

CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

インライン形式はその 1 回の起動に対して Bash または Zsh で変数を設定します。すべてのセッションで有効に保つには、環境変数を設定する に示されているように ~/.claude/settings.json の env ブロックに追加してください。

これは追加ディレクトリから CLAUDE.md、.claude/CLAUDE.md、.claude/rules/*.md、および CLAUDE.local.md を読み込みます。--setting-sources から local を除外した場合、CLAUDE.local.md はスキップされます。

`.claude/rules/` でルールを整理する

大規模なプロジェクトの場合、.claude/rules/ ディレクトリを使用して指示を複数のファイルに整理できます。これにより、指示がモジュール化され、チームが保守しやすくなります。ルールは 特定のファイルパスにスコープ することもできるため、Claude が一致するファイルで作業するときにのみコンテキストに読み込まれ、ノイズを減らしてコンテキストスペースを節約します。

ルールをセットアップする

プロジェクトの .claude/rules/ ディレクトリにマークダウンファイルを配置してください。各ファイルは 1 つのトピックをカバーし、testing.md または api-design.md のような説明的なファイル名を持つべきです。すべての .md ファイルは再帰的に発見されるため、frontend/ または backend/ のようなサブディレクトリにルールを整理できます。

your-project/
├── .claude/
│   ├── CLAUDE.md           # Main project instructions
│   └── rules/
│       ├── code-style.md   # Code style guidelines
│       ├── testing.md      # Testing conventions
│       └── security.md     # Security requirements

paths frontmatter のないルールは、.claude/CLAUDE.md と同じ優先度で起動時に読み込まれます。

--setting-sources から project を除外した場合、プロジェクトルールはスキップされます。v2.1.211 より前では、パススコープ付きルールやネストされた .claude/rules/ ディレクトリ内のルールを含む、オンデマンドで読み込まれるルールは、project が除外されている場合でも読み込まれました。

パス固有のルール

ルールは YAML frontmatter の paths フィールドを使用して特定のファイルにスコープできます。これらの条件付きルールは、Claude が指定されたパターンに一致するファイルで作業するときにのみ適用されます。

---
paths:
  - "src/api/**/*.ts"
---

# API Development Rules

- All API endpoints must include input validation
- Use the standard error response format
- Include OpenAPI documentation comments

paths フィールドのないルールは無条件に読み込まれ、すべてのファイルに適用されます。パススコープ付きルールは、すべてのツール使用時ではなく、パターンに一致するファイルを読むときにトリガーされます。v2.1.198 の時点で、マッチングは Claude がシンボリックリンクされたパスを通じてファイルに到達するときにも機能します。例えば、プロジェクトディレクトリへのシンボリックリンクされたチェックアウト。

paths フィールドでグロブパターンを使用して、拡張子、ディレクトリ、またはそれらの任意の組み合わせでファイルをマッチしてください。

複数のパターンを指定し、ブレース展開を使用して 1 つのパターンで複数の拡張子をマッチできます。

---
paths:
  - "src/**/*.{ts,tsx}"
  - "lib/**/*.ts"
  - "tests/**/*.test.ts"
---

各ブレースグループは展開されたパターンの数を乗算します。src/*.{ts,tsx} は 2 つのパターンに展開され、{a,b}/{c,d}/*.{ts,tsx} は 8 つに展開されます。展開を制限するために、ルール全体の paths リストは 1,000 展開パターンと 4 MiB の 1 つの予算を共有し、ブレースのないパターンはそれに対してカウントされません。

Claude Code は予算を超えるパターンを展開されていない状態で使用し、その文字通りのブレースはファイルをマッチしません。v2.1.217 より前では、多くのブレースグループを持つ paths 値は起動時に CLI をスタールまたはクラッシュさせました。

グロブ構文は [ をブラケット式（[abc] など）の開始として扱います。photos [2024/** のようにブラケット式として読めない [ を持つパターンは無効です。何もマッチしず、ルールの他のパターンは機能し続けます。ファイル名内のリテラル [ をマッチするには、photos \[2024/** としてエスケープしてください。v2.1.207 より前では、1 つの無効なパターンは、マッチしない代わりに、ルールが評価されたすべてのファイルに対して Read ツールを失敗させました。

ルール frontmatter リファレンス

YAML frontmatter を使用してルールを設定してください。--- マーカーの間に配置します。paths は Claude Code が読み取る唯一のフィールドです。その他のフィールドはエラーなしで無視されます。Claude Code はルールをコンテキストに読み込む前に frontmatter を削除します。

マーカー間の YAML が解析されない場合、Claude Code は frontmatter を無視し、paths がないかのようにルールを読み込みます。claude --debug を実行して解析エラーを確認してください。

シンボリックリンクでプロジェクト全体でルールを共有する

.claude/rules/ ディレクトリはシンボリックリンクをサポートしているため、共有ルールセットを保持し、複数のプロジェクトにリンクできます。循環シンボリックリンクは検出され、適切に処理されます。

Claude Code は、ターゲットが作業ディレクトリの外にあるシンボリックリンクを 外部インポート のように扱います。リンクされたルールは、プロジェクトの外部インポートを承認するまで読み込まれず、その後は paths フィールド のないものだけが読み込まれます。Claude Code は、@path でファイルをディレクトリの外にインポートするプロジェクトメモリファイルに対してのみ承認を求め、シンボリックリンク単独に対しては求めません。その承認なしで共有ルールを読み込むには、~/.claude/rules/ に保持してください。ここでは、マシン上のすべてのプロジェクトに適用されます。

この例は、共有ディレクトリと個別ファイルの両方をリンクしています。

ln -s ~/shared-claude-rules .claude/rules/shared
ln -s ~/company-standards/security.md .claude/rules/security.md

ユーザーレベルのルール

~/.claude/rules/ 内の個人的なルールはマシン上のすべてのプロジェクトに適用されます。プロジェクト固有ではない設定に使用してください。

~/.claude/rules/
├── preferences.md    # Your personal coding preferences
└── workflows.md      # Your preferred workflows

ユーザーレベルのルールはプロジェクトルールの前に読み込まれるため、プロジェクトルールは Claude のコンテキストでユーザールールより後に表示されます。どちらのセットも他方をオーバーライドしません。ユーザールールとプロジェクトルールが矛盾する場合、Claude はどちらか一方に従う可能性があるため、2 つを一貫性のあるものに保ってください。

大規模なチーム向けに CLAUDE.md を管理する

Claude Code をチーム全体にデプロイする組織の場合、指示を一元化し、どの CLAUDE.md ファイルが読み込まれるかを制御できます。

組織全体の CLAUDE.md をデプロイする

組織は、マシン上のすべてのユーザーに適用される一元管理の CLAUDE.md をデプロイできます。このファイルは個別の設定で除外することはできません。

claudeMd キーを使用すると、別のファイルをデプロイする代わりに、管理された CLAUDE.md コンテンツを managed-settings.json 内に直接配置できます。

スコープ: マシン上のすべての Claude Code セッション、すべてのリポジトリ内。リポジトリ固有のガイダンスについては、プロジェクト CLAUDE.md をコミットしてください。

優先度: 管理された CLAUDE.md ファイルと同じ。ユーザーおよびプロジェクト CLAUDE.md の前に読み込まれます。

どこで尊重されるか: 管理および管理ポリシー設定のみ。ユーザー、プロジェクト、またはローカル設定で claudeMd を設定しても効果がありません。

以下の例は、管理設定ファイル内に直接動作指示を追加します。

{
  "claudeMd": "Always run `make lint` before committing.\nNever push directly to main."
}

管理された CLAUDE.md と 管理設定 は異なる目的を果たします。技術的な強制には設定を、動作ガイダンスには CLAUDE.md を使用してください。

設定ルールは、Claude が何をするかに関係なく、クライアントによって強制されます。CLAUDE.md 指示は Claude の動作を形作りますが、ハード強制レイヤーではありません。

特定の CLAUDE.md ファイルを除外する

大規模なモノレポでは、祖先 CLAUDE.md ファイルに、作業に関連のない指示が含まれている可能性があります。claudeMdExcludes 設定を使用すると、パスまたはグロブパターンで特定のファイルをスキップできます。

この例は、トップレベルの CLAUDE.md と親フォルダのルールディレクトリを除外します。.claude/settings.local.json に追加して、除外をマシンにローカルに保つようにしてください。

{
  "claudeMdExcludes": [
    "**/monorepo/CLAUDE.md",
    "/home/user/monorepo/other-team/.claude/rules/**"
  ]
}

パターンはグロブ構文を使用して絶対ファイルパスに対してマッチされます。claudeMdExcludes は任意の 設定レイヤー で設定できます。ユーザー、プロジェクト、ローカル、または管理ポリシー。配列はレイヤー全体でマージされます。

シンボリックリンク を通じて到達するルールファイルを除外するには、ファイルまたはそのディレクトリがリンクであるかどうかに関わらず、パスに対してパターンを書いてください。.claude/rules/ の下のファイルのパスまたはそのリンクターゲット。パターンがいずれかのパスに一致する場合、ファイルは除外されます。v2.1.239 より前では、リンクターゲットに一致するパターンのみがファイルを除外しました。

管理ポリシー CLAUDE.md ファイルは除外できません。これにより、個別の設定に関係なく、組織全体の指示が常に適用されることが保証されます。

AGENTS.md

Claude Code は AGENTS.md をプロジェクト指示として読み込むことができるため、他のコーディングエージェント向けにセットアップされたリポジトリは、CLAUDE.md、インポート、またはセッティングを追加することなく動作します。このテーブルは、リポジトリ内の指示ファイルの組み合わせごとに Claude が既定で読み込むものを示しています。

既定の動作を変更する場合（例えば、Claude に常に両方のファイルを読み込ませたい、CLAUDE.md のみを読み込ませたい、または組織が管理する指示のみを読み込ませたい場合）は、Project instructions セッティングを変更 してください。

Claude Code が AGENTS.md を読み込むとき

既定では、Claude はワーキングディレクトリまたはその上位ディレクトリに CLAUDE.md がない場合にのみ AGENTS.md を読み込みます。このチェックに該当するファイルは以下の通りです。

• 該当するため、Claude は AGENTS.md の代わりにこれらを読み込む: ワーキングディレクトリまたはその上位ディレクトリにある CLAUDE.md、.claude/CLAUDE.md、または CLAUDE.local.md
• 該当しないため、AGENTS.md と一緒に読み込み続ける: ~/.claude/CLAUDE.md、組織が管理する CLAUDE.md、および .claude/rules/ ファイル

該当するものがない場合、Claude が読み込むものと確認方法は以下の通りです。

• セッション開始時: ワーキングディレクトリとその上位ディレクトリ内のすべての AGENTS.md と .claude/AGENTS.md。インタラクティブセッションでは、会話に no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md のような行が表示されます
• Claude がサブディレクトリで作業するとき: Claude が Read ツールでそこにファイルを開き、そのサブディレクトリに 3 つの CLAUDE.md ファイルのいずれも含まれていない場合、サブディレクトリの AGENTS.md
• 各 AGENTS.md 内: @path インポート が展開され、claudeMdExcludes パターンが適用され、プロジェクト指示をスキップ するサブエージェントがこれらのファイルもスキップします
• 読み込まれない: AGENTS.local.md、AGENTS.override.md、または .agents/ ディレクトリ下のすべてのもの

Claude が読み込む指示ファイルを選択する

Claude が読み込むファイルを変更するには、Claude Code セッションで /config と入力してセッティングパネルを開き、Project instructions を以下のいずれかの値に設定します。

/config の代わりにセッティングファイルで値を設定することもできます。~/.claude/settings.json、--settings ファイル、または 管理セッティング の pluginConfigs 下の組み込み agents-md プラグインの ID に追加してください。Claude Code はプロジェクトおよびローカルセッティングファイルではこれを無視します。この例は Claude に両方のファイルを読み込ませます。

{
  "pluginConfigs": {
    "agents-md@builtin": {
      "options": { "instructionFiles": "claude-md-and-agents-md" }
    }
  }
}

変更は次のメッセージから、およびすべての新しいセッションで適用されます。

AGENTS.md サポートが利用できないとき

これらのセッションでは Claude は CLAUDE.md ファイルのみを読み込み、Project instructions は /config セッティングパネルに表示されません。

• Claude Code v2.1.277 より前のバージョンを使用している
• 組み込み agents-md プラグインを /plugin で無効にしました
• 一部の場合、v2.1.276 以前から アップグレード した後の最初のセッションです。次のセッションから Claude は AGENTS.md を読み込みます

v2.1.281 より前では、Amazon Bedrock 上のセッションやテレメトリが無効になっているセッションなど、一部のセッションは CLAUDE.md ファイルのみを読み込みます。これらのバージョンでは Claude Code を更新してください。これらのセッションのいずれかで Claude に AGENTS.md を提供するには、CLAUDE.md からインポート してください。

AGENTS.md が CLAUDE.md と異なる点

Claude が Project instructions セッティングを通じて読み込む AGENTS.md は、これらの場所で CLAUDE.md と異なります。

以前の AGENTS.md 回避策を削除する

Claude Code が独自に AGENTS.md を読み込む前にそれを読み込むようにセットアップした場合、各一般的なセットアップで以下を実行してください。

• @AGENTS.md を含む CLAUDE.md: そのままにしておくことができます。インポートを保持することで、使用する Project instructions 値に関係なく Claude が AGENTS.md を 2 回読み込むことはありません。CLAUDE.md が他に何も含まない場合は削除するか、一部のセッションが AGENTS.md を直接読み込むことができない 場合は保持してください。
• Claude に言葉で AGENTS.md を読み込むよう指示する CLAUDE.md: Claude がファイルを開くことを決定した場合のみ AGENTS.md が表示されます。CLAUDE.md を削除して Claude が AGENTS.md を直接読み込むようにするか、文を @AGENTS.md インポートに置き換えてください。
• AGENTS.md にシンボリックリンクされた CLAUDE.md: 何もしないか、シンボリックリンクを削除してください。どちらの場合でも Claude はコンテンツを 1 回読み込みます。
• AGENTS.md を出力する SessionStart フック: 削除してください。Claude が AGENTS.md を直接読み込むと、フックはコンテキストに 2 番目のコピーを追加します。

他のコーディングツールと 1 つのファイルを共有する

Claude が AGENTS.md を直接読み込んでいない場合でも、AGENTS.md の隣に CLAUDE.md に @AGENTS.md インポートを配置することで、すべてのツールが共有する 1 つのファイルとして保持できます。プロジェクトに CLAUDE.md もある場合、Project instructions を claude-md に設定した場合、または AGENTS.md を読み込むことができない セッションで実行してください。インポートの下に Claude 固有の指示を追加すると、Claude はインポートされたファイルを最初に読み込み、その後残りを読み込みます。

@AGENTS.md

## Claude Code

`src/billing/` 下の変更にはプランモードを使用してください。

Claude 固有のコンテンツが不要な場合、シンボリックリンクも機能します。

ln -s AGENTS.md CLAUDE.md

コマンドは成功時に出力を出力しません。シンボリックリンクをインポートより選択する前に、これらの制約を確認してください。

• 編集: Claude はリンクを通じて CLAUDE.md を読み込みますが、Edit および Write ツールは シンボリックリンクを通じた書き込みを拒否 し、拒否はリンクのターゲットである AGENTS.md を代わりに編集するよう Claude に指示します
• Windows: リポジトリをクローンする人が Windows で作業する場合は、@AGENTS.md インポートを代わりに使用してください。そこでシンボリックリンクを作成するには管理者権限または開発者モードが必要であり、core.symlinks が有効になっていない限り Git はコミットされたシンボリックリンクをプレーンテキストファイルとしてチェックアウトします。これにより、そのクローンに指示の代わりに 1 行の CLAUDE.md が残ります

どちらのアプローチでも、次のセッションで /context を実行し、Memory files の下に CLAUDE.md が表示されることを確認してください。

他のツールから指示を移行する

/init を実行すると、他のツールの指示ファイルが読み込まれ、関連する部分が生成された CLAUDE.md に組み込まれます。

• .cursor/rules/ または .cursorrules の Cursor ルール
• .github/copilot-instructions.md の Copilot ルール
• CLAUDE_CODE_NEW_INIT=1 が設定されている場合: AGENTS.md、.devin/rules/、.windsurf/rules/ または .windsurfrules、および .clinerules

/import を実行して、サポートされているコーディングエージェントの設定を Claude Code に取り込むこともできます。これにより、AGENTS.md などの指示ファイルの 1 回限りのコピーが一致する CLAUDE.md に追加され、MCP サーバー、コマンド、サブエージェント、およびスキルが引き継がれます。Claude Code v2.1.213 以降が必要です。

自動メモリ

自動メモリを使用すると、Claude は何も書かずにセッション間で知識を蓄積できます。Claude は作業中に自分自身のためにメモを 4 種類保存します。Claude はメモリファイルのフロントマターに type フィールドとして種類を記録します。

• user：あなたの役割、専門知識、および作業の好み
• feedback：Claude に与える修正と確認するアプローチ
• project：進行中の作業、期限、および Claude がコードまたは git 履歴から導き出せない決定
• reference：issue トラッカーやダッシュボードなど、プロジェクト外の情報を見つける場所

Claude はアーキテクチャ、ファイルパス、デバッグ修正など、コードベースから導き出せるものはすべてスキップします。また、CLAUDE.md ファイルが既に述べていることもスキップします。

Claude はすべてのセッションで何かを保存するわけではありません。情報が将来の会話で役立つかどうかに基づいて、何を記憶する価値があるかを決定します。

自動メモリを有効または無効にする

自動メモリはデフォルトで有効です。切り替えるには、セッションで /memory を開き、自動メモリトグルを使用します。これにより autoMemoryEnabled が ~/.claude/settings.json のユーザー設定に保存されます。単一のプロジェクトに対してオフにするには、そのプロジェクトの設定で autoMemoryEnabled を設定します。

{
  "autoMemoryEnabled": false
}

環境変数を使用して自動メモリを無効にするには、CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 を設定します。

ストレージの場所

各プロジェクトは ~/.claude/projects/<project>/memory/ に独自のメモリディレクトリを取得します。<project> パスは git リポジトリから派生しているため、同じリポジトリ内のすべてのワーキングツリーとサブディレクトリは 1 つの自動メモリディレクトリを共有します。git リポジトリの外では、プロジェクトルートが代わりに使用されます。

CLAUDE_CODE_PROJECT_DIR_NAME を CLAUDE_CONFIG_DIR の横に設定した場合、Claude Code はその名前を、どのリポジトリを起動しても <config dir>/projects/ の下の <project> ディレクトリとして使用するため、その設定ディレクトリで起動されたプロジェクトは 1 つの自動メモリディレクトリを共有します。Claude Code v2.1.234 以降が必要です。詳細は CLAUDE_CODE_PROJECT_DIR_NAME を参照してください。

自動メモリを別の場所に保存するには、settings.json で autoMemoryDirectory を設定します。これは任意の設定スコープから読み込まれます。ユーザー、プロジェクト、ローカル、ポリシー、または --settings です。

{
  "autoMemoryDirectory": "~/my-custom-memory-dir"
}

値は絶対パスであるか、~/ で始まる必要があります。

プロジェクトの .claude/settings.json または .claude/settings.local.json で設定する場合、Claude Code はそれを設定ファイル内の hooks と同じワークスペーストラストルールの下で尊重します。permissions.blockReadsOutsideWorkingDirectories がオンの間、Claude Code はリポジトリ提供の設定ファイルが選択するディレクトリからは自動メモリを読み込まず、そこに保存もしません。そのディレクトリがどこにあるかに関わらず。

ディレクトリには MEMORY.md インデックスとメモリごとに 1 つのトピックファイルが含まれます。

~/.claude/projects/<project>/memory/
├── MEMORY.md           # インデックス、メモリごとに 1 行、すべてのセッションに読み込まれます
├── user_role.md        # 1 つのメモリ
├── feedback_testing.md # 1 つのメモリ
└── ...                 # Claude が作成するその他のトピックファイル

MEMORY.md はメモリディレクトリのインデックスとして機能します。Claude はセッション全体を通じてこのディレクトリ内のファイルを読み書きし、MEMORY.md を使用して保存されている内容を追跡します。

自動メモリはマシンローカルです。同じ git リポジトリ内のすべてのワーキングツリーとサブディレクトリは 1 つの自動メモリディレクトリを共有します。ファイルはマシン間またはクラウド環境全体で共有されません。

Claude Code は cleanupPeriodDays 保持期間後に古いセッショントランスクリプトを削除しますが、メモリディレクトリ内のメモリファイルをその保持スイープから除外します。MEMORY.md とトピックファイルは、あなたまたは Claude が編集または削除するまで保持されます。

仕組み

MEMORY.md の最初の 200 行、または最初の 25KB のいずれか先に来る方が、すべての会話の開始時に読み込まれます。そのしきい値を超えるコンテンツはセッション開始時に読み込まれません。Claude は詳細なメモを別のトピックファイルに移動することで、MEMORY.md を簡潔に保ちます。

Claude が MEMORY.md に書き込んだ後、Claude Code はファイルを 200 行および 25KB の読み込み制限に対して測定します。ファイルが制限に近い場合、Claude Code は Claude に短縮するよう促します。エントリごとに 1 行を保持し、詳細をトピックファイルに移動し、古いエントリをマージまたは削除します。ファイルが制限を超えている場合、書き込みは成功しますが、Claude Code はClaude にインデックスを書き直すよう指示するエラーを返します。次の読み込み時に制限を超えるすべてが削除されるためです。

この制限は MEMORY.md にのみ適用されます。Claude Code は最大 4 MiB の CLAUDE.md ファイルを完全に読み込み、より大きいファイルはスキップします。より短いファイルはより良い遵守を生成します。

user_role.md または feedback_testing.md などのトピックファイルは起動時に読み込まれません。Claude は標準ファイルツールを使用してセッション中にオンデマンドで読み込み、情報が必要な場合に読みます。

メイン会話の自動メモリはサブエージェントに読み込まれません。例外はフォークで、これは親会話とシステムプロンプトを継承します。サブエージェント memory フィールドで有効にされたサブエージェント自身の自動メモリは、別のディレクトリです。

Claude はセッション中にメモリファイルを読み書きします。Claude Code インターフェイスで「Saved 2 memories」または「Recalled 2 memories」などのメッセージが表示されたら、Claude は ~/.claude/projects/<project>/memory/ から積極的に更新または読み込みを行っています。

Claude が YAML フロントマターで始まるメモリファイルを書き込む場合、Claude Code は書き込み時刻を ISO 8601 タイムスタンプとして modified フロントマターフィールドに記録します。タイムスタンプは、事実がどの程度最新であるかを、あなたと Claude がメモリを読み戻すときの両方に示します。フロントマターを持つすべてのファイルは、以前のバージョンで作成されたファイルを含め、Claude が次に書き込むときにフィールドを取得します。Claude Code はフロントマターを持たないファイルにフロントマターを追加することはありません。modified フィールドには Claude Code v2.1.214 以降が必要です。

メモリを監査および編集する

自動メモリファイルはプレーンマークダウンで、いつでも編集または削除できます。/memory を実行して、セッション内からメモリファイルを参照して開きます。

`/memory` で表示および編集する

/memory コマンドは、ユーザーおよびプロジェクトスコープ全体にわたる CLAUDE.md、CLAUDE.local.md、およびその他のメモリファイルの場所をリストします。これには、まだ存在しないファイルのユーザーおよびプロジェクト CLAUDE.md エントリも含まれます。また、自動メモリのオン/オフを切り替えたり、自動メモリフォルダを開くオプションを提供したりできます。任意のファイルを選択してエディタで開きます。まだ存在しないファイルを選択すると、最初にそれが作成されます。現在のセッションに実際に読み込まれたファイルを確認するには、/context を実行します。

VS Code などの GUI エディタはファイルを別のウィンドウで開き、ファイルが開いている間もセッションを使用し続けることができます。v2.1.216 より前は、/memory はファイルを閉じるまで応答を待っていました。Vim などのターミナルエディタはターミナルを占有し、終了するまで制御します。

Claude に何かを記憶するよう求めるとき、「常に npm ではなく pnpm を使用する」または「API テストがローカル Redis インスタンスを必要とすることを覚えておく」のように、Claude はそれを自動メモリに保存します。代わりに CLAUDE.md に指示を追加するには、Claude に直接「これを CLAUDE.md に追加する」と尋ねるか、/memory を通じてファイルを自分で編集します。

メモリの問題をトラブルシューティングする

CLAUDE.md と自動メモリに関する最も一般的な問題と、それらをデバッグするための手順を以下に示します。

Claude が CLAUDE.md に従っていない

CLAUDE.md のコンテンツは、システムプロンプト自体の一部ではなく、システムプロンプトの後のユーザーメッセージとして配信されます。Claude はそれを読んで従おうとしますが、特に曖昧または矛盾した指示の場合、厳密な準拠を保証することはできません。

デバッグするには：

• /context を実行し、Memory files の下のリストを確認して、CLAUDE.md と CLAUDE.local.md ファイルが読み込まれたことを確認します。CLAUDE.md ファイルがそこにない場合、Claude はそれを見ることができません。/memory を使用してファイルを開いて編集します。
• 関連する CLAUDE.md がセッションに読み込まれる場所にあることを確認します（CLAUDE.md ファイルをどこに配置するかを選択する を参照）。
• 指示をより具体的にします。「Use 2-space indentation」は「format code nicely」よりも効果的です。
• CLAUDE.md ファイル全体で矛盾する指示を探します。2 つのファイルが同じ動作に対して異なるガイダンスを提供する場合、Claude は任意に 1 つを選択する可能性があります。

指示が各コミットの前やファイル編集後など、特定の時点で実行する必要があるものである場合は、代わりに hook として記述します。Hook はシェルコマンドとして固定されたライフサイクルイベントで実行され、Claude が何をすることに決めたかに関係なく適用されます。

システムプロンプトレベルで指示が必要な場合は、--append-system-prompt を使用します。起動時に渡すため、対話的な使用よりもスクリプトと自動化に適しています。会話を再開するときの動作については、再開された会話でのシステムプロンプトフラグ を参照してください。

AGENTS.md が読み込まれていない

リポジトリに AGENTS.md があり、Claude がそれが何を言っているかを知らないようである場合、通常の原因はプロジェクトパスのどこかに CLAUDE.md があることです。デフォルトでは、Claude は、作業ディレクトリまたはそれより上のディレクトリに CLAUDE.md または CLAUDE.local.md がない場合にのみ AGENTS.md を読み込みます（~/.claude/CLAUDE.md を除く）。以下の順序で確認します：

1. 作業ディレクトリまたはそれより上のディレクトリ（~/.claude/CLAUDE.md を除く）で CLAUDE.md、.claude/CLAUDE.md、または CLAUDE.local.md を探します。見つかった場合、Project instructions を claude-md-and-agents-md に設定しない限り、Claude はそれを AGENTS.md の代わりに読み込みます。
2. claude --version を実行し、v2.1.277 以降であることを確認します。v2.1.281 より前では、Amazon Bedrock 上のセッションやテレメトリが無効なセッションなど、一部のセッションは AGENTS.md を読み込むことができない ため、これらのバージョンでは v2.1.281 以降に更新してください。
3. セッションで /config を入力して設定パネルを開き、Project instructions が claude-md または managed-only に設定されていないことを確認します。そこに設定が表示されない場合、セッションは AGENTS.md を読み込むことができない セッションです。

Claude が AGENTS.md を読み込んだかどうかを確認するには、/memory を実行し、リストでそのパスを探します。

v2.1.280 より前では、/memory と /context は Claude が直接読み込んだ AGENTS.md をリストしていませんでした。これらのバージョンでは、代わりに Claude にプロジェクト指示が何であるかを尋ねます。

見つけた CLAUDE.md を保持したい場合、またはセッションが AGENTS.md を読み込むことができない場合は、AGENTS.md の横に AGENTS.md をインポートする CLAUDE.md を追加します。

自動メモリが何を保存したかわからない

/memory を実行し、自動メモリフォルダを選択して、Claude が保存したものを参照します。すべてはプレーンマークダウンであり、読み取り、編集、または削除できます。

CLAUDE.md が大きすぎる

200 行を超えるファイルはより多くのコンテキストを消費し、準拠を減らす可能性があります。Claude Code は 4 MiB を超えるファイルをスキップします。パススコープルール を使用して、Claude が一致するファイルで作業する場合にのみ指示を読み込むか、すべてのセッションで必要でないコンテンツをトリミングします。@path インポート に分割すると、組織化に役立ちますが、インポートされたファイルは起動時に読み込まれるため、コンテキストは削減されません。

/doctor チェックアップは、チェックインされた CLAUDE.md のトリミングを提案します。コードベースから派生できるコンテンツ（ディレクトリレイアウト、依存関係リスト、アーキテクチャの概要など）を削除し、落とし穴、根拠、およびツールのデフォルトと異なる規約を保持します。トリムチェックには Claude Code v2.1.206 以降が必要です。

`/compact` 後に指示が失われたようです

プロジェクトルート CLAUDE.md は圧縮後も保持されます。/compact の後、Claude はディスクから再度読み込み、セッションに再度注入します。サブディレクトリ内のネストされた CLAUDE.md ファイルと paths: frontmatter を持つルールは、Claude がそれらが適用されるファイルを読み込むときに再度読み込まれます。

圧縮後に指示が消えた場合、それは会話でのみ与えられたか、まだ再度読み込まれていないネストされた CLAUDE.md に存在するか、またはまだ再度マッチしたファイルがないパススコープルールです。会話のみの指示を CLAUDE.md に追加して、それらを永続化させます。完全な内訳については、圧縮後に保持されるもの を参照してください。

効果的な指示を書くためのガイダンスについては、効果的な指示を書く を参照してください。

関連リソース

• 設定をデバッグする: CLAUDE.md または設定が有効にならない理由を診断する
• Skills: オンデマンドで読み込まれる反復可能なワークフローをパッケージ化する
• Settings: 設定ファイルで Claude Code の動作を設定する
• Subagent メモリ: subagent が独自の自動メモリを保持できるようにする