Qoder 自訂模型：Claude 與 GPT

Qoder 是阿里推出的 Agentic IDE；把 Code By AI 加成 OpenAI 相容供應商，就能用一把金鑰跑 Claude 與 GPT 模型。

Qoder 透過 Models 設定支援自備金鑰（BYOK）。自訂供應商表單接受 OpenAI 相容的 base URL，因此 Code By AI 可以用一個項目同時服務兩個模型家族：GPT ID 走 Codex 通道，claude-* ID 會轉往 Claude 通道並依 Claude 價格計費。

一條命令？

setup.sh 不配置 Qoder。它的 BYOK 供應商與憑證由 Qoder 帳號目錄管理，Qoder CLI 文件也明確要求不要寫進 settings.json。請用下面的介面步驟。

1. 建立 Code By AI API Key

登入 Code By AI，打開 API Keys 頁面建立金鑰。金鑰形如 sk-proj-...。

2. 新增自訂供應商

1. 打開 Qoder Settings。
2. 在左側導覽選 Models。
3. 點 Add model。
4. 在 Provider 下選 Custom → OpenAI Compatible，再選 Chat Completions API。
5. Base URL 填入 https://www.codebyai.net/api/agent/v1。
6. 貼上 Code By AI API Key。
7. 填入模型 ID gpt-5.6-terra。
8. 可選填 Display name。
9. 依 Qoder 顯示的欄位設定上下文視窗與能力。不確定就保留預設；只有模型真的支援時才打開 Vision 或 Thinking。
10. 點 Validate and add model。

Qoder 要的是 base URL，不是完整端點。照抄 /api/agent/v1 即可，Chat Completions 路徑由 Qoder 自己接上。

3. 在同一供應商加入 Claude 模型

點 Add Model ID，填入 claude-sonnet-5。同一個 base URL 同時服務兩個家族，所以 Claude 與 GPT 共用一個供應商項目就夠。要用的模型 ID 都可以從 模型廣場 取得。

如果你改選 Responses API，base URL 不用變：閘道也路由 /api/agent/v1/responses。對第三方 OpenAI 相容客戶端來說，Chat Completions API 仍是較安全的預設，因為幾乎每個供應商都實作這個格式。

4. 選模型

開一個對話，在模型選擇器挑選新模型，送出一句簡短請求。能正常回覆，就代表金鑰、base URL 與模型 ID 都正確。

計費

自訂模型的流量由 Code By AI 計費，不扣 Qoder Credits。Qoder 的 Repo Wiki 仍使用它自己的固定模型並消耗 Credits；加入自訂模型不會改變這件事。

疑難排解

• 驗證失敗 — 確認 Base URL 沒有 /chat/completions 後綴、金鑰前後沒有空白，且模型 ID 與模型廣場完全一致。
• 404 — Base URL 填成了完整端點，或 /v1 重複。請用 https://www.codebyai.net/api/agent/v1。
• 401 — 金鑰無效、已刪除或已過期。
• 餘額不足 — 到 Wallet 頁面儲值。
• Claude 模型的行為或價格像 GPT — 確認模型 ID 以 claude- 開頭；閘道靠這個前綴選擇通道。

同一個模型只留一條路徑。把相同模型 ID 同時加在 Chat Completions 與 Responses 下，只會讓問題更難排查，並不會多出能力。