English
Integration docs

BitCloud API Documentation

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

Current documentKilo Code
Markdown rendered as page contentKilo Code

Kilo Code 配置

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


前置工作

获取凭证

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

使用 Kilo Code CLI

安装

需要 Node.js 18 或更新版本。

安装命令:

bashnpm install -g @kilocode/cli

验证安装(如有版本号输出,则表示安装成功):

bashkilocode --version

配置基本信息

编辑或创建 config.json,路径如下:

  • macOS/Linux~/.config/kilo/config.json
  • Windows用户目录\.config\kilo\config.json

将以下内容复制到配置文件中(按需替换 BASE_URLAPI_KEY):

json{
  "$schema": "https://kilo.ai/config.json",
  "disabled_providers": [],
  "provider": {
    "bitcloud": {
      "name": "BitCloud",
      "npm": "@ai-sdk/openai-compatible",
      "models": {
        "gpt-4o": {
          "name": "GPT-4o",
          "options": {
            "thinking": {
              "type": "enabled"
            }
          }
        }
      },
      "options": {
        "apiKey": "API_KEY",
        "baseURL": "BASE_URL"
      }
    }
  },
  "permission": {
    "bash": "allow"
  }
}

更多配置详情请参阅 Kilo Code CLI 官方文档:kilo.org.cn/docs/cli

运行 Kilo Code CLI

配置完成后,打开新终端并启动:

bashkilocode

启动后,输入 /models 可切换模型。


使用 Kilo Code IDE 插件

安装插件

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

配置自定义供应商

填写以下字段:

  1. 从供应商下拉列表中选择 Custom Provider
  2. 填写配置信息:
  • Provider IDDisplay name:按个人偏好设置(如 bitcloud
  • Base URLhttps://web.bitcloud.com.cn/v1
  • API Key:从控制台获取的密钥
  • Models:按需添加,例如 gpt-4o

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

使用 Kilo Code 插件

配置成功后,切换到已配置的模型,在输入框中输入请求即可开始使用。


常见问题

Windows 安装报错

如果在 Windows 上验证安装时遇到以下错误:

"It seems that your package manager failed to install the right version of the Kilo CLI for your platform..."

执行以下命令解决:

bashnpm install -g @kilocode/cli-windows-x64