最終更新 2026年9月8日

Codex Router インストールガイド — macOS、Windows、Linux

このガイドでは、macOS・Windows・Linux で Codex Router をインストールするすべての方法、各方法の内容、OAuth と API キーの選び方、検証・更新・削除の手順を説明します。現在の推奨インストールには、ガイド付きプロバイダー設定、Electron Control Center、トレイ／メニューバーアプリ、macOS デスクトップウィジェットが含まれます。Codex App は macOS と Windows、Codex CLI は 3 OS に対応します。

前提条件

開始前に、以下を公式ソースからインストールしてください。インストーラーがパッケージマネージャーやランタイムを黙って導入することはありません。

Codex App または CLI。
Node.js 22.19 以上（Node.js 24 LTS 推奨）。
uv、または Python 3.10+（venv 含む）。
Git（管理型ワンコマンドインストールとロールバック用）。
Windows PowerShell は FullLanguage モードで、ローカルのアプリケーション制御ポリシーが Add-Type を許可している必要があります。インストーラーは確認だけを行い、ポリシーを弱めません。

インストール方法の選択

デスクトップ UI が必要かどうかで方法を選びます：

推奨フルインストール——ガイド付き設定 + Control Center + トレイ／メニューバー + macOS デスクトップウィジェット。多くの人に最適。
AI エージェントでのインストール——Codex タスクに 1 文を貼り付けて、リポジトリの AGENTS.md 手順どおりにエージェントに任せる方法。
Homebrew CLI 専用インストール——デスクトップ UI を構築せず、ルーターとコマンドラインだけを導入。
クローンして確認してからインストール——リポジトリをクローンしてコードを確認してからインストーラーを実行。実行前に確認したい人向け。

詳細は後述します。プロバイダーが決まっている場合はモデルチュートリアルへ。

推奨フルインストール

macOS または Linux：

curl -fsSL https://raw.githubusercontent.com/duolahypercho/codex-router/main/install.sh \
  | sh -s -- --target codex --guided --with-tray

Windows 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 -WithTray

ウィザードは番号付きで進みます：プロバイダー一覧は番号で切り替え（a で全選択、n でクリア、Enter で続行）、各プロバイダーに ready/needs-key/needs-sign-in の状態が表示され、選択した未接続項目の認証情報設定を案内し、変更前に確認サマリーを表示します。

完了後は Codex を完全終了して再起動し、新規タスクでルートモデルを選び、Codex Router を開いて Control Center を使います。macOS では Spotlight または ~/Applications から開け、ウィンドウを閉じてもメニューバーホストは動作します。デスクトップウィジェットは Settings → Dynamic Island → Desktop で有効化できます。公開 .dmg はまだなくローカルビルドです。SwiftUI macro と WidgetKit target のため、単体 Command Line Tools ではなくフル Xcode App が必要です。

Homebrew CLI 専用インストール

Codex Router はまだ homebrew/core に入っていません。上流リポジトリを tap として一度追加し、formula をインストールします：

brew tap duolahypercho/codex-router https://github.com/duolahypercho/codex-router
brew install codex-router
codex-router setup --guided

Homebrew はルーターと CLI のみをインストールし、Electron Control Center、トレイ／メニューバー、デスクトップウィジェットは含みません。更新は brew upgrade codex-router。削除前に codex-router uninstall、続いて brew uninstall codex-router を実行します。

クレデンシャルフリーインストールとブラウザパネル

ルーターをアイドル状態でインストールできます——プロバイダー選択なし、認証情報プロンプトなし、キーチェーンや他の CLI のセッション、Codex の auth.json には一切触れません：

curl -fsSL https://raw.githubusercontent.com/duolahypercho/codex-router/main/install.sh \
  | sh -s -- --target codex --no-provider --no-discovery

このモードでは、Codex トラフィックはプロバイダーやネイティブ転送ではなくローカル 503 router_idle_no_provider を受け取り、doctor は warn でアイドル状態を報告して終了 0 になります。新しい stop サブコマンドでインストール → 開始 → 状態 → doctor → 停止 → アンインストールのライフサイクルが完結します。フラグなしでセットアップを再実行してもアイドルモードは維持されます。

インストール後、bin/panel（Windows：codex-router.ps1 panel）でブラウザパネルを開きます。トレイと同じアプリケーションです——すべてのコマンドが同じコマンドテーブルを経由——ローカル呼び出し能力を含むため、出力の URL は脱敏されます。

クローンして確認してからインストール

git clone https://github.com/duolahypercho/codex-router.git
cd codex-router
./install.sh --target codex --guided

git clone https://github.com/duolahypercho/codex-router.git
Set-Location codex-router
./install.ps1 -Target codex -Guided

認証の選択

Codex Router は 2 種類の認証をサポートします。同一ベンダーでも OAuth と API キーは独立したアカウント・課金体系です：

方式	プロバイダー	仕組み
OAuth	Kimi Code CLI、Grok CLI	公式 CLI のログイン済みセッションを再利用。キー保存不要
API キー	DeepSeek、Kimi Platform、xAI、Anthropic、Ollama Cloud、Z.ai、Qwen plan など	非表示プロンプトで 1 回入力し、保護されたユーザー単位ファイルに保存

API キーは非表示のターミナルプロンプト（またはデスクトップトレイの置換・削除操作）でのみ入力します。トークンや API キーをチャット、コマンド引数、シェル履歴、追跡ファイルに貼り付けないでください。

詳しい比較はFAQと各モデルページ（DeepSeek、Kimi、GLM、Grok、Claude）をご覧ください。

インストールの検証

model_catalog_json は Codex 起動時に読み込まれるため、セットアップ後はアプリを完全に終了して再起動し、新しいタスクを作成して確認します：

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

doctor は健全なレイヤーすべてに OK、失敗したレイヤーごとに修正方法を報告します。対象プロバイダーは SHOW と ready の両方を示す必要があります。

更新・ロールバック・無効化・アンインストール

./bin/model-router codex update
./bin/model-router codex rollback
./bin/model-router codex disable
./bin/model-router codex enable
./bin/model-router codex uninstall

update は認識済みの GitHub オリジンと、追跡ファイルに編集のないチェックアウトを必要とします（未追跡ファイルはブロックしません。必要な場合は --force（./bin/update --force、./bin/rollback --force）で追跡編集を破棄できます）。前バージョンをロールバック参照として保持します。disable は Codex 統合と現在のサービスだけを削除します。uninstall は意図的にチェックアウト・ログ・バックアップ・プロバイダー認証情報を保持し、通常の削除で認証や復旧データが失われないようにします。

プラットフォーム別の詳細は macOS インストール、Windows インストール、エージェントでのインストールを、問題発生時はトラブルシューティングをご覧ください。