Claude Code mods

繁體中文 · English

context-gauge

上面兩條是 Classic 風格（任務進行中、快滿時），最下面是 Terminal 風格。Desktop 和手機 app 用一行高的 SVG 畫用量，字體用系統字體（Windows 是 Segoe UI）；終端與 Terminal 風格用文字畫，永遠一行。

輸入框上方的用量細條，加上可折疊的右側面板。

• Context：用量百分比與 token 數，接近自動壓縮門檻時變紅並顯示 compacts soon
• 額度：5h / 7d 用量與重置倒數，以及本次 session 花費。session 一開始會向 Anthropic 查一次（不用等第一次回應），之後隨時可以在 ◉ 按 ↻ Refresh 或打 /gauge usage 再查（至少間隔 60 秒）
• 任務進行中：思考、輸出、工具各花的時間，tok/s，工具時間軸，■ Stop 按鈕
• 完成通知：一輪超過 20 秒時，結束會跳 toast
• 自動收尾（預設關閉）：5h、週額度各自設定開關與門檻；任務進行中達到門檻時倒數 10 秒，然後在正在跑的那一輪插入收尾指示
• /compact 規則：context 到設定的百分比時，提醒你 /compact（預設 70%），或閒置時自動 /compact
• 模型切換：細條上一個可拖的膠囊滑塊（Claude 橘色填到目前檔位、白色圓鈕）加模型名稱，兩者一起顯示或一起隱藏；按名稱，選擇器在細條內展開：五個檔位、Fast mode、輸出風格，選完自動收起。每一格可選簡稱（sonnet、opus…，跟著最新版）、1M 版本、指定版本（claude-opus-5-5…），或在設定頁輸入任何模型 id。預設 Sonnet low → Sonnet high → Opus medium → Opus xhigh → Fable high；Fable 只給 Max 方案，要在設定頁打開「Max plan」才會解鎖。
• 時間軸：你每則訊息左邊一條色線（綠完成、紅出錯、黃中止），滑鼠停上去浮出卡片（可在設定頁關閉）。細條上的 ≡ 打開 History 視窗：每則訊息的時間、你說了什麼、Claude 做了什麼（各取開頭，不花 token），可篩選，點一下跳回那段對話；AI 一句話摘要預設關閉（每段呼叫一次 Haiku，會用 token）。
• Claude 服務狀態與額度：細條上的 ◉ 在細條內展開 claude.ai、API、Claude Code 等服務的狀態、進行中的事件，以及剛查到的額度；只有按 ↻ Refresh 才會查詢。
• You should know：Anthropic 內建的側邊 agent（cc-plugin-you-should-know@builtin），可在設定頁一鍵開關。
• 設定頁：/gauge settings，或細條旁的 ⚙；分成 Usage / Models / Timeline / Display 四頁

安裝（CLI 和 Desktop 都適用）

claude plugin marketplace add kirishimarisano-rgb/Claude-code-usage-context-cost-show
claude plugin install context-gauge@kirishima-mods

裝好後重開 Claude Code。Desktop 要完全結束再開（Mac 用 ⌘Q），然後在 Code 分頁開本機 session。更新：claude plugin marketplace update kirishima-mods。

不安裝、直接從資料夾跑

git clone https://github.com/kirishimarisano-rgb/Claude-code-usage-context-cost-show
claude --plugin-dir ./Claude-code-usage-context-cost-show/context-gauge

Claude Code Desktop（不能加參數）：在 ~/.claude/settings.json 的 env 加上 mod 的絕對路徑，然後在 Desktop 的 Code 分頁開一個本機 session（不是雲端 session）：

{
  "env": {
    "CLAUDE_CODE_PLUGIN_DIRS": "/Users/you/Claude-code-usage-context-cost-show/context-gauge"
  }
}

Windows 的路徑寫成 C:\\Users\\you\\...\\context-gauge。要改檔後自動重載，再加 "CLAUDE_CODE_PLUGIN_DIR_WATCH": "1"。

