Qwen Code 是一款終端 AI 編程工具,可以通過隨用隨付、Coding Plan、Token Plan 個人版或 Token Plan 團隊版接入阿里雲百鍊。
應用情境
Qwen Code 支援以下使用情境:
- AI 編程輔助:在終端通過自然語言完成代碼產生、代碼補全與代碼審查,提升日常開發效率。
- Web 開發:提供目標網站截圖,Qwen Code 自動解析頁面結構並產生高還原度的前端代碼。
- 視頻製作:給定開源專案倉庫地址,一鍵產生專屬宣傳視頻。
安裝 Qwen Code
-
運行安裝命令
- macOS/Linux: 開啟終端,運行以下命令安裝 Qwen Code。
-
Windows:
在工作列搜尋方塊裡輸入
cmd,選擇以管理員身份運行,開啟cmd視窗後運行以下命令安裝 Qwen Code。
-
關閉並重新開啟
cmd視窗 Windows 系統在安裝完成後,需關閉當前cmd視窗,以使環境變數生效。重新開啟cmd後,運行以下命令查看當前安裝版本。
配置接入憑證
啟動 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 設定檔
進階配置:通過 settings.json 設定檔
編輯或建立
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 產品文檔為準。Token Plan 團隊版
啟動 Qwen Code 後輸入 /auth,依次選擇 訂用計畫 > 阿里雲百鍊 Token Plan,輸入 Token Plan 團隊版專屬 API Key 即可完成配置。可用模型請參考 Token Plan 團隊版支援的模型。
進階配置:通過 settings.json 設定檔
進階配置:通過 settings.json 設定檔
編輯或建立
settings.json 檔案,將 YOUR_API_KEY 替換為 Token Plan 團隊版專屬 API Key。檔案路徑如下:- macOS/Linux:
~/.qwen/settings.json - Windows:
C:\Users\<Windows使用者名稱>\.qwen\settings.json
Coding Plan
啟動 Qwen Code 後輸入 /auth,依次選擇 訂用計畫 > 阿里雲百鍊 Coding Plan,選擇 Coding Plan 地區(global),輸入 Coding Plan 專屬 API Key 即可完成配置。可用模型請參考 Coding Plan 支援的模型。
進階配置:通過 settings.json 設定檔
進階配置:通過 settings.json 設定檔
編輯或建立
settings.json 檔案,將 YOUR_API_KEY 替換為 Coding Plan 專屬 API Key。檔案路徑如下:- macOS/Linux:
~/.qwen/settings.json - Windows:
C:\Users\<Windows使用者名稱>\.qwen\settings.json
隨用隨付
啟動 Qwen Code 後輸入 /auth,選擇 使用自己的 API Key > Standard API Key,選擇對應地區並輸入阿里雲百鍊 API Key 即可完成配置。可用模型請參考OpenAI 相容 - 支援的模型。
進階配置:通過 settings.json 設定檔
進階配置:通過 settings.json 設定檔
編輯或建立 如需添加其他模型,在
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
modelProviders.openai 中以相同格式追加即可。驗證配置
配置完成後,在專案目錄下運行以下命令啟動 Qwen Code,即可開始對話。
Qwen Code IDE 外掛程式
Qwen Code 支援在 VS Code 和 JetBrains IDE 中以外掛程式方式使用,在 IDE 中提供 AI 編程能力。
VS Code
使用前請確保 VS Code 版本為 1.85.0 或更高版本。
- 開啟 VS Code,在擴充市場中搜尋
Qwen Code Companion並安裝。 - CLI 和 IDE 外掛程式共用同一個
settings.json。如果已按上方步驟完成配置,請跳過此步。否則請按照上方配置接入憑證章節進行配置。 - 點擊右上方表徵圖啟動 Qwen Code,通過輸入或點擊
/,選擇Switch model切換模型。
JetBrains IDE
使用前請確保 JetBrains IDE 支援 Agent Client Protocol(ACP)。
- Qwen Code IDE 依賴於 Qwen Code CLI,請先參考本文安裝 Qwen Code章節進行安裝並完成配置接入憑證。
- 開啟 JetBrains IDE,進入AI Chat頁面,點擊 Install Plugin,IDEA 將安裝 JetBrains Al Assistant 外掛程式。
-
點擊 AI Chat 視窗右上方三點菜單,選擇 Add Custom Agent,按以下配置填寫。請將
/path/to/qwen替換為 Qwen Code 安裝路徑,可運行以下命令查看該路徑:- macOS/Linux:
which qwen - Windows:
where qwen(CMD)或Get-Command qwen(PowerShell)
- macOS/Linux:
- 配置完成後,Qwen Code 將出現在 AI Chat 面板中,在右下角可以進行模型切換。
Qwen Code 案頭版
Qwen Code Desktop 是 Qwen Code 的圖形介面應用,內建 CLI 運行時,無需額外安裝命令列工具。案頭版與 CLI 共用同一份 settings.json 設定檔,如果已通過 CLI 完成配置,案頭版開啟即可直接使用,無需重複配置。
前往 Qwen Code GitHub Releases 頁面,下載適用於您作業系統(macOS、Windows 或 Linux)的案頭版安裝包。
如果尚未配置,可通過案頭版圖形介面完成:
- 開啟 Qwen Code Desktop,點擊左側設定,選擇 AI 頁簽。
- 在模型 Provider地區點擊+ 串連。
-
在彈窗中選擇 Alibaba ModelStudio 頁簽,根據計費方案選擇對應項:
- Coding Plan:固定月費訂閱,按模型調用次數計量。
- Token Plan:含個人版與團隊版,按 token 消耗抵扣 Credits。
- Standard API Key:使用已有的百鍊 API Key 隨用隨付。
- 按照頁面提示輸入 API Key,完成配置。
常見命令
以下命令適用於 Qwen Code CLI,IDE 外掛程式僅支援部分命令,請以實際使用為準。
命令 | 說明 | 樣本 |
|---|---|---|
| 切換當前會話中使用的模型。 |
|
| 更改認證方式。 |
|
| 分析目前的目錄並建立初始上下文檔案(QWEN.md),用於定義專案級指令和上下文。 |
|
| 清除終端螢幕內容,開始全新對話。 |
|
| 用摘要替換聊天歷史以節省 Token。 |
|
| 開啟設定編輯器,可配置語言、主題等。 |
|
| 根據對話歷史產生專案摘要。 |
|
| 恢複之前的對話會話。 |
|
| 顯示當前會話的詳細統計資訊。 |
|
| 顯示可用命令的協助資訊。 |
|
| 退出 Qwen Code。 |
|
瞭解更多
- Qwen Code 的子智能體、MCP、Skills 等進階功能,請參見Qwen Code 官方文檔。
- Qwen Code 的使用案例,請參見使用案例。
常見問題
錯誤碼
配置過程中遇到報錯,請參考對應計費方案的常見問題文檔:
- 隨用隨付:錯誤碼
- Coding Plan:Coding Plan 常見問題
- Token Plan 個人版:Token Plan 個人版常見問題
- Token Plan 團隊版:Token Plan 團隊版常見問題
如何切換模型?
在 Qwen Code 中直接輸入 /model 命令,即可從 settings.json 中已配置的模型列表中選擇切換。如需添加新模型,請在 settings.json 的 modelProviders 中添加對應配置,然後重啟 Qwen Code。