文档 / 集成 / Cursor

Cursor 接入 RelayRouter

Cursor 允许把它的 OpenAI 端点替换成你自己的 OpenAI 兼容 base URL。把它指向 RelayRouter 后，聊天面板就能使用密钥所属分组里的任意模型（包括 Claude 和 Gemini），按 token 从 RelayRouter 余额计费。

#配置步骤

步骤	位置	填写
`1`	Cursor Settings → Models → OpenAI API Key	填入为 OpenAI 协议分组创建的 RelayRouter 密钥
`2`	Override OpenAI Base URL	`https://relayrouter.io/v1`
`3`	Add model	输入精确的模型 id，例如 gpt-6-astra 或 claude-opus-5-5，然后启用
`4`	Verify	点击密钥旁的 Verify，然后在聊天的模型选择器中选中该模型

要用 OpenAI 协议分组的密钥（GPT、Codex 分组，或模型页上标注 OpenAI 的任意分组）。Cursor 发送的是 OpenAI 格式请求，绑定在 Anthropic 协议分组上的密钥会对该模型返回 404。

#可用与不可用的功能

使用你所选模型的聊天、行内编辑和智能体对话会经由 RelayRouter。Cursor 在自家服务器上运行的功能（例如 Tab 补全和部分索引）不会走自定义 base URL。支持流式输出；长任务请控制在 Cursor 的超时设置内。

#在 Cursor 之外验证密钥

terminalbash

curl https://relayrouter.io/v1/chat/completions \
  -H "Authorization: Bearer sk-your-relayrouter-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-astra","messages":[{"role":"user","content":"ping"}]}'

#排错

现象	处理
`Verify 报 401`	密钥输错、被停用或余额为零，去控制台核对
`模型能选但回复 404`	该 id 不在密钥分组里；按模型页的精确 id 和正确分组重试
`回复中途停止`	调大 Cursor 的请求超时，或换更快的分组

←Claude Code Cline / Roo Code→