2026年9月18日公開のClaude Code 2.1.277で、AGENTS.mdへの対応がchangelogに載りました。CLAUDE.mdがないプロジェクトでは、Claude CodeがAGENTS.mdを代わりに読み込みます。ほかのAIコーディングエージェント用に書いた指示ファイルを、Claude Codeでもそのまま使えるようになります。複数のエージェントを使い分けている開発者は、指示ファイルを二重に管理する手間が減ります。
発表内容
公式のClaude Code changelog(GitHubのCHANGELOG.mdから生成されたページ)では、バージョン2.1.277の追加項目の最初にこう書かれています。
Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under “Project instructions” in /config (not yet on Bedrock, Vertex or Foundry)
要点は次の3つです。
- 対象になる条件:CLAUDE.mdがないプロジェクトに限り、AGENTS.mdが代わりに読み込まれる
- 設定:
/configの「Project instructions」で変えられる - 提供範囲:Bedrock、Vertex、Foundryではまだ使えない
自分のバージョンは claude --version で確認できると、changelogに書かれています。
なぜ重要か
これまでClaude Codeのプロジェクト指示はCLAUDE.mdに書くものでした。今回の変更で、CLAUDE.mdがなければAGENTS.mdが読まれます。つまり、ほかのツール向けにAGENTS.mdを用意済みのリポジトリなら、CLAUDE.mdを新しく作らなくても指示がClaude Codeに届きます。
条件は「CLAUDE.mdがない場合」なので、すでにCLAUDE.mdを置いているプロジェクトではAGENTS.mdは代わりに読まれません。いまCLAUDE.mdで運用しているチームへの影響は小さいと考えられます。
同じバージョンでは、ほかにも多くの修正が入っています。たとえば、claude -p やAgent SDKのセッションが内部エラーの後に結果を返さず止まることがある問題が直り、エラーを報告して終了コード1で終わるようになりました。また、プロジェクトの .claude/skills がgitで追跡されていないと、--worktree セッションでメインリポジトリのプロジェクトスキルが読み込まれない問題も修正されています。
現時点での未確定事項
changelogは1行の記載だけなので、次の点は分かっていません。
- CLAUDE.mdとAGENTS.mdが両方あるときの細かい扱い:「CLAUDE.mdがない場合に代わりに読む」とあるだけで、両方を併用する方法は書かれていない
- 「Project instructions」で選べる項目:/configで変えられるとはあるが、どんな選択肢があるかは書かれていない
- サブディレクトリやユーザー単位のAGENTS.mdの扱い:記載なし
- Bedrock・Vertex・Foundryへの対応時期:「not yet」とあるだけで、予定は示されていない
細かい動きは、公式ドキュメントの更新や実際に試した結果を見てから判断するのが安全です。
まとめ
- Claude Code 2.1.277(2026年9月18日)で、CLAUDE.mdがないプロジェクトではAGENTS.mdが読まれるようになった
- 設定は /config の「Project instructions」で変えられる。Bedrock・Vertex・Foundryではまだ使えない
- 両方のファイルがある場合の扱いなど、細かい仕様はchangelogには書かれていない
実装家視点で言うと、複数のAIコーディングエージェントを使い分けているリポジトリでは、今回の変更で指示ファイルをAGENTS.md 1本にまとめやすくなります。ただし、CLAUDE.mdが1つでもあればそちらが優先され、AGENTS.mdは代わりに読まれません。現場で使うなら、まず claude --version で2.1.277以上になっているか確認します。次に、既存のCLAUDE.mdを残すか、AGENTS.mdに寄せるかを決めます。最後に、/configの「Project instructions」で実際の設定を確かめる。この順番で進めるのが確実です。


コメント