AIコーディングツールを替えるたびに、同じ開発ルールを別ファイルへ書き直す。この地味な二重管理が、ようやく減らせそうです。
Claude Code v2.1.277は、プロジェクトにCLAUDE.mdがない場合、AGENTS.mdをプロジェクト指示として読むようになりました。すでにCodexなどでAGENTS.mdを使っているチームなら、Claude Codeのためだけに説明書を複製せずに済みます。
ただし、ファイルを置けば統一運用が完成するわけではありません。既存のCLAUDE.mdがあるプロジェクトでは、今回のフォールバックは働きません。移行は「追加」より「正本を決める」作業です。
何が変わったのか
Anthropicが2026年9月18日に公開したClaude Code v2.1.277では、プロジェクト内にCLAUDE.mdが見つからないとき、AGENTS.mdを代わりに読みます。読み込むファイルは/configの「Project instructions」から変更できます。
公式リリースには制約も書かれています。この対応は、公開時点ではAmazon Bedrock、Google Vertex AI、Microsoft Foundryでは利用できません。これらの環境を使う会社は、検証せずにCLAUDE.mdを消すべきではありません。
AGENTS.mdの公式サイトは、このファイルを「エージェント向けのREADME」と説明しています。書式は普通のMarkdownです。セットアップ、テスト、コード規約、PR前の確認など、人にはREADMEで説明しきれない実行ルールを置けます。
会社で効くのは、ツール対応より二重管理の削減
開発現場では、ルールそのものより更新漏れが事故を生みます。片方にはpnpm test、もう片方には古いnpm test。一方だけに「本番DBへ接続しない」と書かれている。AIは読んだ指示に沿って動くので、説明書の差分がそのまま作業差になります。
複数のコーディングエージェントを併用するなら、共通ルールの正本をAGENTS.mdへ寄せる価値があります。特定ツールだけに必要な設定まで無理に共通化する必要はありません。共通部分と専用部分を分けます。
AGENTS.md：ビルド、テスト、禁止操作、ディレクトリ構成、完了条件- ツール固有設定：権限モード、モデル、フック、接続先
- CI：テストや静的解析など、文章ではなく機械で強制する条件
この分け方なら、AGENTS.mdは業務の入口、CIは最後の検査になります。文章だけで安全を担保しない点が肝です。
移行前に見るべき3つの衝突
最初に、リポジトリ内のCLAUDE.md、CLAUDE.local.md、.claude/rules/を確認します。Anthropicの公式文書では、CLAUDE.mdはプロジェクト、ユーザー、組織など複数の範囲に置けます。自動記憶も別に読み込まれます。ルートの1ファイルだけ見て「指示はこれだけ」と判断すると、見落とします。
次に、同じ命令が違う言い方で重複していないかを見ます。たとえば「変更後にテスト」と「小変更はテスト不要」が別の場所にあれば、エージェントは場面ごとに違う判断をします。重複はまとめ、例外には対象パスや条件を書きます。
最後に、指示と強制設定を分けます。公式文書も、CLAUDE.mdは設定の強制ではなくコンテキストだと説明しています。絶対に止めたい操作は、PreToolUse hookやCI、権限設定へ移します。
30分でできる受け入れテスト
いきなり全リポジトリを移行するより、小さな検証用ブランチで読み込み差を確かめる方が安全です。
- 現在の
CLAUDE.mdと関連ルールを退避し、内容を一覧化する。 - 共通ルールだけを
AGENTS.mdへ移す。最初は20〜40行程度に絞る。 - Claude Code v2.1.277で
/configを開き、「Project instructions」にAGENTS.mdが出るか確認する。 - 「テストコマンドを答える」「変更禁止フォルダを答える」「小さな修正後に検査する」の3ケースを実行する。
- 別の対応エージェントでも同じ3ケースを試し、結果の差分を記録する。
判定は単純です。共通ルールを両方が読み、テストと禁止事項が一致すれば限定GO。どちらかが別ファイルを優先する、またはBedrock・Vertex・Foundryを使っているならHOLDです。現行ファイルを残したまま、対象環境の対応を待ちます。
この変更で解決しないこと
AGENTS.md対応は、指示の置き場所を揃える機能です。指示が正しいこと、最新版であること、エージェントが毎回その通りに動くことまでは保証しません。
長すぎるファイルも逆効果です。Anthropicは、CLAUDE.mdを具体的かつ簡潔に書くよう案内しています。手順が長い作業はスキルへ、特定フォルダだけの規則はパス別ルールへ分ける考え方は、AGENTS.mdを正本にするときも変わりません。
私は、まず「全ツール共通の最低限」だけをAGENTS.mdへ置く運用を勧めます。全部を1ファイルへ詰め込むと、今度は正本が情報の墓場になります。
最初の一手
既存の指示ファイルを消す前に、共通・Claude専用・機械で強制の3列に分けてください。共通列だけをAGENTS.mdへ移し、検証用ブランチで受け入れテストを通す。これなら戻せます。
今回の更新は、AIツールの乗り換えを簡単にする小さな互換性改善です。実務での価値は、説明書を増やさず、同じルールを複数のエージェントへ渡せることにあります。
一次情報
リリース仕様は2026年9月19日確認。限定GO/HOLDと受け入れテストは、公式仕様を基にしたmonobloの運用提案です。