何が起きたか

Anthropic（Claudeを作るAI会社）のコード作業用ツール、Claude Codeで、プロジェクトのルールを書いたAGENTS.mdが読まれない事例が報告された。きっかけは、テレメトリーを無効にした設定だった。テレメトリーは、利用状況などを送る仕組みだ。

報告者は、AGENTS.mdだけを置いた空のフォルダを作り、そこにしかない合言葉をClaude Codeへ尋ねた。テレメトリーを有効にした場合は答えられたが、DISABLE_TELEMETRY=1やCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1を設定すると、ファイルの内容が使われなかったという。元記事では、変数を0にしても、設定が存在するだけで同じ状態になったと説明している。元記事

背景にある仕組み

AGENTS.mdは、コード作業をするAIに、テスト方法や変更時の注意点などを伝えるためのファイルだ。複数のAI開発ツールで同じルールを使えるようにする役割もある。

Claude Codeの対応は、組み込みのagents-mdという機能モジュールで追加された。このモジュールは、機能を遠隔でオン・オフできるfeature flag（機能スイッチ）を確認してから動く設計だった。テレメトリーを切ると、そのスイッチを取得できず、機能が無効と判断された。つまり、パソコン内のファイルを読むだけの処理が、会社側の通信設定に間接的に左右されたことになる。

なぜ重要か

問題は、ルールの内容が外へ漏れたということではない。報告された挙動では、ルールがAIに渡らず、何も知らない状態で作業を始める可能性があった。チームが決めたテスト、書式、触ってはいけない場所などが無視されれば、結果の信頼性を損なう。

特に、通信を減らしたい企業や、外部への送信を厳しく管理する環境では、同じプロジェクトでも設定によって動きが変わる。しかも、ファイルを読み飛ばしたという警告は表示されなかった。利用者が、ルールの書き方が悪いと誤解する余地があった。

確認できたこと

Hacker Newsのスレッドでは、Claude Codeの開発側アカウントが、遠隔で止められる仕組みを用意した際の公開上のミスだったと説明した。そして、修正版2.1.281に対応を含めたとしている。Hacker Newsのスレッド

修正前の回避策としては、同じ場所のCLAUDE.mdに@AGENTS.mdと書き、通常の読み込み経路から参照させる方法が示された。Anthropicの公開ソースでは、既定設定ではCLAUDE.mdがない場合にAGENTS.mdを読むこと、両方を読む設定も用意されていることが確認できる。公開ソース

この話題はHacker Newsで464 points、264 commentsを集めた。ただし、これは技術コミュニティの注目度であり、報告内容の正しさを証明する数字ではない。

まだ分からないこと

影響を受けた利用者の正確な範囲や、修正版が各配布経路へ届く時期は、個人の再現テストだけでは決められない。また、同じ仕組みが他の新機能にも使われているか、利用者へどこまで説明されるかも明確ではない。さらに、AGENTS.mdはCLAUDE.mdがあると既定では読まれないため、テレメトリー以外の設定も結果を左右する。

次に見る点

利用者はまずClaude Codeの版を確認し、2.1.281以降へ更新したうえで、自分の設定でAGENTS.mdが読み込まれるか確かめるのがよい。開発側には、ローカルファイルの読み込みを通信のオン・オフから切り離すこと、読めなかった場合に明示することが求められる。今回の本質は、プライバシー設定そのものではなく、設定変更が別の機能を静かに止めてしまった点にある。