- Claude Code 2.1.277でAGENTS.mdに対応、CLAUDE.mdが無い場合に読み込む
- AGENTS.md対応はClaude Code modsの組み込みmodとして実装されている
- modsはClaude Codeのハーネスをカスタマイズする今後の仕組みと説明
何が発表されたのか
AnthropicのThariq Shihipar氏は、Claude CodeにAGENTS.mdのサポートを追加すると発表しました。バージョン2.1.277から、あるフォルダ内にCLAUDE.mdが存在しない場合、ClaudeはAGENTS.mdを探して利用します。この発表は、Simon Willison氏が2026年9月18日のブログ記事で引用として取り上げたものです。
AGENTS.mdは、プロジェクト固有の指示をエージェントに与えるためのファイルという位置づけになります。原文で示されているのは、CLAUDE.mdが無い場合にAGENTS.mdを見るという条件だけです。そのため、両方のファイルが存在するときの挙動については原文に明記がありません。
Claude Code modsとは
AGENTS.md対応は、Anthropicが進めている「Claude Code mods」という仕組みの上に作られています。Shihipar氏の説明では、modsはClaude Codeの「ハーネス」、つまりエージェントを動かす土台の部分をカスタマイズする今後の方法とされています。今回のAGENTS.md対応は、その中の組み込みmod(built-in mod)という扱いです。
さらに、ユーザー自身がプロジェクト指示のカスタム版を作れるようにもなると述べられています。modのソースコードは公開されているとの記述もあります。ただし、modsの提供開始時期やAPIの詳細、カスタムmodの作成手順は原文では触れられていません。
読み込みの優先順位
原文で示されている条件は「フォルダ内にCLAUDE.mdが無い場合」です。これはCLAUDE.mdが優先され、AGENTS.mdはその代替として扱われる設計だと読み取れます。既存プロジェクトでCLAUDE.mdを運用している場合、挙動がすぐに変わるわけではないと考えられます。
一方で、AGENTS.mdはエージェントごとに指示ファイル名が異なる状況を揃える動きとして受け止められます。複数のコーディングエージェントを併用するチームでは、指示ファイルの二重管理を減らせる可能性があります。ただしこの点は原文で説明されている内容ではなく、位置づけからの見方です。
現時点で不明な点
原文は短い引用であるため、AGENTS.mdの書式や探索範囲、階層構造への対応といった仕様は示されていません。modsが一般に使えるようになる時期も明記されていません。カスタムmodを作るための仕組みやドキュメントの有無も、この引用からは分かりません。
また、バージョン2.1.277がいつ提供されるのかについても、引用が投稿された2026年9月18日以外の情報はありません。実際に導入を判断するには、Anthropicの公式ドキュメントやリリースノートを確認する必要があります。
Starting today in version 2.1.277, if there is no CLAUDE.md in a folder, Claude will check for and use AGENTS.md. AGENTS.md support is built off of Claude Code mods.
本日からバージョン2.1.277で、フォルダ内にCLAUDE.mdが無い場合、ClaudeはAGENTS.mdを探して使用します。AGENTS.mdのサポートはClaude Code modsを土台に作られています。
今後の見通し
Claude Code modsが実際に提供されれば、AGENTS.md対応はその最初の適用例のひとつとして位置づけられるとみられます。今後は、modsの一般提供時期、カスタムmodの作成方法、AGENTS.mdとCLAUDE.mdの解決順序の詳細が公開されるかどうかが判断材料になります。複数のエージェントを併用するチームにとっては、指示ファイルの共通化がどこまで進むかが注目点になるとみられます。提供時期や仕様が明らかになるまでは、公式ドキュメントの更新を追う段階といえそうです。
日本の開発者・IT企業にとっての意味
日本の開発現場では、Claude Codeと他のコーディングエージェントを併用するケースが増えつつあります。指示ファイルの名前がツールごとに異なると、同じ内容を複数ファイルに書いて保守することになります。AGENTS.mdが読まれるようになれば、共通の指示を1か所に寄せられる可能性があります。ただし優先順位はCLAUDE.mdが先と読めるため、既存のCLAUDE.mdを残したままAGENTS.mdを追加しても、意図した指示が反映されないおそれがあります。導入時はどちらのファイルが読まれているかを確認する運用が望ましいといえます。またmodsの仕組みが公開されれば、プロジェクト指示の解決方法を自前で差し替えられるようになる可能性があり、社内テンプレートの標準化にも影響しそうです。
気になる点
- CLAUDE.mdとAGENTS.mdが同じフォルダにある場合はどちらが使われますか
- 原文では、AGENTS.mdが使われる条件は「フォルダ内にCLAUDE.mdが無い場合」とされています。したがってCLAUDE.mdが優先され、両方があるときはAGENTS.mdが読まれないと読み取れます。ただし両方が存在する場合の明示的な説明は原文にないため、公式ドキュメントでの確認が望ましいです。
- 既存プロジェクトで設定を変える必要はありますか
- バージョン2.1.277以降でも、CLAUDE.mdがあるプロジェクトでは従来どおりの挙動になるとみられます。AGENTS.mdを使いたい場合は、CLAUDE.mdを置かない、あるいは内容を整理する判断が必要になります。移行手順は原文に記載がなく、現時点では公表されていません。
- Claude Code modsでは何ができるのですか
- 原文では、Claude Codeの「ハーネス」をカスタマイズする今後の仕組みと説明され、AGENTS.md対応はその組み込みmodだとされています。ユーザーがプロジェクト指示のカスタム版を作れるようにもなるとの記述があります。提供時期や具体的な作り方は示されていません。
用語解説
- CLAUDE.md
- Claude Codeがプロジェクト固有の指示を読み込むために使うファイル。フォルダ内に置いて運用する。
- AGENTS.md
- エージェントにプロジェクトの指示を与えるためのファイル。今回、Claude CodeがCLAUDE.mdの代替として読む対象になった。
- Claude Code mods
- Claude Codeの動作基盤をカスタマイズするためにAnthropicが準備中の仕組み。AGENTS.md対応はその組み込みmod。
- ハーネス
- 原文でClaude Code modsがカスタマイズ対象としている部分。エージェントを動かす土台を指すとみられる。
出典
Quoting Thariq Shihipar
AI導入も顧問も、お任せください
何から手をつけるか、どこまでAIに任せるか。自社の業務に合わせて整理し、導入から運用まで伴走します。相談だけでも構いません。
AI導入について相談する