
Show HN: 使用 CLI 估算 Claude Code 会话费用
一句话看懂:开发者 jher7 在 GitHub 上发布了开源 CLI 工具 Tokenyst,能在 Claude Code 会话结束后自动统计 token 消耗并计算费用,帮助个人开发者和小团队管理 API 调用预算,避免账单失控。
事件核心:发生了什么
Tokenyst 是一个轻量级命令行工具,运行于 Node.js 18+ 环境,需配合 Anthropic 的 Claude Code 使用。用户通过 tkst claude 命令启动会话,工具会自动抓取 Claude 会话转录文件,解析其中最后若干轮助手回复的 token 用量,并依据当前最新的 Claude 模型定价(含提示缓存乘数)核算成本。每次提示后,终端会实时显示“+$0.861 (turn) | Budget: $0.86 / $2.00 (43%)”这样的进度条。会话结束时,工具会输出一份包含总花费和预算结余的摘要。所有数据存储在用户本地的 ~/.tokenyst/config.json 中,无需联网,也无需第三方服务。
工具支持为任务设置预算上限(例如 “Fix header buttons -b 2” 表示 2 美元),并提供了分配管理、任务重命名、重新分配等命令。目前公开信息显示,该工具由独立开发者维护,项目代码已全部开源在 GitHub 上,采用 MIT 许可协议。
为什么重要
大模型 API 的使用成本正在成为个人开发者和小型团队的实际门槛。Claude Code 这类“代理式”编码助手会反复调用大模型进行推理,一次复杂的编码会话可能产生数美元甚至数十美元的费用,且用户很难在过程中精确感知花费。Tokenyst 的出现,将原本需要在云控制台或第三方计费系统中才能看到的成本信息,直接下沉到了本地开发工具的“最后一米”。这种细粒度的预算控制和实时反馈,让 API 成本的透明度从“事后对账”变成了“事前计划”,对控制模型调用次数的无意浪费非常直接。
从生态角度看,这类工具的出现也表明:围绕 Claude 等闭源模型的开发者工具链正在快速补全——从日志、调试、测试,到现在的成本管理,每个环节都有社区或独立开发者贡献开源方案。这反过来也降低了小团队和独立开发者试用和长期依赖商业大模型的心理门槛。
对用户/开发者/创作者的影响
对于日常使用 Claude Code 的开发者,尤其是以按量计费方式接入 API 而非包月订阅的用户,Tokenyst 提供了近乎即时的预算控制能力。你可以在开始一个实验性重构或复杂调试之前,用 tkst -t 命令设定一个很小的预算(例如 1 美元),当成本触达上限时即使没有记账功能,也能通过终端进度条直观感知。对于使用批量化的“智能体”或自动化脚本频繁调用 Claude 的团队,该工具可以辅助更精确地进行成本核算与任务拆分。
需要注意的是,Tokenyst 本身不调用 API,也不改变 Claude Code 的使用流程,只是被动读取本地会话日志并做文字解析,因此对性能无影响,也不存在数据泄露风险。但它的准确性依赖于 Claude Code 会话日志格式的稳定性——如果 Anthropic 在未来版本中更改日志结构,工具可能需要适配更新。
值得关注的后续
第一,Anthropic 是否会将其吸收为官方功能?目前 Claude Code 没有自带成本控制仪表盘,如果官方在未来版本中加入类似功能,Tokenyst 这类第三方工具可能会被替代。第二,社区是否会扩展对其他模型的支?目前该项目仅支持 Claude 模型定价,但代码结构清晰,如果收到 PR 支持 GPT-4o、Gemini 等模型,其适用范围会进一步扩大。第三,这个工具能否长线维护?作为单人开源项目,后续功能更新和兼容性修补完全依赖作者的积极性,建议关注其 GitHub Stars 和 Commit 频率后再决定是否深度依赖。
来源:github.com


