Cursor 配置

通过 OpenAI 兼容协议将 Cursor 接入 Chimney，让 Cursor 的对话与 Agent 使用你在 Chimney 的额度。

前置条件：

• 已注册并登录 Chimney
• 已安装 Cursor

适用范围

自定义 API Key 模式下，Cursor 的部分官方特性（如 Tab 补全、部分内置模型路由）仍走 Cursor 官方服务，不经过 Chimney；对话 / Agent 中选择你添加的自定义模型时才使用 Chimney 计费。

第一步：创建密钥

1. 打开 密钥管理 页面，点击 新建密钥。
2. 填写名称（如 cursor），分组选择 GPT Plus 或 GPT PRO。
3. 创建后复制密钥（sk- 开头）。

📷 截图占位

cur-01-create-key.png — 创建密钥：分组选择 GPT Plus

第二步：在 Cursor 中配置

1. 打开 Cursor 设置（Ctrl/Cmd + Shift + J），进入 Models 页。
2. 找到 API Keys 区域，展开 OpenAI API Key：
   • OpenAI API Key：填入你的 Chimney 密钥 sk-xxxxxxxxxxxxxxxx
   • 打开 Override OpenAI Base URL，填入：https://www.chimney.asia/v1
3. 点击 Verify。验证通过后开关会自动打开。

📷 截图占位

cur-02-settings.png — Cursor Models 设置页：填入 Key 与 Base URL

第三步：添加模型并使用

1. 在 Models 页的模型列表点击 Add model，输入 Chimney 分组内的模型名（如 gpt-5.5），保存并勾选启用。
2. 在对话框的模型选择器中切换到刚添加的模型，发送一条消息，能正常回复即接入成功。

模型名必须与密钥分组匹配，可用清单见 模型列表。

配置后仍报错？

• Verify 失败 / 401：检查密钥是否完整复制、Base URL 是否为 https://www.chimney.asia/v1（注意带 /v1）。
• 403 not assigned to any group：密钥没绑分组，回 密钥管理 绑定。
• 模型不存在：添加的模型名不在密钥分组范围内，对照 模型列表 修改。
• 更多问题见 常见问题 与 错误码说明。