Cursor
Cursor 是带 Agent、Tab 补全与行内编辑的 AI 代码编辑器。通过 OpenAI API Key + Override OpenAI Base URL,可以把符合条件的 Chat / Agent 请求发到 ApiGo,从而使用目录中的多厂商模型,并由工作空间统一计费与审计。
Cursor 的 BYOK 界面会随版本变化。请以本页为当前推荐配置;若菜单文案不同,对照 Cursor API Key 文档 微调。
前置条件
- 已安装并登录 Cursor
- 在 工作空间 → API Keys 创建的 ApiGo API 密钥
- 准备好要用的模型 slug(见 模型目录)
配置 Cursor
- 打开 Cursor Settings(
Cmd + ,/Ctrl + ,)。 - 进入 Models,展开 API Keys。
-
开启 OpenAI API Key,粘贴 ApiGo Key(
sk-apigo-...)。
注意:这里填的是 ApiGo Key,不是 OpenAI 官方 Key。 - 开启 Override OpenAI Base URL,填入:
https://api.apigo.ai/v1
- 在 Models 中点击 Add model,逐个添加 slug,例如:
gpt-5.6-solqwen3.8-maxdeepseek-v4-flash
- 打开 Chat 或 Agent 面板的模型选择器,选中你刚添加的模型。
- 发一句短提示,再到 Call Logs 确认出现请求。
工作原理
Cursor 的 OpenAI provider 覆盖会把 OpenAI 兼容的 Chat Completions 请求发到你配置的 Base URL。ApiGo 在 /v1/chat/completions 接收这些调用,并按工作区账单与路由策略处理。
与 Claude Code 不同:Cursor 这条路径走 OpenAI 兼容协议,因此 Base URL 必须带 /v1。
限制(请先读)
- Tab 补全 通常仍走 Cursor 内置模型,不受 BYOK 影响。
- Auto / Composer 等模式不一定走你的 Key——以当前 Cursor 版本文档为准。
- Tool calling / Agent 能力取决于所选模型与 Cursor 请求格式。若工具调用失败,可换模型,或到 调用日志 对照报错。
故障排除
| 现象 | 处理 |
|---|---|
| Invalid API key | 使用 sk-apigo-...,不要填 OpenAI / Anthropic 官方 Key |
| Model not found | 粘贴目录中的完整 slug,不要自创别名 |
| 工作空间无流量 | 确认 Override Base URL 为 https://api.apigo.ai/v1,且当前对话选中了你添加的模型 |
| Agent 工具报错 | 换一个支持工具调用的模型;对照 Call Logs 中的状态码与错误信息 |
