# Claude CodeがAGENTS.mdを読み込むように：2.1.277で変わったこと
> 2026年9月18日、Claude Code 2.1.277でAGENTS.mdが直接サポートされました。ファイルが読み込まれる条件、4つのモードからの選び方、インポートへの対処を解説します。
Source: https://ailoot.ai/blog/ja/claude-code-agents-md-support/
Canonical: https://ailoot.ai/blog/ja/claude-code-agents-md-support/
Language: ja
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-041
Revision: sha256-aa68aef1ca8f46e99796f1b9246ad6f7b89d019ff2463abbffba3aadf42cadc7
2026年9月18日、Claude Code 2.1.277で`AGENTS.md`のサポートが追加されました。セッションと作業ディレクトリでこの機能が利用可能で、ディレクトリ階層の上位に`CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md`のいずれも存在しない場合、Claude Codeは手動でインポートしなくても、デフォルトで`AGENTS.md`を読み込みます。以前は、`CLAUDE.md`内で`@AGENTS.md`をインポートするか、`CLAUDE.md`から`AGENTS.md`へのシンボリックリンクを使っていました。詳しくは、[複数のエージェントで1つの指示ファイルを使う方法](https://ailoot.ai/blog/ja/agents-md-claude-md-one-instruction-file/)の記事をご覧ください。
同じリポジトリでClaude Codeとほかのツールを1つか2つ使っている場合、選択する「Project instructions」モードによって、Claude Codeが読み込む指示ファイルが決まります。以下では、4つのモードそれぞれの条件と、以前の設定から切り替える手順を説明します。
ツールの設定に関する資料は、[Ailootのドキュメント](https://ailoot.ai/docs/)でご覧いただけます。
[Ailootガイド](https://ailoot.ai/docs/)
## バージョン2.1.277で何が変わったのか？
重要なポイント
2026年9月18日現在、作業フォルダーから上位に向かうディレクトリ階層のどこにも`CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md`がない場合、Claude Codeはデフォルトで`AGENTS.md`を読み込みます。そのようなファイルが存在する場合、Project instructionsによる`AGENTS.md`の自動読み込みは有効になりません。`CLAUDE.md`からの明示的な`@AGENTS.md`インポートは引き続き機能します。ユーザーレベルの`~/.claude/CLAUDE.md`、組織が管理する`CLAUDE.md`、`.claude/rules/`は、プロジェクトファイルの選択とは無関係に読み込まれます。モードは`/config`で切り替えます。この機能はBedrock、Vertex、Foundryではまだ利用できません。
GitHub上のClaude Code公式プロジェクトのCHANGELOG.mdでは、次のように説明されています。
AGENTS.mdのサポートを追加：CLAUDE.mdのないプロジェクトでは、Claude Codeは代わりにAGENTS.mdを読み込みます。「Project instructions」の設定は/configで変更できます（Bedrock、Vertex、Foundryではまだ利用できません）
— Anthropic、claude-code CHANGELOG.md commit、ca02e7d、https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3
翻訳：`AGENTS.md`のサポートが追加されました。`CLAUDE.md`のないプロジェクトでは、Claude Codeが代わりに`AGENTS.md`を読み込みます。この設定は`/config`の「Project instructions」で切り替えられます（Bedrock、Vertex、Foundryではまだ利用できません）。
このバージョンより前は、作業フォルダーとその上位に`CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md`がないというだけでは、`AGENTS.md`は読み込まれませんでした。明示的なインポート、シンボリックリンク、または手動のフックが必要でした。現在は、機能を利用できる場合、エージェントがファイルを自動的に読み込みます。
## AGENTS.mdの自動読み込みを妨げるファイル
重要なポイント
デフォルトモードでは、作業ディレクトリとその上位で`CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md`が確認されます。個人用の`~/.claude/CLAUDE.md`、組織が管理する`CLAUDE.md`、`.claude/rules/`内のファイルは、`AGENTS.md`の読み込みを妨げず、併せて読み込まれます。
コーディングスタイルの設定を記した個人用の`~/.claude/CLAUDE.md`があっても、Claude Codeによるプロジェクトの`AGENTS.md`の読み込みは妨げられません。ただし、Gitに追加せず個人的なメモに使っている場合でも、作業フォルダー内に`CLAUDE.local.md`があると、デフォルトモードでの`AGENTS.md`の自動読み込みは妨げられます。明示的なインポートは引き続き機能します。両方のファイルを直接読み込むには、モードを切り替える必要があります。
Project instructionsで直接読み込むモードを選択しており（下記「4つのProject instructionsモード：どれを選ぶか」を参照）、作業ディレクトリとその上位に`CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md`がない場合、Claude Codeはセッション開始時にそれらのディレクトリにあるすべての`AGENTS.md`と`.claude/AGENTS.md`を読み込みます。妨げるファイルがない場合、ドキュメントによると、対話セッションには次のような行が表示されます。
```
no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md
```
サブディレクトリ内の`AGENTS.md`は、Readツールでその場所のファイルをClaudeが開いたときに読み込まれます。`claude-md-or-agents-md`モードでは、そのサブディレクトリに`CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md`がない場合に限られます。`claude-md-and-agents-md`について、ドキュメントでは一般則として、各ディレクトリで`CLAUDE.md`を先に、続いて`AGENTS.md`を読み込むと説明しています。`AGENTS.local.md`、`AGENTS.override.md`、`.agents/`ディレクトリ内のものは自動では読み込まれません。
プロジェクトのコンテキストを含む指示ファイルなど、AIエージェントの作業環境を設定する資料は、[Ailootのドキュメント](https://ailoot.ai/docs/)でご覧いただけます。
[Ailootガイド](https://ailoot.ai/docs/)
## 4つのProject instructionsモード：どれを選ぶか
重要なポイント
`/config`コマンドのProject instructionsセクションには4つの値があります。`claude-md-or-agents-md`（デフォルト。どちらか一方）、`claude-md-and-agents-md`（両方を併せて読み込み）、`claude-md`（プロジェクトに`AGENTS.md`しかなくても、`CLAUDE.md`のみを自動で読み込み）、`managed-only`（起動時には組織が管理する`CLAUDE.md`と自動メモリのみで、プロジェクトや個人のファイルは読み込まない）です。変更は次に送信するメッセージから有効になり、新しいセッションにも適用されます。
表に示す各モードの動作は、Anthropicのドキュメントに記載されています。右の列には、モードを選ぶ際の推奨事項を示します。
| 値 | Claude Codeが読み込むもの | 使用する状況 |
|----|----|----|
| `claude-md-or-agents-md` | `CLAUDE.md`。または、作業ディレクトリとその上位に`CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md`がなければ`AGENTS.md` | リポジトリで2つのファイルのうち一方だけを使い、上位に読み込みを妨げるファイルがない場合のデフォルト |
| `claude-md-and-agents-md` | 両方のファイルを併せて読み込みます。各ディレクトリで、まず`CLAUDE.md`、次に`AGENTS.md` | すべてのツールで使う共有`AGENTS.md`と、Claude専用の短い`CLAUDE.md`が必要な場合。または、`CLAUDE.local.md`が存在する場合でも`AGENTS.md`を読み込む必要がある場合 |
| `claude-md` | `CLAUDE.md`のみ。`AGENTS.md`しかない場合でも、Project instructionsによる`AGENTS.md`の自動読み込みは無効です（ただし、`CLAUDE.md`から明示的に`@AGENTS.md`をインポートすれば機能します） | `AGENTS.md`が別のツール用に書かれており、Claudeを混乱させる可能性がある場合 |
| `managed-only` | セッション開始時には組織が管理する`CLAUDE.md`と自動メモリのみを読み込みます。プロジェクト、ローカル、ユーザーの`CLAUDE.md`、`.claude/rules/`、すべての`AGENTS.md`ファイルは初期読み込み対象から除外されます。ただし、サブディレクトリにある`CLAUDE.md`と`.claude/rules/`ファイルは、Claudeがその場所のファイルを開いたときに後から読み込まれます。このモードが制限するのは初期読み込み対象であり、プロジェクトファイルからの完全な隔離にはなりません | プロジェクトに`CLAUDE.md`または`AGENTS.md`があるかどうかにかかわらず、Claude Codeのセッション開始時に読み込む指示の範囲を組織として管理したい場合 |
インターフェースを使わずに、`settings.json`からモードを選ぶこともできます。
```json
{
"pluginConfigs": {
"agents-md@builtin": {
"options": {
"instructionFiles": "claude-md-and-agents-md"
}
}
}
}
```
Claude Codeは、この値を`project`および`local`設定では無視します。Anthropicのドキュメントによると、`~/.claude/settings.json`、`--settings`ファイル、または組織が管理する設定で指定できます。
1つのリポジトリで複数のAIツール向けに共有指示ファイルをすでに設定している場合は、[2.1.277より前のバージョン向けの手順](https://ailoot.ai/blog/ja/agents-md-claude-md-one-instruction-file/)で`@`インポートの使い方を確認できます。この方法は現在も使えます。
## /configにProject instructionsが表示されないのはなぜか
重要なポイント
Anthropicのドキュメントによると、次の理由でProject instructionsセクションが表示されない場合があります。
- Claude Codeのバージョンが2.1.277未満である。
- Anthropicからセッションに機能フラグが届いていない。たとえば、Bedrockや別のサードパーティプロバイダーを使っている場合、またはテレメトリーが無効になっている場合。
- 古いバージョンからインストールまたは更新した直後の最初のセッションである。これだけが理由であれば、次のセッションで機能が表示されます。ただし、`AGENTS.md`自体が読み込まれるのは、選択したモードの条件を満たす場合に限られます。
- 組み込みの`agents-md`プラグインが`/plugin`で無効になっている。
まず、`claude --version`コマンドでバージョンを確認してください。2.1.277未満なら、Claude Codeを更新します。バージョンが条件を満たしているのにセクションが表示されない場合は、上記のほかの理由を確認してください。この機能が利用できない間は、`CLAUDE.md`内で`@AGENTS.md`をインポートする方法が引き続き有効な代替策です。
## 以前の@AGENTS.mdインポートはどうすればよいか
重要なポイント
`CLAUDE.md`内の`@AGENTS.md`インポートとシンボリックリンクはそのまま残せます。どのモードでも、ファイルが二重に読み込まれることはありません。`CLAUDE.md`を残す場合は、「AGENTS.mdを読んで」という文章による依頼をインポートに置き換えてください。ファイルを削除する前に、必要な指示をすべて保存し、選択したモードの条件を確認してください。直接読み込むモードに切り替える場合は、`AGENTS.md`の内容を手動で出力していた`SessionStart`フックを削除してください。そうしないと、ファイルの内容が二重にコンテキストに入ります。その後、新しいセッションで読み込みを確認します。確認方法はバージョンと、読み込みを妨げるファイルの有無によって異なります。
次の手順は以前の設定によって異なります。まず、前のセクションの説明に従って、セッションでこの機能が使えることを確認してください。
- **`@AGENTS.md`をインポートする`CLAUDE.md`がある場合。** そのままでも構いません。Claude Codeは、どのProject instructionsの値でもファイルを二重に読み込みません。`CLAUDE.md`の削除は任意です。インポートによって、すでにClaudeは`AGENTS.md`の内容を利用できます。`/memory`を使って、インポート経由で読み込まれていることを引き続き確認してください。指示の内容をClaudeに直接尋ねるだけでは、確認としては不十分です。
- **`AGENTS.md`を読むよう文章で依頼する`CLAUDE.md`がある場合。** そのような依頼はインポートではなく、それだけでファイルが読み込まれる保証はありません。`CLAUDE.md`を残す場合（ほかのツールもそれを読み込む場合など）は、その文言を`@AGENTS.md`インポートに置き換えてください。`CLAUDE.md`を完全に削除し、`claude-md-or-agents-md`モードを選ぶ場合は、まず`CLAUDE.md`に固有の指示がないこと、作業ディレクトリとその上位に別の`CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md`がないことを確認してください。そうでなければ、Claude Codeは`AGENTS.md`ではなく残ったファイルを読み込み続けます。削除後は、切り替えが反映されたことを確認してください。読み込みを妨げるファイルが残っていない場合、対話セッションに`AGENTS.md loaded`という行が表示されます。`CLAUDE.md`を残して`claude-md-and-agents-md`モードを使っている場合は、バージョン2.1.280以降で`/memory`を確認してください。Claudeへの直接の質問では、直接の読み込みとインポートを区別できません。
- **`AGENTS.md`への`CLAUDE.md`シンボリックリンクがある場合。** そのままでも構いません。どのモードでも二重に読み込まれることはありません。`claude-md-or-agents-md`モードでリンクを削除する前に、必要な指示が保持されていること、作業ディレクトリとその上位に別の`CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md`がないことを確認してください。読み込みは同じ方法で確認します。読み込みを妨げるファイルがない場合はセッション開始時の`AGENTS.md loaded`行で、またはバージョン2.1.280以降なら`/memory`で確認できます。`claude-md-and-agents-md`モードで`CLAUDE.md`を残す場合、Claudeへの直接の質問は不確かな確認にすぎません。エラーがないだけでは、読み込みが確認されたことにはなりません。
- **`AGENTS.md`の内容を手動で出力する`SessionStart`フックがある場合。** ファイルを直接読み込むと、このフックによって同じ内容がコンテキストに二重に入ります。フックの実行中は、「指示には何が書かれていますか」という質問では直接読み込みを確認できません。Claudeがフックの追加したテキストに基づいて答える可能性があるためです。切り替えは次の順で行います。
1. 機能が使えることを確認します。バージョンが2.1.277以降であること、セッションに機能フラグが届いていること、プラグインが有効であること、インストールまたは更新後の最初のセッションが完了していることを確認します。直接読み込むモードを選びます。`claude-md`と`managed-only`は選ばないでください。デフォルトモードでは、読み込みを妨げるファイルがないことも確認します。
2. フックを削除します。
3. セッションを閉じて、新しく開きます。`SessionStart`フックは起動時にテキストを追加するため、すでに開いているセッションのコンテキストにはその内容が残っています。そのようなセッションでClaudeに指示の内容を尋ねても、直接読み込みの確認にはなりません。
4. 新しいセッションで読み込みを確認します。バージョン2.1.280以降では、`/memory`に`AGENTS.md`のパスが表示されます。バージョン2.1.277～2.1.279では、読み込みを妨げるファイルがない場合、起動時に`AGENTS.md loaded`の行を探してください。ドキュメントでは、これは`CLAUDE.md`が見つからなかった場合に特化して説明されています。`CLAUDE.md`を残して`claude-md-and-agents-md`モードを使う場合、確認には制限があります。このバージョンでは`/memory`に`AGENTS.md`が表示されず、このケースの読み込みを示す行もドキュメントに記載されていません。また、指示を言い換えても、直接の読み込みと`CLAUDE.md`内の`@`インポートを区別できません。その場合は2.1.280以降に更新して、`/memory`を確認してください。
## AGENTS.mdが読み込まれたことを確認する方法
重要なポイント
バージョン2.1.280以降では、Project instructions経由で読み込まれた`AGENTS.md`は`/memory`と、`/context`コマンドのMemory files一覧に表示されます。バージョン2.1.277～2.1.279では、コマンド自体は機能し、読み込まれた`CLAUDE.md`やほかのメモリファイルも表示されますが、`AGENTS.md`はそこに表示されません。これらのバージョンでは、読み込みを妨げるファイルがなければ、セッション起動時に`AGENTS.md loaded`の行があるか確認してください。Claudeに指示の内容を尋ねるだけでは、確認としては不十分です。直接読み込んだのか、`@`インポートしたのかを回答から区別できず、`SessionStart`フックが追加したテキストに基づいている可能性もあります。そのため、そのようなフックを削除した後、新しいセッションでのみ質問するのが適切です。
通常の`CLAUDE.md`とは異なり、もう2つ違いがあります。この形式の`AGENTS.md`では`InstructionsLoaded`フックは実行されません（`CLAUDE.md`から`@`構文でインポートした`AGENTS.md`、または`CLAUDE.md`のシンボリックリンクで接続された`AGENTS.md`では実行されます）。また、`--add-dir`フラグと`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`変数で追加されたディレクトリは、そのディレクトリの`CLAUDE.md`だけを読み込みます。`AGENTS.md`は含まれません。
大きなプロジェクト指示ファイルの内容を確認する必要がある場合は、[CLAUDE.mdを肥大化させずに設定する方法の分析](https://ailoot.ai/blog/ja/claude-md-template/)をご覧ください。指示の構成を扱っています。`AGENTS.md`の読み込み条件は上で説明しています。セッション間の作業メモについては、[Claude Codeを第2の脳として使う方法の分析](https://ailoot.ai/blog/ja/claude-code-second-brain/)をご覧ください。プロジェクト指示に個人用メモリを重ねる方法を扱っています。
## 次にすること
この機能は2026年9月18日にバージョン2.1.277でリリースされました。Anthropicは今後のリリースでモードの詳細を明確にする可能性があります。重要なプロジェクトの設定を変更する前に、この記事を最新の`/config`の表示内容と公式変更履歴と照らし合わせてください。
### 出典
- [Claude Code、2.1.277の記載を含むGitHub上のCHANGELOG.md commit（2026年9月18日）](https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3)
- [Claude Code Docs：Claudeがプロジェクトを記憶する仕組み - AGENTS.mdのセクション](https://code.claude.com/docs/en/memory)
[Ailootガイド](https://ailoot.ai/docs/)
[Ailootに移動](https://ailoot.ai/)
## Claude CodeがAGENTS.mdを読み込むように：2.1.277で変わったこと：よくある質問
### AGENTS.mdがあるのに読み込まれないのはなぜですか？
デフォルトモードでは、作業ディレクトリか上位階層にCLAUDE.md、.claude/CLAUDE.md、CLAUDE.local.mdがあると、AGENTS.mdは自動選択されません。Claude Codeのバージョン、機能の提供状況、/configのProject instructionsモードも確認してください。
### 手動フックを外した後、直接読み込まれたことをどう確認しますか？
以前のSessionStart出力を含まない新しいセッションを開きます。2.1.280以降は/memoryか/contextのMemory filesを確認します。2.1.277〜2.1.279では、妨げるCLAUDE.mdがない場合の起動時読み込み表示を確認してください。Claudeの言い換え回答だけでは弱い証拠です。
## Ailoot · 企業とそのプロジェクト群
Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。
企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。
Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。