TokenEconomizer 是什么:微软开源的 Coding Agent 省钱插件

TokenEconomizer 是微软研究院和加州大学伯克利分校开源的一个 Coding Agent 插件,用途很具体:在你常用的仓库里,让 Claude Code、Codex、Copilot CLI 这类 Agent 少花钱。它不换模型、不改 Agent,只从你跑过的会话里学经验,再用到后面的会话里。截至 2026-11-10,最新版 0.1.0,Apache-2.0 许可证,GitHub 5,562 星。
它是什么
用 Agent 写代码,账单里很大一块是重复花的钱:每一轮都要重新发送系统指令、全部工具定义和之前的对话;每开一个新会话,Agent 又要重新摸索一遍这个仓库怎么跑测试、哪个命令要换个写法。TokenEconomizer 把同一个仓库里的多次会话串起来看,前面会话踩过的坑,后面的会话直接绕开。
| 仓库 | github.com/microsoft/TokenEconomizer |
|---|---|
| 作者 | UC Berkeley、Microsoft Research、Microsoft Security(论文作者 Aaron J. Li 等 11 人) |
| 许可证 | Apache-2.0 |
| 热度 | GitHub 5,562 星、345 fork(GitHub API,2026-11-10 15:05 北京时间);仓库创建于 2026-10-13 |
| 运行要求 | Python 3.10+,只用标准库;已登录的 Claude Code、Codex、Copilot CLI 或 Pi 任一 |
| 最新版本 | 0.1.0(发布于 2026-10-27 01:03,北京时间);最近一次提交 2026-11-09 |
| 实验性支持 | opencode、Cursor Agent、Grok Build、Hermes Agent、Antigravity CLI |
解决什么问题
它把浪费拆成三类,每类对应一个开关:
- Micro-skills(记规矩):同一个命令在几次会话里都先失败、换个写法才成功,或者每 3 次会话让模型复盘一遍,从中提炼出关于这个仓库的事实。一条事实要被 3 次会话验证才生效,之后在每次会话开头注入;后面的会话跟它对不上,就自动作废。
- Tool pruning(裁工具):每个已加载工具的定义都会随每次请求发出去。某个工具在至少 2 次会话、累计 10 个提示里都没用到(或者连续 5 次会话没用),就通过 Agent 自己的配置把它关掉,一条命令能恢复。
- Loop guard(防打转):一轮任务反复撞同样的报错时,交给一个「裁判」模型判断是不是卡住了。把握达到 0.7 以上,就给 Agent 塞一句换思路的提示,每轮最多一次;还卡着,就只告诉你怎么按键停下,插件自己从不中断任务。
按论文的数字,Claude Code 配 Sonnet 5 成本降 23.6%,配 Opus 4.8 降 30.9%(这一组通过率掉了 1.0 个百分点);Codex 配 GPT-5.6 Terra 降 24.7%;Copilot CLI 配 Sonnet 5 降 18.4%,通过率反而升了 2.6。这些成本已经算上了插件自己调用模型的开销。官方同时给了范围:单个仓库里的降幅在 5% 到 40% 之间浮动,省多少看仓库和你做的活。
怎么用
以 Claude Code 为例。插件直接从克隆目录运行,装完别删这个文件夹:
git clone https://github.com/microsoft/TokenEconomizer.git
claude plugin marketplace add "$PWD/TokenEconomizer"
claude plugin install tokeneconomizer@tokeneconomizer
然后进到你的项目启动 claude,信任文件夹,依次执行:
/tokeneconomizer:status # 看它学到了什么、会话花了多少
/tokeneconomizer:toolprune refresh-catalog # 每台机器做一次,Claude Code 升级后再做一次
第二条官方特意标了别跳过:不记录工具清单,裁剪只能看到少数几个延迟加载的工具。Codex 换成 codex plugin marketplace add 和 codex plugin add,装完要在「Hooks need review」里选信任,并重开一次会话;Copilot CLI 是 copilot plugin install;Pi 一条 pi install git:github.com/microsoft/TokenEconomizer。
常用的几个设置:
/tokeneconomizer:config set microskills=on # 打开记规矩(会多调用模型)
/tokeneconomizer:config set microskills=envfacts # 只从重复报错里学,不调模型
/tokeneconomizer:config set toolprune=propose # 只提议,等你 toolprune apply 才生效
/tokeneconomizer:toolprune restore # 把被关掉的工具还回来
在 Agent 里敲这些命令要花一轮模型调用;在终端里跑 ~/.tokeneconomizer/bin/te --host claude status 是免费的。临时想关掉整个插件,用 TE_DISABLE=1 claude 启动即可。
装之前要知道的几件事
- 它会改你仓库里的配置:Claude Code 写
.claude/settings.local.json,Codex 写.codex/config.toml,Copilot CLI 写.github/copilot/settings.local.json。只加自己的条目,不碰你写的规则,新建的文件会加进.git/info/exclude。 - 额外的模型调用走你自己的套餐:裁判、提示语和事实提炼都通过
claude -p、codex exec这类命令发出,用你现有的订阅或 key 计费,Claude Code 上默认用 haiku。官方说明这些调用不会发送文件内容和你的提示词,只发命令片段、文件名和报错摘要,每次大约 1,500 token 以内。 - 版本范围:官方测过的是 Claude Code 2.1.300 到 2.1.310、Codex 0.153.1 到 0.164.0、Copilot CLI 1.0.83 到 1.0.102,更新的版本官方写明还没测。
- 工具不会马上消失:要攒够证据,还要等这个仓库的会话空闲 60 分钟才写入禁用列表,这是为了不让正在续写的对话丢掉提示缓存。
卸载时先在每个被裁过工具的仓库里跑 toolprune restore,再 claude plugin uninstall tokeneconomizer@tokeneconomizer,想彻底清掉学到的东西就删 ~/.tokeneconomizer。
适合谁 / 不适合谁
适合天天在同几个仓库里用 Agent、按量付费或经常撞额度的人,尤其是装了一堆 MCP 服务器、工具定义很长的配置。它省的是「重复」,所以仓库越固定、会话越多,效果越明显。
不适合偶尔打开一个新仓库就走的用法:没有历史可学,三个机制大多不会动。论文里两个每题都是新仓库的安全审计基准上,降幅只有 6% 到 20%。另外它只改工具加载和上下文,不压缩 Agent 的输出;想让 Agent 少写废话,可以看看 Caveman 这类 Skill,两者不冲突。