Qwen Code 使用方法：安裝、帳戶與模型選擇、API 設定

Qwen Code 是 Alibaba Qwen 團隊公開的開放原始碼（Apache-2.0）AI 程式設計代理程式。使用方式分為四個步驟：「安裝 → 在專案中執行 qwen → 透過 /auth 設定連線目標 → 提出工作要求」。但免費 Qwen OAuth 等級已於 2026 年 4 月 15 日結束，因此依照此前發布的使用方式登入後，已無法再免費運作。此外，韓文使用者首先需要知道：Qwen Code 沒有韓文 UI。本頁將依序說明目前 /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 output Korean   # 모델 답변을 한국어로 (UI는 한국어 미지원)
/auth                     # 공급자와 API 키 설정

內建 UI 語言只有簡體中文、英文、俄文、德文、日文、巴西葡萄牙文、法文和加泰隆尼亞文，儲存庫的 UI 翻譯檔中也沒有韓文（2026 年 10 月 1 日確認）。因此選單會以英文顯示，本頁直接引用畫面上顯示的英文文字。模型回答語言與 UI 無關，因此可以透過 /language output Korean 固定使用韓文。

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

透過 /auth 選擇連線目標

開啟 /auth（別名 /login）後，會顯示「Select authentication method:」畫面，最上層有三個選項。嘗試選擇 Qwen OAuth 時，會顯示「Discontinued — switch to Coding Plan or API Key」提示。

ModelStudio 的三種方式並不是支付同一張帳單的三種方法。文件為每種方式分別設定端點與金鑰；金鑰類型與 baseUrl 不一致時便無法運作。以 2026 年 10 月 1 日為準，Coding Plan 標示為「數量有限·先到先得，每日 0:00（UTC+8）補充」，因此可能因日期不同而無法註冊。Coding Plan 中的一項工作會以多次模型呼叫計算；Alibaba 說明，簡單工作通常為 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、UnionPay）、Apple Pay、Google Pay 和 Link。若結帳頁面以韓元顯示，也可以選擇 Kakao Pay、Naver Pay、PAYCO、Samsung Pay，以及無法進行海外付款的韓國國內信用卡（韓元換算會加收 Stripe 2–4% 的換匯費，以美元付款即可避免）。不支援 Toss Pay。請查看 付款說明並建立帳戶以取得金鑰。第一次請求後，最確實的方式是到使用記錄確認實際金額。

常見問題

2026 年 10 月 1 日確認：Qwen Code README、驗證·模型供應商·指令·web_search 文件（main 分支）、儲存庫中的 UI 翻譯檔清單、npm 的 @qwen-code/qwen-code 0.24.7，以及 Alibaba Cloud 的 Coding Plan 和 Token Plan 頁面。Kunavo 尚未執行 Qwen Code 連線至自家端點的測試。