Claude CodeがAGENTS.mdを読み込むように：2.1.277で変わったこと

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つの指示ファイルを使う方法の記事をご覧ください。

同じリポジトリでClaude Codeとほかのツールを1つか2つ使っている場合、選択する「Project instructions」モードによって、Claude Codeが読み込む指示ファイルが決まります。以下では、4つのモードそれぞれの条件と、以前の設定から切り替える手順を説明します。

ツールの設定に関する資料は、Ailootのドキュメントでご覧いただけます。

バージョン2.1.277で何が変わったのか？#

GitHub上のClaude Code公式プロジェクトのCHANGELOG.mdでは、次のように説明されています。

翻訳：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/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のドキュメントでご覧いただけます。

4つのProject instructionsモード：どれを選ぶか#

表に示す各モードの動作は、Anthropicのドキュメントに記載されています。右の列には、モードを選ぶ際の推奨事項を示します。

インターフェースを使わずに、settings.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より前のバージョン向けの手順で@インポートの使い方を確認できます。この方法は現在も使えます。

/configにProject instructionsが表示されないのはなぜか#

まず、claude --versionコマンドでバージョンを確認してください。2.1.277未満なら、Claude Codeを更新します。バージョンが条件を満たしているのにセクションが表示されない場合は、上記のほかの理由を確認してください。この機能が利用できない間は、CLAUDE.md内で@AGENTS.mdをインポートする方法が引き続き有効な代替策です。

以前の@AGENTS.mdインポートはどうすればよいか#

次の手順は以前の設定によって異なります。まず、前のセクションの説明に従って、セッションでこの機能が使えることを確認してください。

• @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が読み込まれたことを確認する方法#

通常の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を肥大化させずに設定する方法の分析をご覧ください。指示の構成を扱っています。AGENTS.mdの読み込み条件は上で説明しています。セッション間の作業メモについては、Claude Codeを第2の脳として使う方法の分析をご覧ください。プロジェクト指示に個人用メモリを重ねる方法を扱っています。

次にすること#

この機能は2026年9月18日にバージョン2.1.277でリリースされました。Anthropicは今後のリリースでモードの詳細を明確にする可能性があります。重要なプロジェクトの設定を変更する前に、この記事を最新の/configの表示内容と公式変更履歴と照らし合わせてください。