Qwen 代碼自訂 API 設定

將 TokenHub OpenAI 相容模型新增至 Qwen Code 設定中,並從 CLI 中安全地選擇它。

什麼是 Qwen 代碼?

Qwen Code 是一個命令列編碼代理,具有可設定的提供者、模型、技能和儲存庫工作流程。

本 Qwen 程式碼指南使用目前的 modelProviders.openai 配置和基於環境的 TokenHub API 金鑰。它將憑證保留在共用設定之外,並以唯讀任務啟動。持久設定位於 modelProviders.openai 下的使用者設定檔中,而真正的 API 金鑰則保留在 envKey 引用的環境中。保持共用項目配置不含機密,確認 security.auth.selectedType 和預設模型,並在變更 JSON 或環境變數後重新啟動 CLI。

Qwen Code 可以透過 TokenHub 的 OpenAI compatible 相容 API 中轉模型請求。本文保留官方安裝方式,並只替換 API key、Base URL 和模型 ID。

本指南使用的 TokenHub endpoint 是 https://us-api.tokenhub.com/v1/chat/completions

何時使用

適合先在小型倉庫或測試專案中驗證。先讓工具讀檔、解釋程式碼或產生方案,再逐步開啟修改和自動化任務。

安裝或開啟工具

先依照 Qwen Code 官方文件 安裝或開啟工具。版本不同時,請以官方文件目前的入口為準。

對於 CLI 工具,先確認可執行檔可用,再加入 TokenHub 憑證:

qwen --version

準備 TokenHub 憑證

建立 TokenHub API key,並在 TokenHub 模型列表中選擇一個適合這個工具的模型。

export TOKENHUB_API_KEY="sk-..."

請將金鑰保存在本機 shell、IDE 的密鑰儲存或工具的安全 API key 欄位中,不要提交到程式碼倉庫。

設定 TokenHub 服務商

在工具的模型、供應商、API Keys 或 OpenAI Compatible 設定頁面中填入下列值。

服務商填寫值

欄位填寫值
供應商OpenAI Compatible 或 Custom
Base URLhttps://us-api.tokenhub.com/v1
API KeyTOKENHUB_API_KEY 的值
模型qwen3-coder-plus 或其他 TokenHub 模型 ID

設定檔位置

欄位填寫值
User config~/.qwen/settings.json
Project config.qwen/settings.json
Provider fieldsmodelProviders.openai, security.auth.selectedType, model.name
{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [
        {
          "id": "qwen3-coder-plus",
          "name": "TokenHub / qwen3-coder-plus",
          "baseUrl": "__API_BASE_URL__/v1",
          "envKey": "TOKENHUB_API_KEY"
        }
      ]
    }
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

如果你安裝的版本寫出的 schema 略有不同,先用互動式設定產生一次,再保留相同的 TokenHub 值:Base URL、API key 和模型 ID。

如果工具將 chat、edit、apply 和 fast model 分開,第一次測試先全部使用同一個 TokenHub 模型。確認可用後,再依成本、延遲和推理能力拆分。

臨時環境變數只用於排錯

臨時變數適合確認 Key、網路和模型名。驗證通過後,請把同樣的值寫回上方的持久設定。

export TOKENHUB_API_KEY="sk-..."
export OPENAI_API_KEY="$TOKENHUB_API_KEY"
export OPENAI_BASE_URL="__API_BASE_URL__/v1"
export OPENAI_MODEL="qwen3-coder-plus"

驗證連線

先使用唯讀提示測試,確認模型能讀取上下文且不會改動檔案。成功後再測試編輯、Apply 或 Agent 任務。

閱讀目前專案的 README,請用三句話總結。不要修改任何檔案。

提示成功後,回到 TokenHub 請求記錄確認模型名稱、endpoint、token 用量和計費分組。

常見問題

現象處理方式
401 或驗證失敗確認 TOKENHUB_API_KEY 有效,且保存在同一個 terminal、IDE 或用戶端設定檔中。
404 或找不到模型使用 TokenHub 工作區中存在,且符合所選協議的模型 ID。
endpoint 不正確Base URL 必須與上方一致。OpenAI 相容工具通常需要 /v1;Claude 相容工具通常不需要。
請求逾時檢查到 https://us-api.tokenhub.com 的網路、代理設定,以及工作區 allowlist。
工具使用了其他模型重新檢查 chat、edit、apply、fast 或 autocomplete 等所有模型欄位。

如何選擇推薦模型?

工作負載模型選擇適合原因
複雜任務旗艦推理模型適合規劃、多步驟執行與複雜上下文。
日常使用均衡模型平衡效果、速度與成本。
批次工作快速低成本模型降低摘要與簡單任務成本。
前往模型廣場比較價格和能力

Qwen Code 自訂 API 常見問題解答

為什麼 Qwen Code 仍然以其預設服務啟動?

檢查 security.auth.selectedType 是否為 openai,且活動模型是否出現在 modelProviders.openai 中。

提供者金鑰應該是 tokenhub 還是 openai?

使用目前官方的 modelProviders.openai 配置。 TokenHub透過其baseUrl和envKey連線;不要發明未經驗證的提供者金鑰。

專案設定檔可以包含 TokenHub API 金鑰嗎?

避免它。將 envKey、基本 URL 和模型 ID 保留在共用配置中,同時將實際金鑰儲存在本機環境或秘密管理器中。

如何將 TokenHub 模型加入到 Qwen Code 中?

在~/.qwen/settings.json中的modelProviders.openai下方加入模型,用envKey引用TOKENHUB_API_KEY,並選擇與預設相同的模型。

如何驗證 Qwen Code 代理功能?

從唯讀儲存庫問題開始,並在 TokenHub 日誌中確認請求,然後獨立測試工具呼叫、編輯和命令。

參考資料

本頁設定依據 TokenHub 教學與官方資料,最後驗證日期為 2026-09-04。