Integrations/Cline
接入 Cline
Cline 是 VS Code 上一款免费、开源的 AI 编程智能体。和 Cursor 不同,它对自定义服务商没有任何付费墙 —— 把它指向 Sozdai,即可用我们的任意模型进行完整的智能体编程(读写文件、执行命令)。
#为什么用 Cline(对比 Cursor)
Cursor 免费版把自带密钥限制在基础聊天,Agent/Edit 功能要付费的 Cursor Pro。Cline 没有这个限制:它完整的智能体流程用你自己的 key、任意 OpenAI 兼容端点都能跑,除了 Sozdai 的用量费用之外不再多花一分钱。
#前置准备
1
安装 VS Code
Cline 是 VS Code 的扩展。
2
安装 Cline 扩展
在 VS Code 里打开扩展面板,搜索 "Cline" 并安装。(它的分叉 "Roo Code" 配置方式相同。)
3
获取 Sozdai API key
在控制台创建一个 API key(以 sk-corr- 开头)。记得给余额充值,否则请求会被拒。
#配置 Cline
1
打开 Cline 设置
点击 VS Code 活动栏里的 Cline 图标,再点齿轮图标打开设置。
2
选择服务商:OpenAI Compatible
在 API Provider 下拉菜单里选择 "OpenAI Compatible"。
3
填写配置
| 字段 | 填入的值 |
|---|---|
| Base URL | https://api.sozdai.ai/v1 |
| API Key | 你的 sk-corr- 密钥(直接粘贴,不要加 "Bearer") |
| Model ID | claude-sonnet-5 |
Base URL 要以 /v1 结尾
Cline 会自动在后面拼 /chat/completions —— 就填上面这个地址,后面不要加东西。
4
设置模型能力(可选)
展开 Model Configuration,把上下文窗口和最大输出 token 设成和你选的模型一致(见模型页)。这能避免 Cline 发送超长请求。
#推荐模型
填入下面某个模型 ID(必须和模型页一致)。之后可随时在 Cline 的模型下拉里切换。
| 模型 ID | 适合 |
|---|---|
claude-sonnet-5 | 综合编程质量最佳 |
claude-opus-4-8 | 最难的任务、最强推理 |
deepseek-v4-pro | 质量好、便宜很多 |
deepseek-v4-flash | 简单改动最快最省 |
省钱建议
DeepSeek 价格只有 Claude 的零头,大多数编程任务都够用。对反复出现的大段代码库上下文,我们侧会自动应用提示词缓存,进一步降低成本。
#验证
保存设置,打开任意项目,给 Cline 一个简单任务,比如 "看一下当前文件,提一个安全的小改进"。如果它能读取文件并回应,就说明连上了。之后 Cline 就能在你确认下改文件、跑命令。
#常见问题
| 现象 | 解决 |
|---|---|
| 401 / 认证错误 | 密钥有误,或前面多了 "Bearer " —— 直接粘贴 sk-corr- 原文。 |
| 模型不存在 | Model ID 和我们的不一致 —— 用模型页上的准确 ID。 |
| 连接失败 / 404 | Base URL 必须是上面那个(以 /v1 结尾)。 |
| 402 余额不足 | 在充值页给 Sozdai 余额充值。 |