配置速查
Cursor 的配置分两步：先打开覆盖开关，再手动加模型。
| 配置项 | 填什么 | 容易错在哪 |
|---|---|---|
Override OpenAI Base URL | https://turingapi.space/v1 | 开关不开，填什么都不生效 |
API Key | 控制台创建的 sk- 密钥 | 填完点 Verify，失败先别急着重填 |
模型名 | 必须手动添加 | Cursor 不会自动拉取模型列表 |
前置准备
Cursor 的配置项不多，但每一步都不能漏。
在 注册页 建账号，控制台新建密钥并保存。
Cursor 的 Agent / Composer 模式要靠工具调用读写文件，模型不支持 tools 时会中途失败。优先选旗舰或主力模型。
从 模型列表 复制，后面要手动输入，不能选。
配置步骤
全部在「设置 → Models」里完成。
配置 Base URL 与密钥 主流程
- 打开「设置 → Models」
- 找到
OpenAI API Key，填入你的sk-密钥 - 打开
Override OpenAI Base URL开关 - 在 Base URL 里填
https://turingapi.space/v1 - 点 Verify 验证，然后继续添加模型
Verify 失败不一定代表配错，见下面的说明。
手动添加模型 必做
- 在 Models 页面下方找到模型列表
- 点「+ Add model」
- 输入站内模型名，例如
claude-sonnet-5 - 回车确认，开关打开即可在对话里选到
claude-sonnet-5
gpt-6.1-sol
gpt-6-astra模型名错一个字符就会报模型不存在。直接从模型列表页复制，不要手打。
不同模式要分别打开 特有坑
- Chat 模式用你在 Models 里勾选的模型
- Agent / Composer 模式还要单独确认模型支持工具调用
- Tab 补全走的是 Cursor 自己的服务，不受这个配置影响
很多人配好了 Chat 能用，一切到 Agent 就不动——通常是模型不支持 tools。
验证是否配置成功
看到这些就说明通了
- 在 Chat 里选一个手动添加的模型
- 发一句话，能流式返回
- 控制台「用量」页出现记录
Chat 通但 Agent 不通，问题在模型能力而不在配置。
模型列表里选不到刚加的模型
- 确认添加后按了回车，模型出现在列表里
- 确认模型右侧的开关是打开的
- 重启 Cursor 让配置刷新
只是加了没打开开关，是不会出现在对话页下拉里的。
常见问题
Cursor 的问题集中在模型添加和 Agent 模式两处。
为什么 Verify 一直失败？
Verify 会对模型列表接口发请求，部分分组没有开放这个接口，所以验证报错。但只要地址和密钥正确，对话功能是正常的。
判断标准：直接发一条消息试试，能返回就不用管这个提示。
模型下拉里没有站内的模型？
Cursor 不会自动同步，必须手动 Add model。添加时模型名要和站内完全一致。加了还要把右侧开关打开，否则不会出现在对话页。
配好之后 Cursor 自己的功能还能用吗？
Tab 补全、代码库索引这类功能走的是 Cursor 自己的服务，不受 Base URL 覆盖影响。被影响的只是走 OpenAI 接口的那部分对话能力。
Agent 模式跑到一半就停？
换一个支持工具调用的模型。Agent 需要读写文件、执行命令，模型不支持 tools 时不会报错，而是在那一步静默停住。
能不能少填一点，只改 Base URL？
不行。Override 开关和 API Key 必须一起配，只改一个是不会生效的。
相关客户端
CCline
靠工具调用干活，模型必须支持 tools
RRoo Code
支持 Profile，可多套配置切换
CClaude Code
走 Anthropic 协议，地址不带 /v1
CCodex CLI
wire_api 要写 responses，不是 chat
接入过程卡住了？到 QQ 群 1128182538 说明「客户端 + 报错码 + 时间点」，比只说"用不了"好排查得多。其他通用问题见 常见问题。