快速开始 · TokenEconomizer 中文站

需要以下智能体之一（以它支持的任何方式登录），以及 PATH 上 Python 3.10 或更高版本。插件不需要自己的 API 密钥，也从不处理凭证，因此任何套餐或登录方式都行。

开始之前

已安装并登录你的编码智能体（订阅套餐或 API Key 均可），且版本在下方支持范围内。
PATH 上有 Python 3.10 或更高版本（也可通过环境变量 TE_PYTHON=/path/to/python3.10+ 指定）。
仅 Copilot CLI：首次在目标仓库启动 copilot 时，需选择 Yes, and remember this folder for future sessions 信任该文件夹，否则 Copilot 会忽略该仓库下的 .github/copilot 工具剪枝配置。

命令在哪里输入。 以 / 或 $ 开头的行（如 /tokeneconomizer:status、$tokeneconomizer:status、/te status）是在智能体的对话提示框里输入的，而不是在操作系统的终端 Shell 里。

各智能体安装

在你希望保留克隆的文件夹里运行以下命令。Claude Code、Codex、Copilot CLI 和 opencode 都从克隆目录运行插件，所以请把它留在原位。插件在会话启动时加载，装好后请在你的某个仓库里开启一个新会话。

Claude Code

Claude Code · 安装

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

启动 claude，信任该文件夹（Yes, I trust this folder），并运行 /tokeneconomizer:status，如被询问则允许其脚本运行。每台机器一次，并在 Claude Code 更新之后，再次运行 /tokeneconomizer:toolprune refresh-catalog。

Codex

Codex · 安装

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

启动 codex，为该文件夹选择 Trust and continue，接着在 Hooks need review 处选择 Trust all and continue。钩子从你的下一次 Codex 会话开始生效，因此请退出（/exit）、重新启动 codex，并用 $tokeneconomizer:status 检查。

Copilot CLI

Copilot CLI · 安装

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

启动 copilot，选择 Yes, and remember this folder for future sessions，并运行 /tokeneconomizer:status，选择 Yes 以运行其脚本。每台机器一次，并在 Copilot 更新之后，再次运行 /tokeneconomizer:toolprune refresh-catalog。

Pi

Pi · 安装

pi install git:github.com/microsoft/TokenEconomizer

启动 pi 并运行 /te status。

opencode（实验性）

opencode · 安装

git clone https://github.com/microsoft/TokenEconomizer.git
mkdir -p ~/.config/opencode/plugins
ln -s "$PWD/TokenEconomizer/plugin/opencode/tokeneconomizer.ts" ~/.config/opencode/plugins/

启动 opencode 并发送一条提示，然后在仓库里用 ~/.tokeneconomizer/bin/te --host opencode status 检查。opencode 没有插件命令，因此插件的命令从终端运行。

安装成功的标志。 status 命令会打印一小段状态信息。refresh-catalog 会记录一个会话加载过的每一个工具（不涉及模型调用），以便工具剪枝能考虑到它们全部。请像上面那样保持 marketplace 路径为绝对路径：Copilot CLI 会把 ./TokenEconomizer 这样的相对路径当成某个 GitHub 仓库的名字。在 Windows 上为 Claude Code 添加 marketplace 时，请使用带正斜杠的绝对路径（如 C:/path/to/TokenEconomizer）。

自包含安装（Codex）

Codex 安装插件时会复制一份插件配置，但默认仍引用克隆目录里的 Python 包。如果你希望把插件包本体也一起打包进去，从而可以自由移动或删除最初的克隆目录，可以先运行构建脚本：

构建并安装自包含包

python3 /path/to/TokenEconomizer/scripts/build_plugin.py --out ~/te-marketplace
codex plugin marketplace add ~/te-marketplace
codex plugin add tokeneconomizer@tokeneconomizer

Copilot 自带密钥（BYOK）

如果组织策略禁用了 Copilot 自带模型（提示 Access denied by policy settings），你可以为 Copilot 配置自己的模型提供商（BYOK）：

Anthropic 直连

export COPILOT_PROVIDER_TYPE=anthropic                  # 或 openai、azure
export COPILOT_PROVIDER_BASE_URL=https://api.anthropic.com
export COPILOT_PROVIDER_API_KEY=...                     # 你的提供商密钥

如果经由 OpenRouter 接入，请保持 anthropic 协议以便提示缓存生效，并同时指定两侧的模型 ID：

OpenRouter 接入

export COPILOT_PROVIDER_TYPE=anthropic
export COPILOT_PROVIDER_BASE_URL=https://openrouter.ai/api
export COPILOT_PROVIDER_BEARER_TOKEN=...                        # 你的 OpenRouter 密钥
export COPILOT_PROVIDER_MODEL_ID=claude-haiku-4.5               # Copilot 自身配置的模型名
export COPILOT_PROVIDER_WIRE_MODEL=anthropic/claude-haiku-4.5   # OpenRouter 计费的模型名

注意：Copilot CLI 不会将 COPILOT_PROVIDER_* 环境变量传递给插件钩子，因此在 BYOK 模式下，插件自身的模型调用（微技能提议器、循环守卫裁判）会自动暂停并在会话启动时播报一次；无需模型调用的环境事实学习（microskills=envfacts）、工具剪枝、refresh-catalog 与 measure 则不受影响照常工作。

更新与卸载

智能体	更新方式	卸载步骤
Claude Code	在克隆目录里 git pull，再开启新会话（或运行 /reload-plugins）	`/tokeneconomizer:toolprune restore && claude plugin uninstall tokeneconomizer@tokeneconomizer && claude plugin marketplace remove tokeneconomizer`
Codex	在克隆目录里 git pull，然后再次执行 codex plugin add tokeneconomizer@tokeneconomizer	`~/.tokeneconomizer/bin/te --host codex toolprune restore && codex plugin remove tokeneconomizer@tokeneconomizer && codex plugin marketplace remove tokeneconomizer`
Copilot CLI	在克隆目录里 git pull（Copilot 直接从克隆目录加载插件）	`/tokeneconomizer:toolprune restore && copilot plugin uninstall tokeneconomizer@tokeneconomizer && copilot plugin marketplace remove tokeneconomizer`
Pi	pi update --extensions（普通 pi update 不会更新扩展）	`pi remove git:github.com/microsoft/TokenEconomizer`
opencode	在克隆目录里 git pull	`rm ~/.config/opencode/plugins/tokeneconomizer.ts`

卸载前先在排除过工具的仓库里运行一次 toolprune restore，即可干净移除插件写入的拒绝规则。若想彻底删除本机学到的所有历史状态，可在卸载后执行 rm -rf ~/.tokeneconomizer。更多细节见上游 plugin/README.md。

支持的版本

智能体	支持范围	更老的版本
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	0.99.x：按路径加载扩展
opencode（实验性）	1.19.5 与 2.2.0	未测试

上面的命令在每个范围的最老与最新版本上都测过；更晚的版本尚未测试。

Codex 0.141.0 之前完全不会运行插件钩子。
Pi 0.99.x：不用 pi install，改为克隆仓库，并以 pi --extension /path/to/TokenEconomizer/plugin/pi/tokeneconomizer.ts 启动每次会话，使用你克隆目录的完整路径；在克隆目录里 git pull 即可更新。
opencode 的支持是实验性的：仅在 1.19.5 与 2.2.0 上测试过，且未在 2.x 的终端 UI 中测试。