Claude CodeがAGENTS.mdに対応。CLAUDE.mdを分けて管理する手間が減る

2026年9月19日更新日: 2026年9月23日AIコラム

Anthropicは2026年9月18日、Claude Code 2.1.277を公開し、プロジェクトの指示ファイルとしてAGENTS.mdを直接読み込めるようにしました。

AGENTS.mdは、AIコーディングエージェント向けに、セットアップ方法・テストコマンド・コーディング規約などを記すMarkdownファイルです。Codexをはじめ複数のツールが対応しており、今回の更新でClaude Codeも同じ指示ファイルを参照できるようになりました。

初期設定ではCLAUDE.mdがない場合にAGENTS.mdを読む

初期設定では、作業中のディレクトリやその上位にCLAUDE.mdまたはCLAUDE.local.mdがなければ、Claude CodeがAGENTS.mdをプロジェクト指示として読み込みます。

プロジェクトにあるファイル	初期設定でClaude Codeが読むもの
`AGENTS.md`のみ	`AGENTS.md`
`AGENTS.md`と`CLAUDE.md`	`CLAUDE.md`
`CLAUDE.md`から`@AGENTS.md`を読み込んでいる	`CLAUDE.md`を通じて両方

両方のファイルを常に読み込ませたい場合は、Claude Codeで/configを開き、「Project instructions」をclaude-md-and-agents-mdへ変更します。

これまでClaude Codeが標準で参照するプロジェクト指示はCLAUDE.mdでした。そのため、Codex向けのAGENTS.mdがあるプロジェクトでも、Claude Codeを使うには次のいずれかの準備が必要でした。

同じ内容を2つのファイルへ書く方法では、片方だけを更新すると指示が食い違う可能性がありました。既存のリポジトリをClaude Codeで開くたびに、専用ファイルを追加する手間もあります。

今回の対応により、AGENTS.mdだけを置いたプロジェクトなら、CodexとClaude Codeが同じ指示を参照できます。テスト方法・編集してはいけないファイル・コミット時のルールなどを1か所で管理できます。

Claude Codeは、作業中にサブディレクトリのファイルを開いた際、その場所にあるAGENTS.mdも読み込みます。フロントエンドとバックエンドでディレクトリを分け、それぞれに固有の指示を置く使い方にも対応します。

AIへ渡すプロジェクト指示を最初から作りたい場合は、AIじてんのカスタム指示メーカーも利用できます。

AGENTS.mdに対応しても、初期設定で既存のCLAUDE.mdと両方を読むわけではありません。CLAUDE.mdがある場合は、これまでどおりそちらが優先されます。

共通の指示をAGENTS.md、Claude Codeだけに必要な指示をCLAUDE.mdへ分けたい場合は、CLAUDE.mdに@AGENTS.mdと書いて読み込むか、「Project instructions」で両方を読む設定にします。

利用前に、次の条件も確認してください。

バージョン：直接読み込むにはClaude Code 2.1.277以降が必要です。公式ドキュメントによると、インストールまたはアップデート後の最初のセッションでは有効にならず、次のセッションから読み込まれる場合があります。
対象外の環境：2026年9月19日時点では、Amazon Bedrock・Google Vertex AI・Microsoft Foundry経由のセッションなど、一部の環境は対象外です。