ccusage 是什麼
依它的 GitHub README(2026-10-31 前後查),ccusage 讀編碼 agent CLI 留在你電腦上的本機資料,整理成每日、每週、每月和每個 session 的報表;涵蓋 Claude Code、Codex、Gemini CLI、GitHub Copilot CLI 等多種工具,授權是 MIT,也有離線模式。
差別對照
| ccusage | Budgethelm | |
|---|---|---|
| 主要用途 | 本機用量與成本報表 | 用量報表,加上 agent 卡住時當下停下它 |
| 資料在哪 | 留在這台電腦 | 只上傳時間、工具、模型、token 數和停下紀錄到你的帳號 |
| 多台電腦 | 各看各的本機資料 | 每一台裝了的電腦一起看 |
| agent 空轉 | 事後看報表 | 達到門檻就停下,跳系統通知 |
| 設定檔資安 | 不是它的範圍 | 檢查 AGENTS.md、CLAUDE.md、MCP 設定 |
| 原始碼與費用 | MIT 開源 | 免費使用(付費方案規劃中,見首頁方案) |
ccusage 欄位依其 README;沒寫的就不寫。
什麼時候 ccusage 更適合
- 你只想在終端機看自己這台電腦的用量報表,不想註冊帳號、不想上傳任何東西。
- 你想要開源、可以自己讀程式碼、離線也能跑的工具。
- 你不需要自動停下 agent,也不需要跨電腦彙整。
Budgethelm 的長處是「停下來」和「多台電腦一起看」。兩者並不衝突,可以同時裝;想看 Budgethelm 怎麼處理 Claude Code,見 Claude Code 費用指南。
其他也常被拿來比較的選擇
- Claude Code 內建 /usage:不用裝任何東西,看這台電腦的用量。差別見 /usage 與 Budgethelm。
- Claude-Code-Usage-Monitor:開源(MIT),在終端機即時顯示 Claude Code 用量,並預測什麼時候會用完。
- better-ccusage:開源(MIT),讀本機 JSONL 紀錄分析用量與成本,涵蓋 Claude Code、Droid、OpenCode、Codex 等工具。
以上依各專案 GitHub 說明(2026-10-31 前後查);只寫它們自己寫的功能。
常見問題
- Budgethelm 能取代 ccusage 嗎?
- 看需求。只要本機報表的話,ccusage 就夠了;需要空轉時自動停下、跨電腦彙整或資安掃描,才是 Budgethelm 多出來的部分。
- 兩個可以同時用嗎?
- 可以。它們各自讀本機紀錄,互不影響。
- Budgethelm 會上傳我的對話嗎?
- 不會。只上傳時間、工具、模型、token 數和停下紀錄;對話、程式碼和 API key 不離開你的電腦。