文件

Qoder

獨立版 Qoder 桌面應用程式可在 Provider → Custom 下接受任意 Base URL。填入三個欄位並手動輸入模型 ID，就能透過同一把金鑰讓 Qoder 呼叫 Claude 和 GPT——這些模型都不在它自己的模型目錄中。

Qoder Settings → Models → + Add → Provider → Custom 需要 OpenAI 相容 Base URL、API Key 與手動輸入的 Model IDs — 因此獨立 Qoder 桌面應用程式可連線至 Claude 與 GPT，而這兩者都不在其自身目錄中。

Qoder 設定 → Models → + Add → Provider → Custom

Qoder Settings -> Models -> + Add -> Provider -> Custom

Provider              OpenAI Compatible     <- under "Custom", not a preset
API type              Chat Completions API  <- asked only for OpenAI Compatible
Base URL              https://api.kunavo.com/v1
API Key               sk-kn-...
Model ID              claude-sonnet-5       <- typed by hand
  Add Model ID        claude-opus-5
  Add Model ID        claude-haiku-4-5

Next ->
Display name              Kunavo · Sonnet 5
Supported Context Windows pick from what the model supports
Default Context Window    one of the values picked above
Vision                    on for models that take image input
Thinking Mode             on for reasoning models, then pick effort levels

Validate and Add Model

這是獨立的 Qoder 應用程式，不是 Qoder IDE。「Qoder」是由多款產品組成的系列，且各自有獨立文件；只有獨立桌面應用程式的文件說明了任意端點：其自訂模型頁面在 Custom 下提供 OpenAI Compatible 和 Anthropic Compatible；2026 年 9 月 5 日發布的 0.1.8 版更新說明則介紹：「Personal 方案的 BYOK 現已支援為任何 OpenAI 或 Anthropic 相容模型服務設定自訂 Base URL。」Qoder IDE 的自訂模型頁面只列出具名提供者，完全沒有出現 Base URL 字串。如果你的畫面上沒有此欄位，你使用的可能是另一款 Qoder 產品。

Base URL 要保留 /v1 後綴。Qoder 頁面要求「輸入模型服務提供的確切 Base URL」，並以 https://api.example.com/v1 作為格式範例——因此 OpenAI 相容端點的欄位預期填入 /v1 根路徑，而非只有來源網址。這和 Anthropic 風格的用戶端正好相反；後者需要填入 https://api.kunavo.com，並會自行附加路徑。

Qoder 也提供 Anthropic Compatible 自訂提供者，且 Kunavo 也會回應 /v1/messages。其文件只列出一個 Base URL 範例，沒有說明各協定會附加哪個路徑，因此無法據此判定該類型需要 https://api.kunavo.com 還是 https://api.kunavo.com/v1。上方的 OpenAI 相容路徑符合 Qoder 自己的範例；如果改選 Anthropic 類型，預期需要兩種格式都試試。Qoder 自己的疑難排解清單正是從這點開始：「Base URL 是否完整，以及所選的相容協定和 API 類型是否符合端點」。

Kunavo 尚未在 Qoder 中執行過任何工作階段。此處內容都不是用戶端的執行階段測試：欄位是依據下方日期當時 Qoder 自己的頁面轉錄，endpoint 端則依據 Kunavo 公布的介面。真正進行檢查的是 Validate and Add Model 按鈕；它會在你的電腦上執行，而不是在我們這裡。

還沒有金鑰？建立 Kunavo 帳戶，建立金鑰（以 sk-kn- 開頭），並從 $10 起新增額度——呼叫會從該餘額扣款，失敗的呼叫不會計費。之後儀表板會開啟 Qoder 設定。

逐步操作

