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

WorkBuddy はテンセントクラウドのデスクトップ AI Agent です。カスタムモデルのエンドポイントを Code By AI に向けると、1 つのキーで Claude と GPT モデルを動かせます。

WorkBuddy は複数のモデルを内蔵し、カスタムの OpenAI 互換エンドポイントも受け付けます。カスタム項目には完全な Chat Completions URL を入力するため、Code By AI ゲートウェイとそのまま噛み合います。設定と API キーはローカルに保存されます。

コマンド 1 つで設定（macOS / Linux）

先に WorkBuddy を完全に終了してから実行します。

Copy
1
curl -fsSL https://www.codebyai.net/setup.sh | sh -s -- --workbuddy

API キーを非表示入力で尋ね、~/.workbuddy/models.json に gpt-5.6-terra と claude-sonnet-5 を追加し、元ファイルをバックアップして所有者のみ読み書きできる権限にします。再実行でキーを更新でき、| sh -s -- --uninstall で元に戻せます。完了後に WorkBuddy を再起動し、モデル選択からカスタムモデルを選んでください。以下の手動ステップも同じことを行います。

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

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

2. カスタムモデル設定を開く

次のどちらかを使います。

• Settings → Model → Custom models
• 会話画面下部のモデル切り替え → + Configure Custom Model

3. GPT モデルを追加する

Add Model ページで Custom / 自定义 を選び、次を入力します。

• Endpoint / 接口地址: https://www.codebyai.net/api/agent/v1/chat/completions
• API Key: Code By AI のキー
• Model name / 模型名称: gpt-5.6-terra
• Capabilities: 選択したモデルが対応している場合だけ、tool calling、画像入力、reasoning を有効にします。Agent タスクで使うカスタムモデルには tool calling が必要です。

保存して設定が反映されるまで待ちます。WorkBuddy はモデルごとに 1 レコードを作るため、Claude は同じフォームに ID を足すのではなく、2 つ目のレコードとして追加します。

4. Claude モデルを追加する

同じエンドポイントとキーで別のカスタムモデルを追加し、モデル名を claude-sonnet-5 にします。Code By AI の Chat Completions エンドポイントは両方のファミリーを受け付けます。GPT の ID は Codex チャネルへ、claude-* の ID は Claude チャネルへ転送され、Claude の料金で課金されます。

5. モデルを選ぶ

会話に戻り、モデル選択からカスタムモデルを選びます。短いリクエストを送れば、エンドポイント、キー、モデル ID を確認できます。GPT と Claude の項目は同じ選択画面で切り替えられます。

エンドポイントの詳細

WorkBuddy が求めるのは base URL ではなく完全な Chat Completions URL です。/api/agent/v1/chat/completions を省略しないでください。既定のプロトコル設定では、WorkBuddy がアドレスを検証し、欠けていれば標準の /chat/completions を補完します。アドレスが拒否される場合や /chat/completions が二重に付く場合は、詳細設定で Custom Protocol / 自定义协议 をオンにします。このスイッチは入力した URL をそのまま使い、パスの検証と補完をスキップします。

課金とプライバシー

カスタムモデルの利用は Code By AI が課金し、WorkBuddy のクレジットは消費しません。エンドポイント、キー、モデル一覧はローカルの models.json に保存され、クラウドへアップロードされません。WorkBuddy は会話を設定したエンドポイントへ転送するため、その通信には Code By AI の利用規約とプライバシーポリシーが適用されます。

トラブルシューティング

• 404 — エンドポイントに /v1/chat/completions がない、誤字がある、または WorkBuddy がパスを追加しています。このページの URL をそのまま使い、パスが書き換わる場合は Custom Protocol を有効にします。
• 401 / キーが無効 — キーの前後に空白があるか、削除・失効しています。API Keys ページで新しいキーを作成してください。
• 残高不足 — Wallet ページでチャージします。
• Agent がファイルを編集したりコマンドを実行できない — そのカスタムモデルで tool calling が無効です。設定を開き直して有効にしてください。
• モデルは答えるが Agent ループに入らない — モデル ID がファミリーと一致していない可能性があります。Model Plaza で完全な ID を確認してください。