Author

technews

世界の技術ニュースをリアルタイムでキャッチし、日本語でわかりやすく発信。AI・半導体・スタートアップから規制動向まで、グローバルテックシーンの「今」をお届けします。

Claude Code が AGENTS.md を読まない理由は telemetry の有無だった

Claude Code に AGENTS.md のサポートが入ったのに、肝心のファイルが読まれない。しかも原因はローカルの設定やファイル名の間違いではなく、telemetry を切っているかどうかだった、というのが元記事の話だ。見た目は「対応済み」なのに、実際には特定の環境で黙って無効化される。こういう挙動は、使う側からするとかなり厄介だと思う。

telemetry を切ると AGENTS.md が消えるまで

元記事は、Claude Code 2.1.277 で AGENTS.md のサポートが追加されたものの、その読み込みが remote feature flag の背後に置かれている、と指摘する。内部では agents-md という built-in plugin があり、2.1.280 の bundle では tengu_agents_md_mod というフラグを取りにいく。ここでフラグが取れない、あるいは false と判定されると、その plugin は unavailable になり、ローカルに置いた AGENTS.md は読み込まれない。

問題は、この判定がネットワーク前提になっていることだ。AGENTS.md 自体は作業ディレクトリにあるただの Markdown ファイルで、本来ならネット接続なしに読めるはずなのに、実際にはサーバー側のスイッチが先に立つ。元記事の筆者は、空のディレクトリに AGENTS.md を置き、そこに「PERIWINKLE」というカナリア語を書いて、claude -p でその語を答えさせるテストをした。テストは新しい構成ごとに 2 回セッションを回し、最初のセッションでフラグを取り、2 回目でその結果を使う形にしている。

結果ははっきりしていた。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 を立てると feature が止まり、記事が参照している issue の説明どおりになる。DISABLE_TELEMETRY=1 でも同じで、どちらか一方でも立っていると AGENTS.md は読み込まれない。しかも 0 を入れても有効化にはならない。環境変数のドキュメントでは「何か値が入っているだけで効く」扱いらしいが、直感的ではない。プロジェクトの .claude/settings.json に、環境変数を消す設定を書いても効かず、1つの repo だけでこの feature をオンにする方法はないという。

さらに気になるのは、どの場合も警告が出ないことだ。session は始まり、model は project instructions を見ないまま答えるが、ファイルが飛ばされた事実は何も知らせない。元記事は Bedrock や Vertex、あるいは third-party gateway を使う場合も同じ問題に触れている。そこではフラグが true になりようがないからだ。筆者は、回避策として CLAUDE.md に @AGENTS.md を 1 行だけ書く方法を使っている。この import は telemetry を切っていても動き、CLAUDE.md があると AGENTS.md の内容を引っ張ってこられる。ただし、これは本来 AGENTS.md サポートがやりたかった「ファイルを 1 つにまとめる」効果を、別の場所に逃がしているだけだ。

telemetry 設定でローカルの指示まで消えるのは、かなり筋が悪い

私はこの話を読んで、いちばん引っかかったのは「telemetry を切ると診断が減る」以上の影響が出ている点だと思った。普通、プライバシー設定をいじるときに想像するのは、利用状況の送信やクラッシュ報告が減ることだ。ところがここでは、ローカルディスクにある指示ファイルの読み込みまで止まる。しかも黙って止まる。これはかなり乱暴な設計に見える。ローカルの Markdown を読むだけなら、サーバーに何も返さなくても済むはずだからだ。

もちろん、段階的ロールアウトのために remote feature flag を使いたい事情は分かる。新機能を少しずつ出すのは、製品開発としては珍しくない。だが、その対象が「ネットワーク越しに何かをする機能」ならともかく、今回のように入力がすでに手元にある機能まで巻き込むのは納得しにくい。フラグが取れなかったときのデフォルトを「何もしない」にするのではなく、文書どおりの動作に倒すべきだったのではないかと思う。少なくとも、そこで止めたなら止めたと見える形にしてほしい。

AGENTS.md を使う人ほど、この無言の失敗に気づきにくい

面白いのは、この問題が AGENTS.md を真面目に使いたい人ほど刺さることだ。複数の agent で同じ指示を共有したい人は、たいてい出力や送信内容にも敏感だし、policy の切り分けにも気を配る。つまり telemetry を切る側の人だ。そういう人に対して、「AGENTS.md に対応した」と告げながら、実際には無言で無効化しているのは相性が悪すぎる。

