Cline

适用于 VS Code 的开源编程智能体，使用 OneProvider 兼容 OpenAI 的 API。

适用于 VS Code 的 Cline 编程智能体

支持的功能

Cline 通过 OneProvider 发送兼容 OpenAI 的文本和编程智能体请求，所用的是您从目录中选择的兼容模型 ID。

客户端限制

图像、工具调用和上下文能力取决于具体选择的模型；请先用一个小的文本任务验证。

设置

1. 选择 OpenAI Compatible

   在 Cline 的 API Provider 设置中选择 OpenAI Compatible，并粘贴您的 OneProvider 密钥。

   API Provider: OpenAI Compatible
   API Key: sk-your-key-here

2. 设置自定义 base URL

   把 base URL 设为 https://api.oneprovider.dev/v1，并把准确的模型 ID 设为 gpt-6.1-terra。

   Base URL: https://api.oneprovider.dev/v1
   Model ID: gpt-6.1-terra

3. 开始一个小的文本任务

   打开新的 Cline 会话，先请求一个小的只读讲解，再启用与具体模型相关的能力。

验证连接

在仪表板的“用量”中确认请求

请求中应显示所配置的模型，以及一条已结算的、兼容 OpenAI 的用量记录。

连接信息

协议

openai-chat

接口地址

https://api.oneprovider.dev/v1

密钥安全

请使用带有模型、速率、消费和有效期限制的专用密钥；绝不要把密钥提交到工作区设置中。

如何选择模型

Cline 使用 OpenAI Compatible 服务商，所以请按目录 中的写法原样填写模型 ID。gpt-6.1-terra 是编程任务的均衡默认选择，gpt-6.1-sol 适合大型多文件工作，gpt-5.6-luna 价格低廉，适合快速提问。Claude ID 也可以通过同一个服务商使用，例如 claude-sonnet-5-5。图像输入、工具调用和上下文长度取决于具体的模型，所以请先从一个小的只读任务开始。如果 Cline 要求填写上下文窗口或最大输出，请从目录中该模型所在的行复制数值。

常见错误与解决办法

404 或 “Invalid URL”

Base URL 必须是 https://api.oneprovider.dev/v1：带 /v1，不带 /chat/completions。

401 Unauthorized

密钥少了字符，或者两端带有空格或引号，或者余额为空。请重新粘贴完整的密钥，并检查个人中心。

“Model not found”，或关于模型的 400

ID 有拼写错误，或者不在目录中。请从模型页面复制；匹配是精确的，并且区分大小写。

429 “Insufficient balance”

余额或密钥的消费限额已用完。重试没有用：请充值余额或提高限额。

智能体一步之后就停了

所选模型可能对工具调用支持不佳。请选择旗舰或均衡档的模型，并保持任务较小。

数据流中断或卡住

请关闭 VPN 或 VLESS 代理：它们会缓冲 SSE。OneProvider 本身不会缓冲。

常见问题

在 Cline 里选哪个服务商？

OpenAI Compatible。粘贴 OneProvider 密钥和上面的 base URL。

能在 Cline 里使用 Claude 模型吗？

可以，在同一个 OpenAI Compatible 服务商中填写 Claude ID；如果您的版本支持，也可以使用 Cline 的 Anthropic 服务商，并把自定义 base URL 设为 https://api.oneprovider.dev。

我的密钥会存进代码仓库吗？

不会，Cline 把它保存在 VS Code 的机密存储中。但仍请使用带消费限额的专用密钥，并且绝不要把它提交到工作区设置中。

在哪里查看用量？

在仪表板的“用量”页面：每个请求都会显示模型和实际扣费金额。

快速解答

该使用哪个 base URL？

Claude Code 和 Anthropic SDK 使用 https://api.oneprovider.dev。OpenAI SDK 和兼容 OpenAI 的客户端使用 https://api.oneprovider.dev/v1。同一个密钥可用于这两个地址；模型列表见模型页面 ，费率见价格页面 。

如何进行身份验证？

将完整的 sk-… 密钥放在 x-api-key 或 Authorization: Bearer 中，二选一，不要同时使用。请把密钥存放在环境变量中，不要写进会被提交的文件。了解更多身份验证说明 。

在哪里获取密钥？

在 Telegram 机器人 @oneprovider_robot 或 app.oneprovider.dev 打开您的个人中心，为余额充值，然后点击“签发密钥”。每个密钥都可以设置各自的消费限额。个人中心与 API 密钥 。

401、404 和 429 是什么意思？

401：密钥缺失、拼写有误或放错了请求头；请粘贴完整的密钥，不要带引号或空格。404：通常是 base URL 不对，例如缺少或重复了 /v1。429 且提示“Insufficient balance”：个人中心余额或密钥的消费限额已用完，请充值，不要反复重试；其他 429 属于速率限制，请等待 Retry-After 指定的时间。详情见：错误码 和故障排查 。

流式输出为什么会中断或被重置？

VPN 和 VLESS 代理常常会缓冲 SSE，或破坏 HTTP/2 协商。OneProvider 没有地区限制，也不会缓冲流式输出，请关闭代理后重试。

以上都没解决，该去哪里咨询？

请在 Telegram 联系 @Oneproviderhelpbot ，或在网页个人中心打开“客服”，并附上 HTTP 状态码和完整的错误信息。客服如何运作 。