Kilo CLI 可以通过 OpenAI-compatible 或 Anthropic provider 接入云信大模型 API 平台（简称 AIHub）。推荐优先使用 OpenAI-compatible 方式，除非当前工作流明确需要 Anthropic Messages 协议。

安装 Kilo CLI

1. Kilo CLI 需要 Node.js 18 或更高版本，请先确认本机环境：

   bashnode --version
   

2. 执行以下命令安装 Kilo CLI：

   bashnpm install -g @kilocode/cli
   

3. 安装完成后确认命令可用：

   bashkilo --version
   

配置接入凭证

OpenAI-compatible provider

将以下配置合并至 Kilo CLI 配置文件（如 ~/.kilo/config.json）：

json{
  "$schema": "https://kilo.ai/config.json",
  "provider": {
    "aihub": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Aihub",
      "options": {
        "baseURL": "https://ai.yunxinapi.com/hub/v1",
        "apiKey": "sk-..."
      },
      "models": {
        "your-logical-model": {
          "name": "Aihub logical model"
        }
      }
    }
  }
}

配置项说明：

配置项	说明
baseURL	$AIHUB_BASE_URL/v1，例如 https://ai.yunxinapi.com/hub/v1
apiKey	AIHUB_TOKEN，即 AIHub API 密钥/访问令牌
models key	AIHub 模型名称
provider package	OpenAI-compatible 或 Anthropic 包，按工具版本支持项选择

验证配置

1. 使用 curl 验证端点。

   bashcurl "$AIHUB_BASE_URL/v1/chat/completions" \
     -H "Authorization: Bearer $AIHUB_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "'"$AIHUB_MODEL"'",
       "messages": [{"role": "user", "content": "只回复 OK"}]
     }'
   

2. 在 Kilo CLI 中验证。

   在 Kilo CLI 中选择 AIHub provider 和目标模型，发起一次最小请求。

   如果控制台请求日志中出现 /v1/chat/completions 或 /v1/messages 请求，说明配置已生效。

常见问题

现象	排查方向
provider 加载失败	检查 Kilo CLI 当前版本是否已安装对应的 provider package。
401/unauthorized	API Key 未正确填写 AIHub 访问令牌。
404	Base URL 应为 $AIHUB_BASE_URL/v1，不要写成完整的 /chat/completions 路径。
模型不可用	调用 /v1/models 获取当前令牌可调用的逻辑模型名称列表，并更新配置中的模型名称。