Claude Code: テレメトリ無効でAGENTS.md非読込
मूल शीर्षक: Claude Code reads AGENTS.md only when telemetry is on [fixed]
यह क्यों महत्वपूर्ण है
テレメトリ無効化という意図的な設定がサイレントに機能を無効化する設計は、プライバシー重視ユーザーとエンタープライズ環境への信頼性に直結する問題だ。
Claude Code 2.1.277でAGENTS.mdサポートが追加されたが、この機能はリモートフィーチャーフラグ「tengu_agents_md_mod」の背後に置かれており、テレメトリや非必須通信を無効にすると、ローカルのAGENTS.mdファイルが警告なしにスキップされることが判明した。
Claude Code 2.1.277はAGENTS.mdサポートを追加した。プロジェクトにCLAUDE.mdが存在しない場合、代わりにAGENTS.mdを読み込む設計だ。しかしエンジニアのPrzemekが自身のブログで詳細な測定結果を公開し、この機能が実際には動作しないケースを明らかにした。
問題の根本はプラグイン「agents-md」の実装にある。コードバンドルを見ると、デフォルト値（isOnByDefault）はfalseで、利用可否（isAvailable）はリモートフラグ「tengu_agents_md_mod」に依存し、取得失敗時もfalseにフォールバックする。つまりフラグを取得できなければ、ディスク上のファイルを読むだけの処理がそもそも実行されない。
検証によると、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1またはDISABLE_TELEMETRY=1を設定するとAGENTS.mdは読み込まれない。値を「0」に変えても無効化は解除されず、プロジェクトの.claude/settings.jsonのenvブロックで両変数をクリアしても効果はない。さらにどのケースでも警告は一切表示されず、モデルはプロジェクト指示なしで応答する。AWSのBedrockやVertex AI経由でもフラグが解決できないため同様の問題が発生する。
回避策として、CLAUDE.mdの@pathインポート機能を利用する方法がある。CLAUDE.mdに「@AGENTS.md」と1行書くだけで、テレメトリ無効でも読み込みが機能する。ただしこれはAGENTS.md対応で不要にするはずだった余分なファイルを各リポジトリに置くことを意味する。なお本件はGitHub Issue #95690として報告済みで、記事タイトルに「[fixed]」とある通り修正対応が行われている。