在 Codex 中安装 XCR：重活交出去，Codex 额度更耐用

为什么要在 Codex 里用 XCR

Codex 用的是 ChatGPT 套餐里的额度，而涉及多个文件、还要反复修测试的功能，正是最快耗光一个窗口的那类工作。连上 XCR 之后，Codex 负责对话、规划和验收，最重的实现交给 XCR。XCR 的任务用它自己的模型接入完成，费用从 XCR 余额扣，所以 Codex 的额度能撑得更久。关于限额本身，请看 Codex 用量限制详解。

开始之前

• 一台装好并登录了 Codex 的 macOS 或 Linux 电脑。
• Node.js 20 或以上。没有的话，Codex 可以在安装过程中帮你装上，装之前会先问你。
• 一个有余额的 XCR 账户。在安装页用邮箱登录，然后在“余额与账单”充值 $5 起的额度包。

第 1 步：打开安装页，选择 Codex

在控制台打开“安装到电脑”，选 Codex 标签。“XCR 会在你电脑上改动这些”下面列出了它为 Codex 做的两处改动。看完后勾选同意。

第 2 步：复制指令，粘贴给 Codex

点“复制安装指令”，把内容粘贴给 Codex。这段指令会让 Codex：

1. 用 node --version 检查是否有 Node.js 20 或以上；没有就先安装最新的 LTS 版，安装前会先告诉你。
2. 在终端运行一条命令。它从 xcr.ai 下载插件，先核对 SHA-256 再运行，没核对通过的东西不会被执行。
3. 用一两句话告诉你命令的输出，并提醒你重启 Codex。

Codex 请求运行命令或联网时，点“允许”。这段指令只能用一次，10 分钟内有效，过期了重新复制即可。

第 3 步：等到“已连接”，然后重启 Codex

控制台页面会显示“正在等 Codex 装好……”，安装完成后立刻变成“已连接”，并显示你的电脑名。重启 Codex，让它加载 XCR。如果不小心关了页面，点“已安装？检查连接”就能找回这台电脑。

Codex 设置里改了什么

• ~/.codex/config.toml：加一段 XCR 配置，把 XCR 注册为 Codex 的 MCP 服务，工具超时设为 180 秒。
• ~/.codex/AGENTS.md：加一条简短规则，告诉 Codex 什么时候把活交给 XCR，以及怎样验收结果。

每处改动都放在清楚标记的 XCR 行之间，改动前会先把原文件备份到你主目录下 XCR 自己的文件夹里。Codex 的其他设置一概不动。

确认已经生效

重启后问 Codex：“我的 XCR 余额是多少？”Codex 会通过 XCR 回答你的剩余额度和这台电脑今天的花费。然后提一个比小修小改更大的需求，比如“给订单页加 CSV 导出，支持按日期和状态筛选”。Codex 会把它交给 XCR，任务会出现在控制台的“任务记录”里。

一次交接是什么样的

XCR 在项目副本上工作，在离线沙箱里运行你项目的检查（类型检查、代码规范检查、测试）：macOS 直接支持，Linux 装好 bubblewrap 即可；检查失败会在任务预算内自动修复。Codex 收到一份简短报告：完成了哪些要求、改了哪些文件、检查结果和准确费用。检查通过后，改动直接写进你的工作区、不自动提交，你可以像审查其他 diff 一样审查它。Codex 会对照你的需求检查一遍，并完成需要联网的步骤，比如安装依赖包。想把改动撤回？让 Codex 撤销这次 XCR 改动即可。

在 Codex 里用好 XCR

• 把完整需求一次说清，包括怎么测试。XCR 照着它实现，Codex 照着它验收。
• 保持 AGENTS.md 简洁。Codex 每个任务都会读它，XCR 的规则只有几行。
• 某个仓库不想用 XCR？在“电脑与项目”里为这个项目关掉即可。
• 想要一个硬性上限？在“电脑与项目”里给这台电脑设每日上限。

暂停或卸载

用“概览”页顶部的开关可以暂停全部；暂停期间 Codex 自己干活，不会产生费用。要从这台电脑删除 XCR，对 Codex 说“帮我把 XCR 从这台电脑上卸载”，或者在“电脑与项目”里点“从这台电脑移除”。卸载只会拿掉 XCR 加进 config.toml 和 AGENTS.md 的内容，文件其余部分保持原样；备份会保留，直到你自己删除。第一次用 XCR？先看 XCR 快速上手。