Claude Code : AGENTS.md は遥測オンでしか読まれない
Original : Claude Code reads AGENTS.md only when telemetry is on [fixed]
Pourquoi c'est important
テレメトリ拒否がサイレントに機能損失を招くことを示した事例
Claude Code 2.1.277 は AGENTS.md のサポートを追加したが、ローダーはリモートフィーチャーフラグの裏に隠されている。DISABLE_TELEMETRY=1 または CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 を設定すると、ローカルの AGENTS.md は警告なしにスキップされる。開発者 Przemek がこの挙動を実測し公開した。
Claude Code 2.1.277 は AGENTS.md をプロジェクト指示ファイルとして読み込む機能を導入した。CLAUDE.md が存在しない場合に AGENTS.md を代替として使う設計だ。しかし実装を見ると、プラグイン agents-md の isOnByDefault は false であり、isAvailable はリモートフラグ tengu_agents_md_mod を問い合わせ、失敗時のフォールバックも false になっている。
テレメトリや非必須トラフィックを無効にしていると、フラグが取得できず機能が無効のまま動く。問題は無警告である点だ。モデルはプロジェクト指示なしで回答し、ユーザーはファイルがスキップされたことに気づかない。DISABLE_TELEMETRY や CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC を 0 に設定しても効果はなく、.claude/settings.json での上書きも機能しない。AWS Bedrock や Vertex 経由でも同じ問題が発生する。
回避策は CLAUDE.md に @AGENTS.md と一行書くだけ。@path インポートはフラグに依存しないため、テレメトリ無効でも正常に動作する。ただしこれは、AGENTS.md 対応が解決しようとした「余計なファイルを置かなくてよい」という目的を無効にする。バグは修正済みとされているが、経緯はリモートフラグでローカルファイル読み込みを制御するという設計判断を浮き彫りにしている。