# 自带 Key，让 Cursor 走一个端点

> https://router.one/zh/integrations/cursor 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 最后更新：2026-08-07

Cursor 是最热门的 AI 代码编辑器之一，设置里支持自带 API Key：覆盖 OpenAI Base URL、粘贴你的 Key，chat 和 Composer 模型就改由这个 Key 计费。把覆盖指向 Router One，一个 Key 就能用 GPT、Claude、Gemini、DeepSeek 系列——按量计费，部分模型最低低至官方价 1 折，每次调用都有成本 trace。边界说清楚：覆盖只作用于 Cursor 的 chat/Composer 模型；Cursor Tab 自动补全仍走 Cursor 自家模型。

## 把 Cursor 配置到 Router One base URL

打开 Cursor → Settings → Models → OpenAI API Key，勾选「Override OpenAI Base URL」，填入网关地址和你的 Router One Key，点 Verify 验证。模型可以直接选列表里的，也可以把 /models 页的精确 ID 加为自定义模型：

`cursor-settings`

```bash
# Cursor → Settings → Models → OpenAI API Key
Override OpenAI Base URL:  https://api.router.one/v1
API Key:  sk-your-router-one-key
Model:    <copy the exact ID from /models>
```

## Cursor 该填哪个模型 ID？

从 /models 页复制精确的模型 ID——ID 区分大小写，页面同时列出每个模型的上下文窗口、能力和当前单价。建议为每个工具单独建一个 API Key，并设置 maxSpend 消费上限，这样单个工具跑飞不会影响其他工作负载。

## 在 trace 里验证 Cursor 的调用

发出第一个请求后，到 Dashboard → Logs 查看它的完整 trace：模型、tokens、花费、延迟和状态码。Cursor 的每一次调用从此都有账本和轨迹，不再是黑盒。

## 常见问题

### 覆盖 Base URL 对 Cursor Tab 自动补全生效吗？

不生效。覆盖只作用于你在 Cursor 里选择的 chat 和 Composer 模型；Tab 自动补全跑在 Cursor 自家模型上，按你的 Cursor 订阅计费。在中国大陆用 Cursor？国内直连与支付宝充值的配置有专门指南——见下方相关页面。

### Cursor 能通过网关用哪些模型？

目录里任何具备对话能力的模型——GPT、Claude、Gemini、Grok、DeepSeek、GLM、Kimi 等系列。/models 页是模型 ID 与单价的事实来源。

### 中国大陆能直连吗？

能。网关在大陆可直连、无需 VPN，配置与全球环境完全一致。

### 报 401/403/429 怎么排查？

先到 Dashboard → Logs 看请求有没有到达网关以及状态码，再对照错误码速查页逐项检查环境变量、Key 状态和限额。

## 相关页面

- 全部接入指南：https://router.one/zh/integrations
- Cursor 的 401/403/429 排查：https://router.one/zh/llm-api-error-codes
- OpenClaw 接入：https://router.one/zh/integrations/openclaw
- Zed 接入：https://router.one/zh/integrations/zed
- Cursor 国内接入（免翻墙 + 支付宝）：https://router.one/zh/cursor-china
- 网关层负责什么：https://router.one/zh/llm-api-gateway
- OpenAI 兼容 API：https://router.one/zh/openai-compatible-api
- API 文档：https://router.one/zh/docs
- 本页规范地址：https://router.one/zh/integrations/cursor
- 模型与每模型 token 价格：https://router.one/zh/models（markdown：https://router.one/zh/models.md）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md