Cursor 与其它兼容客户端
适合谁
Cursor 适合在编辑器里写代码、希望对话不离开 IDE 的人。其它兼容客户端适合已经有自己的聊天界面、只想把模型地址换成 LokoSpace 的人。
Cursor 三步配置
1. 填 Base URL
打开 Cursor 设置（macOS 用 Cmd + Shift + J，Windows / Linux 用 Ctrl + Shift + J），进入「Models」。
找到「Override OpenAI Base URL」并启用，填：
https://sheverai.com/8811c8/api/llm/v1
不同版本的入口可能在「Settings → Models」或「Cursor Settings → Models」，字段名以 Override OpenAI Base URL 为准。
2. 填 Key
在同一页的「OpenAI API Key」里填 LokoSpace API Key。密钥在客户端「个人中心 → API 接入」创建。
只填 Key 本体，不要加 Bearer。填完确认已经保存，再关闭设置页。
3. 选模型
在「Models」里点「+ Add model」，把 GET /models 返回的 id 原样填进去。保存后回到 Chat，在模型下拉框里选中它。
curl https://sheverai.com/8811c8/api/llm/v1/models \
-H "Authorization: Bearer $LOKO_KEY"
Cursor 的模型名是自定义字符串，大小写和连字符都要和 id 一致。上游鉴权和缓存断点由网关处理，不需要在 Cursor 里额外配置。
此处放截图：Cursor 的 Models 设置页，标出 Override OpenAI Base URL、OpenAI API Key 和自定义模型。
验证是否接通
打开一个新的 Chat，选中自定义模型，发送：
你好，请用一句话介绍你自己
收到正常的文字回复即接通。先用普通 Chat 验证，不要一上来就用 Agent 长任务，便于判断问题出在地址、Key 还是模型名。
常见故障
| 现象 | 原因 | 处理 |
|---|---|---|
401，错误码 API_KEY_INVALID | Key 没填、没保存、复制不完整、已撤销或过期 | 回「个人中心 → API 接入」重新创建；重新输入并保存；确认 Key 没有带 Bearer ，Base URL 没有误填到 Key 字段 |
403，错误码 MODEL_ACCESS_DENIED；或 400，错误码 MODEL_PROTOCOL_MISMATCH | 模型不存在、自定义模型名和 /models 的 id 不一致；账号没有该模型权限；或该模型不接受 Chat Completions 协议 | 删除自定义模型，按 id 原样重加；协议不匹配时换一个支持 Chat Completions 的模型，Cursor 不能靠改 Base URL 绕过 |
504，错误码 OFFICIAL_LLM_APPLICATION_TIMEOUT，或 Cursor 提示请求超时 | 首个响应慢、网络或代理不稳定、会话上下文过长 | 先用短提示重试；检查代理或 VPN；缩短当前会话；仍超时就换一个响应更快的模型 |
如果请求路径出现 /v1/v1/...，把 Base URL 末尾多余的 /v1 去掉。
其它兼容客户端
先确认客户端满足这四点：
- 能自定义 Base URL 或 API Host
- 支持 Chat Completions 兼容协议
- 能填自定义模型 ID
- 有 API Key 或 Bearer Token 输入框
字段名对照：
| 要填的内容 | 常见字段名 |
|---|---|
| Base URL | API 地址、API Host、Base URL、自定义接口地址 |
| Key | API Key、API 密钥、Token |
| 模型 | 模型、Model、模型 ID |
填法：
- Base URL 填
https://sheverai.com/8811c8/api/llm/v1 - Key 填 LokoSpace API Key 本体
- 模型填
/models返回的id
如果客户端把地址拆成 Host 和 Path 两项，Host 填 https://sheverai.com，Path 填 /8811c8/api/llm/v1/chat/completions。两项拼起来要和 Base URL 一致。
只支持 Chat Completions 的客户端，遇到 MODEL_PROTOCOL_MISMATCH 时只能换一个接受该协议的模型；它不能像 Claude Code 那样走 Messages 入口。