# Codex CLI

出典: https://docs.aicentos.com/ja/clients/codex-cli

Language: ja

> Codex CLI で aicentos を使う —— config.toml の model_providers を手動設定

Codex CLI は OpenAI 公式のコマンドライン用コーディングエージェントで、`~/.codex/config.toml` でモデルプロバイダーを定義します。カスタム provider を aicentos に向ければ、ターミナル内で aicentos が接続しているモデルを利用できます。

複数の設定を GUI で管理したい場合は、[CC Switch](https://docs.aicentos.com/ja/clients/cc-switch) でワンクリック切り替えもできます。本記事では手動設定のみを扱います。

## 準備

まずコンソールの「API キー」ページで、Codex CLI 専用のキーを作成してください（名前は `codex-cli` のようにすると使用量の追跡に便利です）：

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

Codex CLI がインストール済みか確認します：

```bash
codex --version
```

## 設定値

| 項目           | 値                         |
| ------------ | ------------------------- |
| Provider ID  | `aicentos`                |
| Provider 名   | `aicentos`                |
| API Key 環境変数 | `AICENTOS_API_KEY`        |
| Base URL     | `https://aicentos.com/v1` |
| モデル          | コンソール「モデル広場」のモデル名         |

## 設定手順

### 1. API Key 環境変数の設定

```bash
export AICENTOS_API_KEY="sk-あなたの-API-Key"
```

永続化するには `~/.zshrc` または `~/.bashrc` に書き込み、`source` で反映させ、`echo $AICENTOS_API_KEY` で確認します。

### 2. config.toml の編集

`~/.codex/config.toml` に次を追加します：

```toml
model = "あなたのモデル名"
model_provider = "aicentos"

[model_providers.aicentos]
name = "aicentos"
base_url = "https://aicentos.com/v1"
env_key = "AICENTOS_API_KEY"
wire_api = "responses"
```

`あなたのモデル名` はコンソール「モデル広場」に表示されているモデル名に置き換えてください。[対応モデル](https://docs.aicentos.com/ja/billing/models-list) を参考にできます。

### 3. Codex の起動

```bash
codex
```

簡単なリクエストを 1 つ送り、provider が正常に動作していることを確認します。

## テスト

```
codex exec "1+1 はいくつですか？一文で答えてください"
```

内容が正常に返れば接続成功です。返ってきた内容に応じて少量のクレジットを消費します。コンソールの使用量ログで確認できます。

## 注意事項

* **Base URL は `/v1` までにしてください**。`/v1/chat/completions` までの完全なパスにしないでください。
* `base_url`、`env_key` などのフィールドはユーザーレベルの `~/.codex/config.toml` でのみ有効です。プロジェクト内の `.codex/config.toml` に書いても無視され、起動時の警告が出ることがあります。
* `wire_api` には `responses` を指定します。aicentos の [Responses インターフェース](https://docs.aicentos.com/ja/api/chat/openai/responses) に対応します。公式ドキュメントでは現時点でこの値のみサポートされています。バージョンによって `unknown variant` エラーが出る場合は CLI が古すぎるので、先にアップグレードしてください。
* `openai`、`ollama`、`lmstudio` は予約済みの provider ID です。内蔵 `openai` の base\_url を書き換えてサードパーティのゲートウェイに向けることは**できません**。新しい provider 名を起ち上げる必要があります（本記事では `aicentos` を使用しています）。
* 切り分けの順序：モデル名がコンソールと一致しているか → Base URL が `/v1` までか → 環境変数が **codex を起動したターミナル**から見えているか → アカウント残高は十分か。

## 関連リンク

* [Codex への接続（CC Switch 方式）](https://docs.aicentos.com/ja/clients/codex)