2026年3月、仕事の途中で使用量制限に止められて、ようやくClaudeのSettingsを開いた。追加使用量はすでに84%、七日間の使用量も半分を超えていた。
ずっと目に入る場所に表示があれば、少なくとも次の仕事を早めに調整できるかもしれない。そう思ってClaudeと協力して作ったのが、「Claude 用量喵喵」というChrome拡張機能だ。ツールバーには茶トラが一匹いて、クリックすると使用量のカードが開く。
ここに記すのは、当時の開発経験だ。その後のツールのバージョンやサービスの画面は変わりうる。以下の当初の画面を、現在すべてのアカウントで得られる結果としては扱わない。
何をするものか
表示を置いたのは三か所だ。ツールバーのバッジ、クリックして開くポップアップ、claude.aiのページ上のフローティングステータスバー。目的は単純で、使えなくなってから使用量を確認することを思い出す、という状態を避けたかった。
当時の設計では、上半分にアカウント側の五時間、七日間などのパーセンテージと、追加使用量の項目を置いた。下半分には、そのブラウザのウェブ上の会話から観察できるトークン数と料金の推定値をまとめた。
ここでいう「料金」は、意味を明確にする必要がある。推定トークン数に、あるモデル料金表の単価を掛けたものは、API料金に換算した推定値だ。Pro/Maxで実際に差し引かれた額でも、支払いの請求書でもない。料金表、モデルの判定、推定方法が違えば、結果も変わる。
色やアイコンは注意を向けるきっかけにはなるが、あとどれだけ仕事を終えられるかまでは教えてくれない。画面の数字は、情報源、更新時刻、エラーの状態と合わせて見る必要がある。
二つの経路は、それぞれ別の問いに答える
一つ目の経路は、claude.aiの内部使用量エンドポイントにアカウント情報をリクエストする。公開コードのbackground.jsには、この流れと、五時間、七日間、追加使用量などの項目を解析する処理がある。
データがサービス側から来るからといって、公開された仕様があり、長期にわたって依存できる開発者向けAPIとは限らない。項目、権限、応答形式が変われば、ツールの保守が必要になる。リクエストの失敗も、使用量がゼロだとは解釈できない。
二つ目の経路は、claude.aiのページ内で会話のリクエストとストリーミング応答を観察し、このブラウザが捕捉できた内容を整理する。アカウントのすべての利用を網羅する保証はなく、推定値をモデルの実際の課金に使われる完全なトークン記録とみなすこともできない。
つまり、上側のプランの使用率と下側のウェブ上の推定値は、対象範囲も単位も異なる情報だ。並べて観察することはできても、そのまま引き算したり、同じ分母に対する誤差として扱ったりはできない。
Claude Codeについても分けて説明する必要がある。Anthropicのプラン説明によれば、サブスクリプションでログインする場合、ClaudeとClaude Codeはプランの制限を共有し、API課金は別の扱いになる。ウェブ上の捕捉機能でCLIの会話を一件ずつ見られないからといって、CLIがアカウント側のプラン使用率に影響しないわけではない。
二つの経路を残したいのは、それぞれから何が分かり、何がまだ分からないのかを見たいからだ。
手を動かす前に、まず一通り調べた
プログラムを書き始める前に、関連するツールを十数個探した。その範囲にはmacOSのネイティブアプリがかなりあり、当時の私は、欲しい画面と言語の条件を満たす組み合わせを見つけられなかった。
これは限られた検索の経験だ。すべてのツールが英語だけだとか、ほかのプラットフォームには選択肢がないとか、二つの情報源を並べた画面を誰も作っていない、という結論にはできない。
私にとって、作りたい方向はそれでも明確だった。Chrome拡張機能として表示し、二つの経路を一緒に置き、まず中国語を使いやすくする。当時はさらに英語と日本語を加え、ブラウザの言語に合わせて画面を切り替えられるようにした。
これらは当時の選択だ。対応範囲やインストール方法は、プロジェクトの現在のバージョン説明に戻って確認する必要がある。一つの開発記録から、すべての環境でテスト済みとは保証できない。
開発でつまずいたこと(技術に興味がなければ読み飛ばしてよい)
一つ目は応答形式だった。内部エンドポイントへの接続には、従える公開の形式仕様がなかった。初めてポップアップで生のJSONを見てから、少しずつ項目を理解していった。デバッグには役立ったが、一度解析できたからといって、以後変わらないわけではないとも気づかされた。
デバッグ情報を残すことは役に立つ。ただ、生の応答にはアカウントや組織の情報が含まれる可能性がある。問題の相談に使うなら、内容を丸ごと貼るのではなく、不要な項目を先に取り除きたい。
二つ目は、スクリプトを実行する環境だった。Chromeのcontent scriptの説明では、ページと拡張機能のisolated worldを区別している。最初は隔離された環境でwindow.fetchを変更したが、ページのリクエストを捕捉できなかった。その後、関係するスクリプトをMAIN worldに置き、イベントを通じてデータを橋渡しの層へ戻すようにした。
これで解決したのは、スクリプトがどこで動くかという問題だ。ページの実行環境に入るなら、データの境界も慎重に見る必要がある。機能が動いたからといって、隔離や安全性まで確認できたとは言えない。
三つ目はアイコンだった。前後で三版を作り、茶トラの参考写真を使って、耳や額のM字模様を、ようやくイメージに近づけた。今回の協働では、言葉で説明し続けるより、具体的な参考が役に立った。
限界を先にはっきりさせておく
今、より大切だと思うのは、画面でアカウント情報、部分的な推定値、読み取りの失敗を明確に分けることだ。目立つパーセンテージが一つあっても、時刻や集計の意味が見えなければ、判断を誤る可能性は残る。
ログインとデータの行き先も、正確に説明したい。同じ公開バージョンのmanifestには、storage、alarms、claude.aiへのホストアクセス範囲とページスクリプトが設定されている。backgroundではcredentials: 'include'を使い、リクエストにログイン状態を引き継いでいる。これは、プログラムがCookieの値を直接読み出しているという主張とは異なる。
ローカルストレージを使うことは、外向きのリクエストがまったくないことを意味しない。このツールは、そもそもclaude.aiからデータを取得する。ソースコードが公開されていれば確認はしやすくなるが、バージョン、権限、実際の配布パッケージの確認に代わるものではない。
今回はアカウントにログインし直してテストしておらず、Web Storeのパッケージやすべての依存関係について、完全なセキュリティ監査もしていない。本稿で説明できるのは、開発の考え方と公開コードに見られる構成の一部だ。現在、すべてのアカウントで使えるという機能保証にはできない。
作りたかったのは、いつも、自分が少し早めに使用量へ目を向けられる小さなツールだった。分からないところを明確に示すほうが、どの数字も精密に見せるより、もともとの目的に近い。
**2026年11月改訂:**3月の開発経験を残しながら、情報源、推定値の意味、ログイン状態の使い方、公開ソースコードから言える範囲を明確にした。


💬 コメント
読み込み中...