| 指令 | 作用 | | --- | --- | | /gauge | 在對話裡顯示儀表（只能顯示文字的客戶端會看到文字快照） | | /gauge pane | 打開右側面板（f 折疊/展開） | | /gauge settings | 設定頁 | | /gauge wrap 5h 90\|on\|off | 5 小時額度的自動收尾 | | /gauge wrap 7d 95\|on\|off | 週額度的自動收尾 | | /gauge compact 70\|remind\|auto\|off | context 到幾 % 時提醒或自動 /compact | | /gauge look classic\|minimal\|terminal | 顯示風格：Classic（深綠/深黃/深紅，預設）、Minimal（低飽和）、Terminal（最原本的文字進度條，Desktop 也用文字畫） | | /gauge size s\|m\|l | 文字大小（預設 M；只對 Classic、Minimal 有效，空間不夠時先精簡內容再縮小） | | /gauge model | 打開模型選擇器（在細條內） | | /gauge model 1-5 | 切到第幾格 | | /gauge models on\|off | 顯示或隱藏模型控制（滑塊與名稱一起） | | /gauge max on\|off | 你是 Max 方案（解鎖 Fable） | | /gauge fast | 切換 Fast mode | | /gauge style [名稱] | 下一個輸出風格，或指定一個 | | /gauge ysk on\|off | You should know 側邊 agent | | /gauge history | History 視窗 | | /gauge status | 查一次 Claude 服務狀態 | | /gauge usage | 立刻向 Anthropic 查 5h / 週額度 | | /gauge summary on\|off | 時間軸的 AI 摘要（會用 token） | | /gauge marks on\|off | 訊息上的時間軸色線 | | /gauge footer auto\|on\|off | 每輪回答下附一行用量；auto（預設）只在沒有客戶端能畫細條時開啟，例如雲端 session |

上方細條只在終端與 Claude Code Desktop 顯示，手機 app 不顯示。右側面板要在終端全螢幕、寬度 110 欄以上才會停靠在右側。雲端 session 沒有可以畫 mod 介面的客戶端，所以只能看 /gauge 的文字快照。

雲端 session（claude.ai/code）

連進雲端 session 的客戶端（網頁、Desktop、手機）都不畫 mod 介面，所以沒有上方細條和面板。改成在每輪回答下面附一行用量：

🟢 ctx 20%  ·  🟢 5h 12% ↻4h17m  ·  🔴 7d 93% ↻1h47m  ·  $5.01  ·  ⏱ 2m13s (think 40s)  ·  14 tools  ·  52 tok/s

這行只顯示給你看，不會進入模型讀到的對話紀錄。

要讓每個雲端 session 都自動裝好，在雲端環境的 setup script 加上：

claude plugin marketplace add kirishimarisano-rgb/Claude-code-usage-context-cost-show
claude plugin install context-gauge@kirishima-mods

讀寫範圍

只讀 session 用量、每輪事件與時鐘。連網只有兩處：查額度（session 開始時一次，以及你按 ↻ Refresh 或 /gauge usage 時）與查服務狀態（只在按 ↻ Refresh 時）。寫入只有畫面、記憶體中的狀態，以及保存在 $.store 的設定（面板是否折疊、設定頁的各項）。不讀寫專案檔案、不執行程式。

/gauge 系列指令的輸出會留在對話紀錄裡，模型讀得到（每次約幾十到一兩百 token；/gauge history 會帶出你先前訊息的開頭）。每輪回答下方那一行和所有細條、面板則只給你看。

會影響對話的只有：■ Stop、自動收尾（插入一段收尾提示）、/compact 規則設為 Auto 時的自動壓縮（壓縮本身會呼叫一次模型），以及你按下的模型、Fast、輸出風格、You should know 切換（透過 /model、/effort、/fast、/plugin 與 /config）。時間軸的 AI 摘要開啟時，每段會呼叫一次 Haiku。

安全性

• 對外連線只有兩個，都是 GET：
  • https://status.claude.com/api/v2/summary.json：只在按 ↻ Refresh 時，不帶憑證。
  • https://api.anthropic.com/api/oauth/usage：session 開始時一次（可在設定頁關閉）、按 ↻ Refresh 或 /gauge usage 時，至少間隔 60 秒。用的是 Claude Code 自己的登入：mod 只拿到一個代號，看不到憑證本身，而且 Claude Code 只會把它送到 Anthropic。
