Codex CLI

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

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

推奨:ワンクリック接続

Codex グループのキーを選ぶ

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

設定コマンドを生成する

キーの横にあるワンクリック接続を選択し、Codex CLI を選んで macOS / Linux か Windows PowerShell かを確認したら、接続コマンドを生成をクリックしてコピーします。

macOS では「ターミナル」、Linux では任意のターミナル(curl が必要です)、Windows では「PowerShell」にコマンドを貼り付けて実行します。完了したらターミナルを開き直し、codex を実行します。スクリプトは npm で Codex CLI をインストールするため、Node.js がない場合は設定の書き込みだけを行います。Node.js LTS をインストールしてから npm install -g @openai/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 / Codex Pro グループ	両グループのモデルは同じです:`gpt-6-astra`、`gpt-6-sol`、`gpt-6-luna`、`gpt-5.6-sol`、`gpt-5.6-terra`、`gpt-5.6-luna`、`gpt-5.5`。現在のキーで `GET /v1/models` を呼んだ結果が正となります
画像生成	Codex グループでは `gpt-image-` を提供していません。画像生成にはキーに GPT Image 全モデル*グループを追加してください。画像生成 API を参照

手動設定: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 エラーが出る場合は、エラーコードと再試行を参照してください。設定がうまくいかない場合はトラブルシューティングを参照してください。

次のステップ

CC Switch: Codex App を接続する、または複数のキーを切り替える
OpenAI SDK: 自分のコードから同じ GPT モデルを呼び出す
トラブルシューティング: エラーメッセージから対処法を探す