English
Integration docs

BitCloud API Documentation

Browse Base URL, API key, model, and client setup guides for connecting tools to the unified gateway.

Current documentCline
Markdown rendered as page contentCline

Cline 配置

BitCloud API 兼容 OpenAI 协议,支持 Cline CLI 和 IDE 插件,可参考本文进行配置与使用。


前置工作

获取凭证

项目
Base URL(OpenAI 兼容)https://web.bitcloud.com.cn/v1
API Key格式:sk-xxxxx
获取方式前往 控制台 → 令牌管理 页面创建

使用 Cline CLI

安装

前置条件: Node.js 20 或更新版本(推荐 Node.js 22)。

通过 npm 全局安装:

bashnpm install -g cline

验证安装:

bashcline --version

如有版本号输出,则表示安装成功。

配置

使用 cline auth 命令注册 BitCloud 为供应商:

bashcline auth -p openai -k YOUR_API_KEY -b BASE_URL -m gpt-4o

参数说明:

参数用途
-p openai选择 OpenAI 兼容供应商
-kAPI Key(从控制台获取)
-bBase URL(https://web.bitcloud.com.cn/v1
-m模型标识符,例如 gpt-4o

更多选项请参阅 Cline CLI 官方文档

也可不带参数运行 cline auth 来启动交互式配置向导。

运行 Cline CLI

打开新终端并启动:

bashcline
提示: 如果偏好传统终端界面,选择 Exit,然后运行 cline --tui 返回经典命令行环境。

使用 Cline IDE 插件 (VS Code)

安装

在 VS Code 扩展市场搜索 Cline 并安装。

配置

在 VS Code 中打开 Cline 扩展,填写以下字段:

必填设置:

字段
API ProviderOpenAI Compatible
Base URLhttps://web.bitcloud.com.cn/v1
API Key从控制台获取的密钥
Model ID模型名称,例如 gpt-4o

可选设置:

字段推荐值
Supports Images取消勾选(禁用)
Context Window Size128000(根据模型调整)
Temperature1.0(可根据任务需求调整)

以上未提及的参数均可按需调整。

使用

配置完成后,在输入框中输入请求(例如让模型生成代码),Cline 将通过 BitCloud 处理请求。


常见问题

如何选择模型?

模型广场 查看所有可用模型,选择适合编程任务的模型。常用选择:

  • gpt-4o — 通用能力强,适合大多数编程任务
  • claude-sonnet-4-20250514 — 代码生成质量高
  • deepseek-chat — 性价比高,适合轻量任务