什麼是 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 URL | https://us-api.tokenhub.com/v1 |
| API Key | TOKENHUB_API_KEY 的值 |
| 模型 | qwen3-coder-plus 或其他 TokenHub 模型 ID |
設定檔位置
| 欄位 | 填寫值 |
|---|---|
| User config | ~/.qwen/settings.json |
| Project config | .qwen/settings.json |
| Provider fields | modelProviders.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。