Qwen Code 是一款專為 Qwen3-Coder 模型最佳化的命令列 AI 工作流程工具，通過先進的代碼理解能力、自動化任務和智能協助工具功能，顯著提升開發效率。
安裝 Qwen Code
配置 Qwen Code
編輯或建立 settings.json 檔案，寫入下面的內容並儲存，請將 YOUR_API_KEY 替換為阿里雲百鍊API Key，具體路徑如下：
macOS / Linux:
~/.qwen/settings.jsonWindows:
C:\Users\您的使用者名稱\.qwen\settings.json
本文檔僅適用於隨用隨付模式，Coding Plan 使用者請使用專屬 Base URL 和 API Key 接入，詳情請參考Qwen Code Coding Plan說明文檔進行配置。
{
"env": {
"BAILIAN_API_KEY": "YOUR_API_KEY"
},
"modelProviders": {
"openai": [
{
"id": "qwen3.5-plus",
"name": "[Bailian] qwen3.5-plus",
"baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
{
"id": "qwen3-coder-plus",
"name": "[Bailian] qwen3-coder-plus",
"baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_API_KEY"
},
{
"id": "qwen3-coder-next",
"name": "[Bailian] qwen3-coder-next",
"baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_API_KEY"
}
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"model": {
"name": "qwen3.5-plus"
},
"$version": 3
}配置項 | 說明 |
modelProviders | （必選）設定為 |
id | （必選）模型的ID。建議選擇代碼能力較強的模型，如：qwen3.5-plus、glm-5、kimi-k2.5 各模式支援的模型請參見模型列表，部分模型（如glm-5）僅支援中國內地部署模式（北京地區）。 |
name | （可選）模型的顯示名稱，預設與id一致。 |
envKey | （必選）API Key 讀取的環境變數，設定為 |
baseUrl | （必選）服務地址，需要與API Key 所屬地區一致：
|
generationConfig.extra_body.enable_thinking | （可選）是否開啟深度思考。 |
更多 modelProviders 配置選項請參見 Qwen Code 配置文檔。使用 Qwen Code
在終端中輸入qwen以啟動 Qwen Code。在對話方塊中輸入“如何用python實現一個二叉搜尋樹？”Qwen Code 會進行規劃，並申請建立檔案、寫入檔案和執行檔案等操作。
效果如下圖所示：
常見命令
命令 | 說明 | 樣本 |
| 切換當前會話中使用的模型。 |
|
| 更改認證方式。 |
|
| 分析目前的目錄並建立初始上下文檔案（QWEN.md），用於定義專案級指令和上下文。 |
|
| 清除終端螢幕內容，開始全新對話。 |
|
| 用摘要替換聊天歷史以節省 Token。 |
|
| 開啟設定編輯器，可配置語言、主題等。 |
|
| 根據對話歷史產生專案摘要。 |
|
| 恢複之前的對話會話。 |
|
| 顯示當前會話的詳細統計資訊。 |
|
| 顯示可用命令的協助資訊。 |
|
| 退出 Qwen Code。 |
|
更多 Qwen Code 的進階功能，可以參考 Qwen Code 官方文檔。
免費額度
阿里雲百鍊對 Qwen3-Coder 等模型各提供 100 萬 Token 的免費額度（僅新加坡地區）。系統會優先消耗模型的免費額度，查詢剩餘額度請前往模型廣場並單擊模型卡片。為避免額外消費，可開啟免費額度用完即停按鈕。
除了阿里雲百鍊的免費額度，Qwen Code 還提供了每天 1000 次的免費額度。
瞭解更多
Qwen Code 的子智能體、MCP、Skills等進階功能，請參見 Qwen Code 官方文檔。
Qwen Code 的使用案例，請參見使用案例。
常見問題
Q：Qwen Code 為什麼 Token 消耗快？
A：Qwen Code 可能多次調用 API，從而消耗大量 Token。請參考以下方法控制 Token 消耗：
精簡工作目錄
建議在具體的專案目錄下啟動，啟動目錄（如根目錄）中過多的檔案會增加 Token 消耗。
設定 Token 限額
在專案的根目錄中建立
.qwen/settings.json檔案並重啟 Qwen Code，通過sessionTokenLimit控制單次 API 呼叫的 Token 使用量：{ "sessionTokenLimit": 32000 }Qwen Code 可能多次調用 API，使得單個問題的 Token 消耗量大於
sessionTokenLimit值。使用壓縮/清理指令
輸入以下命令可減少 Token 消耗：
/compress壓縮對話歷史，以便在 Token 限制內繼續對話。
/clear清除所有對話歷史並重新開始。
Q：如何切換模型？
A：在 Qwen Code 中直接輸入 /model 命令，即可從 settings.json 中已配置的模型列表中選擇切換。如需添加新模型，請在 settings.json 的 modelProviders 中添加對應配置，然後重啟 Qwen Code。
Q：如何使用每天 1000 次的免費額度？
A：啟動 Qwen Code 後輸入/auth，選擇 Qwen Oauth 認證方式，單擊 Enter 後通過 Qwen Chat認證方式接入。在跳轉介面登入 Qwen Chat 帳號，或掃描二維碼進行驗證，完成後即可每天免費調用 1000 次模型 API，該免費額度與阿里雲百鍊免費額度獨立。
超過 1000 次 API 呼叫後如需繼續使用，請通過/auth 切換為 OpenAI 認證方式。若首次使用 Qwen Chat，請註冊帳號。
Q：為什麼報 401 Incorrect API key provided 錯誤？
A：可能是 API 配置錯誤，請對比錯誤資訊中的API Key與設定是否一致，設定檔存在優先順序順序，如專案設定檔會覆蓋使用者設定檔。更多問題請參見 Qwen Code 故障排查文檔。