9月19日、Runtime Wireが「Claude Code adds AGENTS.md fallback for repositories shared across coding agents」と題した記事を公開した。Anthropicのコーディングエージェント「Claude Code」が、複数のAIエージェント間で共有されるAGENTS.mdファイルを読み込めるようになったアップデートについて詳しく紹介されている。
複数エージェントが共存するリポジトリでの「重複管理」問題
コーディングエージェントを実務で使うチームが直面する地味な問題がある。同一リポジトリにClaude Code、Codex、Cursor、Gemini CLIなど複数のエージェントを導入すると、それぞれに向けた指示ファイルを別々に管理しなければならない。ビルドコマンドやテスト要件、コード規約といった情報が各エージェント向けに重複して存在し、「一方を更新してもう一方を忘れる」という単純なミスが起きやすい。
Anthropicは9月18日にリリースしたv2.1.277でこの問題に対処した。Claude Codeが、Claude専用のCLAUDE.mdが存在しないリポジトリでAGENTS.mdをフォールバックとして読み込めるようになった。
Claude Codeチームのエンジニア、Thariq Shihipar（@trq212）がXで発表し、公式リリースノートでも確認できる。
AGENTS.mdとは何か
AGENTS.mdは、リポジトリルートやサブディレクトリに配置してエージェントへの指示を記述するスキーマフリーのMarkdownファイルだ。現在はagents.mdとしてフォーマットのドキュメントが公開されており、Codex、Cursor、Devin、Gemini CLI、GitHub Copilot、VS Codeといったツールがすでに対応している。Claude Codeはここに加わった形だ。
AGENTS.mdの来歴や普及状況の詳細については元記事を参照されたい。
動作の詳細：既存のCLAUDE.mdは引き続き優先
挙動のポイントは以下の通りだ。
CLAUDE.mdが存在する場合：従来通りそちらを優先して読み込む。既存の設定に影響はない。CLAUDE.mdが存在しない場合：AGENTS.mdをフォールバックとして使用する。- 動作は
/configの「Project instructions」設定で変更できる。 - Amazon Bedrock、Google Vertex AI、Microsoft Foundryでは現時点で未対応。
「mod」として実装された拡張レイヤーの予告
今回のアップデートは単なるファイル名の別名対応にとどまらない。Shihiparによると、AGENTS.mdサポートはAnthropicが準備中の「mod」という仕組みを使ったネイティブ実装として作られており、そのソースコードとドキュメントがGitHubに公開されている。
modが提供する指示の読み込みモードは4種類だ。
CLAUDE.mdのみを読み込むAGENTS.mdをフォールバックとして使う（デフォルト）- 両方のファイルを同時に読み込む（
CLAUDE.mdとAGENTS.mdの双方が存在する場合にどちらも反映させたいケースで使用する） - 一元管理された指示ファイルのみに限定する（個別リポジトリの指示ファイルを無視し、組織レベルの設定だけを使いたい場合に有効）
重要な点として、リポジトリ内の.claude/settings.jsonからはmodのオプションを設定できない。チェックインされたコードがユーザーや組織の指示読み込みポリシーを上書きできないよう、管理上の制御はAnthropicが保持している。
modの一般提供時期は現時点では未定だが、今回の実装がその具体的な形を初めて示したものとなっている。
既存リポジトリへの影響
エンジニアチームにとっての即効性はシンプルだ。他のコーディングエージェント向けにすでにAGENTS.mdを整備済みのリポジトリであれば、Claude Codeを追加導入するだけでそのまま指示を読み込ませられる。専用ファイルの追加も、インポートの記述も不要になった。
詳細はClaude Code adds AGENTS.md fallback for repositories shared across coding agentsを参照していただきたい。
