--- slug: codeburn-ccusage-token-usage-analysis title: codeburn + ccusage + Tokscale：怎麼看 AI coding 的 token 使用 status: published excerpt: codeburn 看整體 spend、模型比較與浪費，ccusage 看 daily / monthly / session usage，Tokscale 則補上跨 agent 的 TUI 與可視化面板。這篇把三者的定位、指令、來源與分工整理在一起。 category: AI Tools tags: [codeburn, ccusage, tokscale, token, observability, ai-tools, cli] author: Seer author_role: Author read_time: 11 min cover: "/static/codeburn-ccusage-token-usage-analysis-cover.png" closing_note: "自動化的代價，是把原本花在思考上的時間，轉移到了觀測與治理帳單的數字上。" published_at: "2026-06-24T06:29:56Z" updated_at: "2026-07-04T15:05:20Z" --- 上個月底收到 API 帳單時差點沒昏過去。我只是叫 Claude Code 幫我重構了一個 React 元件，居然就燒掉了十幾塊美金。這讓我痛定思痛，決定把本機上所有 AI coding tool 的 token 消耗情況徹底查個清楚。 當我們同時在用 Claude Code、Codex、Cursor 或是 Antigravity 這些 AI 輔助開發工具時，最容易遇到的問題往往不是「能不能做」，而是：**我的 token 到底花去哪了？** 有時候是某個模型單價太貴，有時候是模型陷入無限重試（retry）的死循環，或者是對話 session 太長導致每次 prompt 都送進巨大的 context。為了解決這個問題，我建議把觀測拆成三層： - **codeburn**：負責看整體 spend、進行模型費用比較與無效花費（waste）分析。 - **ccusage**：負責產生 daily / weekly / monthly 的 usage 報表與 session 明細。 - **Tokscale**：提供跨 Agent 的 token 整合觀測、TUI 視覺化面板與開發 contributions 貢獻圖。 --- ## 這三套工具的定位 ### 1. codeburn：看整體花費，揪出帳單裡的無效浪費 `codeburn` 是一個 local-first 的 AI usage 觀測工具。它會去讀取你本機上已經產生的 session 歷程紀錄檔案，然後把 token 數量、成本、使用的模型與專案等資訊做關聯分析。 它強在： - 提供互動式的終端機 TUI 儀表板。 - 可開網頁瀏覽器檢視視覺化圖表。 - 內建模型性價比比較與「浪費檢測器」。 - 支援跨裝置的 usage 整合。 ### 2. ccusage：快速查 report、查 session、適合腳本自動化 `ccusage` 的定位更偏向傳統的 CLI 報表工具。它把 coding agent 的使用數據整理成日報、週報與月報。如果你只想快速用一行指令知道「我今天花多少錢」、「某個 session 撈了多少 token」，用它最省事。 ### 3. Tokscale：跨 Agent 的視覺化看板 `Tokscale` 是專為複數 AI 工具設計的 **token 統合觀測面板**。它主打極高的 CLI 執行效能與精美的 dashboard，功能特色包含： - token usage 與 costs 的趨勢分析。 - 類似 GitHub 的 2D / 3D token contribution 綠格子圖。 - 支援 public profile 與團隊內部的 leaderboard。 Tokscale 支援的 AI clients 來源非常廣泛，包含 Antigravity、Claude Code、Cursor、Roo Code、Warp 等幾十種工具，非常適合拿來做跨工具的統一管理。 --- ## codeburn 怎麼用？ ### 快速啟動 ```bash npx codeburn ``` 這行指令會直接從 npm 下載並執行 `codeburn`。它會在本機掃描常見 AI coding tools 的 session 紀錄，並啟動一個互動式的終端機儀表板。 你也可以選擇全域安裝或以 Bun 啟動： ```bash npm install -g codeburn bunx codeburn codeburn menubar ``` 這裡展示了其他的安裝與啟動方式，如果你是 macOS 用戶，也可以用 `menubar` 參數把監控面板直接釘在系統選單列上方便隨時查看。 ### 常用指令 ```bash codeburn today codeburn month codeburn overview codeburn report --from 2026-06-01 --to 2026-06-15 codeburn report -p all codeburn report --format json codeburn status codeburn export codeburn export -f json codeburn web codeburn optimize codeburn compare codeburn yield codeburn models ``` 這些是 `codeburn` 的常用 CLI 指令，可以用來輸出特定時間區間的報告、比較各模型的性價比，或者是將統計結果匯出成 JSON 格式供後續分析。 如果你只想針對特定 provider（例如 Claude）進行分析： ```bash codeburn overview --provider claude codeburn optimize --provider claude codeburn compare --provider claude codeburn models --provider claude ``` 你可以加上 `--provider` 參數來過濾特定的 AI 供應商，例如這裡專門針對 Claude 帳單做深入的優化分析與費用比較。 ### 它能抓出什麼細節？ codeburn 不只給你看個總金額，它還能拆解出： - 哪個專案或哪項 task 一直重跑。 - 工具呼叫（tool call）與 MCP server 所佔的 token 比例。 - 緩存命中率（cache hit rate）對花費的實際影響。 - 哪些 session 改了很多 code，最後卻因為編譯失敗被 reverted 掉（無效花費）。 這能幫你快速看清哪些錢是真正被轉換成 production 代碼，哪些則是讓 AI 在那裡做白工。 --- ## ccusage 怎麼用？ ### 快速啟動 ```bash bunx ccusage npx ccusage@latest pnpm dlx ccusage ccusage ``` 這是啟動 `ccusage` 工具的幾種方式，你可以直接用 bunx 或 npx 跑，也可以全域安裝後直接下 `ccusage` 指令。 最常用來查看今日帳單的指令： ```bash ccusage daily ``` 這是最常用的基礎指令，用來快速印出今日的 token 消耗清單與花費估計。 ### 常用指令 ```bash ccusage daily ccusage weekly ccusage monthly ccusage session ccusage codex daily ccusage codex monthly ccusage codex session ``` 這些指令可以幫你按日、週、月或單次 session 來分組呈現報表，甚至能單獨拉出 Codex 這條產品線的特定消耗明細。 鎖定特定對帳週期： ```bash ccusage daily --since 20260601 --until 20260615 ccusage monthly --since 20260101 --until 20260630 ``` 你可以用 `--since` 和 `--until` 參數來鎖定特定的起訖日期，方便跟每個月的信用卡帳單進行對帳。 匯出為 JSON 做自動化： ```bash ccusage daily --json ccusage monthly --json > usage-data.json ccusage session --json ``` 加上 `--json` 參數可以把格式化報表轉為 JSON 輸出，你可以直接把這些資料 pipeline 到你自己的自動化統計腳本或資料庫裡。 針對 Codex 專用的離線與快取參數： ```bash ccusage codex daily --speed fast ccusage codex daily --speed standard ccusage codex daily --speed auto ccusage codex session --compact ccusage codex session --offline ``` 這是 `ccusage` 針對 Codex 特有的過濾指令，可以用來過濾不同推理速度下的 token 消耗與離線快取狀態。 --- ## Tokscale 怎麼用？ ### 快速啟動 ```bash bunx tokscale@latest ``` 這行指令會啟動 `Tokscale`，它會自動掃描本機上所有支援的 AI coding 終端工具，並呈現視覺化的 contributions 統計。 同步到 leaderboard： ```bash bunx tokscale@latest submit ``` 跑 `submit` 指令可以把你的 token 數據同步到 Tokscale 雲端，生成你的 public developer profile 或參與公開的 leaderboard 排名。 同步特定平台的本地數據： ```bash tokscale antigravity sync tokscale trae sync tokscale warp sync ``` 這幾行指令用於將特定 AI client（例如 Antigravity、Trae 或 Warp）的 usage 記錄同步進 Tokscale 的本地資料庫中。 --- ## 實戰中，我實際怎麼看 token 有沒有爆掉 在開發現場，AI 確實大幅縮短了寫 code 的時間，但如果放任不管，token 消耗很容易在幾個小時內突然暴增。 我現在最常用的方式其實很簡單：**直接拿 Tokscale 去看小時用量**。 我不會每天開很多工具交叉比對，也不會為了觀測再架一套複雜流程。重點就是把 token 消耗拉到小時級別來看： - 這一小時是不是突然衝高。 - 是不是某個 agent、專案或 session 開始吃特別多 token。 - 跟平常同時段相比，有沒有明顯異常。 - 如果突然暴增，就回頭檢查是不是模型在重試、上下文太長，或任務拆得太粗。 Tokscale 對我來說最有用的地方，不是把報表做得多華麗，而是可以快速看出「現在是不是有一段用量不對勁」。只要小時用量突然變高，我就知道該停下來看一下，不要等到月底帳單來了才發現某個任務一路燒上去。 所以這篇前面整理 codeburn、ccusage 和 Tokscale 的分工，但真正在我的日常裡，核心動作就是：**用 Tokscale 追小時用量，確認 token 消耗有沒有突然大增。** --- ## 相關連結 1. codeburn GitHub: 2. ccusage GitHub: 3. Tokscale GitHub: 4. Tokscale npm: