让你的 AI 编程套餐用得更久。从第一个请求到最后一个 token。
TokenMaestro 正在被打造为指挥你、你的 AI 智能体和你的电脑之间的工作:本地模型将把你的请求结构化,在智能体开工前问清缺少的信息,把繁重的工作交给你电脑上安装的工具,并为每个任务分配合适的模型和推理强度。每一笔节省都将在你的电脑上实测,从不估算。
首个版本,适用于 Claude Code:免费的 X 光,以及 Pro 中的会话守护。之后:完整的乐团,以及 Codex、Gemini 和其他智能体。
免费 X 光 · 无需账号 · 数据不离开你的电脑
乐团:从源头少花 token
大多数 token 工具压缩的是智能体已经花掉的部分。TokenMaestro 在花费之前介入:作用于请求、理解、工具和模型。
结构清晰的请求
一个小型开源模型在你的电脑上运行,在请求到达智能体之前,把你输入的内容整理成清晰、结构化的请求。它不消耗 token。
先提问,再开工
当请求含糊不清时,TokenMaestro 会先问你,这样智能体就不会把 token 花在猜测和返工上。
繁重工作交给本地工具
识别图片中的文字、转换文档、剪辑视频:由你电脑上安装的工具完成,经你允许后由 TokenMaestro 配置。智能体只拿到结果。
合适的模型和推理强度
简单任务交给较轻的模型,用低推理强度;只有任务需要时,才用重型模型和高推理强度。
精简的会话
在 Claude Code 内给出提醒,每条都注明按 API 价格计算的成本:上下文变得很大时,之后每一步重读它要花多少;暂停导致缓存过期时,与有缓存的一轮相比,重新写入要多花多少。恢复会话时,提醒在你的第一条消息之前出现;会话中途暂停后,则随你刚发出的消息一同出现。
每个 token 都有去向
X 光显示每个 token 的去向,数字来自日志统计,从不估算。之后:每项修正都在你自己的工作上实测,分别在开启和关闭时测量;如果不划算,就会被关闭。
智能体由你选择:先支持 Claude Code,之后是 Codex、Gemini 等。TokenMaestro 负责指挥,乐器由你挑选。
为什么这样能省 token
在 AI 智能体中,每一步都会重读之前的全部内容。开头多留的一个 token,之后每一步都要再付一次;在源头砍掉的一个 token,每一步都能省下。所以 TokenMaestro 在花费之前介入。
请求清楚,来回更少
含糊的请求会变成尝试、修正、再尝试,而每一轮都会重读整个会话。先把请求结构化,就能减少来回。
本地提问不花钱
在你的电脑上把疑问问清楚,不花云端 token。等智能体发现自己理解错了,就要多花一整轮,外加修正。
大文件留在上下文之外
智能体读取一份 50 页的 PDF,它就会进入上下文,并在每一步被重读。本地工具只提取真正需要的部分。
模型与任务相匹配
轻量模型的成本只是最强模型的一小部分,而高推理强度会生成大量推理文本。只有任务需要时,才用强模型。
不膨胀的会话
上下文一旦超过几十万 token,每次回答都会变贵。在合适的时机压缩,并且不让缓存在暂停期间过期,就能避免按全价重写所有内容。
实测,而非承诺
每项调整都将在你自己的工作上实测,分别在开启和关闭时测量。如果省不下来,就会被关闭。在那之前,不承诺任何节省。
从头到尾如何运行 即将推出
- 只需安装一次。TokenMaestro 会找到你已经在用的智能体,以及你电脑上的工具。
- 你通过 TokenMaestro 提出请求:在终端里,或者在智能体内部。
- 它在你的电脑上准备好请求(结构化、询问缺少的信息、调用本地工具),然后把准备好的请求交给你选择的智能体。
- 会话期间,它会关注上下文、缓存和限额,在它们变成浪费之前提醒你。
- 最后,X 光测量发生了哪些变化。
现在:无论你用订阅(Claude Pro 或 Max)还是 API 密钥登录,X 光都读取 Claude Code 的日志,并以 API 价格显示价值。之后:乐团将按你已有的登录方式,驱动你所选智能体的官方应用(先是 Claude Code,之后是 Codex 和 Gemini)。
从 X 光开始:你的套餐值多少,用在了哪里
一条命令,几秒内读完几个月的日志,生成一个仪表盘文件:按天、模型、推理强度和项目列出按 API 价格计算的价值;你触及限额的日子;以及与 Claude Code 自身计数器的交叉核对。
它能找出的泄漏,每个数字都带标签
“实测”表示日志中能看到。“上限”表示一项修正最多能挽回多少——不是节省。在创始人的日志中:
超大上下文
的价值(按 API 价格计)花在了上下文超过 400k token 的轮次上。这是花费中的占比,不是可以挽回的金额。每一步都会重读之前的全部内容。
暂停后的缓存重写
暂停期间缓存过期了 491 次,上下文中已不在缓存里的部分按全价重新写入。
第一次回答前的 token
每个会话一开始就带着的指令、工具和记忆——之后的每一轮都会重读。每个会话最多计入 100k token。
负载地图
你的智能体读得最多的内容,按项目和文件划分。面积表示进入上下文的数据量;颜色表示其中有多少是在文件未改动的情况下被重读的。
下一步:把同一张地图画在你的代码结构上,并显示智能体在每个会话中走过的路径。

