Sublyx Field Notes快速结论
在 Cursor 的模型或服务商设置中选择可自定义的 OpenAI 兼容方式，填写 Base URL https://api.sublyx.org/v1、Sublyx API Key，并使用 模型列表中的 Claude 模型 ID。设置名称和位置可能随 Cursor 更新而变化；如果当前版本不能自定义 Base URL，就不能按此方式直连。
准备工作
- 在 Sublyx 控制台创建 API Key，完整密钥只保存到本机安全位置。
- 从 模型列表复制当前可用的 Claude 模型 ID，不凭印象填写别名。
- 确认 Cursor 当前安装版本允许配置 OpenAI 兼容服务商或覆盖 Base URL。
具体配置
| 配置项 | 填写值 |
|---|---|
| 服务商 / 协议 | OpenAI compatible |
| Base URL | https://api.sublyx.org/v1 |
| API Key | 你的 Sublyx API Key |
| Model | 模型列表中的 Claude 模型 ID |
保存后启用该模型，再在新对话中选择它。不要把 Anthropic Messages 的地址 https://api.sublyx.org 填进 OpenAI 兼容配置，否则客户端会拼出错误路径。
最小验证请求
先用终端排除 Key、模型和网络问题，再回到 Cursor 测试：
curl https://api.sublyx.org/v1/chat/completions \
-H "Authorization: Bearer $SUBLYX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_CLAUDE_MODEL_ID",
"max_tokens": 32,
"messages": [{"role": "user", "content": "只回复 OK"}]
}'常见错误
| 现象 | 处理方法 |
|---|---|
401 | 检查 Key 是否完整、有效，Base URL 是否指向 Sublyx。 |
404 | 确认 OpenAI 兼容 Base URL 末尾为 /v1，不要重复拼接版本路径。 |
| 模型不存在或不支持 | 重新从模型列表复制 ID，并确认账户可用。 |
| 终端成功但 Cursor 失败 | 检查 Cursor 是否实际使用了自定义服务商；部分内置能力可能不走自定义端点。 |
429 | 降低并发并稍后重试，参考 AI API 429 指南。 |
安全说明
不要把 API Key 写进项目代码、提交到 Git、粘贴到公开截图或共享配置。个人与团队、开发与生产应使用不同 Key；怀疑泄露时立即撤销并创建新 Key。详细接口格式可阅读 Sublyx 文档和Claude Messages API 指南。