在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
開啟 Qoder Settings，在左側導覽選取 Models，然後按一下 + Add。
開啟 Provider，在 Custom 下選擇 OpenAI Compatible——不要選上方的預設 provider。接著選擇 Chat Completions API 作為 API 類型。
輸入 Base URL、API Key 和至少一個 Model ID。Qoder 的文件沒有記載此欄位支援探索模型清單，因此請手動輸入 ID；若要在同一個 endpoint 加入其他模型，請針對每個模型按一下 Add Model ID。
按一下 Next，並設定 Qoder 無法推斷的能力：Display name、Supported Context Windows，以及從這些值中選擇 Default Context Window；若模型支援，還要設定 Vision 和 Thinking Mode 切換鈕。
按一下 Validate and Add Model。Qoder 的模型選取器頁面指出，新增後「此模型即可在任務、代理和自動化的模型選取器中使用」。

已於 2026年9月21日根據獨立版 Qoder 應用程式的自訂模型頁面進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

這是簡短版本。完整指南——模型選擇、實際工作階段費用，以及失敗情況——請參閱 Qoder 與 Claude Code 比較——用的是哪款 Qoder、哪個 endpoint，帳單又如何計算。

除錯用戶端前先驗證

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

# 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 權杖的美元價格，輸入／輸出。

模型 ID	Kunavo 輸入／輸出	它在 Qoder 中的位置
`claude-sonnet-5`	$1.40 / $7.00	供任務和 Agent 選擇器使用的預設工作模型
`claude-opus-5`	$3.50 / $17.50	大型重構；錯誤的計畫會比 token 花費更多
`claude-haiku-4-5`	$0.70 / $3.50	高用量自動化執行；次數是主要成本
`gpt-5-6-sol`	$2.00 / $12.00	使用相同金鑰和相同 endpoint，聽聽不同模型家族的第二意見

計費方式是從預付餘額按權杖計費，沒有月費——請參閱 billing。在重複的上下文中——這是編輯器或聊天用戶端傳送內容的大部分——提示快取對帳單的影響比模型選擇更大。

為什麼你的 Qoder 可能沒有 Base URL 欄位

三種 Qoder 介面都有關於自帶金鑰的文件，但只有一種記載了可自行選擇的 endpoint。這會直接決定你目前使用的介面能否進行上述設定，因此在修改設定檔之前，值得先確認；而 CLI 頁面明確告訴你不要修改設定檔。

介面	文件是否記載自訂 Base URL？	產品自己的頁面如何說明
Qoder（獨立版應用程式）	是	`OpenAI Compatible` 和 `Anthropic Compatible` 位於 Provider 清單的 Custom 之下，並提供 Base URL、API Key，以及手動輸入的 Model ID。請參閱本頁。
Qoder IDE	否	其自訂模型頁面寫道：「適用對象：使用 Individuals 方案的使用者」，並列出多家提供者——Alibaba Cloud Model Studio、DeepSeek、Z.ai、Kimi、MiniMax、Xiaomi MIMO。頁面上沒有出現 `Base URL` 字串。
Qoder CLI	文件頁面未提及	`/model` 下方有一個 Custom 分頁，內含 `Add custom model...`，但該頁面未說明 Base URL，並警告「請勿在 `settings.json` 中手動設定 BYOK」。

CLI 最令人困惑，因為它自己的發布說明和文件內容不一致。2026 年 9 月 11 日發布的 1.1.50 版更新說明指出：「Personal 版使用者現在可透過 Custom 頁面，集中設定及管理使用自訂 URL 端點的 BYOK 模型」，但此後仍保留的自訂模型頁面描述的是目錄：「可用的提供者、模型和憑證欄位，取決於目前帳戶可使用的 BYOK 目錄。」這兩者以及 IDE 頁面都將此功能限於 Individual 方案。因此，當 Custom 分頁不存在或沒有端點欄位時，應確認帳戶的方案和該帳戶目錄提供的項目，而不是檢查設定檔；CLI 頁面明確提醒不要手動修改設定檔，而且設定檔本來就會由目錄重新產生。

常見問題

如何在 Qoder 加入自訂 provider？

