我做了个 Coding Agent 用量统计 App

时间进入到 2026 年 5 月,软件工程领域已经全面引入 Coding Agent,目前一线生产力用得最多的是 Claude Code、Codex、OpenCode。我之前也介绍过我自己现在在本地编程的场景是通过 VS Code 使用 Claude Code 和 Codex。

想知道编程一共用了多少Token

我到底用了多少 token?花了多少钱?(虽然基本都是Coding Plan,但如果按原价看,会感觉赚了)

我还经常想知道「某个项目到底吃了多少 token」。但三个 Agent 各自存数据,散落在硬盘的不同角落。写个脚本统计?能用,但太折腾了。每次想看数据都得重新跑。

所以我做了 TokenScope

TokenScope 是一个 macOS 原生应用。SwiftUI 写的,零外部依赖。

核心思路就一句话:把常用的 Coding Agent 的用量数据拉到一起,统一展示。

它目前支持三个数据源:Claude Code、Codex、OpenCode。原理也不复杂——这些工具在本地都会留下 session 日志,TokenScope 直接读这些日志,解析 token 用量,然后汇总。

不需要 API key,装上就能用。基本功能也不需要联网。

Dashboard:一眼看清用量

打开 App 第一个看到的就是 Dashboard。

图片

最上面是几个关键数字:总会话数、总 token 数、输入 token、输出 token、费用估算(美元)。

下面按来源拆开。Claude Code 用了多少,Codex 用了多少,OpenCode 用了多少。点一下就能筛选。

再往下是柱状图。按天展示 token 消耗,不同颜色代表不同模型。鼠标悬停能看到每天的详细拆解:用了哪些模型,每个模型花了多少钱。

还可以按月展开,看到每个月的总 token、费用、消息数。点开就是每一天的数据。

筛选器很灵活。按日期、来源、模型、token 类型,想怎么看就怎么看。

我每次打开 App 第一件事就是看这个柱状图。哪天用得多,哪天用得少,一眼就能看出来。

Plan额度追踪:不用再切多个网页查看了

这是我自己用得最多的功能。

图片

Claude Code、Codex、Z.ai 三个来源的配额和使用量,实时展示。进度条直接告诉你还剩多少。重置倒计时也有。

以前用着用着突然到 limit,或者就是隔一会儿去刷一下各家的 Usage 页面看看剩余额度。现在随时在 TokenScope 看一眼进度条就心里有数了。

还有费用统计。今天花了多少,最近 30 天花了多少。

如果你有多个 Codex 账号——比如工作账号和个人账号分开——TokenScope 支持多账号切换。OAuth 登录,直接在 App 里搞定。

会话浏览:每条消息的 token 都能查

所有 Coding Agent 的会话都在一个列表里。按时间、来源、项目、消息数、token 数、费用,想怎么排就怎么排。

图片

搜索也方便。想找某个项目的会话,搜项目名就行。

双击一个会话,能看到完整的对话记录。每条消息的 token 拆解都在:输入多少、输出多少、缓存读取多少、缓存创建多少、消耗多少费用。

能看到哪些对话特别费 token。有时候一个复杂任务,Agent 反复尝试,token 就蹭蹭涨。看到具体数字之后,我会更有意识地控制对话长度和 prompt 质量。

价格管理:20+ 模型定价内置

我在 TokenScope 内置了 20 多个模型的定价数据。Anthropic 全系、OpenAI 全系、GLM 全系都有。

所以每个视图都带费用估算。从 Dashboard 到会话详情,token 数旁边永远跟着一个美元数字。

觉得内置价格不准?可以自己覆盖,改成你使用的 API 的实际价格。

几个技术细节

数据存在本地。第一次打开会扫描所有日志文件,之后有缓存,秒开。后台自动刷新新数据。

API key 存在 macOS Keychain 里。这点我很在意,密码类的东西不应该明文存在配置文件里。

纯 Swift 实现,零外部依赖。最低支持 macOS 14。


下载地址:https://github.com/aooyoo/TokenScope/releases 

目前仅支持 M 芯片的 Mac 电脑

这个项目还在持续开发中。感兴趣的话,或者有什么功能建议,欢迎告诉我。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注