Skip to main content
接入用戶端/開發工具

Qwen Code

Qwen Code 是一款終端 AI 編程工具,可以通過隨用隨付、Coding Plan、Token Plan 個人版或 Token Plan 團隊版接入阿里雲百鍊。

應用情境

Qwen Code 支援以下使用情境:
  • AI 編程輔助:在終端通過自然語言完成代碼產生、代碼補全與代碼審查,提升日常開發效率。
  • Web 開發:提供目標網站截圖,Qwen Code 自動解析頁面結構並產生高還原度的前端代碼。
  • 視頻製作:給定開源專案倉庫地址,一鍵產生專屬宣傳視頻。

安裝 Qwen Code

  • 運行安裝命令
    • macOS/Linux: 開啟終端,運行以下命令安裝 Qwen Code。
bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)" -s --source bailian
  • Windows: 在工作列搜尋方塊裡輸入cmd,選擇以管理員身份運行,開啟cmd視窗後運行以下命令安裝 Qwen Code。
curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat --source bailian
  • 關閉並重新開啟cmd視窗 Windows 系統在安裝完成後,需關閉當前cmd視窗,以使環境變數生效。重新開啟cmd後,運行以下命令查看當前安裝版本。
qwen --version

配置接入憑證

啟動 Qwen Code 後輸入 /auth 命令進行可視化配置。阿里雲百鍊提供四種計費方案,根據需要選擇:
  • Token Plan 個人版:按 token 消耗抵扣個人 Credits。
  • Token Plan 團隊版:按坐席訂閱,按 token 消耗抵扣 Credits。
  • Coding Plan:固定月費訂閱,按模型調用次數計量。
  • 隨用隨付:按實際調用量後付費。

Token Plan 個人版

啟動 Qwen Code 後輸入 /auth,依次選擇 訂用計畫 > 阿里雲百鍊 Token Plan,輸入 Token Plan 個人版專屬 API Key 即可完成配置。可用模型請參考 Token Plan 個人版支援的模型
編輯或建立 settings.json 檔案,將 YOUR_API_KEY 替換為 Token Plan 個人版專屬 API Key。檔案路徑如下:
  • macOS/Linux:~/.qwen/settings.json
  • Windows:C:\Users\<Windows使用者名稱>\.qwen\settings.json
關鍵字段說明:env 用於定義存放 API Key 的環境變數,模型條目中的 envKey 需與該環境變數名保持一致;generationConfig.extra_body.enable_thinking 用於開啟或關閉模型思考模式;部分樣本中的 $version 為設定檔格式版本號碼,請保留預設值。完整欄位以 Qwen Code 產品文檔為準。
{
  "env": {
    "BAILIAN_TOKEN_PLAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.8-max",
        "name": "[Token Plan 個人版] qwen3.8-max",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.7-max",
        "name": "[Token Plan 個人版] qwen3.7-max",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.7-plus",
        "name": "[Token Plan 個人版] qwen3.7-plus",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.6-flash",
        "name": "[Token Plan 個人版] qwen3.6-flash",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-5.2",
        "name": "[Token Plan 個人版] glm-5.2",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-pro",
        "name": "[Token Plan 個人版] deepseek-v4-pro",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-pro-0813",
        "name": "[Token Plan 個人版] deepseek-v4-pro-0813",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-flash-0731",
        "name": "[Token Plan 個人版] deepseek-v4-flash-0731",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      }
    ]
  }
}

Token Plan 團隊版