しかも筆者が指摘しているように、ほとんどの人は binary を grep したり、カナリア語で実験したりしない。普通は「モデルが指示を無視した」と受け取るはずだ。すると人は prompt をいじり始める。実際にはファイルがモデルに届いていないのに、そこを疑わせるのが最悪だという話だ。ここでの問題は単なる bug ではなく、失敗の兆候を消してしまう UX だと思う。見えない失敗は、ユーザーを間違った改善に誘導する。

1 つの共有ファイルにしたいのに、またコピーと同期の話になる

元記事の後半で筆者は、AGENTS.md の理想像についても触れている。たとえば Codex は ~/.codex/AGENTS.md のような global な共有ファイルを読めるし、Claude Code でも /import で user の CLAUDE.md に取り込める。ただし、そのコピーは元ファイルの後続変更を追わない。結果として、複数の agent で同じ指示を使いたい人は、結局どこかで @ import を張り替えたり、同期の仕組みを自前で持ったりすることになる。

さらに筆者は、shared agent skills の扱いにも不満を示す。Codex は .agents/skills と ~/.agents/skills を見るのに対し、Claude Code 2.1.280 は /import でそれを .claude/skills にコピーするだけだという。コピーは元とずれるので、筆者は .claude/skills を ../.agents/skills へ向ける symlink を使っている。これもまた、本来なら製品が吸収してくれるべき手間を、ユーザーが逃がしている形だ。

私がこの件で少し強く感じたのは、AI 補助ツールほど「設定ファイルが読まれない」ことの影響が大きいという点だ。人間相手なら会話で埋められるが、agent は指示の取りこぼしをその場で自分で説明してくれない。だからこそ、読み込み失敗は silent であってはいけない。少なくとも、AGENTS.md があるのに無視したなら「今は telemetry が無効なので読みませんでした」と出すべきだったと思う。機能を隠すのではなく、動いていない事実を見せる。それだけで、かなりの混乱は避けられたはずだ。

参考: Claude Code reads AGENTS.md only when telemetry is on

同じ著者の記事

MacのスクリーンタイムでApple Intelligenceを止める方法が案内された

Apple Intelligenceは、Macの使い勝手を大きく変える一方で、家庭や学校、業務の現場では「使えると困る」場面も出てきます。Appleが今回案内したのは、まさにそのための制御方法です。Macのスクリーンタイムを使い、作文ツールや画像生成、他社製のAI拡張といった機能へのアクセスを個別に止められるようにしています。単なる便利機能の紹介ではなく、AI機能を“使わせない”ための手順を前面に出しているのが面白いところです。 Appleのサポート記事は、MacのスクリーンタイムでApple Intelligenceの一部機能へのアクセスを制限する方法を説明している。対象になるのは、作文ツール、画像作成機能、そしてインテリジェンス拡張だ。ここでいうインテリジェンス拡張は、ChatGPTのような他社製AIプロバイダの拡張を指す。つまりAppleは、Apple純正のAI機能だけでなく、外部AIとつながる入口までまとめて制御できると案内している。 手順の土台になるのは、Macの「システム設定」から「スクリーンタイム」を開き、「コンテンツとプライバシー」の制限をオンにすることだ。そのうえで「

papoo.work

ChatGPTの「広告用クッキー」が、他サイトの行動をつなげてしまう話

ChatGPTを使っているだけなのに、その識別子が広告経由で別サイトの行動と結びつく――元記事は、そんな仕組みがOpenAIの広告基盤で動いていると指摘している。話が重いのは、対象がふつうの広告ネットワークではなく、会話の中に個人的な相談が集まりやすいChatGPTだからだ。しかも、ユーザーがログアウトしていても動くとされる。広告計測は珍しくないが、生成AIサービスの中で同じ発想がそのまま使われると、見え方はかなり変わる。 元記事が中心に扱っているのは、OpenAIの広告集計用の仕組みだ。著者によれば、`bzr.openai.com` のコレクターが `__obi` というCookieをセットし、その値は `openai.com` ドメインに紐づけられる。まずChatGPT側で、この識別子がアカウントに結びついた状態で作られる。著者が確認した流れでは、`chatgpt.com` 上のクライアントが16バイトの乱数を作り、`POST /backend-api/bazaar/obi/sync-token` あるいはログアウト時の `/backend-anon/` に送る。するとバックエンド

papoo.work

ZCode が黙って残す、作業フォルダごとの“雲の上の複製”

