Claude Code、AGENTS.md読み込みに対応

Anthropicが開発するAIコーディングツール「Claude Code」の最新リリース(v2.1.277)で、プロジェクトごとにAIへの指示を書いておくファイルのうち、CLAUDE.mdが無い場合には代わりにAGENTS.mdを読み込む機能が追加された。開発元のリリースノートによると、ashwin-ant氏が2026年9月18日18:06に公開したもので、設定を変更したい場合は/configの「Project instructions」(プロジェクトへの指示に関する設定画面)から行えると案内されている。リリースノートには、CLAUDE.mdが無いプロジェクトでこの挙動が有効になると記されている。

同じリポジトリを複数のAIエージェントで扱う開発現場では、指示ファイルをツールごとに書き分ける手間が地味な負担になっていた。今回の変更は、CLAUDE.mdが存在しないプロジェクトに限って、AGENTS.mdという別ファイルを代わりに参照できるようにするものだ。AGENTS.mdの読み込みに関しては、既にCLAUDE.mdを用意しているプロジェクトの挙動は変わらない。

この変更を「指示ファイルの統合」と読むと、実態より一歩踏み込みすぎる。リリースノートの文言は、あくまでCLAUDE.mdが無い場合に代わりを読むという趣旨のフォールバック(代替手段)であり、両方のファイルを併用したり優先順位を切り替えたりする仕組みではない。つまり恩恵を受けるのは、これまで指示ファイルを一つも用意していなかったプロジェクトに限られる。

ここでAGENTS.md一本に寄せてしまえばいいのではないかという発想が浮かぶ。しかし設定の変更経路が/configの「Project instructions」という、リポジトリ内のファイルとは別の場所に用意されている以上、AGENTS.mdが実際に読まれるのはCLAUDE.mdが存在しない場合に限られる。加えて、Bedrock、Vertex、Foundry(いずれもクラウド事業者が提供するAI基盤サービス)経由で使う形態では、この挙動にまだ対応していないという留保もリリースノートに明記されている。指示ファイルを一本化したくても、利用形態によっては当面フォールバックの恩恵を受けられない。

それでも、この変更には意味がある。CLAUDE.mdが無いプロジェクトに限ってAGENTS.mdを代わりに読めるようにするという今回のフォールバックは、同じリポジトリを複数人・複数ツールで触る現場ほど効いてくる。一方で、この挙動が働くかどうかはCLAUDE.mdの有無という一点で決まるため、どちらのファイルが実際に読まれているかを運用側が把握し続ける必要がある点は変わらない。指示ファイルの一本化は、ファイルを増やすことより、どの環境がどれを読むかを常に一箇所で説明できる状態を保つことの方が難しい。

こうした運用ルールの変更点は、口頭のミーティングで共有されて終わりがちだ。会議を録音してAIボイスメモのメモリスに渡しておけば、決定事項が数分後にはテキストの要約として手元に残り、あとから「どの環境でどう設定したか」を検索して確認できる。