# Codex

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

Language: ja

> Codex で aicentos を使う —— CC Switch ワンクリックインポート、または config.toml の手動設定

Codex は OpenAI プロトコルと互換性があるため、モデルプロバイダーを aicentos に向けるだけで、aicentos が接続しているすべてのモデルを利用できます。

接続方法は 2 種類あります：**CC Switch で一括管理する**（推奨）か、**config.toml を手動編集する**かのどちらかです。

## 方法 1：CC Switch を使う（推奨）

CC Switch は Codex の Provider 設定も管理でき、複数の設定をワンクリックで切り替えられます。

詳しくは [CC Switch への接続 →](https://docs.aicentos.com/ja/clients/cc-switch) をご覧ください。

## 方法 2：手動設定

### 準備

| 項目           | 値                         |
| ------------ | ------------------------- |
| Provider ID  | `aicentos`                |
| Provider 名   | `aicentos`                |
| Base URL     | `https://aicentos.com/v1` |
| API Key 環境変数 | `AICENTOS_API_KEY`        |

まずコンソールの「API Key」ページで専用のキーを作成します。名前に `codex` を含めると使用量の追跡に便利です。

### API Key の設定

ターミナルで環境変数を設定します：

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

永続化するには `~/.zshrc` または `~/.bashrc` に追加し、再読み込みします：

```bash
source ~/.zshrc
```

変数が有効になっているか確認します：

```bash
echo $AICENTOS_API_KEY
```

### Codex Provider の設定

`~/.codex/config.toml` を編集し、次を追加します：

```bash
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) を参考にできます。

### Codex の起動

```bash
codex
```

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

## トラブルシューティング

リクエストが失敗したときは、Codex のターミナル出力とコンソールの使用量ログを見比べて原因を調べます。よくある原因：

* モデル名の書き間違い（モデル広場を基準にしてください）。
* Base URL の形式が不正（`/v1` まで入力し、それ以上のパスを追加しないでください）。
* 環境変数が現在のターミナルで読み込まれていない（ターミナルを開き直すか、設定ファイルを `source` します）。