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

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

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

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

この記事では、何が変わったのか、これまで何が不便だったのか、複数のコーディングAIを使う場合にどう便利になるのかを簡潔に整理します。

Claude Code 2.1.277から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.mdを別に用意する必要があった

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

同じ内容をCLAUDE.mdへ書き直す
CLAUDE.mdから@AGENTS.mdをインポートする
CLAUDE.mdをAGENTS.mdへのシンボリックリンクにする

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

複数のコーディングAIで指示を共有しやすくなる

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

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

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

CLAUDE.mdがあるプロジェクトでは挙動を確認したい

注意したいのは、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経由のセッションなど、一部の環境は対象外です。