Skip to content
ccgauge
稳定版 · 100% 本地

看清楚你的 AI 编程 CLI 到底用了多少 token。

ccgauge 是 Claude Code 与 OpenAI Codex CLI 的本地用量看板。按项目、模型、会话维度追踪 token、花费、缓存节省、5 小时 block 进度 —— 全程不出本机。

bash
npx ccgauge

一行命令。自动在浏览器打开 localhost:3737。无注册、无遥测、无 API key。

ccgauge 概览仪表盘真实截图,中文界面,展示 KPI、token 趋势、缓存命中率和 5 小时 block。 ccgauge 概览仪表盘真实截图,中文界面,展示 KPI、token 趋势、缓存命中率和 5 小时 block。
Claude Code OpenAI Codex CLI 100% 本地 MIT 开源 macOS · Linux · Windows 中文 / English
为什么用 ccgauge

六个让 ccgauge 值得 10 秒装上的理由。

所有功能都围绕两个点:你的数据不出本机,你的问题秒级有答案 —— 不用再去手搓 Excel。

ccgauge 模型页面截图,并列对比 Claude 和 Codex 各模型的花费与 token。 ccgauge 模型页面截图,并列对比 Claude 和 Codex 各模型的花费与 token。

双数据源统一看板

Claude Code、OpenAI Codex CLI 或两者并表的 All 视图共用一份看板;带真品牌 logo,URL + cookie 记忆你的选择。

生成的终端报告视觉图,展示 token 与花费分析。

命令行报告

无 server 无浏览器,一条 `ccgauge report` 直接在终端打出彩色对齐的报告 —— 趋势、Top-N、JSON 输出皆可,管道友好。

查看 CLI 文档
生成的 MCP 集成视觉图,本地服务节点连接到结构化用量工具。

MCP 服务

让 Claude Desktop / Cursor / Cline 直接查你的用量。8 个 MCP tool 覆盖总数、时间序列、按模型 / 项目 / 会话钻取。

MCP 接入指南
生成的 7 天乘 24 小时活跃度热力图视觉图,包含 tooltip 和侧边统计。

活跃度热力图

7 天 × 24 小时网格,hover 看消息数、token、占总数和占峰值比例。你的高产时段一目了然。

生成的本地隐私视觉图,包含盾牌、锁定文件和被阻断的外联路径。

100% 本地、零遥测

ccgauge 只读取你 CLI 自己写的 JSONL 文件,零网络调用。默认绑 127.0.0.1。MIT 开源。

隐私设计理念
生成的双语与主题切换视觉图,包含深浅两个仪表盘面板。

双语 + 主题

中文 / 英文界面 + CLI 全语贯通;深 / 浅 / 跟随系统三档主题,首次加载零闪烁。npm 跨平台安装。

钻到单次调用

从月度花费一路追到某一次 API 调用。

所有 assistant 调用都按真实对话轮次聚合。点开一轮看每次调用的工具列表、prompt 片段、花费 —— 支持搜索、过滤、排序、CSV 导出。

ccgauge — localhost:3737
ccgauge 用量页面截图,按 turn 聚合的表格、可展开 tool-call 行、搜索框与 CSV 导出按钮。 ccgauge 用量页面截图,按 turn 聚合的表格、可展开 tool-call 行、搜索框与 CSV 导出按钮。
Usage · turn 聚合表 · 支持 CSV 导出
数字怎么算的

不黑箱,全公开。

Token 数直接读 CLI 已经写的 JSONL,花费走 ccgauge 内置的官方单价表。

完整方法论
  • Token 统计

    直接读取 CLI JSONL 文件里的 assistant record;对子 agent fork 出来的同 (messageId, requestId) 会去重。

  • 花费计算

    按模型查每百万 token 单价。未知变体 fallback 到家族最新版(如 gpt-5.5-foogpt-5.5)。

  • 缓存节省

    把每次缓存命中假设成"全量按输入单价计费",差额即"Saved by cache"。这就是 prompt caching 帮你省了多少。

  • 5h block 跟踪

    纯粹的 5 小时窗口钟表进度。不是 Anthropic 的套餐配额计数器 —— 那个在服务端,客户端拿不到。

支持 MCP

让 LLM 自己查它自己的账单。

往 Claude Desktop 配置里加三行,然后问模型:"我这周 Opus 花了多少钱,按项目拆一下?" 这种问题和它的十几种变体,8 个 MCP tool 都能答。

看完整 8 个 MCP tool
json
{
  "mcpServers": {
    "ccgauge": {
      "command": "npx",
      "args": ["-y", "ccgauge", "mcp"]
    }
  }
}

10 秒装上。

一行命令,本地起一个仪表盘,无需注册。别再猜 Claude Code 到底花了你多少。