为什么这些数字可信
大多数 token 工具报告的节省都是它们自己估算的。对其中热门工具的独立测量没有发现节省,有时成本反而更高。我们从另一端开始。
日志里的陷阱,已处理
Claude Code 每条消息会写入多条记录,早期记录的计数不完整;恢复的会话会重放消息;子智能体写入单独的文件。每种情况都有测试。
与 Claude Code 核对
在 16 次对照中,我们的缓存读取计数比 Claude Code 自身计数器低 4.6%,从未高于它。这些数字是下限。
未经测量,不谈节省
在发布配对测量及其原始数据和复现方法之前,本页面不会出现任何节省百分比。
下载
X 光是一个小型命令行工具。在终端中粘贴一行命令即可安装,也可以直接下载文件。
irm https://thetokenmaestro.com/install.ps1 | iex由于程序尚未签名,Windows SmartScreen 可能会对下载的文件发出警告。推荐使用上面的安装命令。
curl -fsSL https://thetokenmaestro.com/install.sh | shtokenmaestro xray正在使用 Claude Code?可以让它帮你运行安装命令。
更新时,再运行一次安装命令即可。卸载时:先运行 tokenmaestro guard uninstall(如果开启了会话守护),再运行 tokenmaestro deactivate(如果有 Pro 许可证),然后才删除程序(Windows 上还要删除它的 PATH 条目)。
TokenMaestro 在电脑上运行:Windows、macOS 或 Linux。请在电脑上打开本页面进行下载。
价格
Pro
创始会员:每年 19 美元,只要持续订阅,价格保持不变。限前 1,000 人。
- 会话守护:上下文超过 200k token 时,在 Claude Code 内给出提醒,并注明之后每一步重读它的成本(按 API 价格)
- 暂停导致缓存过期时给出提醒,并注明与有缓存的一轮相比,重新写入上下文多花的成本
- 终端状态栏:上下文、下一步的重读成本、缓存和订阅限额
状态栏在 Claude Code 的终端中工作;运行 tokenmaestro guard install 可查看如何开启。
- 由本地模型生成结构化请求
- 智能体开工前先提问
- 安装并调校好的本地工具
- 为每个任务选对模型和推理强度
- 在你自己的工作上实测节省
- Codex、Gemini 及其他智能体陆续支持
两年的 Pro,比 Claude 两档套餐之间一个月的差价还便宜。
常见问题
TokenMaestro 读取什么?
Claude Code 已经写在你电脑上的会话日志(~/.claude/projects):API 为每条消息返回的 token 数,以及运行了哪些工具、返回了多少内容。不会发送任何数据。
美元金额就是我付的钱吗?
不是。它是你的用量按 API 价格计算的费用。在固定价格订阅下,它显示的是套餐为你提供了多少价值,而不是账单。
Claude Code 已经有 /usage,为什么还需要这个?
/usage 告诉你限额用掉了多少。TokenMaestro 告诉你用在了哪里、价值多少、哪里在泄漏。
我能省多少?
测量之前,我们不承诺任何数字。X 光会显示你的情况下泄漏了多少。修正功能推出后,每一项都会在你自己的工作上实测。
需要注册账号吗?
不需要。X 光无需账号,也无需邮箱。Pro 使用许可证密钥,购买后通过邮件发送。
支持 Codex、Cursor 或 Gemini 吗?
还不行。目前它只读取 Claude Code;Codex 和 Gemini 随后支持,Cursor 暂不支持。智能体由你选择,其余由 TokenMaestro 指挥。
Windows、macOS、Linux?
都支持。X 光在这三个系统上都能运行。
需要自己安装模型或工具吗?
不需要。当某项任务需要时,TokenMaestro 会显示缺少什么、说明原因,并在你允许后安装。本地模型小巧且开源;如果你的电脑跑不动它,TokenMaestro 也能不用它照常工作。(Pro,即将推出。)
订阅能用吗,还是只能用 API 密钥?
两者都可以。无论你用订阅(Claude Pro 或 Max)还是 API 密钥登录,X 光都读取 Claude Code 写下的日志,并在两种情况下都以 API 价格显示价值。它无法显示每项操作占用了你套餐限额的多少,因为这些限额并未公布;但它会标出达到限额的日子。乐团推出后,将按你已有的登录方式驱动官方应用,绝不在这些应用之外使用你的登录信息。
可以退款吗?
可以。如果你住在巴西,可在购买后 7 天内申请全额退款;住在欧盟、欧洲经济区或英国,可在 14 天内申请;在其他地区,可在首次购买某个套餐后 7 天内申请。请写信至 hello@thetokenmaestro.com。退款由我们的记录商户 Creem 处理,退款后许可证密钥将被停用。X 光是免费的,所以你可以在购买前,先在自己的电脑上看看 TokenMaestro 能发现什么。
如何卸载?
先运行 tokenmaestro uninstall:它会从 Claude Code 中移除会话守护的 hook,并释放这台电脑占用的许可证名额。然后删除程序(Windows 上还要删除它的 PATH 条目)。按这个顺序操作,Claude Code 之后不会显示 hook 错误。1.0.3 之前的版本:先运行 tokenmaestro guard uninstall,再运行 tokenmaestro deactivate。