如何在 Kilo CLI 中使用百鍊 - Alibaba Cloud Model Studio

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 的地區不匹配，請確認兩者對應同一地區。
模型名稱不正確，支援的模型請參見模型列表。