CodeBuddy IDE の設定

CodeBuddy IDE は AI Agent とコーディング支援のツールです。ローカルのモデル設定ファイルでカスタムモデルを追加できるため、OpenAI 互換の Chat Completions API 経由で InOneAPI に接続できます。

1. 事前準備

  1. CodeBuddy IDE をインストールしてサインインします。
  2. プロジェクトディレクトリを一度開き、アプリにローカルの設定ディレクトリを作成させます。
  3. InOneAPI コンソールで API キーを作成し、モデル詳細ページのモデル ID をそのままコピーします。YOUR_MODEL_ID はドキュメント上のプレースホルダーです。

モデル詳細ページの Agent ツール入口では、キーとモデル ID を入力済みの完全な設定内容をそのまま生成できます。

2. ローカルのモデルを設定する

ユーザーレベルの設定ファイルを作成または編集します：

  • macOS / Linux：~/.codebuddy/models.json
  • Windows：C:\Users\<ユーザー名>\.codebuddy\models.json

特定のプロジェクトにだけ反映したい場合は、プロジェクトレベルの設定ファイル <プロジェクト>/.codebuddy/models.json を作成できます。

次の設定を記述します：

{
  "models": [
    {
      "id": "YOUR_MODEL_ID",
      "name": "YOUR_MODEL_ID",
      "vendor": "InOneAPI",
      "url": "https://api.inoneapi.com/v1/chat/completions",
      "apiKey": "ioa_sk_...",
      "supportsToolCall": true,
      "supportsImages": false
    }
  ],
  "availableModels": [
    "YOUR_MODEL_ID"
  ]
}

models 配列をマージする際は他の項目を保持します。availableModels は表示用の許可一覧です。既存の項目がある場合は現在の ID を追加し、元の一覧を上書きしないでください。

フィールドの説明：

  • url は完全な Chat Completions エンドポイントで、/v1/chat/completions を含める必要があります。
  • id はモデル詳細ページのモデル ID をそのまま指定します。表示名だけでは指定できません。
  • maxInputTokens と maxOutputTokens は任意で、モデルの実上限が明らかな場合のみ設定します。ページ側で 128K / 8192 を推定することはありません。
  • supportsToolCall と supportsImages はモデルの実機能に合わせて指定し、非対応なら false に変更します。

models.json は BOM なし UTF-8 で保存してください。一部のデスクトップ版では、UTF-8 の BOM から始まる JSON を読むとローカル モデル設定の読み込みに失敗することがあります。

apiKey は公式のフィールド説明どおりに実際のキー値を指定します。${INONEAPI_API_KEY} のような、文書でサポートされていない置換記法は使えません。

3. 保存してモデルを選ぶ

  1. ファイルを保存します。公式は約 1 秒のデバウンス付きホットリロードに対応しているため、反映されない場合に限り再起動してください。
  2. モデルピッカーで追加したモデル名を選択します。

4. 任意：API キーを確認する

macOS / Linux ではターミナルでキーとモデル ID が利用可能か確認できます：

curl https://api.inoneapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ioa_sk_..." \
  -d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"hi"}],"stream":false}'

リクエストが成功すれば、API キーとモデル ID の両方が利用可能です。

よくある問題

  • Authentication Fails または 401：apiKey が実際の InOneAPI API キーかを確認します。エンドポイント URL を API キー欄に入力しないでください。
  • モデルが見つからない、または 404：id がモデル詳細ページのモデル ID と完全に一致するか確認します。
  • ローカル モデル設定の読み込みに失敗する：models.json が妥当な JSON か、BOM なし UTF-8 で保存されているかを確認します。
  • モデルピッカーに表示されない：CodeBuddy IDE を完全に再起動し、ファイルが .codebuddy/models.json にあることを確認します。

本番利用では CodeBuddy IDE 専用のサブキーを作成し、予算・利用モデル・アラートを設定します。チームキーと利用量を参照してください。

このページは CodeBuddy IDE 用で、CodeBuddy CLI やすべてのプラグイン版には適用されません。WorkBuddy は画面での設定ガイドを参照してください。

公式リファレンス：CodeBuddy IDE models.json。

CodeBuddy IDE · ドキュメント · InOneAPI