# CodeBuddy

出典: https://docs.aicentos.com/ja/clients/codebuddy

Language: ja

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

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

## 準備

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

* コンソール：[https://aicentos.com](https://aicentos.com)
* キーの作成：[https://aicentos.com/keys](https://aicentos.com/keys)
* ウォレットのチャージ：[https://aicentos.com/wallet](https://aicentos.com/wallet)

## 設定値

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

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

## 設定手順

* CodeBuddy を一度開き、設定ディレクトリを生成させます。
* ユーザーレベルの設定ファイルを新規作成または編集します：
  * macOS / Linux：`~/.codebuddy/models.json`
  * Windows：`C:\Users\<ユーザー名>\.codebuddy\models.json`
  * 単一のプロジェクトにだけ適用したい場合は、プロジェクトレベルの `<プロジェクトルート>/.codebuddy/models.json` を使えます。ユーザーレベルより優先度が高くなります。
* 次の内容を書き込み、`id` をコンソールで利用可能だと確認できたモデル名に置き換えます：

```json
{
  "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}` 参照に対応しています）：

```bash
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](https://docs.aicentos.com)