Cursor API 配置与插件入口
Cursor 场景最容易踩坑的地方，不是不会填 Base URL，而是 把 Cursor 自己的配置、Claude Code 扩展、Codex 扩展、Cline、Roo Code 混成一件事。
先记住一句话：
你在 Cursor 里能用的 AI，不一定都走同一套 Key、同一套 provider、同一套配置文件。
Claude Code 在 VS Code / Cursor 里有独立的 Extension settings，同时也会读取 Claude Code 共享 settings/env，例如 ~/.claude/settings.json。Codex IDE 扩展则依赖 Codex CLI 共享配置，例如 ~/.codex/config.toml。Cline / Roo Code 通常走各自扩展里的 OpenAI Compatible provider 表单。Cursor 原生 AI 则是另一套入口。
先分清 5 条路线
| 你现在要配什么 | 应该看哪条路 | 核心配置 | 下一跳 |
|---|---|---|---|
| Cursor 自带 AI 走兼容 API | Cursor 原生 provider 设置 | base_url / API Key / 模型名 | OpenAI 兼容 API |
| 在 Cursor 里使用 Claude Code 扩展 | Claude Code 扩展路线 | 扩展设置 + ~/.claude/settings.json / env | Claude Code 配置 |
| 在 Cursor 里使用 Codex 扩展 | Codex 扩展路线 | ~/.codex/config.toml + provider/model | Codex API 配置 |
| 在 Cursor 里使用 Cline | Cline 扩展路线 | OpenAI Compatible provider 表单 | Cline / Roo Code 配置 |
| 在 Cursor 里使用 Roo Code | Roo Code 扩展路线 | OpenAI Compatible provider + tool calling 能力 | Cline / Roo Code 配置 |
Cursor custom OpenAI URL 连接失败：先做最小验证
如果你遇到“curl 能通，但 Cursor custom OpenAI URL 不通”，先不要一口气改十几个地方，按最小验证流程走。
最小验证流程
- 先确认当前报错来自 Cursor 原生 AI，不是 Claude Code / Codex / Cline / Roo 面板。
- Base URL 使用兼容接口常见写法：
https://YOUR_API_DOMAIN/v1- API Key 使用当前项目 Key，不复用高权限主 Key。
- Model 使用控制台展示的模型名，不猜官方别名。
- 完全退出 Cursor，再重新打开，避免 IDE 进程没有继承新环境。
- 先发一句短 prompt，例如：
请只回复“连接测试通过”。- 如果仍失败，再判断是 401、404、429、timeout 还是连接测试阶段就失败。
Cursor / Claude Code / Codex / Cline / Roo 分流诊断
| 现象 | 更可能是哪条路线 | 先查什么 |
|---|---|---|
| Cursor 原生聊天失败，但扩展能用 | Cursor 原生 AI | custom OpenAI URL、API Key、模型名 |
| Cursor 能聊，但 Claude Code 扩展报未登录 | Claude Code 扩展 | 扩展设置、~/.claude/settings.json、IDE env 继承 |
| Codex 扩展仍走默认模型 | Codex 扩展 | ~/.codex/config.toml、provider、profile、旧登录态 |
| Cline 报 OpenAI compatible 配置错误 | Cline | Base URL、API Key、Model ID |
| Roo 能聊天但工具调用失败 | Roo Code | 模型是否支持 OpenAI native tool calling |
| 全部都失败 | 共享 Key / 共享线路 / 余额问题 | 先查 Key、账户、余额、状态说明 |
Cursor 原生 AI：连接测试矩阵
| 检查项 | 目标值 | 失败时下一跳 |
|---|---|---|
| 入口 | Cursor 原生 provider 设置 | 若你其实在用扩展，改这里不会生效 |
| Base URL | https://YOUR_API_DOMAIN/v1 | 看 OpenAI 兼容 API |
| API Key | 当前项目 Key | 看 401 Invalid Key |
| Model | 控制台展示 model id | 看 Model Not Found |
| 最小验证 | 短 prompt | 若 429，看 429 排查 |
Claude Code 扩展：Cursor 里单独排查什么
Claude Code 扩展和 Cursor 原生 AI 不是同一个配置入口。重点分两层：
- 扩展设置层：控制扩展 UI、权限模式、打开位置等。
- Claude Code 共享配置层：
~/.claude/settings.json、项目.claude/settings.json/.claude/settings.local.json、shell 环境变量。
如果你要让它走中转站，不要只改 Cursor 原生 AI 的 provider；那通常不会影响 Claude Code 扩展。
重点看：
Codex 扩展：Cursor 里单独排查什么
Codex 扩展依赖的是 Codex CLI/IDE 共享配置。常见排查顺序：
- 确认当前面板真的是 Codex 扩展。
- 看
~/.codex/config.toml里到底是openai_base_url还是自定义model_provider生效。 - 检查旧 profile 或 CLI 参数是否覆盖。
- 再检查 model、Base URL 和
wire_api。
重点看：
Cline / Roo Code：在 Cursor 里要单独看什么
Cline / Roo Code 往往用的是各自扩展里的 OpenAI Compatible provider 表单，不会自动读取 Claude Code 的 ANTHROPIC_BASE_URL，也不会自动继承 Codex 的 config.toml。
如果你在同一个 Cursor 里装了多个 AI 扩展，排错时先确认当前报错来自哪个面板。不同扩展的登录态和配置文件不会自动同步。
IDE 进程、环境变量与设置覆盖
Cursor 里常见的不是“字段不会填”，而是“你改完了，但当前进程没吃到”。
优先检查：
- 你改的是原生 AI、扩展设置，还是共享配置文件。
- 当前 Cursor 进程是否重启过。
- 内置终端和外部终端是否读取同一套环境变量。
- 项目级配置是否覆盖了用户级配置。
- 你当前打开的是哪个扩展面板。
结论
如果你是来找“Cursor 怎么走中转站”的，先别急着只问一个问题。先拆成这五个：
- 我现在用的是 Cursor 原生 AI，还是扩展？
- 扩展是 Claude Code、Codex、Cline，还是 Roo Code？
- 当前报错属于 Key、Base URL、模型名，还是工具调用能力？
- 我改的是共享配置，还是只改了某个扩展 UI？
- IDE 进程是否已经重启并继承新配置？
把这几个问题拆清，排错速度会快很多。