TokenMaestro
面向用 AI 做开发的人

让你的 AI 编程套餐用得更久。从第一个请求到最后一个 token。

TokenMaestro 正在被打造为指挥你、你的 AI 智能体和你的电脑之间的工作:本地模型将把你的请求结构化,在智能体开工前问清缺少的信息,把繁重的工作交给你电脑上安装的工具,并为每个任务分配合适的模型和推理强度。每一笔节省都将在你的电脑上实测,从不估算。

首个版本,适用于 Claude Code:免费的 X 光,以及 Pro 中的会话守护。之后:完整的乐团,以及 Codex、Gemini 和其他智能体。

免费 X 光 · 无需账号 · 数据不离开你的电脑

Nico,由 AI 生成的主持人。数字来自创始人真实的 X 光。
实测,从不估算计数直接取自 API 返回的 token 数,并经过正确的合并与去重。
交叉核对我们的计数会与 Claude Code 自身的计数器对比,并显示两者的差异。
本地运行在你的电脑上运行。无需账号,不上传任何数据。

乐团:从源头少花 token

大多数 token 工具压缩的是智能体已经花掉的部分。TokenMaestro 在花费之前介入:作用于请求、理解、工具和模型。

即将推出

结构清晰的请求

一个小型开源模型在你的电脑上运行,在请求到达智能体之前,把你输入的内容整理成清晰、结构化的请求。它不消耗 token。

即将推出

先提问,再开工

当请求含糊不清时,TokenMaestro 会先问你,这样智能体就不会把 token 花在猜测和返工上。

即将推出

繁重工作交给本地工具

识别图片中的文字、转换文档、剪辑视频:由你电脑上安装的工具完成,经你允许后由 TokenMaestro 配置。智能体只拿到结果。

即将推出

合适的模型和推理强度

简单任务交给较轻的模型,用低推理强度;只有任务需要时,才用重型模型和高推理强度。

Pro · 现已提供

精简的会话

在 Claude Code 内给出提醒,每条都注明按 API 价格计算的成本:上下文变得很大时,之后每一步重读它要花多少;暂停导致缓存过期时,与有缓存的一轮相比,重新写入要多花多少。恢复会话时,提醒在你的第一条消息之前出现;会话中途暂停后,则随你刚发出的消息一同出现。

免费 · 首个版本

每个 token 都有去向

X 光显示每个 token 的去向,数字来自日志统计,从不估算。之后:每项修正都在你自己的工作上实测,分别在开启和关闭时测量;如果不划算,就会被关闭。

智能体由你选择:先支持 Claude Code,之后是 Codex、Gemini 等。TokenMaestro 负责指挥,乐器由你挑选。

为什么这样能省 token

在 AI 智能体中,每一步都会重读之前的全部内容。开头多留的一个 token,之后每一步都要再付一次;在源头砍掉的一个 token,每一步都能省下。所以 TokenMaestro 在花费之前介入。

请求清楚,来回更少

含糊的请求会变成尝试、修正、再尝试,而每一轮都会重读整个会话。先把请求结构化,就能减少来回。

本地提问不花钱

在你的电脑上把疑问问清楚,不花云端 token。等智能体发现自己理解错了,就要多花一整轮,外加修正。

大文件留在上下文之外

智能体读取一份 50 页的 PDF,它就会进入上下文,并在每一步被重读。本地工具只提取真正需要的部分。

模型与任务相匹配

轻量模型的成本只是最强模型的一小部分,而高推理强度会生成大量推理文本。只有任务需要时,才用强模型。

不膨胀的会话

上下文一旦超过几十万 token,每次回答都会变贵。在合适的时机压缩,并且不让缓存在暂停期间过期,就能避免按全价重写所有内容。

实测,而非承诺

每项调整都将在你自己的工作上实测,分别在开启和关闭时测量。如果省不下来,就会被关闭。在那之前,不承诺任何节省。

从头到尾如何运行 即将推出

  1. 只需安装一次。TokenMaestro 会找到你已经在用的智能体,以及你电脑上的工具。
  2. 你通过 TokenMaestro 提出请求:在终端里,或者在智能体内部。
  3. 它在你的电脑上准备好请求(结构化、询问缺少的信息、调用本地工具),然后把准备好的请求交给你选择的智能体。
  4. 会话期间,它会关注上下文、缓存和限额,在它们变成浪费之前提醒你。
  5. 最后,X 光测量发生了哪些变化。

现在:无论你用订阅(Claude Pro 或 Max)还是 API 密钥登录,X 光都读取 Claude Code 的日志,并以 API 价格显示价值。之后:乐团将按你已有的登录方式,驱动你所选智能体的官方应用(先是 Claude Code,之后是 Codex 和 Gemini)。

免费

从 X 光开始:你的套餐值多少,用在了哪里

