Claude 用量小工具 Claude Usage Widget

我每天用 Claude 的時間很長，最怕的是做到一半額度用完。電腦上的 Claude Code 會在狀態列顯示用量，但人不在電腦前就看不到。

有一天在 Threads 上看到有人分享自己做的用量通知列，我心想「我也要一個」，於是做了手機版：iPhone 主畫面和鎖定畫面，隨時看得到「5 小時額度」和「每週額度」各用了多少、還要多久重置。

專案背景

額度就像手機流量，用完之前沒感覺，用完的那一刻才發現。如果在通勤時就知道剩多少，就能決定今天要先做哪件大事、哪些小事留到明天。

核心設計

1. 不碰登入憑證。 用的是電腦版 Claude Code 狀態列本來就會拿到的公開數字，不需要也不會讀我的 Claude 帳號密碼。
2. 只傳兩個數字。 傳出去的只有百分比和重置時間，就算外洩，別人也只知道「她今天用了多少」。
3. 省著傳。 數字變動超過 5%，或隔一小時，才更新一次。Cloudflare 免費方案的額度綽綽有餘，不用另外付錢。
4. 哪台最新就看哪台。 筆電和家裡的 iMac 都會回報，手機永遠顯示最近一次回報的數字。

技術架構

• 來源：電腦版 Claude Code 的狀態列，每次數字變動就在背景「抄一份」
• 中繼站：一個 Cloudflare 免費的小型雲端程式，負責收下最新數字、給手機讀
• 顯示：iPhone 上用 Scriptable 做的小工具，主畫面放中尺寸、鎖定畫面放長方形，深淺色跟著系統自動切換

工程挑戰

• 第一天就差點把免費額度用爆。 一開始數字一變就傳，兩台電腦一天傳了五百多次，收到免費方案的警告。改成「變動 5% 或隔一小時才傳」之後，一天降到一百多次。
• 手機那頭的密碼不能放進正本。 小工具的程式碼正本不含讀取密碼，放到手機上時才填進去，避免分享程式碼時不小心把密碼一起送出去。

功能亮點

• 手機主畫面、鎖定畫面直接看額度
• 5 小時額度、每週額度、重置倒數一次看完
• 不碰帳號憑證，只傳百分比
• 兩台電腦都會回報，隨時是最新數字
• 完全用免費方案搭起來