首页 > 教程资讯 > 教程详情

Claude Code 插件 tokendoctor:回放历史会话,估算设置调整能省多少

AI 与前沿 老K说软件 2026-11-18
文章分享

Claude Code 插件 tokendoctor 主打用用户自己的历史会话估算节省空间,再由用户选择修改设置。项目采用 MIT 许可,宣称「最多降低 38% 成本」。不过,README 明确说明,38% 来自作者个人的前后对比,按 API 标价计算,并非对照实验;其公布的基准测试中,也有调整后成本上升的情况。

先回放,再决定改什么

据项目 README,运行 /tokendoctor:sessions 后,插件会逐个请求回放过去 30 天的全部会话,分别计算在 200K、300K、400K 和 600K token 压缩窗口下的成本。这个过程只读取会话记录,不调用模型,也不修改设置。README 提醒,回放得到的节省数字是上限,因为它无法看到模型在摘要后可能重做的工作。

随后,/tokendoctor:optimize 会依据回放结果提出最多五项修改建议,并对照 Claude Code 文档检查设置。每项修改先展示 diff,只应用用户选中的项目;已做的修改可通过 /tokendoctor undo 撤销。

插件还提供可选的 slide 功能:在 Claude Code 原本需要停下来总结对话时,丢弃旧的工具输出,同时保留所有消息。发布方称,这一步不调用模型,耗时以毫秒计。

38% 的节省来自作者个人记录

作者在 README 中称,使用 100 万 token 窗口的模型时,Claude Code 到约 967K token 才压缩上下文;在其个人记录中,三分之二的主线程成本来自上下文超过 400K token 的请求。

作者将窗口设为 400K token,并让子 agent 使用 Sonnet。对比修改前一个月与修改后一周、分别约 2.3 万和 1.9 万个主线程请求,单请求上下文从 412K 降至 219K token,按 API 标价计算的单请求成本下降 38%。代价是摘要次数增加,作者会话中每次摘要平均停顿 79 秒。

自测也有成本上升的情况

发布方公布的基准测试使用 Haiku 5.5,按任务计算成本。slide 相比摘要,在「一天的工作」任务中成本下降 19%、耗时下降 33%;在评测框架任务中分别下降 35% 和 28%。短任务则成本增加 6%,耗时下降 17%。

单独采用设置建议时,4 次运行中有 3 次更贵;设置建议配合 slide,在「一周的工作」任务中成本下降 11% 至 21%。发布方称,所有运行的测试均通过,并解释设置建议单独未能省钱,是因为这些任务很少超过 400K token。

安装与数据处理

按 README 执行以下命令后,重启 Claude Code 即可运行会话回放:

claude plugin marketplace add localixai/tokendoctor
claude plugin install tokendoctor@tokendoctor

README 称,插件唯一的网络调用是每天访问一次 Claude Code 文档的两个公开页面,除此之外没有数据离开本机,也不会自行切换模型。上述收益均来自项目方披露,未作独立验证;历史回放无法计入摘要后可能发生的重做成本。

相关下载

来源