codeburn + ccusage + Tokscale：怎麼看 AI coding 的 token 使用

上個月底收到 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 怎麼用？

快速啟動

npx codeburn

這行指令會直接從 npm 下載並執行 codeburn。它會在本機掃描常見 AI coding tools 的 session 紀錄，並啟動一個互動式的終端機儀表板。

你也可以選擇全域安裝或以 Bun 啟動：

npm install -g codeburn
bunx codeburn
codeburn menubar

這裡展示了其他的安裝與啟動方式，如果你是 macOS 用戶，也可以用 menubar 參數把監控面板直接釘在系統選單列上方便隨時查看。

常用指令

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）進行分析：

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 怎麼用？

快速啟動

bunx ccusage
npx ccusage@latest
pnpm dlx ccusage
ccusage

這是啟動 ccusage 工具的幾種方式，你可以直接用 bunx 或 npx 跑，也可以全域安裝後直接下 ccusage 指令。

最常用來查看今日帳單的指令：

ccusage daily

這是最常用的基礎指令，用來快速印出今日的 token 消耗清單與花費估計。

常用指令

ccusage daily
ccusage weekly
ccusage monthly
ccusage session
ccusage codex daily
ccusage codex monthly
ccusage codex session

這些指令可以幫你按日、週、月或單次 session 來分組呈現報表，甚至能單獨拉出 Codex 這條產品線的特定消耗明細。

鎖定特定對帳週期：

ccusage daily --since 20260601 --until 20260615
ccusage monthly --since 20260101 --until 20260630

你可以用 --since 和 --until 參數來鎖定特定的起訖日期，方便跟每個月的信用卡帳單進行對帳。

匯出為 JSON 做自動化：

ccusage daily --json
ccusage monthly --json > usage-data.json
ccusage session --json

加上 --json 參數可以把格式化報表轉為 JSON 輸出，你可以直接把這些資料 pipeline 到你自己的自動化統計腳本或資料庫裡。

針對 Codex 專用的離線與快取參數：

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 怎麼用？

快速啟動

bunx tokscale@latest

這行指令會啟動 Tokscale，它會自動掃描本機上所有支援的 AI coding 終端工具，並呈現視覺化的 contributions 統計。

同步到 leaderboard：

bunx tokscale@latest submit

跑 submit 指令可以把你的 token 數據同步到 Tokscale 雲端，生成你的 public developer profile 或參與公開的 leaderboard 排名。

同步特定平台的本地數據：

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: <https://github.com/getagentseal/codeburn>
2. ccusage GitHub: <https://github.com/ccusage/ccusage>
3. Tokscale GitHub: <https://github.com/junhoyeo/tokscale>
4. Tokscale npm: <https://www.npmjs.com/package/tokscale>