Claude CodeがAGENTS.mdをサポート、ただしテレメトリが無効な場合は特集がサイレントに無効化される

しかし、技術レポートおよびGitHubのIssue #95690は、AGENTS.mdの読み込みメカニズムが、Anthropicのリモート特集フラグによって制御されるプラグインとして実装されていることを示しています。これは、ユーザーがCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1やDISABLE_TELEMETRY=1といった環境変数を通じてテレメトリや非必須の通信をオフにしている場合、特集がサイレントに無効化されることを意味します。さらに、BedrockやVertexなどのサードパーティ製ゲートウェイを介してClaude Codeにアクセスしているユーザーも、必要なリモートフラグを解決できないため、同様の問題に直面します。

重大な点として、このツールはAGENTS.mdファイルがスキップされた際に警告やエラーメッセージを表示しません。この沈黙は、実際にはローカルファイルがセッションに読み込まれていないにもかかわらず、ユーザーが「モデルが指示を無視している」と誤解する原因となります。現在、回避策として、@AGENTS.mdのインポートを含む1行のCLAUDE.mdファイルを使用する方法があり、これはテレメトリが無効な状態でも正しく機能します。

PLUS ULTRAby Amenoyomi

AGENTS.mdの読み込みは、agents-mdと呼ばれる組み込みのプラグインによって管理されています。このプラグインはデフォルトではアクティブではなく、ファイルが読み込まれるためには、tengu_agents_md_modとして知られるサーバー側のスイッチであるリモート特集フラグが有効である必要があります。

このプラグインはリモートフラグに依存しているため、DISABLE_TELEMETRY=1やCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1の設定のように、非必須の通信をブロックするあらゆる設定が、フラグの取得を妨げます。これはAmazon BedrockやGoogle Vertexなどのサードパーティ製ゲートウェイを使用している場合にも発生し、フラグをtrueとして解決できないため、実質的にローカルファイルの読み込みがネットワーク要件によってロックされることになります。

Claude Codeはこのプロセスが失敗した際に警告やエラーメッセージを提供しないため、ユーザーはプロジェクトの指示がスキップされたことに気づけません。このサイレントな失敗は、ユーザーが反応の欠如を「モデルが指示を無視している」あるいは「能力が不足している」と誤解するリスクを生み、結果として不必要なプロンプトの調整に時間を浪費させる可能性があります。