ccusage 替代方案：一个可视化、常驻桌面的 GUI

一句话总结

ccusage 是一个快速、开源的命令行工具，把你本地的 Claude Code（以及 Codex）日志变成终端里的每日、每月、按会话和 5 小时计费窗口的花费报表。Token Forest 则是一个独立的桌面应用，读取同样的日志，把它们变成一只温馨的像素宠物，外加一个三视图仪表盘。两者都不上传任何东西，都在本地估算花费。

关键结论：Token Forest 是 ccusage 的一个可视化替代方案 —— 而不是它的前端。它与 ccusage 不共享任何代码，完全独立运行。如果你喜欢终端，请继续用 ccusage；如果你想要一个常驻、一眼可见的视图，就加上 Token Forest。

ccusage 的过人之处

ccusage（npm 包名 ccusage，作者 ryoppippi，MIT 许可）是一个真正优秀的工具，对于以终端为主的工作流，我们推荐它。

• ✦在任意终端里即时出报表 —— 用 npx 运行，无需安装。
• ✦按天、按周、按月、按会话、按 5 小时计费窗口拆分 token 与估算花费。
• ✦它专注于终端报表，另外还有一个实验性（测试版）的 Claude Code 状态栏显示。
• ✦可脚本化、对 CI 友好 —— 支持 JSON 输出、日期过滤、按模型拆分。
• ✦它能读取多种编码代理（15+ 种，含 Claude Code —— Codex、Gemini CLI、Copilot CLI 等），不止一种。

Token Forest 额外带来的

Token Forest 是一只面向 Windows 10/11 和 macOS 的温馨像素风桌面宠物。它免费（公开测试版）、本地优先、可完全离线运行。

• ✦一个常驻的小伙伴：你工作时，token 用量会让一棵像素树经历 8 个阶段生长 —— 不用敲任何命令。
• ✦一个完整的离线仪表盘，含三个互相印证的视图 —— 成长（每棵树的阶段、种植天数、“这棵树 ≈ $X”）、用量（每日/每周/每月图表、Claude Code 与 Codex 的按模型拆分、26 周热力图、燃烧率、按项目汇总）、以及对话（每次会话一行，含四类 token 与估算花费）。
• ✦用温和的游戏化激励取代冷冰冰的数字 —— 看着付出的努力长成会生长的东西。
• ✦一个可选的全球排行榜，默认关闭；只有你想比较时才自行开启。

ccusage 与 Token Forest 一览

两者读同样的日志 —— 而且从不碰你的代码

两个工具都只读取你本机上的本地用量日志 —— Claude Code 在 ~/.claude，Codex 在 ~/.codex。Token Forest 只使用 token 计数，外加少量结构性元数据（模型名、时间戳、会话标题、项目文件夹名、git 分支、会话 id，以及消息类型结构）。它从不读取你的源代码、你的提示词或对话内容，不发送任何遥测，并且可以在完全断网的情况下运行。

为什么 token 数字看起来那么大

两个工具都跟踪四类 token：输入、输出、缓存读取和缓存写入。缓存读取在原始计数里占大头，但每个都很便宜 —— 在 Token Forest 自己的六周样本里，缓存读取约占真实花费的 57%，而输入和输出加起来只有约 24%。这就是为什么原始 token 总数看着吓人，真实花费却依然不高。

对两个工具都要诚实说一句：这些美元数字都是在本地根据价目表估算出来的，可能与你真实的 Anthropic 或 OpenAI 账单有出入。把它们当作一个接近的、私密的近似值 —— 想看自己随时间变化的真实数字，就用 Token Forest 的仪表盘。

你该选哪个？

• ✦如果你常驻终端、想要能进 CI 的可脚本化输出，或只是偶尔想快速看个数字 —— 选 ccusage。
• ✦如果你想要一个可视化、常驻的视图、一个可点击的仪表盘，还有一点温和的激励 —— 选 Token Forest。
• ✦拿不定主意？它们并不冲突 —— 两个都装，哪个当下顺手就用哪个。

两个能一起用吗？

可以。它们读的是同一份只读日志，都不会修改它，所以终端里的 ccusage 和桌面上的 Token Forest 可以愉快共存。很多人用 ccusage 做 CI 里的快速检查，用 Token Forest 看每天一眼可见的全貌。