在獨立版 Qoder 桌面應用程式中：開啟 Qoder Settings，在左側導覽選取 Models，按一下 + Add，然後開啟 Provider，並在 Custom 下選擇「OpenAI Compatible」或「Anthropic Compatible」。若選擇 OpenAI 類型，還要選擇 Chat Completions API 或 Responses API。輸入 Base URL、API Key 和至少一個 Model ID；若要在同一個 endpoint 加入其他模型，請使用 Add Model ID。按一下 Next，設定 Display name、Supported Context Windows、Default Context Window、Vision 和 Thinking Mode，然後按一下 Validate and Add Model。Qoder 會先驗證連線，再儲存設定。

Qoder 的 Base URL 結尾需要加上 /v1 嗎？

若是 OpenAI 相容端點，需要。Qoder 的自訂模型頁面指示你輸入模型服務提供的確切 Base URL，並以 https://api.example.com/v1 為格式範例，因此欄位需要的是 /v1 根路徑，而非不帶路徑的來源網址；Kunavo 的網址是 https://api.kunavo.com/v1。對於 Anthropic Compatible 類型，頁面沒有另外提供範例，也未說明會附加哪條路由，因此文件無法確定這種情況；請先試 /v1 根路徑，若驗證失敗，再試不帶路徑的來源網址。

為什麼我的 Qoder 沒有 Custom 分頁或 Base URL 欄位？

因為三種 Qoder 介面的自帶金鑰規則各不相同。只有獨立版 Qoder 桌面應用程式的文件記載了可自訂任意 Base URL。Qoder IDE 的自訂模型頁面只列出具名 provider，完全沒有提到 Base URL；Qoder CLI 的頁面則指出，可用的 provider、模型和憑證欄位取決於目前帳戶可使用的 BYOK 模型目錄。IDE 和 CLI 的頁面也都限制此功能僅適用於 Individual 方案。若找不到該欄位，請確認目前開啟的是哪款 Qoder 產品，以及帳戶方案和模型目錄允許哪些設定——CLI 頁面特別提醒，不要在 settings.json 中手動設定 BYOK。

Qoder 能在沒有 Anthropic 帳戶的情況下使用 Claude 模型嗎？

可以透過自訂 provider 使用——Qoder 內建模型目錄則是另一回事。它的模型選擇器頁面列出 Qwen、DeepSeek、GLM、Kimi 和 MiniMax 模型，沒有列出 Claude、GPT 或 Gemini 模型，因此文件所述使用這些模型的方法是自帶金鑰。「OpenAI Compatible」在此指的是線上通訊協定選擇，而非供應商選擇：你輸入的 Model ID 會由已設定的 Base URL 解析，只要 endpoint 提供該模型，就能使用 Claude ID；而你持有的憑證屬於該 endpoint，而非 Anthropic。

在 Qoder 中使用自訂模型，仍會消耗 Qoder Credits 嗎？

Qoder 的自訂模型頁面指出，自訂模型費用會直接向你的 provider API 帳戶收取，不會使用 Qoder Credits；但 Repo Wiki 是例外，因為它使用固定模型並以不同方式計費，產生內容時會顯示提示。Kunavo 端的費用則按 token 計算，從預付餘額扣除，沒有月費。另請注意，Qoder 僅能透過已儲存自訂模型上的 Edit 操作更新 API 金鑰；若要變更 Base URL，必須刪除現有項目並重新新增。

Kunavo 在 Qoder 中測試過這項設定嗎？

沒有。Kunavo 尚未在任何 Qoder 介面中執行過工作階段，而本頁也不是執行階段相容性報告：欄位名稱及其順序是依據頁面所示日期當時 Qoder 自己的自訂模型頁面轉錄，endpoint 端則依據 Kunavo 公布的 API。實際檢查應在你的電腦上進行——Qoder 的 Validate and Add Model 按鈕會在儲存前，一併測試 Base URL、金鑰和 Model ID；使用相同的 base URL 和金鑰執行一般 curl，也能確認失敗問題來自 endpoint 還是用戶端。