TokenEconomizer - 为编码智能体做经验驱动的黑盒成本控制

TokenEconomizer 是微软开源的一个编码智能体（coding agent）插件，目标是在不更换智能体模型、不改动智能体代码的前提下，降低在同一仓库中反复运行智能体的成本。据项目自述，它从智能体已经跑过的会话中学习，把经验用于后续会话，减少重复发现的事实、反复加载却用不上的工具定义，以及卡在同一失败上的循环。它适合那些长期在固定几个仓库里使用 Claude Code、Codex、GitHub Copilot CLI 或 Pi 的开发者——用得越频繁、仓库越固定，可复用的经验就越多。

维护者与状态

项目由 microsoft 维护，仓库创建于 2026-10-13，最后一次提交在 2026-10-31。最新正式版本为 v0.1.0，发布于 2026-10-26。截至 2026-11-01，仓库星标数为 3113。从版本号与时间线看，这是一个刚起步的项目，接口与行为仍可能随版本变化。

主要能力

据项目说明，TokenEconomizer 由三种机制组成，每种都可以单独开启或关闭：

• 微技能（Micro-skills）：记住仓库是怎么运作的。 智能体在不同会话中会反复重新发现同样的事实，例如必须先跑的构建步骤、在这个仓库里能用的命令写法、某条命令需要的环境变量、生成文件放在哪里。微技能从两类来源学习这类事实：跨会话重复出现的失败，以及每 k 个会话（默认 k = 3）由一个模型回顾近期会话后提出的事实。一条事实在被三个会话确认后，会在每个会话开始时被陈述；后续会话若与之矛盾，该事实会被丢弃。
• 工具裁剪（Tool pruning）：不再加载用不上的工具。 每个已加载工具的定义都会随每次请求发送。若某个工具在至少 m 个会话中累计 p 个提示（默认 p = 10、m = 2）内未被使用，或在任意长度的 s 个会话（默认 s = 5）内未被使用，它就会通过智能体自身的设置从后续会话中移除；一条命令即可将其恢复。
• 失败循环干预（loop guard）：在一轮卡住时介入。 当一轮（智能体针对一个提示所做的工作）反复遇到相同失败时，一个裁判模型会判断它是否卡住。若裁判的把握至少为 c（默认 c = 0.7），智能体会收到一条重定向提示，建议换一种做法，每轮最多 r 次（默认 r = 1）。若之后仍然卡住，TokenEconomizer 会告诉用户如何停止，但它本身从不主动终止一轮。

项目自述还强调了几条设计原则：通过智能体本来就会读取的内容生效，不要求智能体学习新工具；成本按实际计费方式计算，包含缓存重读价格，也包含插件自身发起的模型调用；保护任务成功率，事实需重复证据才成立、工具需先闲置才移除、仍在推进的一轮不会被干预；每个动作都可逆，被后续会话否定的事实会丢弃，被移除的工具可以恢复，循环干预只做提示与告知。

关于效果，项目自述称在六个仓库的同一批 277 个 SWE-Bench 任务上跑了五组智能体与模型组合，平均成本下降 18.4%–30.9%，30 个「仓库 × 组合」单元全部更便宜，五组中有四组 Pass@1 上升；在 Web-Bench 上成本下降 16%–21%，在两个每个任务都位于新仓库的安全审计基准上下降 6%–20%。这些数字来自项目方自己的实验，本站未做独立验证。

使用入口

仓库地址：microsoft/TokenEconomizer。

据项目说明，使用前需要已安装并登录受支持的智能体之一，且 PATH 中有 Python 3.10 或更新版本；插件不需要自己的 API key，也不接触凭据。以 Claude Code 为例，安装方式为在希望保留克隆的目录中执行：

git clone https://github.com/microsoft/TokenEconomizer.git
claude plugin marketplace add "$PWD/TokenEconomizer"
claude plugin install tokeneconomizer@tokeneconomizer

随后启动 claude、信任该文件夹，并运行 /tokeneconomizer:status 查看状态。Codex 与 Copilot CLI 的流程类似，分别使用 codex plugin marketplace add / codex plugin add 与 copilot plugin marketplace add / copilot plugin install；Pi 使用 pi install git:github.com/microsoft/TokenEconomizer，启动后运行 /te status。opencode 为实验性支持，需要手动建立符号链接，并通过终端命令 ~/.tokeneconomizer/bin/te --host opencode status 查看状态。项目说明还提示，Claude Code 与 Copilot CLI 每台机器需运行一次 /tokeneconomizer:toolprune refresh-catalog，并在智能体升级后重跑。

许可与限制

许可证为 Apache-2.0。

据项目说明，已知限制包括：插件只支持特定版本的智能体——Claude Code 2.1.300 至 2.1.310、Codex 0.153.1 至 0.164.0、Copilot CLI 1.0.83 至 1.0.102、Pi 1.2.0 至 1.3.0，更新的版本尚未测试；Codex 0.141.0 之前的版本完全不运行插件钩子；Pi 0.99.x 需改用 --extension 按路径加载；opencode 支持为实验性，仅在 1.19.5 与 2.2.0 上测试过，且未在 2.x 终端界面中测试。此外，Claude Code、Codex、Copilot CLI 与 opencode 从克隆目录运行插件，克隆需保留在原位；插件学习到的内容保存在本机 ~/.tokeneconomizer 目录中。若插件任一部分出错，会话会像未安装插件一样继续运行。