AI コーディング用のデスクトップアプリが、作業中のコードをどこまで見ているのか。そんな不安を、かなり具体的な形で突きつけたのが今回の話だ。調べたのは Zhipu の公式アプリ「ZCode」で、利用者のワークスペースや Git 履歴が、気づかないうちにクラウドへ送られているのではないかという疑いが出発点になっている。単なるテレメトリの話ではなく、実際にどのファイルが集められ、どう暗号化され、どこへ送られるのかまで追っているのが重い。しかも、止めるつもりで設定画面を触っても止まらない、というのがいちばん不気味だ。 元記事の著者は、ディスク容量を整理している最中に `~/.zcode` が 700MB を超えていることに気づいた。中を追うと、`v2/checkpoints/` に 313MB の `.enc` ファイルが残っており、その横に状態メタデータが置かれていた。そこにはワークスペースのパス、暗号化後サイズ 313070842 バイト、元のワークスペースサイズ 345549173 バイト、種類が `baseline` であること、さらに失敗回数が 564 と記録されていた。著者の読み

papoo.work

Claude Codeの更新履歴が示す、ツールとしての成熟

Claude Codeの changelog は、単なる修正一覧ではなく、この開発ツールがどう現場向けに育ってきたかをそのまま映しています。今回のページには 2.1.277 を中心に、細かな不具合修正から管理機能、プロキシ対応、プラグイン周りの改善まで、かなり大量の変更が並んでいました。生成AIの話題は新機能ばかりが目立ちますが、実際に使う人に効くのは、こうした地味な修正の積み重ねです。だからこそ、この changelog を読む意味があります。 この changelog は GitHub 上の `CHANGELOG.md` から生成されていて、`claude --version` で手元の版を確認できる、と案内しています。ページで最上位に出ているのは 2.1.277 で、日付は September 18, 2026 です。ここで追加されたのは、まず `CLAUDE.md` がないプロジェクトでは `AGENTS.md` を読むようにした点です。プロジェクトごとの指示ファイルの読み方を広げた形で、設定画面の “Project instructions” から切り替えられますが、Bedr

papoo.work

手元のページを自分だけの検索エンジンにする「Hister」

ウェブで見つけた情報をあとから探し直せない、という悩みは意外と根深い。ブックマークだけでは足りず、ブラウザ履歴も断片的で、ローカルに置いた資料とネット上で読んだページが別々に埋もれていく。GitHubで公開されている Hister は、その散らばった記憶をまとめて引ける「自分専用の検索エンジン」を掲げるプロジェクトだ。しかも、単なるローカル検索ではなく、ブラウザ拡張、terminal、web UI、MCP 経由のAI連携まで含めて見せているのが面白い。個人向けの検索が、ただの便利機能ではなく、情報の持ち方そのものを変える段階に来ている、と感じた。 元記事によると、Hister は「Your own search engine」と名乗るプライベート検索エンジンで、主に自分が訪れたページや手元にあるファイルを対象に全文検索できる。特徴は、タイトルやURLだけを拾うのではなく、ページ本文やファイルの中身まで索引化する点だ。あとで探したい情報を、見出しの雰囲気やサイト名ではなく、実際にその場で目にした言い回しから引き当てられる。 使い方も、かなり具体的に案内されている。最新リリースからバイナリ

papoo.work

Flockカメラの中身が流出して見えた、監視網の素顔

街角や道路脇にある監視カメラは、外から見るとただの黒い箱に近い。だが、その中で何を撮り、どう記録し、誰がそれを見られるのかは、たいてい見えないままだ。今回のWIREDの報道は、ハッカー集団がFlock Safetyのカメラを実地で取り外し、内部データをほぼ丸ごと持ち出したことで、その「見えない部分」がかなり具体的に明らかになった話だ。単なるいたずらや破壊行為の話ではなく、監視インフラがどう動いているのか、そしてその仕組みがどこまで広がっているのかを示す材料になっている。 WIREDによると、匿名のハッカー集団 stegan0gram は道路上のFlockカメラを物理的に外し、内部ストレージをコピーしたうえで、復号に必要な鍵も端末内から見つけ出した。入手したデータは404 Mediaと共有され、さらに透明性団体Distributed Denial of Secretsを通じてWIREDも解析に加わった。Flockは、端末側で暗号化されていると説明してきたが、今回の事案では、その「端末側の保護」をすり抜ける形で、動画や静止画、ログの一部が復元された。 解析で見えたのは、カメラが単にナンバー

