AnthropicでClaude Codeの開発に携わるThariq Shihipar氏（@trq212）は9月18日、AIコーディングツールClaude Codeがバージョン2.1.277 からAGENTS.mdに対応したとXで案内した。デフォルトでは、作業ディレクトリやその上位にCLAUDE.mdなどの指示ファイルがない場合に、AGENTS.mdをプロジェクトの指示として読み込む。
AGENTS.mdをプロジェクトの指示として直接読み込み
AGENTS.md は、AIコーディングエージェントにプロジェクトの情報や作業上の指示を伝えるためのMarkdownベースのオープンな形式。ビルド・テストのコマンドやコーディング規約などを、複数のエージェントで共有できる。今回の対応により、既存のAGENTS.mdをClaude Codeでも直接利用できるようになった。
ただし、バージョン2.1.277のリリースノートによると、Bedrock、Vertex、Foundryを通じてClaude Codeを利用する環境では、AGENTS.md対応はまだ提供されていない。また、利用状況などのデータ送信（テレメトリー）を無効にしている環境など でも、AGENTS.mdの直接読み込みは利用できない[1] 。利用可能な環境では、対応版への更新後、2回目のセッションから読み込みが有効になる。
[1] Claude Codeは、一部の機能をAnthropicから取得する設定情報（フィーチャーフラグ） で有効化する。テレメトリーを無効にすると、この取得も停止するため、AGENTS.mdの直接読み込みも有効にならない。
指示ファイルの共通化を求める声
Claude Codeではこれまで、プロジェクトの指示ファイルとしてCLAUDE.mdを使ってきた。しかし、Shopify CEOのTobi Lütke氏は8月24日、チーム内で異なるツールを使う場合、CLAUDE.mdだけを読み込む方式では指示が食い違うことがあると指摘し、AGENTS.mdなどへの対応を求めていた。
Thariq氏はこの投稿への返信 で、モデルの基本的な振る舞いを定めるシステムプロンプトが性能に大きく影響すると説明し、モデルに合わせた指示を重視する考えを示していた。同氏は、モデルの進化に応じてCLAUDE.mdなどの指示を見直す考え方 も紹介している。
あわせて、同じ返信で、指示を管理する負担も認め、AGENTS.mdの利用やシステムプロンプトの変更を容易にする取り組みを進めていると述べていた。CLAUDE.mdに@AGENTS.md と書いて読み込ませることは以前から可能で、その方法も案内していた。
/configで選べる4つの読み込み設定
Claude Codeの/configにある「Project instructions」
CLAUDE.mdがなければAGENTS.mdを読む （claude-md-or-agents-md、デフォルト） ：CLAUDE.mdなどの指示ファイルがあればそちらを使い、なければAGENTS.mdを読み込む。 両方を読む （claude-md-and-agents-md） ：CLAUDE.mdとAGENTS.mdを読み込む。CLAUDE.mdから@AGENTS.md ですでに読み込んでいる場合は、再度読み込まない。 CLAUDE.mdだけを読む （claude-md） ：AGENTS.mdを直接読み込まず、CLAUDE.mdを使う。 起動時は組織の管理指示と自動メモリーを使う （managed-only） ：組織が管理するCLAUDE.mdと、Claude Codeが自動保存したメモリーを読み込む。ただし、サブディレクトリのCLAUDE.mdなどは作業中に読み込まれる。
CLAUDE.mdを読み込まず、AGENTS.mdだけを読む専用モードは用意されていない。
デフォルトでは 、作業ディレクトリからファイルシステムのルートまで、各階層のCLAUDE.md 、.claude/CLAUDE.md 、CLAUDE.local.md を探す。いずれも見つからなければ、その範囲にあるAGENTS.md と.claude/AGENTS.md を読み込む[2] 。
指示ファイルの組み合わせとデフォルトの読み込み対象
AGENTS.mdには、CLAUDE.mdとの動作の違い もある。たとえば、サブディレクトリのAGENTS.mdを追加で読み込むのは、Claude Codeがその配下のテキストファイルをReadツールで読むときに限られる。また、--add-dirで追加したディレクトリのAGENTS.mdは読み込まない。指示ファイルなどを一覧表示して編集する/memoryにも、直接読み込んだAGENTS.mdは表示されない。
「Claude Code mods」の組み込み機能として実装
Thariq氏は今回の追加投稿で、AGENTS.md対応が「Claude Code mods」 mdの読み込みを実装したmodのソースコード も公開されている。
同氏は、今後は利用者もmodsを使い、プロジェクトの指示を扱う仕組みを自作できるようになると述べている。
コラム： Claude Modsではテトリスの作例もAGENTS.md対応に先立つ9月9日、Claude CodeのGitHubリポジトリにあるIssue では、「 Claude Mods」という名称と、環境変数を設定して試用する方法が案内されていた。
Claude Codeの開発に携わるBoris Cherny氏もXへの投稿 で、Claude内でテトリスを動かすmodが作られたことを紹介している。同Issueには、画面共有を想定し、Claude Code Desktop上の機密情報を通常は伏せ、マウスポインターを重ねたときだけ表示するデモも掲載されている。
