Cursor

按版本支持情况配置 Cursor 聊天 BYOK 与网关地址覆盖，并了解功能限制。

安装、配置与测试

1. 从 https://cursor.com/download 下载适合系统的桌面安装包，安装 Cursor 并打开项目。本指南使用编辑器中的服务商 API 密钥，不是 Cursor CLI 账户令牌。

2. 在 routerra.ai 控制台 (https://routerra.ai/keys)创建有目标模型权限的 API 密钥，复制准确的模型 ID。打开 Cursor Settings → Models，将 YOUR_API_KEY 填入 OpenAI API Key，点击 Save（旧版可能显示 Verify）。仅填写密钥不会将请求改发到网关。

3. 仅当当前版本显示 Override OpenAI Base URL 时启用它，填写 https://routerra.ai/v1；这是基础地址，不要追加 /chat/completions。如有独立密钥开关，也需开启。如提供自定义模型入口，添加 YOUR_MODEL_ID，在新聊天中明确选择它，不要选 Auto。修改地址后重启 Cursor。

4. 发送简短问题并检查网关请求日志。Cursor 官方将 BYOK 限定于聊天模型，OpenAI 集成列出的范围为标准非推理聊天模型。Tab 补全仍使用内置模型，不能据此保证所有 Agent 功能或任意网关模型可用。

找不到地址覆盖控件时，本指南没有该版本的官方网关配置方法。密钥区域隐藏可能是团队策略，请管理员检查个人 API 密钥权限。模型被拒绝时核对模型 ID 和 OpenAI 密钥栏；只有网关已提供别名时才使用别名。