Cursor配置
1. Cursor 是什么，以及开始前需要准备什么
Section titled “1. Cursor 是什么，以及开始前需要准备什么”Cursor 是基于 VS Code 的 AI IDE，可以在编辑器中完成聊天、代码生成、修改和解释等常见开发操作。
在通过 RouteAPI 接入 Cursor 之前，建议先准备好：
- 已安装并可正常登录的 Cursor 桌面应用
- 你的 RouteAPI 密钥
- RouteAPI 控制台中可用的 OpenAI 协议标准聊天模型
- RouteAPI 的 OpenAI-compatible 接入地址
https://www.routeapi.ai/v1
2. 安装并打开模型设置
Section titled “2. 安装并打开模型设置”安装并登录 Cursor
Section titled “安装并登录 Cursor”从 Cursor 官网安装桌面版应用，并使用你的 Cursor 账号登录。
打开 Cursor Settings > Models
Section titled “打开 Cursor Settings > Models”在 Cursor 中打开设置页面，然后进入 Models。
3. 配置 RouteAPI
Section titled “3. 配置 RouteAPI”3.1 填写 OpenAI provider 的接入信息
Section titled “3.1 填写 OpenAI provider 的接入信息”在 Models 页面中找到 OpenAI 相关配置项。不同 Cursor 版本的字段名称可能略有差异，但你需要填写的核心信息是：
OpenAI API Key：你的 RouteAPI 密钥OpenAI Base URL：https://www.routeapi.ai/v1
填写完成后，点击 Verify。
3.2 选择模型
Section titled “3.2 选择模型”验证通过后，打开 Cursor 的模型选择器，选择 RouteAPI 返回的可用 OpenAI-compatible 模型。
更稳妥的做法是：
- 优先选择 RouteAPI 控制台里标注为 OpenAI 协议、适合聊天或编码的标准模型
- 不要优先选择 reasoning 模型，因为 Cursor 官方文档明确说明 OpenAI 自定义 API key 仅支持标准、非 reasoning 聊天模型
3.3 开始使用
Section titled “3.3 开始使用”完成配置后，你可以在 Cursor 的 Chat 或 Composer 中直接使用 RouteAPI 提供的模型。
4. 注意事项
Section titled “4. 注意事项”- 自定义 API key 方案主要影响 Chat / Composer 这类标准聊天模型能力，不会替代 Cursor 的全部内置能力
- 如果你开启的是 Tab Completion、某些 Agent 能力或其他需要专用模型的功能，仍可能继续使用 Cursor 自带模型
- 根据 Cursor 官方 FAQ，API key 不会被存储，但每次请求仍会发送到 Cursor 的服务器，由其完成最终 prompt 组装
5. 常见排查
Section titled “5. 常见排查”Verify失败时，先检查 API key 是否正确，以及地址是否填写为https://www.routeapi.ai/v1- 如果模型列表没有出现你期望的模型，先检查该模型是否支持 OpenAI 协议，并确认它是标准聊天模型而不是 reasoning 模型
- 如果你已经更新了 key 或地址，但 Cursor 仍显示旧状态，可以关闭并重新打开 Cursor，再次
Verify - 如果你需要终端中的编码代理接入方式，也可以参考 Codex 配置文档、Claude 配置文档 和 OpenCode 配置文档