Tare: 診斷 Claude Code Token 使用量與配額限制

Tare 是一款以本地優先為設計理念的診斷工具，旨在識別 Claude Code 中 Token 消耗過快與配額耗盡的原因。透過分析已儲存在使用者機器上的工作階段日誌，Tare 讓開發者能以簡單的英文進行查詢，藉此確定究竟是哪些檔案、工具或自動化程序正在消耗其配額。

Token 審計與限制診斷

Tare 將原始的工作階段日誌轉換為具備行動力的洞察，超越了單純的 Token 計數，進而識別使用量激增的根本原因。該工具能針對特定的操作問題提供解答，例如：

配額耗盡： 識別使用者是觸及了五小時滾動窗口限制，還是週配額上限。
Token 歸屬： 確定哪些專案、模型或特定檔案消耗了最多的 Token。
uma 識別背景程序或自動化腳本是否正在產生並行工作階段，進而導致成本膨脹。
優化： 比較實施如使用 /clear 重置上下文等策略前後的使用模式。

進階使用量分析

與簡單的 Token 計數不同，Tare 實作了多個邏輯層以確保報告的準確性：

去重： Claude Code 的日誌格式經常多次重複 API 回應；Tare 會對這些進行去重處理，以防止總量被誇大（在某些情況下，誇大程度可能高達 86%）。
上下文成本計算： Tare 將檔案讀取的成本歸屬給工作階段中隨後的每一條訊息，因為它意識到在長工作階段初期讀取的大型檔案會持續佔據上下文窗口。
滾動窗口追蹤： 該工具會追蹤五小時的滾動窗口，以告知使用者在被鎖定時，其配額確切的佔用程度。
自動化偵測： Tare 能辨識出數百個短暫且並行的工作階段特徵，這通常表示是腳本而非人類互動。

隱私與技術需求

Tare 預設設計為注重隱私。所有的分析都在使用者的本地機器上進行，且腳本不會進行任何網路連線。在生成可分享的摘要時，工具會遮蔽提示詞、檔案路徑與帳號識別碼，僅提供總量、日期與工具名稱。

技術需求：

OS： macOS 或 Linux。
Runtime： Python 3.9+。
相容性： 目前僅支援 Claude Code 日誌。

安裝與介面

使用者可以透過以下指令將 Tare 安裝為 Claude Code 的 skill：

npx skills add kelviq/tare -g -y --copy --agent claude-code

安裝完成後，使用者可以透過 Claude Code 中的英文查詢或特定的斜線指令進行互動：

Command	Function
`/tare`	Token 使用量與原因的完整診斷
`/tare usage`	附帶歸屬分析的一目了然面板
`/tare window`	五小時滾動窗口的狀態
`/tare report [days]`	生成並開啟一個 HTML 使用量報告
`/tare tools [days]`	上下文填充工具的分析
`/tare share [days]`	建立一個用於公開分享的遮蔽摘要

社群洞察與替代方案

社群討論突顯了對於 Token 限制這種「黑箱」性質的持續掙扎。有些使用者實作了自定義的狀態列，以即時追蹤使用量，避免突如其來的狀況。

"I just used Claude to write a plug-in which changed the bottom of the CLI to say: ( ) Usage: 34% (resets in 2h 47m) Context: 56%... That way if my usage starts shooting up, it's very easy to notice."

其他使用者指出，配額快速耗盡通常是由於發送多個子代理（subagents）的開放式請求，或是大型上下文快取（context caches）過期，導致重複進行高成本的讀取。