部落格

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 分鐘。

逐步操作如下:

  1. 前往 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 檔案,並貼上:

{
  "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_keyVS Code 擴充功能在驗證流程中產生自己的金鑰,而不是使用 Token Plan開啟 ~/.qwen/settings.json,確認金鑰與 Management Platform 顯示的相符(不要與有 sk-sp- 前綴的 Coding Plan 金鑰混淆)
invalid_api_key複製金鑰時一併複製了空格或換行刪除金鑰,並使用複製圖示重新複製(不要用滑鼠選取)
model not found你的方案未包含該模型檢查訂閱頁面的 Available Models 清單
Insufficient quotaCredits 已用完檢查 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-maxAlibaba 的新旗艦(於 2026 年 8 月推出),複雜任務的最高品質選擇高——Credits 會比使用 3.7-max 消耗得更快
qwen3.7-max複雜架構、大型專案重構、從頭生成高——每天編碼的話,一週內就會用完配額
qwen3.6-plus日常主力:編輯、改進、審查、說明中——每天使用 2–4 小時,可用一個月
qwen3.6-flash快速編輯、簡單問題、格式調整低
deepseek-v4-proQwen 的替代選擇,有時更擅長演算法任務和數學中
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 CodeQwen 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 就會產生幻覺。

來源

繼續探索 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 與金鑰是否與成功請求一致,也要確認用量記入預期訂閱。

所有文章