Claude Code: v2.1.277 でテレメトリが無効化されていると AGENTS.md のサポートが制限される

Claude Code v2.1.277 では、テレメトリが無効化されている場合、AGENTS.md プロジェクトの指示ファイルが静かに読み込まれませんでした。これは、リモートの機能フラグによって機能が制限されていたためで、そのフラグを取得するにはネットワーク接続が必要だったためです。結果として、DISABLE_TELEMETRY=1 または CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 が設定されたユーザーに対して、ローカルファイルの読み取り機能が無効化されていました。

リモート機能フラグがローカルファイルアクセスを制限

v2.1.277 では、agents-md プラグインが isOnByDefault: false に設定されていました。このプラグインの有効性は、tengu_agents_md_mod というリモート機能フラグによって決定されていました。Claude Code が Anthropic のサーバーからこのフラグを取得できない(テレメトリや非必須トラフィックが無効化されている場合)と、プラグインは利用不可となり、ローカルの AGENTS.md ファイルも読み込まれませんでした。

この挙動は、Bedrock や Vertex などのサードパーティゲートウェイを利用しているユーザーにとって特に深刻でした。これらの環境では、ネットワークポリシーがこのフラグの解決に必要なトラフィックをブロックするため、機能が完全に利用できなくなっていました。

影響と静黙的な失敗

ユーザーは、AGENTS.md に含まれるプロジェクトの指示がモデルに反映されないまま、警告やエラーメッセージなしに回答を受け取るという静黙的な失敗を経験しました。これにより、一部のユーザーはモデルが指示を無視していると誤解し、実際にファイルがコンテキストに読み込まれていないにもかかわらず、プロンプトの最適化に時間を費やすことになりました。

対処法と設定

v2.1.281 の修正がリリースされるまで、ユーザーはプライバシー設定を維持しつつプロジェクトの指示を使用するためのいくつかの回避策を採用していました。

  • @path インポート: @AGENTS.md を含む 1 行の CLAUDE.md ファイルを作成することで、機能フラグに依存せずに指示を読み込むことができます。
  • セッションレベルのオーバーライド: --settings フラグを使用して、特定のセッションでテレメトリ環境変数をクリアします: claude --settings '{"env":{"DISABLE_TELEMETRY":"","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":""}}'。
  • シンボリックリンク: AGENTS.md を CLAUDE.md にシンボリックリンクする(ln -s AGENTS.md CLAUDE.md)。

開発者による対応と解決

Anthropic のエンジニア(@mpoteat)は、この問題を「展開のアーティファクト」であり、ロールアウト中に何かが壊れた場合にリモートで機能を無効化できるようにするためのキルスイッチの実装に関する『人的ミス』であると確認しました。この問題は v2.1.281 で解決され、ローカルファイルの読み取りにテレメトリの依存が削除されました。

"ごめんなさい、これは展開のアーティファクトです。何かが壊れた場合にリモートで機能をオフにできるようにする必要があり、テレメトリがオフだとそのフラグが取得できません。すでに今日リリースされた v2.1.281 で修正済みです。"

コミュニティの洞察と設計に関する批判

Hacker News での技術的議論では、ローカル動作に機能フラグを使用する点について、いくつかの設計上の懸念が指摘されました。

  • プライバシーと機能のトレードオフ: 指摘された点として、プライバシー設定(テレメトリの無効化)が、関連のないローカル機能を静かに無効化してはならないという意見がありました。
  • バイブコーディング: 一部のユーザーはこれを「バイブコーディング」と表現し、AI がコードベースにパッチを適用する際に、従来のテストでは検出できない微妙で深刻なバグを引き起こす可能性があると指摘しました。
  • 標準化: コミュニティの継続的な要望として、Claude Code が独自の CLAUDE.md 形式ではなく、AGENTS.md と .agents/ の標準を完全に採用すべきだという声があります。
  • グローバル設定: ユーザーは、プロジェクト間で手動でコピーせずに永続的に有効な ~/.codex/AGENTS.md やユーザー単位の指示ファイルをサポートしてほしいと指摘しています。

Sources

関連

  • Dispatch
  • Dispatch
  • プロジェクト
  • Dispatch
  • Dispatch