# Codebuff

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

Language: ja

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

Codebuff はターミナル上で動く AI コーディングエージェントで、タスクに応じて複数のサブエージェントを投入してコードの読み取り、計画の作成、ファイルの変更を行います。デフォルトでは公式のホスト型サービスに接続します。お使いのバージョンが OpenAI 互換エンドポイントの上書きに対応していれば、環境変数でリクエストを aicentos に向けることができます。

## まずバージョンがカスタムエンドポイントに対応しているか確認する

Codebuff の公式推奨はホスト型モードです：ログインして公式クレジットを使うか、`CODEBUFF_API_KEY` で公式 API を利用します。カスタム Base URL はすべてのバージョンで提供されているわけではないため、先に確認してください：

* `codebuff --help` を実行し、`--base-url` や `--provider` のようなオプションがあるか確認します。
* `OPENAI_BASE_URL`（一部のバージョンでは `CODEBUFF_BASE_URL`）を読み取ってエンドポイントを上書きするか確認します。
* どちらも対応していない場合、そのバージョンは公式サービスしか使えず、aicentos に直接接続することはできません。

## 準備

バージョンがカスタムエンドポイントに対応していることを確認したら、まずコンソールの「API Key」ページで Codebuff 専用のキーを作成します（名前は `codebuff-cli` のようにするとよいでしょう）。

* コンソール：[https://aicentos.com](https://aicentos.com)
* キーの作成：[https://aicentos.com/keys](https://aicentos.com/keys)
* 残高不足のときのチャージ：[https://aicentos.com/wallet](https://aicentos.com/wallet)

あわせて、Node.js がインストール済みで、Codebuff がグローバルインストールされていることを確認します：

```bash
npm install -g codebuff
```

## 設定値

| 項目       | 値                         |
| -------- | ------------------------- |
| Base URL | `https://aicentos.com/v1` |
| API Key  | コンソールで作成したキー              |
| モデル      | コンソール「モデル広場」のモデル名         |

## 設定手順

* エンドポイントとキーを shell 設定（`~/.zshrc` または `~/.bashrc`）に書き込みます：

```bash
export OPENAI_API_KEY="sk-あなたのaicentosキー"
export OPENAI_BASE_URL="https://aicentos.com/v1"
```

* 設定を再読み込みします：`source ~/.zshrc`。
* プロジェクトディレクトリに移動し、`codebuff` をそのまま実行します。
* バージョンが `--model` 引数に対応していれば、起動時にモデルを明示指定できます。対応していない場合は、対話画面のモデル選択コマンドで切り替えます。

一部のバージョンでは、設定をユーザー設定ディレクトリ以下の JSON ファイルに書きます（認証情報ファイルのデフォルト権限は `600` で、バージョン管理にコミットしないでください）。環境変数ではなく設定ファイルを使うバージョンの場合は、`codebuff --help` や公式ドキュメントに示されたフィールド名に従って、同じ Base URL とキーを入力してください。

## テスト

起動後、まず簡単なプロンプトで軽くテストします。たとえばファイルを 1 つ読ませて内容を要約させ、結果が正常に返ることを確認してから本格的に使い始めます。

## 注意事項

* カスタムエンドポイントは上級者向けの使い方で、フィールド名はバージョンによって異なる場合があります。お使いの環境の `codebuff --help` 出力を基準にしてください。
* `OPENAI_BASE_URL` は `https://aicentos.com/v1` まで入力し、`/v1/chat/completions` の完全なパスに補わないでください。
* Codebuff はコード片やターミナル出力をコンテキストとして送信します。利用前に、所属チームのデータコンプライアンス要件に合致するか確認してください。
* エラーが出たときは、順に確認します：環境変数が現在のターミナルで有効か、モデル名がコンソールと一致しているか、アカウントの残高が十分か（[https://aicentos.com/wallet）。](https://aicentos.com/wallet）。)
* 詳しくはドキュメントサイトをご覧ください：[https://docs.aicentos.com](https://docs.aicentos.com)