Trae のカスタムモデル：Claude と GPT

Trae は ByteDance の AI IDE です。カスタムモデルのフォームが OpenAI 互換エンドポイントを受け付けるので、1 つの Code By AI キーで Claude と GPT を扱えます。

Trae は複数のモデルを内蔵し、サードパーティのエンドポイント用に カスタム設定 を用意しています。API 形式、リクエスト URL、モデル ID、認証情報を入力できるため、Agent の動作を変えずに IDE を Code By AI に向けられます。

コマンド 1 つで設定できますか？

setup.sh は Trae を設定しません。Trae はカスタムモデルをアプリ内部に保存しており、編集用のファイルを公開していないため、スクリプトから安全に変更できません。以下の手順を使ってください。

1. Code By AI API キーを作成する

Code By AI にサインインし、API Keys ページでキーを作成します。形式は sk-proj-... です。

2. モデル設定を開く

Trae の Settings → Models を開き、Add model をクリックします。チャットのモデル選択からも同じモデル管理画面に入れます。

3. カスタム設定を追加する

1. Custom configuration を選びます。
2. API format を OpenAI Chat Completions にします。
3. Request URL に https://www.codebyai.net/api/agent/v1 を入力します。
4. Full URL はオフのままにします。Trae が /chat/completions を追加します。オンにする場合は完全な https://www.codebyai.net/api/agent/v1/chat/completions を入力してください。
5. Code By AI の API キーを貼り付けます。
6. モデル ID に gpt-5.6-terra を入力します。
7. 保存し、チャットのモデル選択で選びます。

4. Claude を追加する

同じ URL とキーで 2 つ目のカスタム設定を追加し、モデル ID を claude-sonnet-5 にします。ゲートウェイは claude-* ID を Claude チャネルへ転送し、Claude の料金で課金します。

SOLO では、カスタムモデルを選ぶ前に AUTO をオフにしてください。オンのままだと内蔵モデルへルーティングされ続けることがあります。

5. 確認する

新しいチャットで短いリクエストを送ります。正常な応答が来れば、URL、キー、モデル ID が一致しています。モデルが表示されない場合は、モデル管理画面を開き直し、カスタム項目が保存・有効化されているか確認してください。

トラブルシューティング

• 404 — リクエスト URL と Full URL スイッチが食い違っています。スイッチをオフにして base URL を入れるか、オンにして完全な /chat/completions を入れてください。混在させないでください。
• 401 / キーが無効 — キーの前後に空白があるか、削除・失効しています。API Keys ページで新しいキーを作成してください。
• 残高不足 — Wallet ページでチャージします。
• モデル選択に表示されない — カスタム項目が保存されていないか、SOLO の AUTO がオンのままです。
• ツール呼び出しが失敗する — Model Plaza からツール呼び出しに対応する agentic モデル ID を選んでください。ゲートウェイは両ファミリーを Chat Completions で扱いますが、モデル自体の対応は必要です。