• 會呼叫的 Claude Code 指令固定為 /model、/effort、/fast、/plugin enable|disable cc-plugin-you-should-know@builtin，以及 /config 的 outputStyle；模型 id 只接受英數與 . _ - [ ] :，在輸入與切換時各檢查一次。
• 不執行程式、不讀寫專案檔案；SVG 只放數字與固定標籤，不放你或 Claude 的文字；狀態頁回傳的文字有長度上限。
• 自動收尾插入的提示、自動 /compact 都是固定內容，且預設關閉或只提醒。

已知限制

• 雲端 session 的客戶端不畫 mod 介面，只有文字（/gauge 與回答下方那一行）；雲端 session 的登入也沒有查額度的權限，額度只能從回應裡讀到。
• 用 API key 或企業閘道登入時沒有 5h／週額度可查。
• 手機 app 不畫細條；/gauge 那一列有按鈕。
• 時間軸只記得 mod 載入後的訊息，重開 Claude Code 會清空；少數沒有訊息編號的回合不能跳回。
• mod 讀不到你的方案，Fable 檔位要你在設定頁自己打開「Max plan」。
• Fast mode 是否可用取決於帳號（可能需要 usage credits）。
• 用滑塊切換模型時，對話裡會留下 /model、/effort 的紀錄。

開發

claude plugin validate context-gauge
claude plugin test context-gauge

Claude Widget（Windows 桌面小組件）

釘在桌面上的液態玻璃小組件，一次看所有本機 Claude Code session：

• 左邊：選中的 session 在做什麼（思考、撰寫、執行哪個工具）、待辦清單進度環、已用時間和約剩多久，加上 context、5 小時、7 天用量和花費。
• 右邊中控：每個 session 一列，有狀態燈、目前動作、進度條和時間；滑過去會出現 ■ 停止。
• 結束提醒：超過 10 秒的任務完成、出錯或被停止時，跳 Windows 通知。
• 預設是透明玻璃，桌面直接透出來，底色深淺可以調。也可以改成 Windows 的毛玻璃，但視窗沒被點選時 Windows 會把它換成灰色。
• 可以釘在最上層，或縮成一顆膠囊；位置會記住。有繁中和英文介面。

分兩部分：桌面 App（claude-widget/）和 mod（widget-bridge），mod 負責把每個 session 的狀態送給 App。

安裝

1. App：到 Actions → Claude Widget (Windows) 最新一次成功的建置，下載 claude-widget-windows，解壓後執行安裝檔。安裝檔沒有程式碼簽章，Windows SmartScreen 會跳警告，按「其他資訊 → 仍要執行」。
2. mod：

   claude plugin install widget-bridge@kirishima-mods
   

   如果還沒加過 marketplace，先跑 context-gauge 安裝段落的第一行。
3. 配對：打開小組件 → ⚙，複製 /widget pair … 那一行，在 Claude Code 裡貼上執行一次。之後這台電腦的每個本機 session 都會自動出現。

指令

| 指令 | 作用 | | --- | --- | | /widget | 這個 session 有沒有連上小組件 | | /widget pair <code> | 和小組件配對 | | /widget unpair | 忘掉配對碼 | | /widget on\|off | 開始或停止傳送 | | /widget port <n> | 小組件的連接埠（預設 47615） |

怎麼運作、安全性

• mod 只把狀態 POST 到 http://127.0.0.1:47615，不會連到外網。送出的內容有：專案資料夾名稱、你這次訊息的前 80 字、模型、目前的工具和簡短說明（例如 Bash 的說明或指令開頭、檔名）、待辦清單的標題和進度、context／額度百分比、花費。
• App 只監聽 127.0.0.1。要有配對碼才收資料，瀏覽器網頁送來的請求一律拒絕；每個請求最多 64 KB，最多記 40 個 session。
• App 能要求的只有「停止這個 session 的這一輪」。mod 會核對 turn id，其他指令一律忽略。
• 沒配對前，mod 什麼都不送。

限制

• 「約剩多久」是用待辦清單已完成的比例推算的，Claude 沒列待辦清單時只顯示已用時間。
• 雲端 session 跑在雲端，連不到你的電腦，所以不會出現在小組件裡。
• 通知按了不會跳回對應的 session。
• 目前只建置 Windows 版。

授權

MIT