logo

コミュニティ

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

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

Kyle ChungKyle Chung

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

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

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

🧱 前提条件

  1. Codex CLIのインストール:

    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をプロバイダーとして定義します。

# デフォルトで使用するモデル
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回のセッションでの使用向け：

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

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

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

  1. シェル設定を開きます（例：~/.zshrc または ~/.bashrc）：

    nano ~/.zshrc

  2. 末尾に以下の行を貼り付けます：

    export ZEABUR_API_KEY="あなたのzeabur-api-key"

  3. 保存してリロードします：source ~/.zshrc

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

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

基本的な使用法:

codex "Write a hello world function in Python"

モデルの切り替え:

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

# 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!

return Blogs