时间进入到 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 电脑
这个项目还在持续开发中。感兴趣的话,或者有什么功能建议,欢迎告诉我。