Cursor / Cline / Roo Code 接入多模型 API 教程（2026）
Cursor、Cline、Roo Code 这一类工具有个共同点：都支持 OpenAI 兼容协议的自定义端点。这意味着接入方式完全统一——Base URL 指向兼容网关的 /v1，密钥填网关签发的密钥，模型随便换。本文以汕拓智算为例，一次讲清三个工具的配置。
统一的三要素
| 要素 | 值 |
|---|---|
| Base URL | https://swato.ai/v1 |
| API Key | 控制台签发的 sk-...（OpenAI 分组） |
| 模型 id | 以 GET /v1/models 返回为准 |
密钥在控制台创建，分组平台选 OpenAI。模型 id 不要凭记忆填写——GPT-5.5、Claude Opus 4.8、DeepSeek V4 等 50+ 在售模型的确切 id 都以接口返回或模型价格页为准。
先用 curl 验证一次，确认密钥与端点可用：
bash
curl https://swato.ai/v1/chat/completions \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [{ "role": "user", "content": "回复 ok" }]
}'Cursor
- 打开 Cursor 设置，找到 Models 里的 OpenAI API 配置。
- 启用自定义 OpenAI Base URL，填
https://swato.ai/v1。 - 粘贴你的 API Key。
- 选择要用的模型；下拉里没有的模型可以手动添加 id。
注意 Cursor 的部分内置功能绑定其自家后端，自定义端点主要作用于对话与代码生成的模型调用。
Cline
- 在 Cline 的设置里，API Provider 选择 OpenAI Compatible。
- Base URL 填
https://swato.ai/v1。 - API Key 填
sk-...。 - Model 填确切的模型 id。
Cline 是重度 token 消耗型工具（Agent 循环会带完整上下文），建议接入后先跑一个小任务，到用量台账看一眼单次任务的实际 token 消耗，对成本有个直观感受。成本控制方法见LLM API 成本优化实战。
Roo Code
Roo Code 是 Cline 的社区分支，配置完全同源：Provider 选 OpenAI Compatible，Base URL、密钥、模型 id 三项照填即可。
验证：以账本为准
三个工具的验证方法相同——跑一个只读小任务，然后到控制台用量台账确认：
- 这次调用有记录，模型与你配置的一致；
- 输入 / 输出 token 分开计量，费用与官方定价一致（网关按官方价结算、不加价）；
- 每条记录带 trace id，失败与超时的请求不会出现在扣费里。
台账有记录，配置才算真正生效。如果工具显示成功但台账没有记录，大概率是请求走了别的配置源（旧代理、别的密钥或别的服务商）。
换模型 = 换一个字符串
统一入口的最大好处是切换成本趋近于零：同一个 Base URL 和密钥下，把 model 从 gpt-5.5 换成 Claude、DeepSeek 或 GLM 的 id，就完成了模型切换。哪个模型写代码更合适，建议用自己的真实任务实测，方法见旗舰模型写代码怎么选与国产大模型 API 选型。
相关阅读
常见问题
Cursor 填了 Base URL 之后模型列表是空的怎么办？
先确认 Base URL 是 https://swato.ai/v1（带 /v1，不要再接 /chat/completions），密钥是 OpenAI 分组。模型下拉不全时，手动添加模型 id，确切 id 调用 GET /v1/models 获取。
Cline 和 Roo Code 应该选哪种 Provider 类型？
选 "OpenAI Compatible"。Base URL 填 https://swato.ai/v1，API Key 填 sk- 开头的密钥，然后从模型列表选择或手填确切的模型 id。
一把密钥能同时给多个工具用吗？
可以，但更推荐按工具或项目分别创建密钥：泄漏时可以只轮换受影响的一把，用量台账里也能更清晰地区分各工具的消费。
这些工具能用 Claude 系模型吗？
可以。OpenAI 兼容面下用 chat/completions 协议调用全部在售模型（包括 Claude、Gemini、DeepSeek 等），模型间切换只是换一个 model 字符串，确切 id 以 GET /v1/models 为准。