Claude CodeのAGENTS.md、テレメトリ無効で読み込まれない不具合
원제: Claude Code reads AGENTS.md only when telemetry is on [fixed]
왜 중요한가
テレメトリ無効化という意図的な選択がサイレントな機能喪失を招く設計は、エンタープライズやプライバシー重視ユーザーのClaude Code採用に直接影響する問題。
Claude Code 2.1.277はAGENTS.mdサポートを追加したが、ローダーはリモートフィーチャーフラグ「tengu_agents_md_mod」で制御されている。テレメトリや非必須通信を無効化した環境では同ファイルが無警告でスキップされ、AWS BedrockやVertex AIなど第三者ゲートウェイでも同様の問題が生じることが実測で確認された。
エンジニアのPrzemekが自身のブログで報告した内容によると、Claude Code 2.1.277で追加されたAGENTS.mdサポートは、内部プラグイン「agents-md」がデフォルトで無効（isOnByDefault = false）となっており、起動時にAnthropicのサーバーからリモートフィーチャーフラグを取得して初めて有効化される仕組みになっている。
つまり、ローカルディスク上のMarkdownファイルを読み込むだけの処理にもかかわらず、ネットワーク接続と外部サーバーの応答が前提条件となっている。DISABLE_TELEMETRY=1やCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1を設定している環境ではフラグが取得できないため、AGENTS.mdは完全に無視される。
問題をさらに深刻にしているのは、この挙動に対するユーザーへの通知が一切ない点だ。セッション開始時にエラーや警告は表示されず、AIはプロジェクト指示なしで応答を返す。値を「0」に設定しても効果はなく、プロジェクト単位の.claude/settings.jsonでの上書きも機能しない。
AWS BedrockやGoogle Vertex AI経由での利用でも同様の問題が発生することがGitHub Issue #95690で指摘されており、これらの環境ではフラグが真（true）に解決できないためだ。
回避策として、Przemekは一行のCLAUDE.mdを使用する方法を紹介している。CLAUDE.mdの@pathインポート機能はフィーチャーフラグに依存しないため、AGENTS.mdと同じディレクトリに「@AGENTS.md」と記述したCLAUDE.mdを置くことで、テレメトリ無効環境でも正常に読み込まれることを確認済みだ。ただしこれは、AGENTS.mdサポートが解決しようとしていた「ファイルを1つにまとめる」という目的を損なう。