Cursor 可以把 OpenAI 系模型请求发到 XiuRouter Chat Completions。这个 Base URL 覆盖是全局的；先验证 Ask，再按模型测试 Agent，不要把 Verify 成功当作完整工具链证明。
选择配置方式
- 首次配置：填写 XiuRouter API Key、Base URL 和精确模型 ID。
- 替换已有：先记录原 Key 来源、Base URL 和模型，再开启覆盖。
- 对话协助：不提供。连接和凭据由 Cursor 设置界面保存。
前置条件
- Cursor 已更新到当前稳定版。
- 已创建一把 Cursor 专用 XiuRouter API Key。
- 已选择一个 OpenAI 系模型 ID。Claude 系和 Gemini 系模型 ID 不走这个覆盖。
配置连接
- 打开 Cursor Settings → Models。
- 替换已有连接时，先记录当前 OpenAI API Key 来源和 Base URL。
- 在 OpenAI API Key 填 XiuRouter API Key。
- 打开 Override OpenAI Base URL。
- Base URL 填
https://router-api.xiu.ai/v1。 - 点击 Verify。
- 在模型列表中添加并选择 XiuRouter 当前目录里的精确模型 ID。
Cursor 已有同名模型时直接选原项，不要再建重复 ID。不要给这把 Key 加“只允许当前电脑 IP”一类限制；请求可能由 Cursor 服务端代发。
能力边界
- Ask 的普通提问通过
/v1/chat/completions。 - Tab 补全和依赖 Cursor 专有模型的功能继续走 Cursor 自己的服务。
- Base URL 覆盖会影响所有符合条件的 OpenAI 系模型，不能按模型分别配置 provider。
- Agent 依赖 Cursor 的流式 ApplyPatch 工具。能否编辑文件取决于所选模型，必须逐个验证。
验证
- 先在 Ask 发一个短问题，确认收到完整回复。
- 在 XiuRouter 控制台“检查实际请求”核对同一 Key、模型、
/v1/chat/completions和成功状态。 - 再让 Agent 只读取一个文件，不允许修改。
- 最后执行一次可撤销的小改动，并检查 diff。
常见失败
| 现象 | 处理 |
|---|---|
| Verify 失败 | 检查 Key 是否启用、允许当前模型且钱包有余额 |
| Ask 能用，Agent 不能改文件 | 更新 Cursor，新建对话后重试；仍失败就换用工具调用更稳定的模型 |
| Cursor 自带模型突然不可用 | 关闭 Override OpenAI Base URL，让这些模型恢复 Cursor 原路由 |
| “检查实际请求”没有匹配记录 | 核对模型是否属于 OpenAI 系，以及当前对话是否在覆盖开启后新建 |
回滚
关闭 Override OpenAI Base URL，恢复原 API Key 来源和模型。新建对话确认请求已回到原路由后，再撤销 Cursor 专用 XiuRouter API Key。
来源与核对日期
本文以 XiuRouter 产品集成页当前 Cursor 配置、限制和验证路径为准，核对日期为 2026-08-22。本轮未使用真实 Key 运行 Cursor 计费任务；Agent 编辑能力需要按模型验证。