クイックスタート
このガイドは新規インストール状態から非 OpenAI モデルで Codex を実行するまでを案内します。
1. セットアップウィザードの実行
Section titled “1. セットアップウィザードの実行”ocx initocx init は次の手順を案内します:
- プロバイダー選択 — 組み込みレジストリのプリセット 50 個から一つを選ぶか、
customを選んで base URL とアダプターを直接入力します。 - API キー — キーを貼り付けるか、
${ANTHROPIC_API_KEY}のような環境変数を参照します。 - デフォルトモデル — API キー、ローカル、custom プロバイダーではプリセット値を使うかモデル ID を直接入力します。
- プロキシポート — デフォルトは
10100です。 - Codex に注入しますか? — 一般的なローカル専用構成では
$CODEX_HOME/config.toml(デフォルト~/.codex/config.toml)のルートにopenai_base_urlを追加し、 Codex の組み込みopenaiプロバイダーがプロキシを見るようにします。LAN などの外部アドレスにバインドした 構成では API 認証ヘッダーを含む専用プロバイダーエントリを代わりに使います。 - 自動起動 shim をインストールしますか? — オンにすると
codex実行時にまずocx ensureが実行されます。
結果は $OPENCODEX_HOME/config.json(デフォルト ~/.opencodex/config.json)に保存されます。
2. プロキシの起動
Section titled “2. プロキシの起動”ocx start # デフォルトポート 10100ocx start --port 8080起動時に opencodex は:
- PID を
~/.opencodex/ocx.pidに記録し(二重起動を拒否)、 - 対応プロバイダーではライブモデルを照会し、ネイティブおよびルーティング項目を Codex モデル カタログに同期し、
http://localhost:<port>/v1で待機します。
要求したポートが既に使用中の場合は空きポートを探して runtime-port.json に記録し、Codex が実際の
リスナーを使うように設定を更新します。
確認:
ocx statusocx gui # 現在のポートでダッシュボードを開く3. Codex の使用
Section titled “3. Codex の使用”これで Codex は opencodex と透過的に通信します:
codex "Refactor this function for readability"特定のルーティングモデルを指定するには、Codex のモデルピッカーに表示される provider/model 形式を使ってください:
codex -m "anthropic/claude-opus-5" "Explain this stack trace"codex -m "ollama-cloud/glm-5.2" "Write a SQL migration"GPT-5.6 の利用権がある場合、ネイティブ ChatGPT 経路は bare モデル名、API キーと OpenRouter 経路は明示的
provider/model 形式を使ってください:
codex -m "gpt-5.6-sol" "Plan a risky refactor"codex -m "openai-apikey/gpt-5.6-terra" "Review this architecture"codex -m "openrouter/openai/gpt-5.6-luna" "Summarize this trace"サブエージェントモデルの選択(任意)
Section titled “サブエージェントモデルの選択(任意)”新規構成では gpt-5.5、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.4-mini が
Codex のサブエージェントピッカーにデフォルトで表示されます。ocx gui でネイティブモデルとルーティングモデルを
合わせて最大 5 つまで変更や並び替えができます。推奨サブエージェントモデルと推論負荷も指定でき、
opencodex はこの値を v1 コラボリクエストのガイダンスメッセージに反映します。
キーを貼り付ける代わりにログイン
Section titled “キーを貼り付ける代わりにログイン”一部のプロバイダーは実際のアカウントログインをサポートします(OAuth、自動更新):
ocx login xai # または anthropic, kimi, kiro, google-antigravity, cursorocx logout xaiデフォルトの OpenAI 経路はキー不要です — 既存の codex login 認証情報をそのまま転送します。
OpenAI API キーを別に使うには openai-apikey プロバイダーを追加してください。このプリセットには
gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna が含まれますが、API キーに実際の利用権が必要です
(プロバイダー参照)。
ocx stop # プロキシを停止しネイティブ Codex を復元ocx restore # プロキシは残したままネイティブ Codex を復元(エイリアス: ocx eject)ocx restore back # 実行中のプロキシに Codex を再接続