ARTICLE · 1303759

微软开了个插件:不改 Agent,也能让写代码少烧一截 Token

发布时间：2026-11-03 21:38:18 最近访问：2026-11-03 21:38:19

微软研究院联合 UC Berkeley 开源了一个插件：TokenEconomizer。

一句话：不改你的编程 Agent 本身，专治「同一个仓库里反复浪费 Token」。

它到底解决啥

真实干活时，你很少只让 Agent 做一次就走。

同一个仓库里，今天修 bug，明天加功能，后天跑测试——会话一个接一个。

贵就贵在这儿：每一回合都要再付一遍系统说明、已加载工具定义、还有到目前为止的对话。很多钱其实花在三件重复事上：

仓库规矩一遍遍重新摸（测试命令到底怎么写、环境变量缺啥）
一堆这里根本用不到的工具，每次请求都带着定义走
卡在同一类失败上打转，Token 哗哗掉

TokenEconomizer 的思路很黑盒：Agent 的模型、权重、代码都不动。它只盯「这个仓库里已经跑过的会话」，把经验留给后面的会话。学到的东西落在你本机 ~/.tokeneconomizer，不经过它自己的账号。

目前正式支持Claude Code、Codex、GitHub Copilot CLI、Pi；opencode、Cursor Agent是实验支持。

怎么工作：三招

官方框架图把机制拆成知识、接口、控制三条线。

1. 微技能（Micro-skills）——记住这个仓库怎么干活

跨会话反复踩的坑，会被收成「事实」：比如这里必须先跑某步构建、测试要用 python -m pytest 而不是裸 pytest、某个命令缺哪个环境变量。

默认每隔 3 个会话，会有一个提议模型扫最近会话；再叠加「反复失败」这条证据链。同一事实被大约三个会话确认后，才会在下次会话开头塞进上下文；后面会话打脸了就丢掉。

这一档默认关着，因为提议会多耗一点模型调用；省多少，跟你仓库和工作方式强相关。可按需打开。

2. 工具裁剪（Tool pruning）——别再加载这里没人用的工具

每个已加载工具的定义，几乎会跟着每次请求一起走。某个工具在跨至少 2 个会话的累计 10 次提示里都没用上，或连续 5 个会话都没用，就会通过 Agent 自己的设置，在后续会话里剔除。一条命令能加回来。

这一档默认开。不同 Agent 能裁的粒度不一样：Claude Code 可裁单个工具；Codex 裁能力包；Copilot CLI 裁整个 MCP 服务器；Pi / Cursor / opencode 这边基本还裁不动。

3. 失败循环干预（Loop guard）——卡住了先轻推一把

它会先摸清：在这个仓库里，一个「回合」通常多长。默认大约攒够 5 次「顺利结束」的回合后，才开始盯死循环。

同一类失败反复出现时，裁判模型够确信（默认置信度 0.7）会塞一句改道提示，每回合最多一次；还不灵，就提示你怎么停——它自己不会替你掐断回合。

这一档也默认开。

三招都可逆：事实会过期，工具能 restore，循环干预只 nudge + 通知。插件挂了某一步，会话也会当没装它一样继续跑。

能省多少：官方数字

论文在 SWE-Bench 上跑了6 个仓库、277 个任务，五种 Agent–模型组合，任务按仓库顺序跑、从零开始学习；成本里包含TokenEconomizer 自己的模型调用。

README 里的均值成本降幅：

Claude Code · Sonnet 5：23.6%
Claude Code · Opus 4.8：30.9%
Codex · GPT-5.6 Terra：24.7%
Codex · GPT-5.6 Sol：26.1%
Copilot CLI · Sonnet 5：18.4%

也就是官方写的：五种组合均值成本低 18.4%–30.9%，30 个「仓库 × 组合」格子里成本都更低；Pass@1 五种里有四种上升。Web-Bench 上也报了大约 16%–21% 的成本下降；在「每个任务都是新仓库」的安全审计类基准上，仍有约 6%–20% 的下降。

翻译成人话：你越常泡在同一个仓库里，这套越可能回本。天天换新仓、一次性活，收益会薄一些。

怎么装：最短路径

需要：已登录的支持 Agent + 本机Python 3.10+。插件不另要 API Key，走你 Agent 自己的登录/套餐。

以Claude Code为例（在你想放 clone 的目录执行）：

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

启动 claude，信任文件夹，跑 /tokeneconomizer:status。本机再跑一次 /tokeneconomizer:toolprune refresh-catalog（Claude 大版本更新后也建议再跑）。

Codex类似，但第二步动词是 add 不是 install：

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

Copilot CLI则是 copilot plugin marketplace add … + copilot plugin install …。Pi一条：pi install git:github.com/microsoft/TokenEconomizer。

装好后日常几乎不用管。常用自查：

作用	Claude Code / Copilot	Codex	Pi
看状态与花费	`/tokeneconomizer:status`	`$tokeneconomizer:status`	`/te status`
看微技能	`/tokeneconomizer:microskills`	`$tokeneconomizer:microskills`	`/te microskills`
打开微技能	`/tokeneconomizer:config set microskills=on`	同左（`$` 前缀）	`/te config set …`
恢复被裁工具	`/tokeneconomizer:toolprune restore`	同左	—