Trae 自訂模型：Claude 與 GPT

Trae 是字節跳動的 AI IDE；它的自訂模型表單接受 OpenAI 相容端點，所以一把 Code By AI 金鑰就能跑 Claude 與 GPT。

Trae 內建多個模型，也提供 自訂配置 接入第三方端點。表單要求 API 格式、請求位址、模型 ID 與鑑權資訊，正好可以把 IDE 指向 Code By AI，而不改變 Agent 的工作方式。

一條命令？

setup.sh 不配置 Trae。Trae 把自訂模型存在應用程式內部，沒有公開可編輯的設定檔，腳本無法安全修改。請用下面的步驟。

1. 建立 Code By AI API Key

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

2. 打開模型設定

在 Trae 打開 設定 → 模型，點 新增模型。對話中的模型選擇器也能進入同一個模型管理介面。

3. 新增自訂配置

1. 選擇 自訂配置。
2. API 格式 選 OpenAI Chat Completions。
3. 自訂請求位址 填 https://www.codebyai.net/api/agent/v1。
4. 保持 完整 URL 關閉。Trae 會自行接上 /chat/completions；若打開這個開關，請改填完整位址 https://www.codebyai.net/api/agent/v1/chat/completions。
5. 貼上 Code By AI API Key。
6. 模型 ID 填 gpt-5.6-terra。
7. 儲存模型，並在對話的模型選擇器選取它。

4. 新增 Claude

再新增一個自訂配置，位址與金鑰相同，模型 ID 改成 claude-sonnet-5。閘道會把 claude-* ID 轉往 Claude 通道並依 Claude 價格計費，兩個家族共用一個端點。

在 SOLO 裡，選自訂模型前請先關掉 AUTO；否則 Agent 可能繼續路由到內建模型。

5. 驗證

開一個新對話送出簡短請求。能正常回覆，就代表位址、金鑰與模型 ID 都正確。模型沒出現時，重新打開模型管理介面，確認自訂項目已儲存並啟用。

疑難排解

• 404 — 請求位址與 完整 URL 開關不一致：要嘛關閉開關填 base URL，要嘛打開開關填完整的 /chat/completions。不要混用。
• 401／金鑰無效 — 金鑰前後有空白、已被刪除或已過期。到 API Keys 頁面重新建立。
• 餘額不足 — 到 Wallet 頁面儲值。
• 模型選擇器裡找不到模型 — 自訂項目沒有存到，或 SOLO 裡的 AUTO 還開著。
• 工具呼叫失敗 — 從 模型廣場 挑一個支援工具呼叫的 agentic 模型 ID。閘道兩個家族都走 Chat Completions，但模型本身仍必須支援工具。