What is Ccusage?
ccusage 是一款功能強大的命令列介面 (CLI) 工具，旨在為您的 Claude Code 代幣使用量帶來關鍵的透明度。透過分析 Claude Code 所生成的本地 JSONL 使用檔案，ccusage 解決了吃到飽方案用戶的普遍問題：量化實際使用情況、辨識主要開銷來源，以及評估訂閱所帶來的真實價值。它提供詳細且具體可行的報告，協助您管理與優化 AI 互動。
主要功能
我們專注於提供精確的細節和實用的洞察，確保您能完全掌握代幣使用量與支出狀況。
📊 全方位報告套件
存取跨多個維度彙整的使用量，超越單純的每日總計。每日、每週、每月及會話報告讓您能追蹤長期趨勢，並即時辨識哪些對話或時間段產生了最高的消耗。這種細緻的檢視對於回溯性使用分析至關重要。
⏰ 5 小時區塊與即時監控
追蹤 Claude 後端系統所使用的特定 5 小時計費區間內的消耗。這份獨特的區塊報告 (Blocks Report) 提供即時主動監控、成本預測和消耗率計算，給予您早期預警，並幫助您根據底層平台機制管理使用量。
💰 詳細成本與模型追蹤
ccusage 根據目前的代幣使用量和各模型專屬的定價，提供美元預估成本。它會自動追蹤不同 Claude 模型（如 Opus、Sonnet 等）的使用量，並提供模型細項分析 (Model Breakdown) 檢視。此外，它能精確區分標準代幣與快取讀取/建立代幣 (Cache Read/Creation Tokens)，提供您更真實的實際營運成本概況。
🔒 100% 本地化與私密分析
您的隱私至關重要。ccusage 完全在離線模式 (Offline Mode) 下運作，透過讀取 Claude Code JSONL 檔案，在您的機器上本地執行所有分析。絕不會傳輸任何資料或離開您的電腦，確保您的使用模式擁有完整的安全性與資料主權。
🚀 超輕量級與即時存取
與許多複雜的 CLI 工具不同，ccusage 的設計擁有極小的檔案大小。這種對效率的重視意味著您通常無需完整安裝即可直接執行該工具（例如，使用 bunx ccusage），以最低的設定開銷即時存取關鍵使用數據。
應用情境
ccusage 將原始使用數據轉化為策略性洞察，讓使用者能夠對其 AI 工作流程做出明智的決策。
1. 評估吃到飽方案的投資報酬率 (ROI)
如果您是 Max 方案用戶，可以使用「每月報告」和「會話報告」來計算，若採用按用量計費方案，您的使用量將產生多少費用。此比較提供具體且可量化的指標，以評估您目前的訂閱模式是否提供足夠的價值，幫助您證明或調整您的方案。
2. 辨識高成本工作流程
利用「會話報告」精準找出消耗最多代幣的特定專案或對話串。結合模型追蹤 (Model Tracking) 和細項分析 (Breakdown) 功能，您可以判斷高成本會話是否過度依賴高階模型（如 Opus 等），並評估較低成本的模型是否能為某些任務達到相似的成果。
3. 將使用數據整合至自訂儀表板
JSON 輸出 (JSON Output) 功能允許您以結構化、程式化的格式匯出所有彙整分析。開發人員和進階使用者可以將這些資料直接匯入內部監控系統、自訂分析儀表板或試算表工具，以進行更深入的趨勢分析，並與更廣泛的專案管理系統整合。
獨特優勢
ccusage 透過專注於細緻的細節和使用者對資料的掌控，提供獨特的價值。
與平台邏輯一致的細緻報告
我們不只提供日曆摘要；我們提供 5 小時區塊報告 (5-Hour Block Reports)。這種層次的細節至關重要，因為它與 Claude 的底層計費區間一致，讓您對使用情況有更實際的功能性理解，這是標準日曆報告所無法呈現的。
內建支援開發者生態系統
整合的模型上下文協定 (MCP) 伺服器 (Model Context Protocol (MCP) Server) 讓 ccusage 能夠與其他開發者工具和系統流暢互動。此功能使 ccusage 不僅僅是一個檢視器，更是大型工具鏈中的一個活躍元件，實現更深層次的自動化與整合。
彈性配置與時區控制
ccusage 提供廣泛的配置選項，包含支援 IDE 驗證與自動完成的 JSON 配置檔 (JSON Configuration Files)，以及彈性的時區與地區設定支援 (Timezone and Locale Support)。這確保報告能根據您的特定操作環境與地理位置，準確地分組、顯示與格式化。
結論
ccusage 提供您掌握 Claude Code 代幣使用量所需的清晰度與掌控能力。透過將不透明的使用數據轉化為詳細、具體可行的報告，讓您有信心優化工作流程、準確追蹤成本，並最大化您的 AI 投資價值。
立即探索 ccusage 如何協助您掌握自身使用情況。請至 GitHub 查看工具與文件。
More information on Ccusage
Launched
Pricing Model
Free
Starting Price
Global Rank
Follow
Month Visit
<5k
Tech used
Ccusage was manually vetted by our editorial team and was first featured on 2025-10-18.
Ccusage 替代方案
更多 替代方案-
-
-
Desktop Commander MCP 是一款開源工具，讓您能直接透過 Claude Desktop 應用程式執行終端機指令和編輯檔案。使用 Claude 提升您的 AI 工作流程。
-
runCLAUDErun 讓 macOS 上的 Claude Code 自動化作業變得更簡便。您可以排程 AI 任務，保障本機資料的隱私安全，並輕鬆地一覺醒來，所有工作皆已大功告成。
-
Claude Context 賦能 AI 程式開發代理，使其具備完整的程式碼上下文，從而獲得精準、具成本效益的程式碼，並能降低 token 成本、加速開發。