papoo.work

FirefoxにMistralのAIが入る意味

ブラウザにAIが組み込まれる動きは、もう珍しくありません。ただ今回の話は、単に「検索の横にチャット欄が付いた」という程度ではなく、プライバシーやデータ保持の考え方まで含めて、誰がAI体験を握るのかを問い直す内容です。MistralとMozillaが組むことで、Firefoxの中にあるAIアシスタントがどう変わるのか、そしてそれがオープンなAIの行き先にどう関わるのかを見ていきます。 MistralはMozillaとの提携を発表し、FirefoxのAIブラウジングアシスタント「Firefox Smart Window（beta）」を自社のモデルで支えると明らかにしました。Smart Windowは、複雑な検索結果を整理したり、いったん離れてしまった重要な情報を思い出したり、ブラウザのタブにある内容を手がかりに関連情報を示したりするための機能です。Mistralによると、この機能はまずフランスと北米の利用者向けに提供され、英国とドイツは年内に続く見込みだとしています。 発表文の中心にあるのは、「open, private and multilingual AI」をブラウザに持ち込む、という

papoo.work

1つのファイルで動くアプリ、Capsuleが目指すもの

アプリを「インストールして使うもの」から、「ファイルとして渡して、そのまま開くもの」に変えようとしているサービスがあります。Capsuleは、その考え方をかなり正面から押し出したツールです。元記事では、アプリの見た目やデータ、実行に必要な要素を1つの `.capsule` ファイルにまとめ、メールやWhatsApp、AirDropで送れると説明しています。単なるデモではなく、AIでアプリを作り、あとから中身を直接更新できる点まで含めて、かなり野心的です。 いまこの記事を取り上げるのは、ローカル実行やプライバシー重視の流れに、AIによるアプリ生成が重なってきたからです。クラウドに預ける前提のSaaSとは違う、新しい「配布」の形を模索しているとも読めます。 Capsuleのサイトは、冒頭からかなり挑発的です。見出しは「Documents that run like apps」。説明文には「One file, entire app. Share like a document, open like an app.」とあり、1つのファイルでアプリ全体を持ち運べることを前面に出しています。`.c

papoo.work

車が勝手に集めて売る「走行データ」の話

自動車はもう、移動手段だけではありません。いま売られている多くの車は、走行距離や速度、夜間走行の有無、位置情報まで集めていて、その一部は外部業者に渡っています。The Verge の Andrew Hawkins は、この問題がようやく表面化しつつある一方で、規制の議論はまだ的外れだと書いています。車の便利さを受け入れる代わりに、私たちはどこまで自分の情報を差し出しているのか。この記事は、その不気味な現実を整理するものです。 The Verge の記事がまず取り上げるのは、General Motors（GM）に対する FTC の制裁です。FTC は今年初め、GM に対して異例の判断を下し、消費者報告機関や第三者のデータブローカーに顧客データを売ることを5年間禁じました。背景にあったのは、GM が長年、顧客の走行データを集めていたことです。たとえば、どれくらいスピードを出したか、夜間に運転したか、といった情報です。 問題は、利用者の多くがそこまで広範囲に情報が集められていると知らなかったことでした。OnStar のコネクテッドサービスに登録したことで、Smart Driver という機能

papoo.work

DHSの“予測型警備”が、米国人の金の流れを追っていた

国境警備当局が、金融データやほかの情報を使って人を絞り込み、地元警察に車を止めさせている――404 Media がそう報じた。しかも対象は、特定の犯罪の疑いがある人とは限らないという。読んでいてまず引っかかるのは、これは単なる監視の話ではなく、日常の買い物や送金、生活のクセから「怪しそうな人」を機械的に選ぶ仕組みに見えることだ。個人の行動を予測して取締りにつなげる発想が、ここまで露骨に運用されているなら、境界線はかなり危うい。 404 Media が明らかにしたのは、Border Patrol が秘密めいた predictive policing、つまり「予測型警備」のユニットを動かしているという話だ。この記事によれば、そのユニットはアメリカ人の金融活動を含むデータを分析し、その情報を地元警察に渡して、車を止めさせる。止められた人たちは、特定の犯罪の容疑者として狙われているわけではない。政府側が、検索や検査の対象として「調べる価値がある」と見なした人たちだという。 記事の説明では、この仕組みの中心にあるのは Border Patrol の予測型警備ユニットで、404 Media はその

papoo.work