claude.ai の使用量を Mac のデスクトップに常時表示する（5時間ウィンドウと週間の上限）

この機能が読むもの、読まないもの

この機能の範囲は意図的に狭くしてあります。最初にその境界をはっきりさせておきます。

• 読むのは使用率であって内容ではありません。 claude.ai 上のご自身の組織の使用量エンドポイントへリクエストを 1 つ送り、返ってくるのは使用率とリセット時刻の組です。5時間ウィンドウ、7 日間のウィンドウ、そして特定のモデルに紐づく上限。それがすべてです。
• サインインはアプリが用意したブラウザの中で、お客様として行います。 貼り付けるキーも、管理するトークンもありません。表示されるのは claude.ai 自身のサインインページで、その後に残るのは通常のセッション Cookie です。
• そのセッションは分離して保管されます。 この機能専用のデータストアに保存され、メディアコレクターが使うストアとも Safari とも共有されません。「サインアウト」は整理ではなく、ストアごとの削除です。
• アップロードは一切ありません。 数値はお使いの Mac の中で表示されます。Emerald Tools のアカウントもなく、この機能のために開発者が運用しているサーバーもなく、数値の控えがどこかに残ることもありません。
• アカウントには何の変更も加えません。 上限はお客様のアカウントのものです。ウィジェットはその中の現在地を示すだけです。

数値が表示される 2 か所

全体を見る場所はダッシュボードの Claude の画面です。「使用量の上限」には「5時間ウィンドウ」と「週間（全モデル）」の 2 行が並び、それぞれにバー・使用率・リセットの表示が付きます。リセットが 1 日以内なら時刻が、それより先なら日付と時刻が出ます。「モデル別の上限」はその下ですが、アカウントがモデル単位の上限を報告している場合にだけ現れ、1 モデル 1 行で並びます。さらに下には 2 つの注記があります。数値がアカウントから直接取得されていて claude.ai と一致すること、そしてサイト側の使用量ページを開くリンクです。

ちらりと見る場所がウィジェットです。たたまれた状態では 5時間ウィンドウの数値を出します。作業中に動くのがこの値だからです。あわせてリセットまでの残り時間とバーが並びます。展開すると週間の数値が独立した行として加わります。このウィジェットはアプリが持つ 10 種類のウィジェットのうちの 1 つで、残る 9 種類は Mac 自体を計測するもの（CPU・メモリ・スワップ・ディスク・ストレージ I/O・ネットワーク・バッテリー・GPU・サーマル）です。そちらはシステムモニタのウィジェットのガイドで扱います。配置・積み重ね・クリックでの展開の挙動は 10 種類すべてで共通です。

サインインと、その維持

サインインのシートに表示されるのは claude.ai 自身のログインページです。始める前に知っておくとよいことが 2 つあります。

Google ではなくメールアドレスを使ってください。埋め込みの Web ビューの中では、Google は OAuth のサインインを完了させません。処理が固まるのではなく、claude.ai からのエラーとして返ってくるため、知らないと戸惑います。メール経由なら問題なく通ります。claude.ai から確認コードが届き、同じシートに入力すれば、セッションが整った時点でシートは自動的に閉じます。

セッションはいつか切れます。アプリはその理由を 2 つに区別しています。 claude.ai がセッションを無効と報告した場合、アプリは保存していたセッションを破棄します。セッション Cookie だけでなくストア全体を消すのは、失効したセッションの残骸こそが次回のサインインを失敗させる原因だからです。そのうえで再接続を促します。一方、VPN が出口を移動し続けているときなどに起こる、claude.ai の手前のネットワークによる拒否は別扱いです。この場合はセッションを保持したまま、次の試行までの間隔を広げるだけにします。一時的なブロックを失効と同じに扱えば、理由もなくサインアウトさせることになるためです。

保存されるもの、されないもの

このアプリはシステム指標を 1 年分記録します。そのうちどこまでがこの機能に当てはまるのかを、はっきりさせておきます。

システム側の数値（CPU・メモリ・ディスク・GPU・バッテリー・ネットワーク・ストレージ I/O・スワップ）は、お使いの Mac の中で指定された間隔で計測され、ローカルの保存先へ書き出されます。1 分ごとの平均を 1 日分、1 時間ごとの平均を 1 か月分、1 日ごとの平均を 1 年分です。claude.ai の使用量は、現行バージョンではこの保存の対象に入っていません。アプリが保持しているのは最新のスナップショット 1 つだけで、メモリ上にあり、次の取得で置き換わり、アプリを終了すれば消えます。「メトリクス履歴」でグラフにできる指標にも含まれていません。時系列で振り返りたい場合は claude.ai の使用量ページをご覧ください。

仕様と制限

以下はすべて現行バージョンの挙動で、計画ではありません。

• 表示する数値: 5時間ウィンドウの使用率、週間の上限の使用率、アカウントが報告するモデル別の上限。いずれもリセット時刻つき。
• 取得元: サインイン済みのご自身のセッションを通じた、claude.ai 上の組織の使用量エンドポイントへのリクエスト 1 種類。
• 取得間隔: 最大 1 分に 1 回。Claude の画面かウィジェットが表示されている間のみ。手動での再取得はいつでも可能。
• レート制限時: Retry-After が返ってくればそれに従い、無ければ 1 分から倍々に、最長 1 時間まで。
• サインイン: claude.ai 自身のページをシート内に表示。メールでのサインインは可能。Google の OAuth は Google 側が埋め込み Web ビューを拒否するため不可。
• セッションの保存先: この機能だけが使うデータストア。サインアウトで丸ごと消去。
• 通信: claude.ai のみ。お客様の操作の結果としてのみ発生します。Emerald Tools のアカウント・解析・サーバーはいずれもありません。
• 履歴: 現行バージョンでは保存されません。数値はメモリ上に保持されるだけで、グラフにできる 8 種類の指標にも含まれません。
• ウィジェットの大きさ: たたんだ状態で 210×64pt、展開して 280×120pt。
• ウィジェットの配置: 任意のディスプレイの任意の隅、1 隅あたり 3 つまで、隅から 16pt 内側、通常のウィンドウより前面、すべての Space に表示。
• ウィジェットごとの調整: 大きさ 50〜200%、背景の不透明度 0〜100%。警告しきい値は CPU とメモリのウィジェット専用の機能です。
• 色のしきい値: 70% 未満が緑、70% からオレンジ、90% から赤。
• 権限: claude.ai へのサインイン以外に必要なものはありません。画面収録・アクセシビリティ・通知のいずれもこの機能には不要です。
• 動作環境: macOS 14.0 (Sonoma) 以降。

Emerald Tools は独立したアプリです。 Anthropic との提携・承認・出資などの関係はありません。また Claude 自体を利用するための手段でもありません。サインインしたアカウントの使用量を読み取り、お使いの Mac の中で表示するだけのものです。