Claude CodeのAGENTS.md読み込みがテレメトリ依存だった件、Anthropicが修正
開発者がテレメトリをオフにした理由は「送信データを減らしたい」からだった。けれど、その隣に置いていた AGENTS.md —— Claude Codeがプロジェクト固有の指示として読み込むべきファイル —— は一切機能していなかった。szypowi.cz上のブログ記事 がコードを辿った結果、判明した事実はさらに厄介だった。Claude Codeが AGENTS.md を読み込む処理は、テレメトリが有効になっている分岐にぶら下がっていたのだ。
Anthropicはすでに対応済みである。事象そのものは小さいが、ここから派生するエンジニアリング上の組織論は見逃せない。
事象の概要:AGENTS.mdは「設定」ではなく「テレメトリスイッチの副産物」
発端はごく普通だった。誰かがClaude Codeに AGENTS.md を置き、モデルに対してプロジェクト規約・コードスタイル・コミット方針などを渡そうとした。ファイル自体はエラーにならず、ログにも異常はなかった。にもかかわらず、モデルは AGENTS.md の内容を完全に無視していた。
テレメトリをオフにしてから再度オンにすると、ファイルが効いた。
ブログ著者のszymon氏は違和感を覚えて、Claude Codeのソースロジックを直接確認した。その結果、AGENTS.md の読み込み経路がテレメトリのオン/オフと確かに結合していることがわかった。テレメトリがオフになると、ファイル読み取りのコードに到達しない。
これはバグレポートでよくある「誤作動」や「境界条件の漏れ」とは類型が違う。コード構造レベルで見て取れる設計判断 —— あるいは、あまりに深い場所に埋め込まれた副作用だ。
Anthropicはフィードバックを受けて修正した。ただし、修正イコール説明ではない。公式には「なぜこう書いていたのか」「テレメトリ無効時に他に静音化される機能があるのか」は明かされていない。それはさておき、まずなぜこの話題がHacker Newsで374ポイント・211コメントを集めたのかを見ていく。
HNのディスカッション:https://news.ycombinator.com/item?id=49814947
なぜこのバグが重要か:テレメトリと機能が結合している
視点を「ファイルが読まれなかった」から「テレメトリと機能が同じコード経路上にある」に引き上げる。
開発者がテレメトリをオフにする典型的な動機はプライバシーだ。コード片・プロンプト・アップロードしたファイルをサーバに持たせたくない。これは合理的な選択であり、企業コンプライアンスの場面では必須ですらある。ところが見返りはというと、そのスイッチをオフにしただけで、プライバシーとは無関係に見える「プロジェクト設定の読み込み」という基本機能まで止まってしまう。
より深刻な問題はここにある:製品ドキュメントにこの事実は書かれていない。
Claude Codeの設定パネルを開くと、テレメトリは単なるスイッチに見える。普通の開発者なら「データ収集のスイッチ」と読むだろう。そこに「プロジェクト設定ファイルの読み込みも無効になります」とは書いていない。この種の暗黙の結合は、信頼を破壊する。Anthropic側に悪意があるかないかではなく、ユーザーがスイッチを切り替える前に、その連鎖的影響を知れる経路がそもそも存在しないのだ。
同様の暗黙依存は、おそらく一箇所では済まないだろう。詳しくは後述する。
AGENTS.mdとは何か、そして.cursorrulesとの関係
ここでファイル自体を簡単に整理しておく。AGENTS.md は2025年半ば頃から広まり始めた慣習で、プロジェクトルートに置き、AI Agent / AI開発ツール向けのプロジェクト単位の指示ファイルとして読み込まれる。フォーマットは README.md を模しているが、内容は人ではなくモデル向けである。
# AGENTS.md
## Build & Test
- pnpm install
- pnpm test
## Style
- 2-space indent
- No `any` in TypeScript
- Prefer composition over inheritance
## Don't
- Don't modify files under `migrations/`
- Don't commit `.env`
同種の仕組みは他のツールにも存在する。ただしファイル名や読み込み経路はそれぞれ異なる。
- Cursor:
.cursorrulesをプロジェクトルートに配置 - Aider:
CONVENTIONS.mdを--read引数で明示的に指定 - Cline / Continue:カスタムsystem promptとして注入
- Claude Code:
AGENTS.mdまたはCLAUDE.md(同一ファイルで両方の名前を受け付ける)
決定的な違いは読み込み経路にある。CursorやClineは設定の解析レイヤを通る —— プロジェクトを開き、ツールが初期化される際に AGENTS.md(あるいは類似ファイル)が読み込まれ、そのロジックは「テレメトリ」や「データ送信」のスイッチとは独立している。Aiderはさらに直接的で、ユーザーが明示的にファイルパスを渡すため、結合自体が発生しようがない。
Claude Codeが今回露呈したのは別種の経路だった —— 読み込み挙動が他のスイッチの裏側にぶら下がっている構造だ。この手の構成は急速に進化する製品では珍しくないが、設定読み込みという基幹経路上で起きたことで、影響が拡大した。
コミュニティの反応:374ポイント、211コメントの論点
HNのスレッドは大きな盛り上がりを見せ、議論はおおむね三派に分かれた。
第一派:Anthropic内部のコード構成に問題あり。代表的な主張は —— AGENTS.md の読み込みは「100%決定論的経路を踏むべき機能」(副作用なし、ランダム性なし)であり、テレメトリのような「オフにできる、可変な」スイッチと束ねる設計は糟糕的だ、というもの。この派の多くは大手企業のエンジニアリング経験を持つ開発者で、本番環境で同種のanti-patternがより深刻な事故を招いた事例を見てきた人たちだ。
第二派:オープンソース / CLIツールの構造的欠陥。この派は、Claude Codeのコードは完全には公開されていないが、公開されている部分だけでも急速に進化する製品の典型的な問題 —— 機能の追加速度に内部リファクタリングが追いついていない —— を露呈していると考える。匿名のユーザーが「これはバグではなくvelocity taxだ」とコメントしていた。意訳すれば、速く走れば走るほど、埋まる穴も深くなるということだ。
第三派:より深い問い —— AIツールのスイッチは何を制御しているのか。この派の議論が最も興味深い。彼らはこの一件をより大きな文脈に置く。LLMツールには一般的に「テレメトリ / データ収集」スイッチがあるが、ユーザーはその裏にいくつの機能挙動が繋がっているかを知らない。あるスイッチは「データ収集」かもしれず、「機能の有効化」かもしれず、「モデルバージョンの選択」かもしれず、「プロンプトキャッシュ戦略」すらあり得る。この不可視性こそが根本的な問題だ。
私自身は第三派に近い。第一派と第二派は「なぜ今回バグが出たか」を語っているが、第三派は「この種のバグをどう体系的に防ぐか」を問うている。
開発者への実務的な影響:今、テレメトリはオンにすべきかオフにすべきか
短期的な推奨:すでにClaude Codeを使っているなら最新バージョンへ更新すること。修正はマージ済みだが、具体的なバージョン番号はszypowi.czのブログにもHNのコメントにも明記されていないため、Claude Codeのリリースノート またはGitHubのコミットログを直接確認してほしい。
修正が効いているかを確認するには:テレメトリをオフにし、Claude Codeを起動、プロジェクトルートにテスト用の AGENTS.md を置いて、他と被らない一意の行(例えば print("AGENTS_MD_TEST_OK"))を書いておく。そして「AGENTS.mdの指示に従って実行して」とClaudeに聞く。実際にそのコードを実行しにいくなら、読み込み経路がテレメトリから独立したことの証拠になる。
テレメトリスイッチ自体のオン/オフは、ユースケース次第。
- オンにする場合:製品改善に貢献したい、新機能を優先的に試したい、利用データをAnthropicにフィードバックしたい。
- オフにする場合:コード片やプロントがアップロードされるのが困る、企業にコンプライアンス要件がある、挙動をより予測可能にしたい。
私個人の考え:AI開発ツールが「ツール」から「協働者」へと性格を変えていく流れの中で、データ収集はデフォルトでオフ、必要な機能はオンにしておく、というのが基本姿勢になる。ただし、そのためにはAnthropic側から明確な約束が必要で、スイッチの副作用はドキュメントに網羅すべきだ。ユーザーにコード解析を依存させるのは筋が違う。
確認しておくべき場所はいくつかある(名称は公式ドキュメントに従うこと):
~/.claude/settings.json内のテレメトリ関連設定- CLIコマンドのテレメトリ関連フラグ
- 起動ログに出力されるテレメトリの状態
編集後記
この一件は「Anthropicがまたやらかした」で片付く話ではない。指し示しているのは具体的なエンジニアリング上の問題 —— AI Agentツールの「機能スイッチ」と「データスイッチ」は分離されるべきか? —— だ。
Cursor、Aider、Cline、Claude Codeといったツールはすべて急速に進化しており、毎週のように新機能・新モデル・新権限が追加されている。新機能が既存の「設定読み込み / 環境初期化 / ポリシー適用」の経路にぶら下がるとき、どこに繋ぐか、何に依存させるか、副作用を持つかどうか —— こうした判断ひとつひとつが、開発者のワークフローに直接影響する。Claude Codeの今回の「設定読み込みがテレメトリ分岐にぶら下がっていた」事象は孤立したケースではなく、この種のツールに共通するコード構成問題の初期シグナルだ。
私の見立て:今後12〜18ヶ月は、この種の「暗黙の結合」事象が増えることはあっても減ることはない。理由は単純で、Agentツールの製品形態がまだ大きく揺れ動いている最中であり、「コア機能とは何か」の定義自体が動いているからだ。今日のコア機能が明日は「実験的」になり、今日の実験的が明日はデフォルトになり得る。この変動の中で、「どのスイッチがどの機能に繋がるか」の会計はすぐに破綻する。
この一件は、過去のツールバグとは性質が違う。従来の「ツールのバグ」は挙動の誤り —— 出力の偏り、計算結果の誤り —— が中心だった。今回はメタレベルの問題だ —— 「何がバグか」という判断基準そのものが、ユーザーとベンダーとの間でずれている。ユーザーは「AGENTS.md は必ず読まれるべきだ」と考えるが、コード上はその意味になっていない。
短期は監査頼みになる:ユーザーコミュニティや第三者のセキュリティ研究者がコードを読み、issueを立て、問題を露出させる続ける。これは部分的にソースが見えるツールの強みが生きる。長期的には業界レベルの透明性が要る —— 私が見たいのは、各スイッチに明確な「影響範囲宣言」が伴い、ドキュメントに副作用が網羅されている状態だ。設定読み込みの経路はデータ収集の経路から独立していることを工学的要件とし、第三者監査がAgentツールの標準装備 —— いわば今のSOC2やGDPR監査のように —— なる世界だ。
完全に解決できるかは、私自身は慎重だ。LLMツールの可観測性は伝統的なソフトウェアより弱い。モデル本体がブラックボックスである以上、モデルを取り巻く製品もブラックボックス化しがちだ。Claude Codeは今回修正したが、修正はこの種の問題が消えることを意味しない。