如何在 Kilo CLI 中使用百炼 - 大模型服务平台百炼

Kilo CLI 是一款开源的终端 AI 编程工具，通过配置可接入阿里云百炼的千问系列模型。

模型配置

支持的模型

模型系列	支持的模型名称（model）
千问Max （部分模型支持思考模式）	qwen3-max、qwen3-max-2026-01-23（支持思考模式）、qwen3-max-preview（支持思考模式）查看更多
千问Plus	qwen-plus、qwen-plus-latest、qwen-plus-2025-09-11 查看更多
千问Flash	qwen-flash、qwen-flash-2025-07-28 查看更多
千问Turbo	qwen-turbo、qwen-turbo-latest 查看更多
千问Coder （不支持思考模式）	qwen3-coder-plus、qwen3-coder-plus-2025-09-23、qwen3-coder-flash 查看更多

重要

本文档仅适用于按量付费模式，Coding Plan 用户请使用专属 Base URL 和 API Key 接入，详情请参考Kilo CLI进行配置。

模型选型建议

深度研发与架构设计：推荐使用qwen3-max-2026-01-23、qwen3-coder-plus。适用于复杂算法实现、系统架构设计等。
辅助编码与轻量任务：推荐使用qwen3-coder-next。适用于代码解释、格式化、单元测试生成等。

详细步骤

步骤一：开通阿里云百炼

注册账号：若无阿里云账号，需首先注册。
如遇问题，请参见注册阿里云账号。
开通阿里云百炼：使用阿里云主账号前往阿里云百炼大模型服务平台，阅读并同意协议后，将自动开通阿里云百炼，如果未弹出服务协议，则表示您已经开通。
如果开通服务时提示"您尚未进行实名认证"，请先进行实名认证。

首次开通百炼后，您可领取新人免费额度（有效期：百炼开通后90天内），用于模型推理服务。免费额度领取方法和详情，请查看新人免费额度页面。

说明

超出额度或期限将产生费用，开启免费额度用完即停功能可避免此情况下产生费用，具体费用请以控制台的实际报价和最终账单为准。

步骤二：安装 Kilo CLI

安装 Node.js（v18.0 或更高版本）。
在终端中执行以下命令安装 Kilo CLI：
```
npm install -g @kilocode/cli
```
运行以下命令验证安装。若有版本号输出，则表示安装成功。
```
kilo --version
```

步骤三：连接模型服务

在 Kilo CLI 中接入阿里云百炼模型服务，需要配置以下参数：

请确保 Base URL 、API Key、模型都归属于同一地域下。

Base URL

按地域区分：

华北2（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1
新加坡：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
美国（弗吉尼亚）：https://dashscope-us.aliyuncs.com/compatible-mode/v1

API Key

百炼访问凭证，用于身份验证和计费，请前往密钥管理（北京）或密钥管理（新加坡）或密钥管理（弗吉尼亚）页面获取。

模型 ID

指定接入的模型，如qwen3-max-2026-01-23、qwen3-coder-plus。

不同地域支持的模型有所差异，如美国（弗吉尼亚）地域暂不支持qwen3-max-2026-01-23模型。各地域支持的完整列表请参考支持的模型。

您可以通过编辑配置文件来连接阿里云百炼模型服务。

使用文本编辑器打开配置文件 ~/.config/kilo/config.json。
```
vim ~/.config/kilo/config.json
```

复制并粘贴以下配置内容，将其中的“百炼 API Key” 替换为您的百炼 API Key：

重要

本文档仅适用于按量付费模式，Coding Plan 用户请使用专属 Base URL 和 API Key 接入，详情请参考Kilo CLI Coding Plan说明文档进行配置。

{
  "$schema": "https://kilo.ai/config.json",
  "provider": {
    "bailian": {
      "npm": "@ai-sdk/anthropic",
      "name": "Alibaba Cloud Model Studio",
      "options": {
        "baseURL": "https://dashscope-intl.aliyuncs.com/apps/anthropic/v1",
        "apiKey": "百炼 API Key"
      },
      "models": {
        "qwen3-max-2026-01-23": {
          "name": "qwen3-max-2026-01-23",
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 1024
            }
          }
        },
        "qwen3-coder-plus": {
          "name": "qwen3-coder-plus"
        }
      }
    }
  }
}

保存后重启 Kilo CLI，输入 /models，搜索Alibaba Cloud Model Studio，选择qwen3-max-2026-01-23或qwen3-coder-plus。您可以根据需要在 models 字段中添加更多模型，模型名称请参见支持的模型。
开始对话。
更多 Kilo CLI 使用技巧及常见命令请参考 Kilo Code 官方文档。

常见问题

连接模型后报错或无法获得响应怎么办？

可能有以下原因：

API Key 与 Base URL 的地域不匹配，请确认两者对应同一地域。
模型名称不正确，支持的模型请参见模型列表。