Codex Grok：Codex で Grok 4.5 を使う

このガイドでは、Codex Router を使って Grok 4.5 を Codex モデルピッカーに追加する方法を説明します。Grok には 2 つの認証経路があります——公式 Grok CLI OAuth セッションと別課金の xAI API キー——OAuth 経路はルーティングモデルにホステッド web search と x_search ツールも追加します。

GrokOAuthAPI キー

追加できるもの

認証方式の選択

• Grok OAuth は ~/.grok/auth.json の公式 Grok CLI 認証情報を再利用します。ルーターは xAI の文書化された Grok CLI 推論プロキシにのみ送信します。この経路ではホステッド web_search と x_search ツールも追加され（Grok Build と同じエージェンティックサーフェス）、検索のタイミングとフィルタリングは xAI バックエンドが決定します。
• Grok API は非表示プロンプトで入力する、別課金の xAI API キーを使用します。Grok CLI を入れたくない場合や、Windows で Smart App Control が CLI をブロックする場合（後述）に。

Grok OAuth を有効化

公式 Grok CLI をインストールして認証：

npm install -g @xai-official/grok
grok login --oauth

次にプロバイダーを有効化：

./bin/model-router codex providers enable grok-oauth
./bin/model-router codex doctor

OAuth トークンは ~/.grok/auth.json に残り、Grok CLI 推論プロキシにのみ送信されます。Codex 設定、キーファイル、環境変数にコピーしないでください。

Grok API を有効化

./bin/model-router codex provider-key grok-api set
./bin/model-router codex providers enable grok-api

Windows では ./codex-router.ps1 codex provider-key grok-api set。非表示プロンプトが端末エコーを無効にし、キーは保護されたユーザー単位ファイルに保存されます。

統合の検証

./bin/model-router codex doctor
./bin/model-router codex providers

選択したプロバイダーが SHOW と ready を報告する必要があります。次に Codex を完全終了、再起動、新規タスク作成、ピッカーで Grok 4.5 を確認。リアルタイムチェック：

./bin/test-model 'grok-oauth/grok-4.5' --live --yes

Windows の注意点：Smart App Control

Windows では Smart App Control が公式 Grok CLI をブロックする場合があります。grok --version が spawn UNKNOWN、“An Application Control policy has blocked this file,” または Smart App Control 通知を返す場合、Grok OAuth はログインやセッション更新を完了できません。Smart App Control は有効のままにし（安全なアプリ単位バイパスはない）、代わりに xAI API キーで grok-api を使用：

./model-router.ps1 codex provider-key grok-api set
./model-router.ps1 codex providers enable grok-api
./model-router.ps1 codex doctor

実行ファイルが許可されていた時に作成した OAuth セッションは永続的な回避策ではありません。トークン期限接近時にルーターが公式 CLI を再び呼び出すため、後で Windows がブロックすればセッションは最終的に更新を停止します。

よくある落とし穴

• OAuth と API は別課金。 Grok CLI サブスクリプションは grok-api の使用量を支払わず、xAI API キーは Grok OAuth セッションを更新できません。
• 検索動作は上流次第。 ルーターは検索ツールを追加しますが、検索環境スイッチやリクエスト側フィルタ設定は受け取りません。検索のタイミング・方法は xAI が決定。
• プロバイダーポリシーのリスク。 xAI がプロキシ経由トラフィックを制限する場合があります。自己責任でお使いください。

公式リンク

• Grok CLI (npm)
• xAI API

関連：モデル概要、Windows インストール、トラブルシューティング。