Qwen Code 使用方法：安裝、/auth、日文化與 API 設定

Qwen Code 是由 Alibaba 的 Qwen 團隊發布的開放原始碼（Apache-2.0）AI 程式碼代理程式。使用流程分為 4 個階段：「安裝 → 在專案中啟動 qwen → 使用 /auth 設定連線目標 → 提出任務」。但由於免費的 Qwen OAuth 額度已於 2026 年 4 月 15 日結束，即使按照那之前的說明登入，也無法免費運作。本頁會依照目前的 /auth 選單，依序說明開始使用方式、切換為日文顯示、使用 Claude 或 GPT 的自訂設定，以及常用命令。最新版是於 2026 年 9 月 29 日發布至 npm 的 v0.24.7；由於每週發布至少一次，請使用 qwen --version 確認你手上的版本。

安裝

以下是官方 README 的步驟。使用獨立安裝程式時，不需要自行準備 Node.js。只有使用 npm 時才需要 Node.js 22 以上。

# macOS / Linux（公式のスタンドアロン インストーラー）
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（Node.js 22 以上が必要）
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 /path/to/your-project
qwen

# セッション内で：
/language ui ja-JP          # 画面表示を日本語に
/language output Japanese   # モデルの回答を日本語に
/auth                       # 接続先と API キーを設定

使用 /language ui ja-JP 後，介面會變成日文，之後畫面中會出現「選擇驗證方式」「工具核准模式」等 Qwen Code 自身的日文顯示。本頁也採用相同用語。回答語言與 UI 語言分開，可透過 /language output Japanese 指定。

除了終端機之外，也提供桌面應用程式、在瀏覽器中開啟的 Web UI（qwen serve --open，實驗性功能）、VS Code、Zed 與 JetBrains 整合，以及用於腳本和 CI 的無頭執行（qwen -p "..."）。這些都包含在同一個免費儲存庫中，推理費用另計。

使用 /auth 選擇連線目標

開啟 /auth（別名為 /login）後會進入「選擇驗證方式」畫面，頂層選項有三個。嘗試選擇 Qwen OAuth 時，會顯示「結束——請切換至 Coding Plan 或 API Key」。

ModelStudio 的三個選項不是同一種帳單付款方式的不同形式。文件為每個選項指定不同的端點與不同的金鑰；若金鑰類型與 baseUrl 不相符，就無法運作。截至 2026 年 10 月 1 日，Coding Plan 顯示「數量有限、先到先得，每日 0 時（UTC+8）補充」，因此有些日子可以申請，有些日子則不行。根據 Alibaba 的說明，Coding Plan 的一次請求在內部會轉成多次模型呼叫；簡單任務會消耗 5～10 次，複雜任務則會消耗 10～30 次以上。費用比較方式在英文版的 Qwen Code pricing 中有詳細說明。

使用 Claude 或 GPT：在 settings.json 中設定 Custom Provider

Qwen Code 的驗證文件建議使用 ~/.qwen/settings.json 的 modelProviders，以連接 OpenAI、Anthropic、Google、OpenRouter 或自己的端點等第三方服務。Kunavo 的設定如下。

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

# キーは settings.json に直接書かず、.qwen/.env か環境変数に
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

有四點需要掌握。

• baseUrl 只能設定到 /v1。模型供應商參考文件明確寫道：「指定 API 的 /v1 路徑，而不是 /v1/chat/completions；請求路徑會由 SDK 附加。」若寫入完整路徑，得到的不是驗證錯誤，而是 404。
• 金鑰的存放位置。Qwen Code 會使用 envKey 指定的變數名稱從環境中讀取。優先順序依序為 shell 的 export、.env（建議使用 .qwen/.env，且只讀取找到的第一個檔案）、settings.json 的 env；最後一項會以純文字儲存，因此不建議使用。
• 設定檔優先於 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 中的範例，先從「說明這個儲存庫，並告訴我該從哪裡開始閱讀」之類的請求開始，就能確認檔案讀取與工具呼叫是否都能正常運作。只打招呼無法找出連線問題。

yolo 等自動核准模式的文件警告：「僅在可信任、已沙箱化或可丟棄的環境中使用」。/stats model 的預估成本是以 Qwen Code 的計算方式得出，並不等於實際帳單金額。請透過連線服務的使用記錄確認實際金額。

需要了解的限制

• 內建的 web_search 取決於連線端。由於它使用 DashScope 的伺服器端搜尋，因此只有在使用 ModelStudio Standard API Key 與 Token Plan，且項目指向可辨識的 DashScope 主機時才會啟用；在 Coding Plan 中會停用（因為該端點尚未經過驗證），對第三方或其他主機的自訂端點也會停用（web_search 文件）。如有需要，請新增 MCP 搜尋伺服器。
• Kunavo 僅提供聊天路徑。Kunavo 沒有嵌入、文字轉語音或語音辨識模型。Qwen Code 的 Live Voice 必須使用 DashScope 端點，因此無論將聊天模型指向何處，使用的仍是另一組金鑰。

試用 Kunavo 時的付款方式

Kunavo 採預付儲值制，不收月費，會按 Token 使用量從餘額扣除。最低儲值額為 $10，Stripe 結帳頁支援卡片（Visa、Mastercard、American Express、JCB）、Apple Pay、Google Pay 和 Link。請先查看帳單說明，再建立帳戶並取得金鑰。首次請求後，建議在使用記錄中確認實際收費金額。

常見問題

2026 年 10 月 1 日確認：Qwen Code 的 README、驗證、模型供應商、指令與 web_search 文件（main 分支）、日文 UI 字串（packages/cli/src/i18n/locales/ja.js）、npm 的 @qwen-code/qwen-code 0.24.7，以及 Alibaba Cloud 的 Coding Plan 與 Token Plan 頁面。Kunavo 並未針對自有端點執行 Qwen Code。