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

Qoder はアリババの Agentic IDE です。Code By AI を OpenAI 互換プロバイダーとして追加すると、1 つの Code By AI キーで Claude と GPT モデルを動かせます。

Qoder は Models 設定から BYOK（Bring Your Own Key）モデルを追加できます。カスタムプロバイダーのフォームは OpenAI 互換の base URL を受け付けるため、Code By AI なら 1 つの項目で両方のモデルファミリーを扱えます。GPT の ID は Codex チャネルへ、claude-* の ID は Claude チャネルへ転送され、Claude の料金で課金されます。

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

setup.sh は Qoder を設定しません。BYOK プロバイダーと認証情報は Qoder のアカウントカタログが管理し、Qoder CLI のドキュメントも settings.json に手で書かないよう明記しています。以下の UI 手順を使ってください。

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

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 キーを貼り付けます。
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 で 1 つのプロバイダー項目を使い回せます。使う予定の ID は Model Plaza から追加してください。

Chat Completions API の代わりに Responses API を選んでも base URL は同じです。ゲートウェイは /api/agent/v1/responses もルーティングします。ただし、ほとんどのサードパーティ製 OpenAI 互換クライアントが実装しているのは Chat Completions なので、こちらを既定にするのが安全です。

4. モデルを選ぶ

チャットを開き、モデル選択から新しいモデルを選んで短いリクエストを送ります。正常な返答が来れば、キー、base URL、モデル ID が正しい状態です。

課金

カスタムモデルの通信は Code By AI が課金し、Qoder Credits は消費しません。Qoder の Repo Wiki は独自の固定モデルを使い続けて Credits を消費します。カスタムモデルを追加してもこの動作は変わりません。

トラブルシューティング

• 検証に失敗する — Base URL に /chat/completions が付いていないか、キーの前後に空白がないか、モデル ID が Model Plaza と完全に一致するかを確認します。
• 404 — Base URL が完全なエンドポイントになっているか、/v1 が重複しています。https://www.codebyai.net/api/agent/v1 を使ってください。
• 401 — キーが無効、削除済み、または失効しています。
• 残高不足 — Wallet ページでチャージします。
• Claude モデルの挙動や料金が GPT のようになる — モデル ID が claude- で始まっているか確認してください。ゲートウェイはこの接頭辞でチャネルを選びます。

1 つのモデルには 1 つの経路だけを使ってください。同じモデル ID を Chat Completions と Responses の両方に追加しても、能力は増えず、障害の切り分けだけが難しくなります。