複数のAIコーディングエージェントをチームで併用している開発リーダーや、Claude Code（Anthropic製のCLI型AIコーディングエージェント）の運用ルールを整備している方に向けた話です。指示ファイルの管理方法が1つ変わったことで、チームのドキュメント運用に見直しどころが出てきました。
Anthropicは2025年9月18日付けのアップデート、Claude Code 2.1.277で「AGENTS.md」への対応を発表しました。AGENTS.mdとは、AIコーディングエージェントに対して開発環境の情報やテスト手順、プルリクエストのガイドラインなどをMarkdown形式でまとめておく指示書ファイルです。プロジェクトのルートに置いておくと、エージェントが作業前にこれを読み込んで振る舞いを合わせてくれます。
何が変わったのか
これまでClaude Codeは独自のCLAUDE.mdというファイルだけを読み込む仕組みでした。一方でOpenAIのCodexやGoogleのGemini CLI、Devin、Cursor、GitHub CopilotといったほかのAIエージェントは、業界で緩やかに共有されつつあるAGENTS.mdという形式に対応していました。つまりClaude Codeだけが独自路線を取っていた状態です。
今回の変更は「CLAUDE.mdが存在しないプロジェクトでは、代わりにAGENTS.mdを読み込む」というものです。両方存在する場合はCLAUDE.mdが優先されます。この挙動は/configコマンドの「Project instructions」設定から変更可能です。なおAmazon Bedrock、Google Vertex、Microsoft Foundry経由の利用では、まだこの機能は反映されていないとアナウンスされています。
なぜチーム運用の観点で見逃せないか
スクラムやアジャイル開発のチームでは、コーディング規約・レビュー観点・テスト実行コマンドといった「暗黙知」をどこかに明文化しておく必要があります。従来はREADMEやWikiに書いていたものが、AI時代には「エージェント向けの指示書」という新しいレイヤーとして独立しつつあります。
ここで問題になるのが、ベンダーごとにファイル名がバラバラだと二重管理が発生することです。たとえばフロントエンドチームがCursorとGitHub Copilotを使い、バックエンドチームがClaude Codeを使っている場合、これまではAGENTS.mdとCLAUDE.mdを両方メンテナンスする必要がありました。内容が食い違えば、エージェントごとに挙動が変わってしまい、レビュー時の「なぜこの書き方をしたのか」の説明コストが増えます。
技術的負債の話に近い構図です。指示書という「メタなドキュメント」自体が重複管理されることで、更新漏れという形の負債が静かに積み上がります。1つのファイルに集約できるなら、その負債を減らせるチャンスになります。
既存の指示書運用との比較
AGENTS.mdの発想は、DevOpsの文脈でおなじみの「Infrastructure as Code」に近い側面があります。人間向けの手順書ではなく、ツールが直接解釈できる形式で運用ルールをコード化するという考え方です。README.mdが「人が読んで理解する」ためのものだとすれば、AGENTS.mdは「エージェントが読んで実行判断に使う」ためのものと役割が分かれます。
日本のチームで馴染みのある例で言えば、CIパイプラインの設定ファイル（.github/workflows/*.ymlなど）と同じ位置づけに近いです。人が手作業でやっていたことをツールが読み取れる形式に落とし込む、という流れの延長線上にAGENTS.mdはあります。
複数ベンダーのエージェントを併用するチームが増えるほど、この「共通フォーマット化」の恩恵は大きくなります。逆に単一ベンダーのツールしか使わないチームであれば、緊急性は高くありません。
今日確認できること
チームでの影響範囲を判断するために、まず以下を確認してみてください。
- 現在使っているClaude CodeのバージョンをCLI上で
claude --versionで確認し、2.1.277以降かどうかを見る - プロジェクトルートに
CLAUDE.mdとAGENTS.mdの両方が存在していないか確認する（両方あるとCLAUDE.mdが優先され、AGENTS.mdの更新が反映されない事態になりえる） - Cursor・Codex・Gemini CLIなど他エージェントとの併用がある場合、それぞれが参照しているファイル名を棚卸しする
/configコマンドで「Project instructions」の設定項目を開き、読み込み対象の挙動を確認する- Bedrock・Vertex・Foundry経由でClaude Codeを利用している場合は、この機能がまだ反映されていない前提で運用ルールを別途決めておく
複数エージェントを併用しているチームであれば、この機会にCLAUDE.mdの内容をAGENTS.mdに一本化するかどうかを検討する価値があります。ただし既存のCLAUDE.mdに書かれた内容がClaude Code固有の設定（たとえばツール呼び出しの許可設定など）を含んでいる場合、単純な統合はできない可能性もあるため、内容を精査してから移行判断をするのが安全です。
まとめ
Claude CodeのAGENTS.md対応は、単なる機能追加ではなく、チームのドキュメント運用ルールを見直すきっかけになる変更です。
- CLAUDE.mdが存在しないプロジェクトでは自動的にAGENTS.mdが読み込まれる（優先順位はCLAUDE.md > AGENTS.md）
- Bedrock・Vertex・Foundry経由の利用では未対応なので、環境ごとの挙動差を把握しておく
- 複数のAIエージェントを併用しているチームは、指示書の二重管理が解消できるかを一度棚卸しする
- 移行を決める前に、Claude Code固有の設定が指示書に混在していないか内容を確認する
まずは自分のプロジェクトのバージョンとファイル構成をclaude --versionとディレクトリ確認で洗い出すところから始めてみるとよさそうです。