Qwen Code 與 Qwen 3.7-max:設定 Token Plan
Markdown在 Node.js 22 上安裝 Qwen Code、連接國際版 Token Plan,以及造成 401 錯誤的三個陷阱:API 位址、金鑰和席位指派。
閱讀全文
Ailoot 參考文件:ailoot.ai/docs/.
更新於 2026 年 10 月 3 日:自發布以來,有三件事改變了。Alibaba 已停止 Coding Plan 的新購買——Lite 方案早在 3 月就停止銷售,Pro 則已售罄。Token Plan 從每週配額改為每月配額。較新的模型 Qwen3.8-max 已推出。我也修正了 Token Plan 金鑰說明中的錯誤——這和那個 401 錯誤直接相關,以下會說明。
Qwen Code 是什麼?為什麼它不只是另一個仿製品?
重點摘要
Qwen Code 是 Alibaba 的開放原始碼終端機 AI 代理,運作方式類似 Claude Code:它在 VS Code 終端機執行、讀取你的專案、撰寫程式碼並執行命令。主要差異在於,透過一個訂閱方案即可使用十多種模型,包括 Qwen 3.7、DeepSeek V4 和 Kimi K2。
我第一次聽說 Qwen Code 時,心想:「又一個 Claude Code 克隆品,第二個提示就會出問題。」我錯了。Alibaba 並沒有複製介面,而是從頭打造了自己的 CLI 代理,並完整相容 OpenAI API。這表示你不只能在其中執行 Qwen 模型,也能使用 DeepSeek、GLM、Kimi,甚至透過 Anthropic API 使用 Claude。
它實際上能做的事如下:
- 讀取專案結構並理解脈絡(就像使用
CLAUDE.md的 Claude Code) - 執行 shell 命令、編輯檔案並建立提交
- 支援 Skills 和 SubAgents
- 可透過內建終端機或擴充功能在 VS Code 中使用
- 使用一個
/model命令切換模型
它有一個缺點,而且很重要:免費方案已於 2026 年 4 月 15 日關閉。以前 Qwen OAuth 每天提供 100 次免費請求,現在只剩付費選項。不過,付費版 Qwen Code 仍比 Claude Pro 訂閱便宜不少。如果你現在正在選擇工具,我在指南「2026 年用什麼寫程式:8 款 AI 工具」中介紹了所有選項。
費用是多少?應該選哪個方案?
重點摘要
Alibaba 提供三種付款選項:依 Token 計費、Coding Plan 訂閱方案,以及 Token Plan 訂閱方案。日常氛圍式編碼最划算的選擇是 Token Plan:每月固定費用、10 種以上的模型,而且不必計算 Token 數量。
設定 Qwen Code 時,最大的麻煩就是各種方案令人混淆。Alibaba 在控制台不同區域使用不同名稱,連 VS Code 擴充功能顯示的選項也不正確。實際運作方式如下(已對照 Alibaba Cloud 文件,該文件於 2026 年 9 月 28 日更新)。
| 方案 | 內容 | 適用對象 | 約略費用 |
|---|---|---|---|
| 隨用隨付 | 每一百萬個 Token 分別計費 | 偶爾使用、試用 | 每 1M 個 Token $0.30-1.20 |
| Coding Plan | 個人訂閱方案,附每月配額(每週配額已於 2026 年 9 月 22 日停用) | 目前不接受新訂戶——Lite 方案於 2026 年 3 月 20 日停止購買,Pro 已售罄 | 新帳戶目前無法使用 |
| Token Plan Team Edition,Standard Seat | 每個席位每月 25,000 Credits,提供 10 種以上的模型 | 每天進行氛圍式編碼並切換模型 | 促銷價每個席位每月 $20(原價:$30) |
依本文作者描述的經驗,選擇了 Token Plan,因為一個訂閱方案就能使用 Qwen 3.7-max(以及較新的 Qwen3.8-max)、DeepSeek V4 Pro 和 GLM-5。所有模型共用同一組 Credits。使用 /model 命令即可切換——你不必為每個供應商另購金鑰。
重要:Coding Plan 和 Token Plan 是不同產品,使用不同的 API 位址。Coding Plan 金鑰的前綴是 sk-sp-。Token Plan 金鑰則沒有任何前綴——官方 Qwen Code 文件就是這樣描述的。若混用了不同產品的位址或金鑰,就會收到 401 錯誤。而且 Coding Plan 已停止接受新購買,Token Plan 目前是大多數讀者唯一可用的選項。
如何安裝 Qwen Code?
重點摘要
有兩種安裝方式:使用 npm(npm install -g @qwen-code/qwen-code@latest)或 Homebrew(brew install qwen-code)。你需要 Node.js 22 以上版本。安裝後,在終端機執行 qwen。
安裝前先檢查 Node.js 版本:
node --version
你需要 22 或更新版本。若版本較舊,請透過 nodejs.org 或 nvm 更新:
nvm install 22
nvm use 22
接著用一個命令安裝 Qwen Code:
npm install -g @qwen-code/qwen-code@latest
在 macOS 上也可以使用 Homebrew:
brew install qwen-code
確認安裝結果:
qwen --version
若顯示版本號,就準備好了。在終端機執行 qwen 命令即可啟動 Qwen Code。在 VS Code 中,開啟內建終端機(Ctrl+)並輸入 qwen`。
此外也有一款 VS Code 擴充功能——市集中的 QwenLM Qwen Code Companion。它會新增一個聊天側邊欄,類似 GitHub Copilot。我使用這款擴充功能,比單純使用終端機方便。
如何建立帳戶並購買 Token Plan?
重點摘要
在 Alibaba Cloud 國際版控制台(modelstudio.console.alibabacloud.com)註冊,新增供應商接受的信用卡,然後訂閱 Token Plan。整個流程需要 10 分鐘。
逐步操作如下:
- 前往 modelstudio.console.alibabacloud.com
- 點選右上方的 Free Sign Up
- 輸入電子郵件地址(Gmail 也可以),並確認收件匣中的驗證碼
- 新增你的電話號碼
- 新增供應商接受的信用卡。Alibaba 會收取 $1 進行驗證,並在 1–3 天內退款。
- 在控制台中找到 ModelStudio 區域的 Token Plan 分頁
- 選擇 Standard 方案(入門所需的最低方案)
- 確認付款
購買後會進入 My Subscriptions 頁面。你會看到:
- Standard Seat: 0/1——這表示你已購買一個席位,但尚未指派給自己
- 點選 Assign,選取你的帳戶並確認
- 狀態應該會變成 1/1
若不完成這個步驟,API 金鑰就無法使用。依作者描述的經驗,這個步驟花了 20 分鐘。
在哪裡取得 API 金鑰和正確的位址?
重點摘要
API 金鑰和 API 位址(Base URL)位於 Management Platform 頁面。國際版 Token Plan 的位址是 https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1。不要與一般的 DashScope 位址混淆——Token Plan 金鑰無法在那裡使用。
在 My Subscriptions 頁面,點選大型紫色 Go to Management Platform 按鈕。系統會開啟另一個面板。
在左側選單選擇 Overview。這個頁面上有兩個區域:
Plan-specific API Key——你的個人金鑰。它會以星號遮蔽。點選旁邊的複製圖示(不要用滑鼠選取——複製到的會是星號)。Token Plan 金鑰沒有前綴。這不是說明文件中的筆誤;官方 Qwen Code 文件就是這樣描述的。若看到 sk-sp-,那是不同產品的 Coding Plan 金鑰——你複製錯了。
Plan-specific Base URL——有兩個選項:
- 適用於 OpenAI 相容工具(Qwen Code):
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - 適用於 Anthropic 相容工具:
https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
請記住:Token Plan 金鑰只能搭配這些位址使用。標準的 dashscope-intl.aliyuncs.com 位址適用於一般金鑰(隨用隨付),而 coding-intl.dashscope.aliyuncs.com 則是 Coding Plan 的位址。Token Plan 金鑰若搭配其中任何一個位址,都會回傳 401。
如何連接到 VS Code?
重點摘要
透過 ~/.qwen/settings.json 檔案設定 VS Code 擴充功能。你需要輸入金鑰、正確的 API 位址和模型。以下是可直接使用的設定——複製後將金鑰換成你自己的即可。
如果你是從 VS Code 市集安裝 Qwen Code Companion 擴充功能:
- 開啟命令選擇區(Cmd+Shift+P)
- 輸入 Qwen Code: Choose Provider
- 若出現選項清單,不要選 Coding Plan(那是不同產品)。請選 Standard API Key
- 貼上 Management Platform 中的金鑰——Token Plan 金鑰沒有固定前綴
- Region:Singapore
- Model:
qwen3.7-max
若完成後出現錯誤,請透過檔案手動設定。擴充功能有時會填入錯誤的位址。
開啟或建立 ~/.qwen/settings.json 檔案,並貼上:
{
"env": {
"TOKEN_PLAN_API_KEY": "YOUR-KEY-FROM-MANAGEMENT-PLATFORM"
},
"modelProviders": {
"openai": [
{
"id": "qwen3.7-max",
"name": "qwen3.7-max",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": { "enable_thinking": true },
"contextWindowSize": 262144
}
},
{
"id": "qwen3.6-plus",
"name": "qwen3.6-plus",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": { "enable_thinking": true },
"contextWindowSize": 1000000
}
},
{
"id": "deepseek-v4-pro",
"name": "deepseek-v4-pro",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": { "enable_thinking": true },
"contextWindowSize": 1000000
}
}
]
},
"security": {
"auth": { "selectedType": "openai" }
},
"model": { "name": "qwen3.7-max" }
}
將 YOUR-KEY-FROM-MANAGEMENT-PLATFORM 替換為你在 Management Platform 取得的金鑰。重新啟動 VS Code。完成。
為什麼會出現 401 錯誤?如何修正?
重點摘要
設定 Qwen Code 時,90% 的 401 錯誤都是 API 位址或金鑰錯誤所致。Token Plan、Coding Plan 和隨用隨付使用不同的位址,彼此的金鑰不能互換。
作者描述了設定過程中遇到的錯誤。以下列出 401 錯誤的所有成因,以及檢查方法:
| 症狀 | 原因 | 解決方法 |
|---|---|---|
invalid_api_key | 將 Token Plan 金鑰傳送到 DashScope 位址(或反過來) | 檢查 Base URL。Token Plan:token-plan.ap-southeast-1...;Coding Plan:coding-intl.dashscope... |
invalid access token | 尚未指派 Standard Seat(0/1) | 前往 My Subscriptions,點選 Assign——應顯示 1/1 |
invalid_api_key | VS Code 擴充功能在驗證流程中產生自己的金鑰,而不是使用 Token Plan | 開啟 ~/.qwen/settings.json,確認金鑰與 Management Platform 顯示的相符(不要與有 sk-sp- 前綴的 Coding Plan 金鑰混淆) |
invalid_api_key | 複製金鑰時一併複製了空格或換行 | 刪除金鑰,並使用複製圖示重新複製(不要用滑鼠選取) |
model not found | 你的方案未包含該模型 | 檢查訂閱頁面的 Available Models 清單 |
Insufficient quota | Credits 已用完 | 檢查 My Subscriptions 中的 Usage。如果達到 100%,請等候重設,或購買 Boost Pack |
透過終端機快速檢查金鑰:
curl -s -o /dev/null -w "%{http_code}" -X POST \
"https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen3.7-max","messages":[{"role":"user","content":"hi"}],"max_tokens":5}'
若回傳 200,金鑰就能正常使用,問題出在擴充功能設定。若回傳 401,金鑰或位址就不正確。
有哪些模型可用?應該選哪一個?
重點摘要
Token Plan 提供來自 5 家供應商的 10 種以上模型;新旗艦 Qwen3.8-max 已於 2026 年 8 月加入。氛圍式編碼的主力模型是 qwen3.6-plus(兼顧價格和品質)。複雜任務可使用 qwen3.7-max 或較新的 qwen3.8-max。快速編輯則使用 qwen3.6-flash。
以下是對氛圍式編碼確實實用的模型:
| 模型 | 適用時機 | Credits 用量 |
|---|---|---|
| qwen3.8-max | Alibaba 的新旗艦(於 2026 年 8 月推出),複雜任務的最高品質選擇 | 高——Credits 會比使用 3.7-max 消耗得更快 |
| qwen3.7-max | 複雜架構、大型專案重構、從頭生成 | 高——每天編碼的話,一週內就會用完配額 |
| qwen3.6-plus | 日常主力:編輯、改進、審查、說明 | 中——每天使用 2–4 小時,可用一個月 |
| qwen3.6-flash | 快速編輯、簡單問題、格式調整 | 低 |
| deepseek-v4-pro | Qwen 的替代選擇,有時更擅長演算法任務和數學 | 中 |
| kimi-k2.6 | 長脈絡:讀取大型程式碼庫、分析文件 | 中 |
在 Qwen Code 工作階段中直接使用 /model 命令切換模型,不必變更設定或重新啟動。
我會建議從 qwen3.6-plus 開始。如果一週後發現配額消耗太快,就把日常工作改用 qwen3.6-flash,只在複雜任務中使用 qwen3.7-max。
Qwen Code 和 Claude Code,該用哪一個?
重點摘要
Claude Code 產生的程式碼品質較好,理解脈絡的能力也較強。Qwen Code 費用較低,並能透過一個訂閱方案使用多種模型。理想的組合是:主要工作使用 Claude Code,並行任務和實驗則使用 Qwen Code。
這篇評測描述了作者使用這兩款工具一個月的經驗。以下比較根據這段經驗整理:
| 評估項目 | Claude Code | Qwen Code |
|---|---|---|
| 程式碼品質 | 較好——Anthropic 此後推出了更新的模型(Opus 5.5,2026 年 9 月 22 日);差距並未縮小 | 良好,但即使是新的旗艦 Qwen3.8-max,在獨立測試中仍不及 Anthropic 的頂尖模型 |
| 專案理解 | CLAUDE.md 加上深入讀取專案樹,運作起來就像真人 | 機制相似,但成熟度較低 |
| 價格 | Claude Pro 每月 $20(重度編碼者使用的 Max 每月 $100-200) | Token Plan Standard 每月 $20 起,包含 10 種以上模型 |
| 模型選擇 | 只有 Claude(Opus/Sonnet/Haiku) | Qwen + DeepSeek + GLM + Kimi + MiniMax |
| 開放原始碼 | 否(封閉原始碼) | 是(MIT 授權) |
| VS Code 擴充功能 | 原生、穩定 | 有提供,但仍不夠成熟——有時會出現金鑰問題 |
以下情況選 Qwen Code 更划算:
- 你需要使用多種模型(用 DeepSeek 做數學、用 Kimi 處理長脈絡)
- 你想針對同一項任務嘗試不同做法
- 預算有限,但每天都要寫程式
- 你想要可自訂的開放原始碼工具
以下情況 Claude Code 不可或缺:
- 程式碼品質直接關係到收入的重要專案
- 維護大型舊有專案(Opus 對脈絡的維持能力較好)——我在如何避免用完 Claude Code 額度中另有說明
- 你需要穩定的 VS Code 擴充功能,不想手動設定
依作者描述的經驗,理想搭配是:主要專案使用 Claude Code,實驗和並行任務使用 Qwen Code,快速用較便宜的模型測試想法。若想與其他工具深入比較,請參閱 Cursor vs Claude Code 和 Codex vs Claude Code。
每個人都會遇到的三個陷阱
重點摘要
Token Plan 和 Coding Plan 是使用不同位址的不同產品。VS Code 擴充功能會填入錯誤的金鑰。你必須手動指派席位。這三個陷阱會浪費 30 分鐘到數小時——我全都遇過,也記錄了各自的解決方法。
陷阱 1:Token Plan ≠ Coding Plan
Alibaba 在控制台不同區域使用不同名稱稱呼這些產品。VS Code 擴充功能中的「Coding Plan」選項不是 Token Plan。請記住,截至 2026 年 3 月 20 日,Coding Plan Lite 已停止接受新購買,Pro 也已售罄——如果你尚未訂閱,就只能選擇 Token Plan。兩者的 API 位址不同:
- Token Plan:
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - Coding Plan:
https://coding-intl.dashscope.aliyuncs.com/v1
如果你買了 Token Plan,卻將擴充功能設定為 Coding Plan,就會收到 401 錯誤。反過來也一樣。
陷阱 2:VS Code 擴充功能會產生自己的金鑰
透過擴充功能的 GUI 設定時(Cmd+Shift+P - Qwen Code: Choose Provider),擴充功能有時會透過 Alibaba Auth API 產生自己的金鑰。這種金鑰格式不同,也沒有連結到你的 Token Plan 訂閱方案。
解決方法:透過 GUI 設定後,開啟 ~/.qwen/settings.json,確認 env 中的金鑰與 Management Platform 顯示的相符(Overview - Plan-specific API Key)。若不相符,請手動替換。
陷阱 3:尚未指派 Standard Seat
購買 Token Plan 後,你會在 My Subscriptions 頁面看到 Standard Seat: 0/1。這表示席位已購買,但尚未連結到你的帳戶。按下 Assign 之前,API 金鑰都無法使用。
依作者的經驗,在注意到這一行之前,排查 401 錯誤花了 20 分鐘。
如何確認所有功能都正常?
重點摘要
分兩步驟:先在終端機用 curl 檢查金鑰(應回傳 200),再在 Qwen Code 輸入任意提示。如果 curl 正常,但擴充功能不行,問題就在 ~/.qwen/settings.json 檔案的設定中。
步驟 1:在終端機檢查金鑰:
curl -X POST \
"https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen3.6-plus","messages":[{"role":"user","content":"Hello"}]}'
若回應中包含模型產生的文字,金鑰和位址就能正常使用。
步驟 2:在 Qwen Code 中檢查:
開啟 VS Code,選擇內建終端機並輸入 qwen。若程式啟動,請輸入一些內容:
這個資料夾中的專案是什麼?
Qwen Code 會讀取專案結構並回覆。如果有回覆,就表示設定完成。
步驟 3:檢查 Credits 使用量:
送出第一次請求後五分鐘,前往 Management Platform—Overview—Usage Consumption。百分比應該不為零。送出 10 次以上請求後仍顯示 0%,表示你使用了錯誤的位址(請求沒有經過訂閱方案,可能轉到隨用隨付,也可能完全沒有送達)。
接下來呢?
重點摘要
Qwen Code 已設定完成——你可以開始氛圍式編碼了。不過,工具本身只是起點。「我安裝了 CLI」和「我正在用 AI 打造產品」之間的差異,在於使用脈絡的方法。
你已安裝 Qwen Code,並確認它能正常運作。你可以開啟任何專案,開始透過與 AI 對話來打造產品。
接下來的問題是:為什麼同一個提示在 Qwen Code 中,對某個專案會產生出色結果,對另一個專案卻只產生垃圾?原因在於脈絡。如果專案中有包含目標對象、產品和目標的 business/ 結構,AI 就能像夥伴一樣協助你。如果資料夾是空的,AI 就會產生幻覺。
來源
- GitHub 上的 Qwen Code——原始碼和文件,於 2026 年 10 月 3 日查閱
- Alibaba Cloud ModelStudio——管理訂閱方案和金鑰的控制台
- Token Plan 概覽——目前的方案和 Coding Plan 狀態;Alibaba 於 2026 年 9 月 28 日更新,並於 2026 年 10 月 3 日查閱
- Qwen Code 文件:驗證——Token Plan 和 Coding Plan 的金鑰格式,於 2026 年 10 月 3 日查閱
繼續探索 Ailoot,請前往 ailoot.ai。
更多詳情
常見問題:Qwen Code 與 Qwen 3.7-max:設定 Token Plan
Token Plan 金鑰回傳 401,應先檢查什麼?
確認金鑰與 Base URL 都屬於 Token Plan,而不是 Coding Plan 或一般 DashScope;使用主控台複製按鈕取得金鑰,並檢查已購買的 Standard Seat 是否完成指派。再用同一組設定核對擴充功能儲存的內容。
終端機請求成功,就代表 VS Code 擴充功能設定完成嗎?
不能。它只驗證該次請求使用的金鑰、端點與模型。請另外在 Qwen Code 測試提示,核對其 Base URL 與金鑰是否與成功請求一致,也要確認用量記入預期訂閱。