SupaNexus

Cursor

覆盖 Cursor 的 OpenAI Base URL 与 Key,让 Chat / Agent / 行内编辑走 SupaNexus。

1. 领取 SupaNexus API Key

登录开发者控制台,进入项目 → API Keys,创建 Key 并立即复制(仅展示一次)。同一把项目 Key 可用于 OpenAI 兼容与 Anthropic 兼容客户端。

2. 打开 Cursor 模型与 API 设置

打开 Cursor Settings(齿轮,或 Cmd/Ctrl + ,)→ Models。展开 API Keys。我们将启用 OpenAI 兼容覆盖,而不是只用 Cursor 内置厂商 Key。

3. 启用 OpenAI Key 并覆盖 Base URL

打开 OpenAI API Key 开关,粘贴 SupaNexus 项目 Key。打开 Override OpenAI Base URL,填入 OpenAI 兼容接入点(host + /v1)。保存后若未生效,请完全退出并重启 Cursor。

OpenAI API Key: sk-snx-...
Override OpenAI Base URL: <BASE_URL>/v1

4. 添加目录型号

在 Models 中点击 + Add model(或同等入口),填入精确的 SupaNexus 型号 ID。启用后才会出现在 Chat / Agent 选择器里。

Examples:
deepseek/deepseek-chat
anthropic/claude-3-5-sonnet
openai/gpt-4o

5. 选用目录型号 ID

型号 ID 以 SupaNexus 模型市场或 GET /v1/models 为准(例如 deepseek/deepseek-chat、anthropic/claude-3-5-sonnet)。不要套用其它网关的自创 slug。

6. 选择型号并冒烟测试

打开 Chat 或 Agent,选中刚添加的型号,发一条短提示(例如解释某文件)。确认有回复,并在 SupaNexus 项目用量中可见。Tab 补全是否走覆盖取决于 Cursor 套餐——先验证 Agent / Chat。

7. 排障

401 / Key 无效:确认是项目 API Key,且 Base URL 含 /v1。型号不存在:ID 必须出现在 GET /v1/models。工具/Agent 异常:改 Base URL 后重启 Cursor;关闭其它冲突的 OpenAI 覆盖。

接入说明 →