Claude Code、テレメトリ無効時にAGENTS.md未読の不具合
Judul asli: Claude Code reads AGENTS.md only when telemetry is on [fixed]
Mengapa Ini Penting
テレメトリ無効化がローカルファイル読み込みに影響する設計は、プライバシー重視ユーザーへの信頼を損なう。
Claude Code 2.1.277がAGENTS.mdサポートを追加したが、テレメトリまたは非必須通信を無効にすると、AGENTS.mdが警告なしに読み込まれないバグが確認された。
Claude Code 2.1.277でAGENTS.mdサポートが追加されたが、エンジニアのPrzemekが実測した結果、`DISABLE_TELEMETRY=1`または`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`を設定すると、ローカルのAGENTS.mdが一切読み込まれないことが判明した。
原因はプラグイン`agents-md`の実装にある。`isOnByDefault`が`false`に設定されており、リモートフィーチャーフラグ`tengu_agents_md_mod`を取得できない場合、フォールバック値も`false`となるためプラグインが無効化される。テレメトリ無効時はこのフラグを取得できず、機能が動作しない。
さらに問題なのは、この挙動に対する警告が一切表示されないことだ。セッションは正常に開始され、モデルはAGENTS.mdなしで応答するが、ファイルがスキップされたことはどこにも通知されない。Amazon BedrockやVertex AI経由のサードパーティゲートウェイでも同様の問題が発生する。
回避策として、CLAUDE.mdに`@AGENTS.md`と一行記述するimport機能を使う方法がある。これはリモートフラグに依存しないため、テレメトリ無効でも動作する。ただしこれは、AGENTS.mdサポートが「不要にするはずだったファイル」を別途作成することを意味する。