Skip to Content
aicentos
クライアント接続

CodeBuddy

CodeBuddy（IDE / CLI）で models.json を通じて aicentos の OpenAI 互換エンドポイントに接続

最終更新:

CodeBuddy はカスタムモデルに対応しており、ユーザーレベルまたはプロジェクトレベルの models.json を通じてリクエストを aicentos の OpenAI 互換エンドポイントに向けることができます。IDE と CodeBuddy Code CLI は同じ設定を共有します。

準備

まずコンソールの「API キー」ページで、CodeBuddy 専用のキーを作成してください（名前は codebuddy のようにすることをおすすめします）。

設定値

項目値
Base URLhttps://aicentos.com/v1
エンドポイント URL（url フィールド）https://aicentos.com/v1/chat/completions
API Key（apiKey）コンソールで作成したキー
モデル ID（id）コンソール「モデル広場」のモデル名
supportsToolCalltrue
maxInputTokens / maxOutputTokens選択したモデルに応じて設定

注意：models.json の url フィールドは完全な API パスが要求され、/chat/completions で終わる必要があります。

設定手順

  • CodeBuddy を一度開き、設定ディレクトリを生成させます。
  • ユーザーレベルの設定ファイルを新規作成または編集します：
    • macOS / Linux：~/.codebuddy/models.json
    • Windows：C:\Users\<ユーザー名>\.codebuddy\models.json
    • 単一のプロジェクトにだけ適用したい場合は、プロジェクトレベルの <プロジェクトルート>/.codebuddy/models.json を使えます。ユーザーレベルより優先度が高くなります。
  • 次の内容を書き込み、id をコンソールで利用可能だと確認できたモデル名に置き換えます：
{
  "models": [
    {
      "id": "gpt-5",
      "name": "GPT-5 (aicentos)",
      "vendor": "aicentos",
      "apiKey": "${AICENTOS_API_KEY}",
      "url": "https://aicentos.com/v1/chat/completions",
      "maxInputTokens": 128000,
      "maxOutputTokens": 16384,
      "supportsToolCall": true,
      "supportsImages": false,
      "supportsReasoning": false
    }
  ]
}
  • 環境変数を設定します（apiKey と url はどちらも ${VAR_NAME} 参照に対応しています）：
export AICENTOS_API_KEY="sk-あなたのaicentosキー"
  • CodeBuddy を完全に終了してから開き直します（IDE パネルの再起動で OK です）。
  • モデルセレクターで先ほど設定したモデルを選択します。

ファイルを編集したくない場合は、CodeBuddy IDE のチャットパネルの下でモデル選択ボックスをクリック → カスタムモデルを設定 → プロバイダーで Custom を選び、Base URL に https://aicentos.com/v1 を入力し、API Key とモデル名を入力することでも設定できます。

テスト

保存後、新しい会話またはコーディングタスクを作成し、まず簡単なプロンプトで軽量テストを行い、内容が正常に返ることを確認してから本格的に使い始めてください。

注意事項

  • 現時点で対応しているのは OpenAI インターフェース形式の API のみです。
  • url は必ず完全な /v1/chat/completions パスで書いてください。https://aicentos.com/v1 と書いても効果がありません。
  • 最外層は必ず {"models": [...]} 構造にします。models は必須のトップレベルフィールドです。
  • availableModels はホワイトリストです。一度記入すると、モデルのドロップダウンにはリスト内のモデルだけが表示され、内蔵モデルも一緒に消えます。制限が必要ない場合はこのフィールドを省略してください。
  • ファイルは必ず UTF-8 (BOM なし) で保存してください。BOM 付きの JSON ではローカルモデル設定の読み込みに失敗します。
  • 環境変数は起動時に解決されます。変数が存在しない場合、設定ファイル内の ${AICENTOS_API_KEY} はそのまま残り、呼び出しに失敗します。
  • models.json の権限は 600 にし、バージョン管理にコミットしないことをおすすめします。
  • CLI は環境変数方式でも設定できます：CODEBUDDY_API_KEY、CODEBUDDY_BASE_URL、CODEBUDDY_MODEL。CODEBUDDY_BASE_URL を直接設定するときは /chat/completions を付けないでください。CLI が自動で追加します。
  • 詳細はドキュメントサイトをご覧ください：https://docs.aicentos.com

GitHub Copilot

GitHub Copilot Chat の BYOK（キー持ち込み）で aicentos の OpenAI 互換エンドポイントに接続する

Codebuff

Codebuff のコマンドラインエージェントで aicentos の OpenAI 互換エンドポイントに接続する

このページの内容

準備設定値設定手順テスト注意事項