啟動 Qwen Code 後輸入 /auth,依次選擇 訂用計畫 > 阿里雲百鍊 Token Plan,輸入 Token Plan 團隊版專屬 API Key 即可完成配置。可用模型請參考 Token Plan 團隊版支援的模型
編輯或建立 settings.json 檔案,將 YOUR_API_KEY 替換為 Token Plan 團隊版專屬 API Key。檔案路徑如下:
  • macOS/Linux:~/.qwen/settings.json
  • Windows:C:\Users\<Windows使用者名稱>\.qwen\settings.json
{
  "env": {
    "BAILIAN_TOKEN_PLAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.8-max",
        "name": "[Token Plan 團隊版] qwen3.8-max",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.7-max",
        "name": "[Token Plan 團隊版] qwen3.7-max",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.7-plus",
        "name": "[Token Plan 團隊版] qwen3.7-plus",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.6-plus",
        "name": "[Token Plan 團隊版] qwen3.6-plus",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.6-flash",
        "name": "[Token Plan 團隊版] qwen3.6-flash",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "deepseek-v4-pro",
        "name": "[Token Plan 團隊版] deepseek-v4-pro",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-pro-0813",
        "name": "[Token Plan 團隊版] deepseek-v4-pro-0813",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-flash",
        "name": "[Token Plan 團隊版] deepseek-v4-flash",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-flash-0731",
        "name": "[Token Plan 團隊版] deepseek-v4-flash-0731",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v3.2",
        "name": "[Token Plan 團隊版] deepseek-v3.2",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "kimi-k2.7-code",
        "name": "[Token Plan 團隊版] kimi-k2.7-code",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "kimi-k2.6",
        "name": "[Token Plan 團隊版] kimi-k2.6",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "kimi-k2.5",
        "name": "[Token Plan 團隊版] kimi-k2.5",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-5.2",
        "name": "[Token Plan 團隊版] glm-5.2",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-5.1",
        "name": "[Token Plan 團隊版] glm-5.1",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-5",
        "name": "[Token Plan 團隊版] glm-5",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "MiniMax-M2.5",
        "name": "[Token Plan 團隊版] MiniMax-M2.5",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "tokenPlan": {
    "region": "global"
  },
  "model": {
    "name": "qwen3.8-max"
  },
  "$version": 3
}

Coding Plan

啟動 Qwen Code 後輸入 /auth,依次選擇 訂用計畫 > 阿里雲百鍊 Coding Plan,選擇 Coding Plan 地區(global),輸入 Coding Plan 專屬 API Key 即可完成配置。可用模型請參考 Coding Plan 支援的模型
編輯或建立 settings.json 檔案,將 YOUR_API_KEY 替換為 Coding Plan 專屬 API Key。檔案路徑如下:
  • macOS/Linux:~/.qwen/settings.json
  • Windows:C:\Users\<Windows使用者名稱>\.qwen\settings.json
{
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.7-plus",
        "name": "[Bailian Coding Plan] qwen3.7-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.6-plus",
        "name": "[Bailian Coding Plan] qwen3.6-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.5-plus",
        "name": "[Bailian Coding Plan] qwen3.5-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3-max-2026-01-23",
        "name": "[Bailian Coding Plan] qwen3-max-2026-01-23",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "qwen3-coder-next",
        "name": "[Bailian Coding Plan] qwen3-coder-next",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "qwen3-coder-plus",
        "name": "[Bailian Coding Plan] qwen3-coder-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "MiniMax-M2.5",
        "name": "[Bailian Coding Plan] MiniMax-M2.5",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "glm-5",
        "name": "[Bailian Coding Plan] glm-5",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-4.7",
        "name": "[Bailian Coding Plan] glm-4.7",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "kimi-k2.5",
        "name": "[Bailian Coding Plan] kimi-k2.5",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "codingPlan": {
    "region": "global"
  },
  "model": {
    "name": "qwen3.7-plus"
  },
  "$version": 3
}

隨用隨付

啟動 Qwen Code 後輸入 /auth,選擇 使用自己的 API Key > Standard API Key,選擇對應地區並輸入阿里雲百鍊 API Key 即可完成配置。可用模型請參考OpenAI 相容 - 支援的模型
編輯或建立 settings.json 檔案,將 YOUR_API_KEY 替換為阿里雲百鍊 API Key。檔案路徑如下:
  • macOS/Linux:~/.qwen/settings.json
  • Windows:C:\Users\<Windows使用者名稱>\.qwen\settings.json
baseUrl 按地區設定(URL 中的 {WorkspaceId} 需替換為真實的擷取Workspace ID),API Key 需與所選地區對應:
  • 華北2(北京):https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
  • 新加坡:https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
  • 美國(維吉尼亞):https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1
{
  "env": {
    "BAILIAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.6-plus",
        "name": "[Bailian] qwen3.6-plus",
        "baseUrl": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.6-plus"
  },
  "$version": 3
}
如需添加其他模型,在 modelProviders.openai 中以相同格式追加即可。

驗證配置

配置完成後,在專案目錄下運行以下命令啟動 Qwen Code,即可開始對話。
qwen

Qwen Code IDE 外掛程式

Qwen Code 支援在 VS Code 和 JetBrains IDE 中以外掛程式方式使用,在 IDE 中提供 AI 編程能力。

VS Code

使用前請確保 VS Code 版本為 1.85.0 或更高版本。
  1. 開啟 VS Code,在擴充市場中搜尋 Qwen Code Companion 並安裝。
  2. CLI 和 IDE 外掛程式共用同一個 settings.json。如果已按上方步驟完成配置,請跳過此步。否則請按照上方配置接入憑證章節進行配置。
  3. 點擊右上方表徵圖啟動 Qwen Code,通過輸入或點擊/,選擇Switch model切換模型。

JetBrains IDE

使用前請確保 JetBrains IDE 支援 Agent Client Protocol(ACP)。
  1. Qwen Code IDE 依賴於 Qwen Code CLI,請先參考本文安裝 Qwen Code章節進行安裝並完成配置接入憑證
  2. 開啟 JetBrains IDE,進入AI Chat頁面,點擊 Install Plugin,IDEA 將安裝 JetBrains Al Assistant 外掛程式。
  3. 點擊 AI Chat 視窗右上方三點菜單,選擇 Add Custom Agent,按以下配置填寫。請將 /path/to/qwen 替換為 Qwen Code 安裝路徑,可運行以下命令查看該路徑:
    • macOS/Linux:which qwen
    • Windows:where qwen(CMD)或 Get-Command qwen(PowerShell)
{
  "agent_servers": {
    "qwen": {
      "command": "/path/to/qwen",
      "args": ["--acp"],
      "env": {}
    }
  }
}
  1. 配置完成後,Qwen Code 將出現在 AI Chat 面板中,在右下角可以進行模型切換。

Qwen Code 案頭版

Qwen Code Desktop 是 Qwen Code 的圖形介面應用,內建 CLI 運行時,無需額外安裝命令列工具。案頭版與 CLI 共用同一份 settings.json 設定檔,如果已通過 CLI 完成配置,案頭版開啟即可直接使用,無需重複配置。 前往 Qwen Code GitHub Releases 頁面,下載適用於您作業系統(macOS、Windows 或 Linux)的案頭版安裝包。 如果尚未配置,可通過案頭版圖形介面完成:
  1. 開啟 Qwen Code Desktop,點擊左側設定,選擇 AI 頁簽。
  2. 模型 Provider地區點擊+ 串連
  3. 在彈窗中選擇 Alibaba ModelStudio 頁簽,根據計費方案選擇對應項:
    • Coding Plan:固定月費訂閱,按模型調用次數計量。
    • Token Plan:含個人版與團隊版,按 token 消耗抵扣 Credits。
    • Standard API Key:使用已有的百鍊 API Key 隨用隨付。
  4. 按照頁面提示輸入 API Key,完成配置。

常見命令

以下命令適用於 Qwen Code CLI,IDE 外掛程式僅支援部分命令,請以實際使用為準。

命令

說明

樣本

/model

切換當前會話中使用的模型。

/model

/auth

更改認證方式。

/auth

/init

分析目前的目錄並建立初始上下文檔案(QWEN.md),用於定義專案級指令和上下文。

/init

/clear

清除終端螢幕內容,開始全新對話。

/clear

/compress

用摘要替換聊天歷史以節省 Token。

/compress

/settings

開啟設定編輯器,可配置語言、主題等。

/settings

/summary

根據對話歷史產生專案摘要。

/summary

/resume

恢複之前的對話會話。

/resume

/stats

顯示當前會話的詳細統計資訊。

/stats

/help

顯示可用命令的協助資訊。

/help/?

/quit

退出 Qwen Code。

/quit

更多 Qwen Code 的進階功能,可以參考 Qwen Code 官方文檔

瞭解更多

常見問題

錯誤碼

配置過程中遇到報錯,請參考對應計費方案的常見問題文檔:

如何切換模型?

在 Qwen Code 中直接輸入 /model 命令,即可從 settings.json 中已配置的模型列表中選擇切換。如需添加新模型,請在 settings.jsonmodelProviders 中添加對應配置,然後重啟 Qwen Code。
Token Plan
模型體驗
  • 音樂產生
用量統計與效能監控
資產中心
服務支援