Claude Code 2.1.277は、リポジトリ用指示ファイルAGENTS.mdをネイティブに読み込む機能を追加した。重要な制限がある。Anthropicの現行ドキュメントによると、機能フラグを取得できないセッションでは、テレメトリーを無効にしたセッションや多くのサードパーティープロバイダー設定を含め、CLAUDE.mdのみを読み込む。

公開版のagents-mdプラグインはファイルの読み込みと、任意のテレメトリー記録を分けている。記録には件数と固定選択肢が含まれ、パスやファイル本文は含まれない。依存条件はその一つ前の層にある。リモートのフラグによって組み込みローダーが利用可能かどうかが決まる。

大きな変化

  • 何が変わったか：ローカルの指示ファイルがリモートの段階的展開の境界を越えるようになった。機能フラグにアクセスできるかどうかで、Claude Codeに組み込まれたAGENTS.mdの読み込み機能が使えるかどうかが決まる。
  • なぜ重要か：同じコミットを使う2人の開発者でも、バージョン、プロバイダー、プライバシー設定によって受け取るプロジェクト指示が異なる場合がある。チーム全体でエージェントの挙動を再現しにくくなる。
  • 今後の注目点：複数のプロバイダーを使うチームや制約の強い環境では、指示ファイルの読み込みを実行時の依存条件として扱える。各環境で動作を確認し、移植可能な方法としてCLAUDE.mdのインポートを維持するとよい。

リリース記録と報告が示すこと

Anthropicの2.1.277リリースノートは9月18日付で、プロジェクトにAGENTS.mdがない場合、Claude CodeがCLAUDE.mdを読み込むとしている。同リリースではBedrock、Vertex、Foundryを対象外としている。

現行のプロジェクトメモリーのドキュメントでは、対応バージョンをインストールまたは更新した直後の最初のセッションと、組み込みプラグインを無効にしたセッションも対象外としている。

Przemek Szypowskiによるきっかけとなった報告は、2.1.280でのカナリアテストについて説明している。報告では、DISABLE_TELEMETRYとCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICによってAGENTS.mdが読み込まれなくなった一方、隣に置いたCLAUDE.mdのインポートは機能したという。BIG CHANGEは有料モデルでのそのテストを再現していない。Anthropicの文書が現在、同じ利用条件を独立に明記している。

機能の利用可否とテレメトリー記録は別のもの

Anthropicの環境変数のドキュメントによると、空でない値をDISABLE_TELEMETRYに設定すると、0やfalseなどの値でも、テレメトリーが無効になり、機能フラグも取得できなくなる。DO_NOT_TRACK、DISABLE_GROWTHBOOK、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICもフラグ取得を止める場合がある。埋め込みホストがCLAUDE_CODE_PROVIDER_MANAGED_BY_HOSTを設定しない限り、サードパーティープロバイダーのセッションは対象外となる。Claudeアプリのゲートウェイセッションも対象外だ。

公開済みのプラグインREADMEによると、テレメトリー呼び出しに失敗しても、その記録は破棄され、プラグインの他の処理には影響しない。リポジトリのmodsの概要では、テレメトリーとagents-mdが別々の組み込み機能として示されている。

ソースコードはローダーの動作を説明し、製品ドキュメントは各セッションでそのローダーが利用できるかを説明する。モジュール内の任意のログ記録によって、外側にある利用条件がなくなるわけではない。

9月23日、BIG CHANGEはagents-mdのREADMEと登録モジュールをmainと9月22日公開の2.1.280タグの両方から取得し、それぞれの組がバイト単位で一致することを確認した。

Claude Codeがファイルを読み込む条件

プラグインが利用可能かつ有効な場合、初期設定の優先順位は次のとおり。

指示ファイル

初期設定での結果

AGENTS.md、プロジェクト用Claude指示ファイルがない場合

AGENTS.mdが読み込まれる

プロジェクトのCLAUDE.md、.claude/CLAUDE.md、またはCLAUDE.local.mdが作業ディレクトリ内またはその上位にある場合

直接読み込まれるAGENTS.mdは、これらのファイルがあれば優先されない

ユーザーまたは管理者のCLAUDE.md、または.claude/rules/

これらはAGENTS.md

より優先されない/config両方の種類のファイルを読み込むには、--settingsで「Project instructions」の設定を変更する。JSONオプションはユーザー設定、

、または管理者設定に置く必要がある。プロジェクト設定とローカル設定は無視される。

代替策は明示的なインポートを一つ置くことCLAUDE.md直接対応していないセッションでは、Anthropicは共通の指示ファイルと同じ場所にある

@AGENTS.md

に次の内容を記すよう推奨している：

インポートはファイルをそのまま読み込む。「読んでください」という文章で頼むだけでは、判断をモデルに委ねることになる。claude --versionを確認し、Project instructionsを/configで確認する。2.1.280では/memoryまたは/contextから、直接読み込まれたAGENTS.mdを一覧できる。これより前の対応バージョンでは、そこに表示されなかった。