Claude Code 2.1.277 が AGENTS.md フォールバックと機能フラグ制限を追加

2026年9月18日に配布された Claude Code のバージョン2.1.277は、従来の CLAUDE.md が見当たらないリポジトリに対して新たに導入された AGENTS.md という Markdown ファイル形式をネイティブにサポートするようになり、開発者はリポジトリ全体の開発コンテキスト、テストコマンド、貢献ルールなどを一元的に管理できるようになりました。この機能追加により、プロジェクトの指示情報が散在することなく、単一のファイルで統合的に提供されます。

具体的には、プロジェクトルートに CLAUDE.md が存在しない場合、Claude Code は自動的に同一ディレクトリに配置された AGENTS.md を検出し、各ツールごとに個別の設定ファイルを複製する必要がなくなります。これにより、指示メタデータの唯一の情報源として AGENTS.md が維持され、開発フローがシンプル化されます。

設定と制御

管理者はツール内の /config メニューから CLAUDE.md と AGENTS.md の使用有無を切り替えることができ、選択内容はローカル設定として永続化されます。ただし、実際の有効化はリモートで取得される機能フラグに依存しており、Korben の報告によれば、組み込みプラグインがこのフラグを読み込んで初めて AGENTS.md のサポートが有効になる仕組みです。

機能フラグ方式であるため、不要なトラフィックやテレメトリを無効化した環境ではフラグが取得できず、Claude Code は自動的に従来通りの挙動に戻ります。この場合、AGENTS.md は無視され、ユーザーには何も通知されない「静かな」フォールバックが発生します。

このような状況への回避策としては、最小限の CLAUDE.md を残しつつ、@AGENTS.md 構文を用いて AGENTS.md をインポートさせる方法があります。この手法を採用すれば、たとえフラグ取得が失敗しても、明示的にインポート指示があるためフォールバックが機能し、指示情報の欠落を防げます。

互換性の現状

本アップデートのロールアウト時点では、Amazon Bedrock、Google Vertex AI、Microsoft Foundry といった主要クラウドバックエンドとの統合は含まれていません。そのため、これらのプラットフォームを利用しているユーザーは引き続き CLAUDE.md もしくは外部ツールに依存した運用を続ける必要があります。

一方で、既に Codex、Gemini CLI、Devin、Cursor、GitHub Copilot など複数の開発支援ツールが AGENTS.md を認識できるよう実装されており、エコシステム全体で指示の重複を減らす効果が期待されています。これにより、チーム全体の指示管理コストが削減され、作業の一貫性が向上します。

チーム向け実践チェックリスト

• /config で AGENTS.md が指示ソースとして選択されていることを確認
• 機能フラグがブロックされる可能性がある場合は CLAUDE.md を @AGENTS.md のインポートだけにする
• UI に “Loading project instructions from AGENTS.md” が表示されることをテスト
• テレメトリやプライバシー設定がリモートフラグ取得を妨げていないか確認

バージョン番号だけでは機能が確実に有効化されているとは限りません。UI が明示的に「プロジェクト指示が AGENTS.md から読み込まれた」旨を表示しない限り、フォールバックは裏で失敗している可能性があるため、実際の動作を確認することが重要です。

リモートフラグに依存している点から、厳格なネットワークポリシーを採用している組織はフラグ取得先エンドポイントをホワイトリストに追加したり、プライバシー設定を調整したりする必要があります。これを怠ると、フラグが取得できずに AGENTS.md が無視されるリスクが生じます。

実務的な観点から見ると、AGENTS.md のフォールバック機能は新規コントリビュータのオンボーディングを大幅に簡素化します。Claude Code が他の AI アシスタントと整合し、複数の指示ファイルを同期管理するコストが削減されることで、チーム全体の生産性が向上します。

日本国内の企業にとっては、プロジェクト全体のガイダンスを単一の AGENTS.md に集約し、CLAUDE.md が存在しない場合でも自動的に適用できる点が特に有益です。UI と上記チェックリストを用いて挙動を確認できるため、作業フローがよりスムーズかつ透明になり、開発プロセスの品質向上に寄与します。