Cursor

Cursor 是带 Agent、Tab 补全与行内编辑的 AI 代码编辑器。通过 OpenAI API Key + Override OpenAI Base URL,可以把符合条件的 Chat / Agent 请求发到 ApiGo,从而使用目录中的多厂商模型,并由工作空间统一计费与审计。

Cursor 的 BYOK 界面会随版本变化。请以本页为当前推荐配置;若菜单文案不同,对照 Cursor API Key 文档 微调。

前置条件

配置 Cursor

  1. 打开 Cursor SettingsCmd + , / Ctrl + ,)。
  2. 进入 Models,展开 API Keys
  3. 开启 OpenAI API Key,粘贴 ApiGo Key(sk-apigo-...)。
    注意:这里填的是 ApiGo Key,不是 OpenAI 官方 Key。
  4. 开启 Override OpenAI Base URL,填入:
https://api.apigo.ai/v1
  1. Models 中点击 Add model,逐个添加 slug,例如:
  • gpt-5.6-sol
  • qwen3.8-max
  • deepseek-v4-flash
  1. 打开 Chat 或 Agent 面板的模型选择器,选中你刚添加的模型。
  2. 发一句短提示,再到 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 中的状态码与错误信息

相关资源