---
title: "将 Cursor 接入 XiuRouter"
description: "在 Cursor 模型设置中覆盖 OpenAI Base URL，并先验证 Ask 再测试 Agent。"
image: "https://docs.xiu.ai/og.png"
---

> XiuAI 文档索引
> 完整文档索引：https://docs.xiu.ai/llms.txt
> 阅读前先通过索引确认当前可用页面。

# 将 Cursor 接入 XiuRouter

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 不走这个覆盖。

## 配置连接

1. 打开 **Cursor Settings → Models**。
2. 替换已有连接时，先记录当前 OpenAI API Key 来源和 Base URL。
3. 在 **OpenAI API Key** 填 XiuRouter API Key。
4. 打开 **Override OpenAI Base URL**。
5. Base URL 填 `https://router-api.xiu.ai/v1`。
6. 点击 **Verify**。
7. 在模型列表中添加并选择 XiuRouter 当前目录里的精确模型 ID。

Cursor 已有同名模型时直接选原项，不要再建重复 ID。不要给这把 Key 加“只允许当前电脑 IP”一类限制；请求可能由 Cursor 服务端代发。

## 能力边界

- Ask 的普通提问通过 `/v1/chat/completions`。
- Tab 补全和依赖 Cursor 专有模型的功能继续走 Cursor 自己的服务。
- Base URL 覆盖会影响所有符合条件的 OpenAI 系模型，不能按模型分别配置 provider。
- Agent 依赖 Cursor 的流式 ApplyPatch 工具。能否编辑文件取决于所选模型，必须逐个验证。

## 验证

1. 先在 Ask 发一个短问题，确认收到完整回复。
2. 在 XiuRouter 控制台“检查实际请求”核对同一 Key、模型、`/v1/chat/completions` 和成功状态。
3. 再让 Agent 只读取一个文件，不允许修改。
4. 最后执行一次可撤销的小改动，并检查 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 编辑能力需要按模型验证。

源文件：https://docs.xiu.ai/router/integrations/cursor/index.mdx