CLI ツール Claude Code、AGENTS.md の読み込み条件がテレメトリー設定に依存する仕様を公開──Issue #95690 で判明したローカル機能の制限
Claude Code 2.1.277 で追加された AGENTS.md 読み込みは、テレメトリーや非必須トラフィックが無効な環境ではリモートフラグの取得失敗により機能しない。
リリース: 2026-09-23 · 読了 3 分記事の要約
1. 核心（What）
- Claude Code 2.1.277 で導入された AGENTS.md のプロジェクト指示読み込み機能が、テレメトリー設定やトラフィック制御と連動していることが Issue #95690 で判明した。
- プラグイン agents-md の内蔵フラグ tengu_agents_md_mod がサーバ側スイッチに依存しており、フラグ未取得時はローカルファイルであっても読み込まれない。
- CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 や DISABLE_TELEMETRY=1 を設定すると機能が無効化され、警告も表示されずにファイルがスキップされる。
- Bedrock、Vertex、サードパーティ製ゲートウェイ経由の利用環境でも、リモートフラグが有効化されないため同様の問題が発生する。
2. 影響（Why）
- プライバシー設定による静かな機能停止: テレメトリーを明示的に無効化したプライバシー重視の開発環境で、ローカルファイルの読み込み機能が警告なしでサイレントに停止するため、指示が無視されていると誤認してデバッグに時間を奪われる。
- 国内エンタープライズ開発への影響: [セキュリティ要件が厳しい国内金融・医療系 SaaS の開発チーム] では、トラフィック制限や VPC 内での隔離運用がポリシーで強制されているため、追加された AGENTS.md 連携が意図せず動作しないリスクを前提に回避策を組み込む必要がある。
3. 根拠・詳細（How）
- プラグインのフラグ依存構造: 2.1.280 バンドル内の内蔵プラグイン agents-md は isOnByDefault が false に設定され、isAvailable 判定でリモートフラグ tengu_agents_md_mod を参照する。
- CLAUDE.md を使った回避策: AGENTS.md と同じディレクトリに echo '@AGENTS.md' > CLAUDE.md を配置し、パスインポート機能を経由させることでテレメトリー設定に関わらず読み込みを強制できる。
4. 展望・課題（Next）
- ローカルファイル読み込みの分離要望: ローカルのマークダウン読み込み処理はテレメトリーサーバへの依存を切り離し、スキップ時には警告メッセージを表示する仕様変更が求められている。