設定 Qwen Code：安裝、供應商、德文介面與 API

Qwen Code 是 Alibaba Qwen 團隊推出的開放原始碼 AI 程式設計代理程式（Apache-2.0）。設定分為四個步驟：安裝、在專案中以 qwen 啟動、使用 /auth 選擇提供者，以及提出任務。首先要注意：免費的 Qwen OAuth 額度已於 2026 年 4 月 15 日結束——依照較舊指南操作將不再免費。 本頁依照目前的 /auth 選單，說明切換成德文、為 Claude 或 GPT 設定自有端點，以及重要命令。最新版本為 v0.24.7，於 2026 年 9 月 29 日發布至 npm；版本至少每週發布一次，請使用 qwen --version 檢查你的版本。

安裝

命令取自官方 README。使用獨立安裝程式時不需要自行提供 Node.js；只有使用 npm 時才必須使用 Node.js 22 或更新版本。

# macOS / Linux (offizieller Standalone-Installer)
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

# Windows (PowerShell)
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

# npm (benötigt Node.js 22 oder neuer)
npm install -g @qwen-code/qwen-code@latest

# Homebrew (macOS / Linux)
brew install qwen-code

之後重新開啟終端機，讓環境變數生效。Qwen Code 最初以 Google Gemini CLI v0.8.2 為基礎，但自 v0.1 起獨立開發，且不再與原始專案同步。Gemini CLI 的設定與額度不適用於此處。

首次啟動與德文介面

cd /pfad/zu/ihrem-projekt
qwen

# in der Sitzung:
/language ui de-DE        # Oberfläche auf Deutsch
/language output German   # Antworten des Modells auf Deutsch
/auth                     # Anbieter und API-Key einrichten

執行 /language ui de-DE 後，Qwen Code 會顯示自己的德文名稱，例如「選擇驗證方法」或「工具核准模式」；本頁使用相同術語。回覆語言與此分開，使用 /language output German 設定。

除了終端機外，還有桌面應用程式、瀏覽器中的 Web 介面（qwen serve --open，實驗性功能）、VS Code、Zed 和 JetBrains 整合，以及供腳本和 CI 使用的無頭模式（qwen -p "..."）。所有功能都位於同一個免費 repository 中；推理費用需另行支付。

使用 /auth 選擇提供者

/auth（別名 /login）會開啟「選擇驗證方法」，最上層有三個選項。若仍想選擇 Qwen OAuth，會看到：「已停止——請改用 Coding Plan 或 API Key」。

三種 ModelStudio 方式不是同一張帳單的三種付款方式：文件為每種方式指定不同的端點與金鑰，而金鑰類型和 baseUrl 必須相互對應。2026 年 10 月 1 日，Coding Plan 標示為「限量供應，先到先得，每日 0:00（UTC+8）補充」——因此某一天可能無法購買。Coding Plan 中的一項任務會消耗多次模型呼叫；Alibaba 表示，簡單任務通常需要 5–10 次，複雜任務則需要 10–30 次或更多。英文頁面 Qwen Code 定價 詳細說明了費用比較。

使用 Claude 或 GPT：settings.json 中的自訂提供者

驗證文件建議，對於 OpenAI、Anthropic、Google、OpenRouter 等第三方或自有端點，在 ~/.qwen/settings.json 中使用 modelProviders 區塊。Kunavo 的設定如下：

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "description": "Kunavo, OpenAI-kompatibel",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

# Den Key nicht in settings.json schreiben, sondern in .qwen/.env oder die Umgebung
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

四個可省下除錯時間的重點：

• baseUrl 以 /v1 結尾。 Model Providers 參考文件明確表示：應設定 API 的 /v1 根路徑，而不是 /v1/chat/completions——SDK 會自行附加該路徑。加入路徑會得到 404，而不是驗證錯誤。
• 金鑰存放位置。 Qwen Code 會從 envKey 所指定的環境變數讀取金鑰。優先順序為：Shell-export，接著是 .env 檔案（建議使用 .qwen/.env；只會採用找到的第一個檔案），最後是 env 中的 settings.json——金鑰會以純文字儲存於該處。
• 檔案優先於 CLI 選項。 順序為：/auth 中的值 → 所選 modelProviders 項目 → CLI 引數 → 環境變數 → settings.json。因此 --openai-base-url 有時不會生效。舊指南中的 security.auth.apiKey 和 security.auth.baseUrl 已過時。
• 先從 Chat Completions 開始。 未設定 wireApi 時會使用 Chat Completions。設定 "responses" 後，不會進行端點偵測，也不會自動回退。對 modelProviders 的變更也會在執行中的工作階段生效（重新開啟 /model）。

Kunavo 目錄中沒有 Qwen 文字模型。 因此這不是取得 Qwen 的較便宜方式，而是透過預付餘額在 Qwen Code 中使用 Claude 或 GPT 的方式。Kunavo 也未親自使用 Qwen Code 對其端點執行；與英文的 Qwen Code 設定頁面一樣，設定來自官方文件。試用期間請保留一條可運作的路由。

第一項任務與重要命令

README 大意上建議的第一個任務是：「說明這個 repository，並告訴我應該從哪裡開始。」這會同時測試檔案存取和工具呼叫——單純說「你好」無法發現連線問題。

對於 yolo 和其他自動模式，文件本身警告：只能在可信任、隔離或拋棄式環境中使用。/stats model 中的預估費用由 Qwen Code 自行計算；實際金額請查看提供者的使用記錄。

你應瞭解的限制

• 內建 Web 搜尋取決於主機。 它使用 DashScope 的伺服器端搜尋：ModelStudio Standard API Key 和 Token Plan 啟用；偵測到 DashScope 主機的項目啟用；Coding Plan 停用（此處未驗證）；其他主機上的第三方與自有端點停用（web_search 文件）。替代方案：MCP 搜尋伺服器。
• Kunavo 僅提供 Chat。 Kunavo 不提供 embedding、語音合成或語音辨識模型。Qwen Code 的 Live Voice 無論如何都要求 DashScope 端點，並持續使用自己的金鑰，不受 Chat 模型指向何處影響。

試用 Kunavo 時付款

Kunavo 使用無訂閱的預付餘額，並按 token 用量計費。最低儲值金額為 $10；Stripe 結帳頁面提供卡片（Visa、Mastercard、American Express）、Apple Pay、Google Pay 和 Link，在奧地利還提供 EPS——目前不提供 SEPA 直接扣款。Stripe 僅向英國、愛爾蘭和芬蘭的買家提供 Pay by Bank；在德國目前僅作為封閉預覽功能提供（Stripe 文件，截至 2026 年 10 月 3 日）。詳情請參閱 帳務；請使用帳戶建立金鑰。完成第一次任務後，使用紀錄會顯示實際金額。

常見問題

於 2026 年 10 月 1 日核查：Qwen Code README、身分驗證、Model Providers、命令及 web_search 文件（main 分支）、德文 UI 文字（packages/cli/src/i18n/locales/de.js）、npm 上的 @qwen-code/qwen-code 0.24.7，以及 Alibaba Cloud 的 Coding Plan 和 Token Plan 頁面。Kunavo 未將 Qwen Code 連接至其端點執行。