Codex Router コミュニティドキュメント
日本語
English中文日本語
GitHub
最終更新

Windows に Codex Router をインストール（Codex App と CLI）

このページでは、Windows で Codex App または CLI 向けに Codex Router をインストールする方法、PowerShell コマンドラッパー、Codex Desktop とシェルが別環境になる WSL のケース、ユーザー単位サービスの検証方法を説明します。

Windows の前提条件

  • Codex App または Codex CLI。
  • Node.js 22.19 以上（Node.js 24 LTS 推奨）。
  • uv、または Python 3.10+（venv 含む）。
  • Git（管理型ワンコマンドインストールとロールバック用）。

ガイド付きインストール

PowerShell を開いて実行：

$installer = Join-Path $env:TEMP "codex-router-install.ps1"
Invoke-WebRequest https://raw.githubusercontent.com/duolahypercho/codex-router/main/install.ps1 -OutFile $installer
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installer -Target codex -Guided

ウィザードは番号でプロバイダーを切り替え、状態をリアルタイム表示し、選択した項目の API キーを非表示で入力させます。タスクスケジューラ経由でユーザー単位のバックグラウンドサービスを導入し、明示的にスモークテストを有効にしない限り、有料テストリクエストは送信しません。

codex-router.ps1 ラッパー

インストール後、すべてのルーターコマンドは PowerShell ラッパー経由で実行します：

./codex-router.ps1 codex doctor
./codex-router.ps1 codex providers
./codex-router.ps1 codex provider-key deepseek set
./codex-router.ps1 codex update
./codex-router.ps1 codex uninstall

API キーは非表示プロンプトで入力します。認証情報をチャット、コマンド引数、シェル履歴、追跡ファイルに入れないでください。

WSL と Codex Desktop 設定

Codex Desktop が Windows で実行され、コマンドを WSL で実行している場合、Codex ホームディレクトリが 2 つある可能性があります：C:\Users\<WindowsUser>\.codex と /home/<LinuxUser>/.codex。ルーターコマンドは CODEX_HOME が指す Codex ホームを使うため、WSL 内で変数を上書きせずに実行すると、Windows Codex Desktop ではなく Linux CLI 設定を更新してしまう可能性があります。

WSL から Windows Desktop 設定を対象にする場合：

export CODEX_HOME=/mnt/c/Users/<WindowsUser>/.codex
export CODEX_ROUTER_STATE_DIR="$CODEX_HOME/codex-router"

また、Windows の config.toml にある model_catalog_json パスが WSL から読み取れることを確認します——C:\... ではなく /mnt/c/Users/<WindowsUser>/.codex/codex-router/merged-models.json を使用してください。セットアップが成功したように見えて Desktop ピッカーが変わらない場合は、変更された Codex ホームを確認してから再実行します。

インストールの検証

  1. ./codex-router.ps1 codex doctor を実行し、FAIL 行をすべて解消。
  2. プロバイダーが SHOW と ready を示すことを確認。
  3. Codex を完全に終了（アプリの Quit コマンド、またはトレイがある場合はトレイから終了）、再起動して新しいタスクを作成。
  4. モデルピッカーを開く。

スケジュールされたタスクを確認：

Get-ScheduledTask -TaskName "Codex Router"

レイヤーが不健康な場合は ./codex-router.ps1 codex doctor --fix で管理対象の設定とサービスを再構築します。

Windows 固有の注意点：Grok OAuth

Windows の Smart App Control が公式 Grok CLI をブロックし、Grok OAuth のログインやセッション更新ができない場合があります。grok --version が spawn UNKNOWN、“An Application Control policy has blocked this file,” または Smart App Control 通知を返す場合は、xAI API キーを使う grok-api プロバイダーに切り替えてください。詳細はトラブルシューティングへ。

アンインストール

./codex-router.ps1 codex uninstall

アンインストールはアクティブな統合とサービスを削除しますが、チェックアウト・ログ・バックアップ・認証情報は設計上保持します。削除前に %LOCALAPPDATA%\codex-router と状態ディレクトリを手動で確認してください。