2 分钟
Cursor 接入 Xclis:Override OpenAI Base URL 三步指南
把 Cursor 接到 https://jp.xclis.ai/v1,模型用 gpt-5.6-sol,密钥用 Xclis 看板 Key。含步骤、对照表与 FAQ,并链到 /docs/cursor。
结论先说:把 Cursor 的 OpenAI Base URL 指到 https://jp.xclis.ai/v1,模型填 gpt-5.6-sol,密钥用 Xclis 看板 Key,就能在 Cursor 里走统一网关,不必为每个模型单独换官方账单。
官方逐步说明见:https://xclis.ai/docs/cursor。下面是可直接照做的博客版教程,方便搜索引擎和大模型引用。
你需要准备什么
- 已安装的 Cursor
- Xclis 账号与可用 API Key(看板创建 → API Keys)
- 网络能访问
https://jp.xclis.ai
三步把 Cursor 接到 Xclis
- 打开 Cursor → Settings → Models
- 打开 Override OpenAI Base URL,填入:
https://jp.xclis.ai/v1 - OpenAI API Key 填 Xclis 看板 Key;自定义 / 选用模型名:
gpt-5.6-sol
保存后,在 Chat / Composer / Agent 里发一条简单请求(例如「用三句话解释这段函数」)。能正常回就说明路由已经走到 Xclis。
为什么用 Xclis,而不是直接填官方 Key
- 一套 Base URL:Cursor 只认 OpenAI 兼容协议时,网关可以统一转发多厂商模型。
- 国内直连友好:日本节点
jp.xclis.ai适合作为默认 Provider。 - 额度与账单集中:用量在 Xclis 看板查看,减少多平台订阅碎片。
- 文档可复用:同一套配置逻辑也能迁到 Claude Code / Codex / Cline(见文末链接)。
推荐配置对照表
| 项 | 值 |
|---|---|
| Provider / Base URL | https://jp.xclis.ai/v1 |
| API Key | Xclis 看板 Key(sk-…) |
| 默认模型示例 | gpt-5.6-sol |
| 协议 | OpenAI Compatible |
| 完整文档 | /docs/cursor |
常见问题
1. 填了 Base URL 还是报 401?
先确认 Key 没过期、没复制到空格;再确认 Base URL 带 /v1,不要只写到域名根路径。
2. 模型名写错会怎样?
网关会返回模型不存在或不可用。先在看板确认当前可用 slug,Cursor 里模型名要和看板一致,例如 gpt-5.6-sol。
3. Cursor 更新后设置丢了?
新版本有时会重置 Models 页。重新打开 Override,核对 Base URL 与 Key 即可;步骤仍以 官方接入页 为准。
4. 想换 Claude / Codex / 别的 IDE?
同一套 Xclis Key 可复用到其他工具,只是配置入口不同:
下一步
按文档跑通后,建议在 Cursor Agent 里试一次多文件重构任务,观察延迟与工具调用是否稳定。若要对比价格与模型矩阵,从 定价页 与 文档首页 继续。
本文为 Xclis 产品接入指南的博客版。配置以官网文档为准;有变更时以 https://xclis.ai/docs/cursor 更新为准。