一条命令,几秒内读完几个月的日志,生成一个仪表盘文件:按天、模型、推理强度和项目列出按 API 价格计算的价值;你触及限额的日子;以及与 Claude Code 自身计数器的交叉核对。

TokenMaestro 仪表盘:五个月内按 API 价格折算约 25,000 美元的价值,每日价值图表标出了触及套餐限额的日子,以及与 Claude Code 计数器的交叉核对。
创始人的真实仪表盘:五个月使用固定价格订阅,按 API 价格计约 25,000 美元。仪表盘目前提供英语和葡萄牙语,其他语言随后提供。

它能找出的泄漏,每个数字都带标签

“实测”表示日志中能看到。“上限”表示一项修正最多能挽回多少——不是节省。在创始人的日志中:

实测
52%

超大上下文

的价值(按 API 价格计)花在了上下文超过 400k token 的轮次上。这是花费中的占比,不是可以挽回的金额。每一步都会重读之前的全部内容。

实测
7.7%

暂停后的缓存重写

暂停期间缓存过期了 491 次,上下文中已不在缓存里的部分按全价重新写入。

实测
~57k

第一次回答前的 token

每个会话一开始就带着的指令、工具和记忆——之后的每一轮都会重读。每个会话最多计入 100k token。

仪表盘中的泄漏卡片:超过 200k token 的上下文、有暂停和无暂停时的缓存重写、每轮重读的固定负载、未改动却被重读的文件、电脑上缺失的工具。

负载地图

你的智能体读得最多的内容,按项目和文件划分。面积表示进入上下文的数据量;颜色表示其中有多少是在文件未改动的情况下被重读的。

下一步:把同一张地图画在你的代码结构上,并显示智能体在每个会话中走过的路径。

智能体读取最多的文件的矩形树图,按项目分组。
项目名和文件名已替换为中性标签;任何人在分享前都可以用 X 光做同样的处理。

为什么这些数字可信

大多数 token 工具报告的节省都是它们自己估算的。对其中热门工具的独立测量没有发现节省,有时成本反而更高。我们从另一端开始。

日志里的陷阱,已处理

Claude Code 每条消息会写入多条记录,早期记录的计数不完整;恢复的会话会重放消息;子智能体写入单独的文件。每种情况都有测试。

与 Claude Code 核对

在 16 次对照中,我们的缓存读取计数比 Claude Code 自身计数器低 4.6%,从未高于它。这些数字是下限。

未经测量,不谈节省

在发布配对测量及其原始数据和复现方法之前,本页面不会出现任何节省百分比。

下载

X 光是一个小型命令行工具。在终端中粘贴一行命令即可安装,也可以直接下载文件。

粘贴到 PowerShell:
irm https://thetokenmaestro.com/install.ps1 | iex
或下载文件

由于程序尚未签名,Windows SmartScreen 可能会对下载的文件发出警告。推荐使用上面的安装命令。

然后运行(如果终端找不到该命令,请使用安装程序显示的完整路径): tokenmaestro xray

正在使用 Claude Code?可以让它帮你运行安装命令。

更新时,再运行一次安装命令即可。卸载时:先运行 tokenmaestro guard uninstall(如果开启了会话守护),再运行 tokenmaestro deactivate(如果有 Pro 许可证),然后才删除程序(Windows 上还要删除它的 PATH 条目)。

价格

X 光

免费
  • 价值与用量仪表盘
  • 泄漏分析,附证据标签
  • 负载地图
  • 与 Claude Code 计数器交叉核对
  • 缺失工具检查

Pro

39 美元 / 年 · 或每月 5 美元

创始会员:每年 19 美元,只要持续订阅,价格保持不变。限前 1,000 人。

现已提供
  • 会话守护:上下文超过 200k token 时,在 Claude Code 内给出提醒,并注明之后每一步重读它的成本(按 API 价格)
  • 暂停导致缓存过期时给出提醒,并注明与有缓存的一轮相比,重新写入上下文多花的成本
  • 终端状态栏:上下文、下一步的重读成本、缓存和订阅限额

状态栏在 Claude Code 的终端中工作;运行 tokenmaestro guard install 可查看如何开启。

即将推出,包含在订阅内
  • 由本地模型生成结构化请求
  • 智能体开工前先提问
  • 安装并调校好的本地工具
  • 为每个任务选对模型和推理强度
  • 在你自己的工作上实测节省
  • Codex、Gemini 及其他智能体陆续支持
购买 Pro 或每月 5 美元

许可证密钥通过邮件发送。使用 tokenmaestro activate YOUR-KEY 激活,最多可用于 3 台电脑。会话守护需要 Claude Code 2.1.251 或更高版本。

两年的 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。

从免费的 X 光开始

下载免费的 X 光