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>/v14. 添加目录型号
在 Models 中点击 + Add model(或同等入口),填入精确的 SupaNexus 型号 ID。启用后才会出现在 Chat / Agent 选择器里。
Examples:
deepseek/deepseek-chat
anthropic/claude-3-5-sonnet
openai/gpt-4o5. 选用目录型号 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 覆盖。