# Qwen Code 與 Qwen 3.7-max：設定 Token Plan > 在 Node.js 22 上安裝 Qwen Code、連接國際版 Token Plan，以及造成 401 錯誤的三個陷阱：API 位址、金鑰和席位指派。 Source: https://ailoot.ai/blog/zh-hant-tw/qwen-code-token-plan-setup/ Canonical: https://ailoot.ai/blog/zh-hant-tw/qwen-code-token-plan-setup/ Language: zh-Hant-TW Publisher: Ailoot (https://ailoot.ai/) Translation: guide-207 Revision: sha256-4efba4e8131b6a14cdb5be0ce4568ba0e2a8ad62777cc526c3c058c366498b5e Ailoot 參考文件：[ailoot.ai/docs/](https://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 工具」](https://ailoot.ai/blog/zh-hant-tw/ai-coding-tools/)中介紹了所有選項。 ## 費用是多少？應該選哪個方案？
重點摘要 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 版本： ```bash node --version ``` 你需要 **22 或更新版本**。若版本較舊，請透過 [nodejs.org](https://nodejs.org/en/download) 或 `nvm` 更新： ```bash nvm install 22 nvm use 22 ``` 接著用一個命令安裝 Qwen Code： ```bash npm install -g @qwen-code/qwen-code@latest ``` 在 macOS 上也可以使用 Homebrew： ```bash brew install qwen-code ``` 確認安裝結果： ```bash 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 分鐘。
逐步操作如下： 1. 前往 [modelstudio.console.alibabacloud.com](https://modelstudio.console.alibabacloud.com/) 2. 點選右上方的 **Free Sign Up** 3. 輸入電子郵件地址（Gmail 也可以），並確認收件匣中的驗證碼 4. 新增你的電話號碼 5. 新增供應商接受的信用卡。Alibaba 會收取 \$1 進行驗證，並在 1–3 天內退款。 6. 在控制台中找到 **ModelStudio** 區域的 **Token Plan** 分頁 7. 選擇 **Standard** 方案（入門所需的最低方案） 8. 確認付款 購買後會進入 **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 擴充功能**： 1. 開啟命令選擇區（Cmd+Shift+P） 2. 輸入 **Qwen Code: Choose Provider** 3. 若出現選項清單，**不要選 Coding Plan**（那是不同產品）。請選 **Standard API Key** 4. 貼上 Management Platform 中的金鑰——Token Plan 金鑰沒有固定前綴 5. Region：**Singapore** 6. Model：`qwen3.7-max` 若完成後出現錯誤，請**透過檔案手動設定**。擴充功能有時會填入錯誤的位址。 開啟或建立 `~/.qwen/settings.json` 檔案，並貼上： ```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 | **透過終端機快速檢查金鑰：** ```bash 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 額度](https://ailoot.ai/blog/zh-hant-tw/claude-code-token-limits-saving/)中另有說明 - 你需要穩定的 VS Code 擴充功能，不想手動設定 依作者描述的經驗，理想搭配是：**主要專案使用 Claude Code**，**實驗和並行任務使用 Qwen Code**，快速用較便宜的模型測試想法。若想與其他工具深入比較，請參閱 [Cursor vs Claude Code](https://ailoot.ai/blog/zh-hant-tw/cursor-vs-claude-code/) 和 [Codex vs Claude Code](https://ailoot.ai/blog/zh-hant-tw/codex-vs-claude-code-choice/)。 ## 每個人都會遇到的三個陷阱
重點摘要 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：在終端機檢查金鑰：** ```bash 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](https://github.com/QwenLM/qwen-code)——原始碼和文件，於 2026 年 10 月 3 日查閱 - [Alibaba Cloud ModelStudio](https://modelstudio.console.alibabacloud.com/)——管理訂閱方案和金鑰的控制台 - [Token Plan 概覽](https://www.alibabacloud.com/help/en/model-studio/token-plan-overview)——目前的方案和 Coding Plan 狀態；Alibaba 於 2026 年 9 月 28 日更新，並於 2026 年 10 月 3 日查閱 - [Qwen Code 文件：驗證](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/)——Token Plan 和 Coding Plan 的金鑰格式，於 2026 年 10 月 3 日查閱
繼續探索 Ailoot，請前往 [ailoot.ai](https://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 與金鑰是否與成功請求一致，也要確認用量記入預期訂閱。 ## Ailoot · 公司及其專案組合 Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。 公司及其專案組合：數百萬客戶，每月銷售額達數十億。 Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。