Codex CLI

Codex CLI が HopBase の OpenAI Responses 互換 API を使うよう設定します。

Codex CLI は OpenAI のコーディングエージェントです。ワンクリック設定を推奨します。手動設定では config.toml と OPENAI_API_KEY が必要です。

推奨:ワンクリック設定

Codex プランのキーを選ぶ

コンソールにサインインし、API キーを開いて、Codex Plus または Codex Pro プランのキーを見つけます。

設定コマンドを生成する

ワンクリック設定を選択し、Codex CLI と使用中の OS を選びます。

実行して確認する

ターミナルでコマンドを実行します。完了したらターミナルを開き直し、codex を実行します。

GUI で設定したい場合は、CC Switch ガイドに従い、キーのメニューからCCS をインポートを選択して、Codex CLI を選びます。

ワンクリック設定は config.toml を上書きします

既存のファイルは config.toml.bak.<timestamp> としてバックアップされます。新しい設定では model = "gpt-6-astra"、model_reasoning_effort = "xhigh"、requires_openai_auth = true が設定され、キーは ~/.codex/auth.json に書き込まれます。環境変数は設定されません。xhigh は最高の推論レベルで、消費トークンも最も多くなります。日常利用では high または medium に切り替えてください。

推論レベルとプラン

設定	内容
`model_reasoning_effort`	`low` / `medium` / `high` / `xhigh`。レベルが高いほど思考時間が長くなり、消費トークンも増えます
Codex Plus プラン	`gpt-6-astra`、`gpt-5.6-sol`、`gpt-5.6-terra`、`gpt-5.5` など
Codex Pro プラン	Codex Plus の全モデルに加えて `gpt-5.3-codex-spark`

手動設定:config.toml を編集する

システム	設定ファイル
macOS / Linux	`~/.codex/config.toml`
Windows	`C:\Users\your-name\.codex\config.toml`

ファイルが存在しない場合は新規作成し、以下を追記します:

model_provider = "hopbase"
model = "gpt-5.6-sol"

[model_providers.hopbase]
name = "HopBase"
base_url = "https://api.hop-base.com/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

2 つのキー設定方法を混在させない

手動設定は env_key を介して環境変数からキーを読み込みます。ワンクリック設定は requires_openai_auth = true と auth.json を使用します。1 つの設定ファイルの中で requires_openai_auth = true と環境変数方式を組み合わせないでください。Codex 0.153 での検証では、この組み合わせだとキーが送信されず、ゲートウェイが 401 missing_api_key を返します。

キーを設定して Codex を起動します:

一時的な設定は現在のターミナルウィンドウのみに適用されます:

export OPENAI_API_KEY=sk-your-key
codex

永続的な設定はシェルの起動ファイルに追加します:

# zsh (the macOS default)
echo 'export OPENAI_API_KEY=sk-your-key' >> ~/.zshrc
source ~/.zshrc

# bash (common on Linux; use this instead of the zsh block)
echo 'export OPENAI_API_KEY=sk-your-key' >> ~/.bashrc
source ~/.bashrc

Web 検索とリモート圧縮は未対応です

Codex の Web 検索は /v1/alpha/search を、リモートコンテキスト圧縮は /v1/responses/compact をリクエストします。どちらのエンドポイントもまだ対応しておらず、404 が返ります。Web 検索の 404 は通常の会話には影響しません。表示させたくない場合は、Codex 側で Web 検索をオフにしてください。

Codex プランのキーを使用する

Codex プラン(Codex Plus / Codex Pro)のキーを使用してください。応答が遅い場合や 502 / 503 エラーが出る場合は、エラーコードと再試行を参照してください。設定がうまくいかない場合はトラブルシューティングを参照してください。