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

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

このガイドでは、macOS・Windows・Linux で Codex Router をインストールするすべての方法、各方法の内容、OAuth と API キーの選び方、検証・更新・削除の手順を説明します。Codex App は macOS と Windows に対応し、Codex CLI は macOS・Windows・Linux に対応します。

前提条件

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

  • Codex App または CLI。
  • Node.js 22.19 以上（Node.js 24 LTS 推奨）。
  • uv、または Python 3.10+（venv 含む）。
  • Git（管理型ワンコマンドインストールとロールバック用）。
  • 少なくとも 1 つの Kimi OAuth、Kimi API、または DeepSeek API 認証情報（ガイド中で別プロバイダーを選ぶことも可能）。

インストール方法の選択

3 つの方法があり、いずれも最終的に同じ検証済みのユーザー単位バックグラウンドサービスになります：

  • ガイド付きターミナルインストール——番号付きウィザードがプロバイダー選択、認証情報の入力、検証を案内。多くの人に最適。
  • AI エージェントでのインストール——Codex タスクに 1 文を貼り付けて、リポジトリの AGENTS.md 手順どおりにエージェントに任せる方法。
  • クローンして確認してからインストール——リポジトリをクローンしてコードを確認してからインストーラーを実行。実行前に確認したい人向け。

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

ガイド付きターミナルインストール

macOS または Linux：

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

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

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

macOS と Linux では、ガイド付きセットアップでデスクトップコンパニオン（macOS メニューバーアプリまたは Windows/Linux トレイ）のビルド・起動も選択できます。--with-tray で無条件にインストール、--no-tray で表示しない、自動モードはスキップ。

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

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 キーは独立したアカウント・課金体系です：

方式プロバイダー仕組み
OAuthKimi 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 インストール、エージェントでのインストール を、問題発生時はトラブルシューティングをご覧ください。