# 独自のAPIキーでOpenAI Codex CLIを使用する方法

> Zeabur AI HubでCodex CLIの可能性を引き出す

<AIHubShutdownNotice />



**Codex CLI**は、ターミナルでAIと対話するための強力なインターフェースです。しかし、単一のプロバイダーに縛られることは、あなたの可能性を制限することになります。

Codex CLIを[**Zeabur AI Hub**](https://zeabur.com/ai-hub)に接続することで、まったく同じツールを使用して、クエリを**あらゆるトップレベルのモデル**（Claude、Grok、Geminiなど）にルーティングできます。この設定は**従量課金制（pay-as-you-go）**で機能するため、異なるAIプロバイダーのために複数のサブスクリプションを管理する必要はありません。

セットアップ方法は以下の通りです。

## 🧱 前提条件

1. **Codex CLIのインストール**:
    
    ```bash
    npm install -g @openai/codex
    ```
    
2. **Zeaburの認証情報**:
    - Zeaburダッシュボードにアクセスして、**AI Hub API Key**を取得してください。
3. **エンドポイントの選択**
    
    Zeaburは現在2つのエンドポイントを提供しています。地理的に最も近いものを選択してください：
    
    - **アジア (東京):** `https://hnd1.aihub.zeabur.ai/`
    - **米国西海岸 (サンフランシスコ):** `https://sfo1.aihub.zeabur.ai/`

---

## ⚙️ クイック設定ガイド

特定のプロバイダーと直接通信するのではなく、Zeaburの統合APIと通信するようにCodexを構成する必要があります。

### 1. 設定ファイルの作成

`~/.codex/config.toml` に設定ファイルを作成または編集します。以下の設定を貼り付けて、Zeaburをプロバイダーとして定義します。

```toml
# デフォルトで使用するモデル
model = "gemini-3-pro-preview"
model_provider = "zeabur"

[model_providers.zeabur]
name = "Zeabur AI Hub"
# 注意: エンドポイントに /v1 を必ず追加してください
base_url = "<https://hnd1.aihub.zeabur.ai/v1>"
env_key = "ZEABUR_API_KEY"
wire_api = "chat"
```

### 2. APIキーの設定

ツールでAPIキーを利用できるようにする必要があります。

**オプションA: とりあえず試す（一時的）**

1回のセッションでの使用向け：

```bash
export ZEABUR_API_KEY="あなたのzeabur-api-key"
codex "Who are you?"
```

**オプションB: 一度設定すればOK（恒久的）**

毎回キーを設定するのを避けるために、シェルプロファイルに追加します。

1. シェル設定を開きます（例：`~/.zshrc` または `~/.bashrc`）：
    
    ```bash
    nano ~/.zshrc
    ```
    
2. 末尾に以下の行を貼り付けます：
    
    ```bash
    export ZEABUR_API_KEY="あなたのzeabur-api-key"
    ```
    
3. 保存してリロードします：`source ~/.zshrc`

---

## 💸 コーディング開始（あらゆるモデルで）

これで、モデルを柔軟に切り替えながらCLIツールを使用できます。

**基本的な使用法:**

```bash
codex "Write a hello world function in Python"
```

**モデルの切り替え:**

`-m` フラグを使用して、設定で定義されたデフォルトモデルを上書きできます。

```bash
# Geminiを使用
codex -m gemini-3-pro-preview "hi"

# Claudeを使用
codex -m claude-sonnet-4-20250514 "hi"

# GPT-4oを使用
codex -m gpt-4o "hi"
```

**これの何が良いのか:**

- **柔軟性:** ツールを変更することなく、Grok、Claude、GPTを切り替えられます。
- **コスト効率:** 複数のAIサブスクリプションに固定月額料金を支払うのではなく、Zeaburを通じて使用したトークン分だけを支払います。

---

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

問題が発生した場合：

- **401 Unauthorized:**
    - 設定内の `base_url` に `/v1` が含まれているか確認してください。
    - 環境変数が設定されているか確認してください：`echo $ZEABUR_API_KEY`。
- **Model Not Found:**
    - モデル名（例：`gpt-4o`）が現在Zeabur AI Hubでサポートされていることを確認してください。利用可能なモデルIDのリストについては、Zeaburダッシュボードを確認してください。

Happy Coding!