Qwen Code

Qwen Code 從 ~/.qwen/settings.json 的 modelProviders 讀取端點 — 一個包含 baseUrl 與 envKey 的項目，即可讓 Claude 與 GPT 出現在其 /model 選擇器中。

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

逐步操作

1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
2. 開啟 ~/.qwen/settings.json（若不存在，請建立該檔案），並合併上方四個區塊。文件建議在使用者範圍的檔案中宣告 modelProviders，「以避免專案設定與使用者設定之間發生合併衝突」。
3. 如果可以，請把金鑰放在比 env 更妥善的位置。Qwen Code 會從 process.env[envKey] 讀取金鑰，而文件列出的來源優先順序由高至低是：shell export、.env 檔案，接著是 settings.json 中的 env 區塊——文件特別指出這是以純文字儲存。上方的 env 區塊是能執行的最小設定，不是最適合長期保留的做法。
4. 執行 qwen。將 security.auth.selectedType 設為 openai，並讓 model.name 符合您宣告的 id，就不需要互動式的 /auth 步驟——文件在單檔範例後明確說明了這一點。
5. 請給它一項需要讀取並編輯檔案的任務，而不是打招呼。Qwen Code 是代理程式：工具呼叫與串流是首次執行時應該測試的功能，也是在端點僅部分相容時最先出問題的地方。
6. 在 modelProviders.openai 下方新增項目，即可透過 /model 在執行時切換模型。這些編輯會在執行中的工作階段即時重新載入；providerProtocol 則只會在啟動時讀取一次，變更後需要重新啟動。

已於 2026年9月21日 根據 Qwen Code 的驗證頁面，選項 4：API 金鑰（彈性設定） 進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

除錯用戶端前先驗證

一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON，則相同的基礎 URL 與金鑰在 Qwen Code 中也能運作。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

欄位中應填入哪個模型 ID

每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models，帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格，輸入／輸出。

文件明確說明的三件事，常被人猜錯

這些資訊來自上方連結的驗證頁面與模型提供者參考文件。若只靠猜測而不查閱，每一項都可能耗費不少除錯時間。

1. modelProviders 項目的優先順序高於 CLI 旗標。文件列出的順序由高至低為：在執行中的工作階段透過 /auth 設定的覆寫值、所選模型提供者的 envKey、例如 --openai-api-key 的 CLI 引數、環境變數，最後是設定中的 security.auth.apiKey。多數人會以為旗標優先，但事實並非如此——這也是為什麼 --openai-base-url 看起來可能沒有作用。
2. security.auth.apiKey 和 security.auth.baseUrl 已棄用。參考文件明確說明此事，並建議遷移至 modelProviders。如果較舊的教學指引您編輯這兩個鍵，您修改的是即將淘汰的路徑。
3. wireApi 會選擇請求格式，不會偵測格式不相符。省略此設定時會使用 Chat Completions，也就是上方區塊採用的格式。設定 "wireApi": "responses" 時，端點必須確實相容 Responses；文件明確指出，請求失敗時不會偵測端點，也不會自動改用其他格式。Kunavo 同時提供 /v1/responses 與 /v1/chat/completions，但本頁尚未測試這兩種搭配，因此請先使用預設值。

如果您來這裡是想找免費方案

許多現存的 Qwen Code 說明仍在介紹使用 Qwen OAuth 登入並取得免費每日額度。這個選項已取消：文件記載其免費方案於 2026 年 4 月 15 日停止，並指出 Qwen OAuth 不再是 /auth 對話框中的可選項目。目前列出的三個項目是 Alibaba ModelStudio——其子選單包含 Coding Plan、Token Plan 和 Standard API Key——第三方提供者，以及自訂提供者，說明為連線至「本機伺服器、代理或不支援的提供者」。Kunavo 屬於第三項。另請注意，ModelStudio 子選單中的項目並非三種可用來支付同一筆帳單的方式：每種方案都有自己的主機和金鑰，Coding Plan 金鑰無法搭配 Token Plan 主機使用。