XCR 快速上手：从注册到拿回第一份检查过的改动

准备工作

• 一台 macOS 或 Linux 电脑。
• 一个 XCR 能连接的AI编程工具：Codex、Claude Code、Cursor 或 Grok Build。
• Node.js 20 或以上。没有的话，AI编程工具会先帮你装上，装之前会先问你。
• 这台电脑上的一个项目文件夹，最好是 git 仓库。

第 1 步：用邮箱创建账户

打开安装页。如果还没登录，输入邮箱，点“通过邮箱发送登录链接”。链接几秒钟就到，15 分钟内有效。不用记密码，注册也不用绑卡。第一次来？同一个链接会直接为你创建账户。

第 2 步：充值额度

XCR 用预充值额度，只为实际干的活付费。在控制台打开“余额与账单”，选一个额度包：

• $5 额度，支付 $5.62
• $10 额度，支付 $10.83
• $25 额度，支付 $26.44
• $50 额度，支付 $52.45

以上为税前价格，已包含充值手续费。付款由 Creem 作为记录商家处理，不是订阅，也不会自动续费。Creem 确认付款后余额马上更新。每个任务的费用是模型用量加 20%，再加每个任务 $0.02，具体算法和示例见价格页。

第 3 步：把 XCR 连接到你的AI编程工具

1. 在控制台打开“安装到电脑”。
2. 选择你的工具：Codex、Claude Code、Cursor 或 Grok Build。
3. 看一下“XCR 会在你电脑上改动这些”，勾选同意。
4. 点“复制安装指令”，粘贴给你的AI编程工具；它问能不能运行命令时，点“允许”。
5. 这条命令会从 xcr.ai 下载插件，先核对 SHA-256 再运行，核对不通过就什么都不做。完成后控制台会显示“已连接”。
6. 重启你的AI编程工具，就装好了。

安装指令只能用一次，10 分钟内有效；过期了重新复制即可。用 Cursor 的话，也可以直接点“添加到 Cursor”。习惯用终端？在同一页展开“习惯用终端？”，复制命令自己运行，效果一样。想看某个工具的详细步骤，请看在 Codex 中安装 XCR。

第 4 步：交出第一个任务

在AI编程工具里照常说出你要做什么。XCR 装进去的那条简短规则会告诉工具什么时候把活交出去：超出小修小改的改动，大约超过 30 行或涉及多个文件，比如新功能、测试、修 bug、重构和迁移。简单问题和一行修改仍由工具自己完成。第一个任务可以这样说：

• “给支付模块补上单元测试，并且让它们全部通过。”
• “给订单页加 CSV 导出，支持按日期和状态筛选。”
• “修复登录状态过早失效的 bug，并为它补一个测试。”

第 5 步：拿回结果

XCR 在项目副本上工作，未提交的文件也会一并带上，所以只有在应用结果时才会动到你的工作区。每个任务只发送需要的文件，并去掉其中的密钥值；.env、私钥这类文件从不读取。XCR 写好改动后，会在离线沙箱里运行你项目自己的检查（类型检查、代码规范检查、测试）：macOS 直接支持，Linux 装好 bubblewrap 即可；检查失败会在任务预算内自动修复。

你会收到一份简短报告：完成了哪些要求、改了哪些文件、检查结果和准确费用。检查通过后，改动会直接写进你的工作区，不会自动提交，你可以用平时的 diff 方式审查。想先看再决定？在“插件偏好”的“检查通过后”里选“先放一边，等我决定”，改动会先放在单独的分支上，等你点头再应用。检查没通过的结果绝不会自动应用。需要联网的步骤（比如安装依赖包）会列在“Needs you”里，由你的AI编程工具接着完成。改主意了？让你的AI编程工具撤销这次 XCR 改动即可。

第 6 步：查看花费

• “概览”显示余额和今天已花的金额。
• “任务记录”列出每个任务：要做什么、结果如何、准确花了多少钱。代码本身从不保存。
• “余额与账单”里有完整的使用记录。
• 在“电脑与项目”里可以给每台电脑设每日上限；每个任务本身也有花费上限。

随时暂停或卸载

想暂停，用“概览”页顶部的开关；也可以在“电脑与项目”里只暂停某台电脑或某个项目。暂停期间，AI编程工具会自己完成工作，不会产生费用。要从电脑上删除 XCR，对AI编程工具说“帮我把 XCR 从这台电脑上卸载”，或者在“电脑与项目”里点“从这台电脑移除”。卸载只会拿掉 XCR 加进去的内容，其他文件保持原样。更多细节见插件介绍。