CodeBuddy のカスタムモデル:Claude と GPT
このガイドには API キーが必要です
アカウントを作成して約 1 分でキーを発行し、以下の手順でキーが必要な箇所に貼り付けてください。
登録にカード不要 · API 利用にはチャージが必要です
CodeBuddy はテンセントクラウドの AI コードエディターです。models.json が完全な OpenAI 互換エンドポイントを受け付けるので、1 つの Code By AI キーで Claude と GPT を扱えます。
CodeBuddy は ~/.codebuddy/models.json(ユーザーレベル)または <workspace>/.codebuddy/models.json(プロジェクトレベル)からカスタムモデルを読みます。同じ id のプロジェクト項目がユーザー項目を上書きし、保存から約 1 秒でホットリロードされます。
コマンド 1 つで設定(macOS / Linux)
1 curl -fsSL https://www.codebyai.net/setup.sh | sh -s -- --codebuddy
API キーを非表示入力で尋ね、ユーザーレベルの ~/.codebuddy/models.json に gpt-5.6-terra と claude-sonnet-5 を追加し、元ファイルをバックアップして所有者のみ読み書きできる権限にします。CodeBuddy はこのファイルを自動で再読み込みするので、モデル選択からどちらかを選んでください。再実行でキーを更新でき、| sh -s -- --uninstall で元に戻せます。同じ id を定義したプロジェクトレベルの .codebuddy/models.json は、引き続きこれらの項目より優先されます。CodeBuddy のプラグイン版は models.json を読まないため、IDE か CLI を使ってください。以下の手動ステップも同じことを行います。
1. Code By AI API キーを作成する
Code By AI にサインインし、API Keys ページでキーを作成します。形式は sk-proj-... です。
2. models.json を編集する
~/.codebuddy/models.json を開き、既存のオブジェクトに次をマージします。既存のモデルは残してください。
1 {2 "models": [3 {4 "id": "gpt-5.6-terra",5 "name": "CodeByAI GPT",6 "vendor": "Custom",7 "url": "https://www.codebyai.net/api/agent/v1/chat/completions",8 "apiKey": "sk-proj-xxxx",9 "maxInputTokens": 200000,10 "maxOutputTokens": 65536,11 "supportsToolCall": true,12 "supportsImages": false,13 "supportsReasoning": false14 },15 {16 "id": "claude-sonnet-5",17 "name": "CodeByAI Claude",18 "vendor": "Custom",19 "url": "https://www.codebyai.net/api/agent/v1/chat/completions",20 "apiKey": "sk-proj-xxxx",21 "maxInputTokens": 200000,22 "maxOutputTokens": 65536,23 "supportsToolCall": true,24 "supportsImages": false,25 "supportsReasoning": false26 }27 ]28 }
CodeBuddy は OpenAI インターフェース形式のみに対応するため、url は完全な Chat Completions パスにする必要があります。Claude ID も使えます。ゲートウェイが claude-* を Claude チャネルへ転送し、Claude の料金で課金します。
3. モデルを選ぶ
ファイルを保存します。CodeBuddy は自動で再読み込みするので、モデル選択から CodeByAI GPT か CodeByAI Claude を選びます。availableModels を管理している場合は両方の ID を追加してください。空でないリストにないモデルは表示されません。
モデルのフィールド
maxInputTokensとmaxOutputTokensはモデルの実際の上限に合わせます。ゲートウェイのモデルは 200,000 と 65,536 を使います。- Agent タスクでは
supportsToolCallをtrueのままにします。 supportsImagesとsupportsReasoningは任意です。モデルが画像入力や推論パラメーターに対応する場合だけ有効にします。
トラブルシューティング
404—urlが base URL になっているか、末尾が/chat/completionsではありません。完全なhttps://www.codebyai.net/api/agent/v1/chat/completionsを使ってください。401/ キーが無効 — キーの前後に空白があるか、削除・失効しています。API Keys ページで新しいキーを作成してください。- 残高不足 — Wallet ページでチャージします。
- モデルが表示されない — 空でない
availableModelsに ID がないか、リスト自体を削除してください。 - ファイルが反映されない — 無効な JSON はリロードを止めます。CodeBuddy のファイルは純粋な JSON なので、コメントと末尾のカンマを削除してください。
はじめに
最初のリクエストまでの 4 ステップ
- 01
無料アカウントを作成
Google、GitHub、またはメールアドレスとパスワードで登録できます。カードは不要です。
- 02
API キーを生成
ダッシュボードでキーをワンクリック作成し、CLI から Code By AI に認証します。
- 03
残高をチャージ
最初のリクエストの前に残高を追加します。利用分はトークン単位で残高から引かれます。
- 04
CLI の接続先を Code By AI に設定
base URL の環境変数を 1 つ設定するか、config.toml に model provider ブロックを追加します。各エージェントの正確な記述は設定ガイドにまとまっています。