最終更新 2026年8月9日

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

このページでは、Codex App または CLI 向けに macOS へ Codex Router をインストールする方法（オプションのメニューバーコントロールパネル含む）と、モデルピッカーを開く前に正常性を確認する方法を説明します。

macOS の前提条件

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

ガイド付きインストール

「ターミナル」を開いて実行：

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

ウィザードで番号によりプロバイダーを切り替え、各プロバイダーの状態がリアルタイム表示され、選択項目の認証情報設定を案内し、インストール前に確認サマリーを出します。

キーをコマンドに貼り付けないでください。 API キーは非表示のターミナルプロンプトで入力します。インストーラーが ChatGPT ログインや既存の Codex 設定に触れることはありません。

デスクトップコンパニオン（任意）

macOS では、ガイド付きセットアップでネイティブなメニューバーコントロールパネルをビルド・起動できます。Codex の健全性、プロバイダーごとの使用量、クォータカード、プロバイダーコントロールをネイティブガラス UI で表示します。いつでも実行可能：

./bin/model-router-tray

アプリバンドルは ~/Applications に配置され、Swift ツールチェーンが必要です。ツールチェーンがない場合は失敗せずに手順をスキップし、案内を表示します。初回起動時にトレイはログイン項目として登録され、再起動後に自動で開きます。設定タブまたは「システム設定 › ログイン項目」で無効化できます。

macOS での Kimi OAuth

Kimi OAuth を選ぶと、ガイド付きセットアップは公式 Kimi Code CLI のセッションを再利用します。CLI がある場合はログインコマンドの実行を提案します：

kimi login

ルーターは $KIMI_CODE_HOME または ~/.kimi-code から公式認証情報を読み取り、クロスプロセスロック下で更新します。OAuth トークンを Codex 設定・キーファイル・環境変数にコピーしないでください。

インストールの検証

Codex は model_catalog_json を起動時のみ読み込むため、セットアップ後：

./bin/model-router codex doctor を実行し、FAIL 行をすべて解消。
./bin/model-router codex providers で対象プロバイダーが SHOW と ready を示すことを確認。
Command-Q で Codex を完全に終了し、再起動して新しいタスクを作成。
通常のモデルピッカーを開く。

Codex の起動カタログを直接確認：

codex debug models

それでもモデルが出ない場合は ./bin/refresh-catalog を実行し、Codex を完全終了して再起動します。

バックグラウンドサービスの確認

ルーターはユーザー単位の launchd サービスとして動作します：

launchctl print "gui/$(id -u)/io.github.codex-router"

停止している場合は ./bin/model-router codex doctor --fix で管理対象の設定とサービスを再構築します。

アンインストール

./bin/model-router codex uninstall

アンインストールはマークされた統合設定と現在のサービスを削除しますが、チェックアウト・ログ・バックアップ・プロバイダー認証情報は意図的に保持します。完全に削除する場合は ~/.codex/codex-router を手動で確認してから削除してください。

よくある問題はトラブルシューティングを、Windows 固有の注意点は Windows インストールガイドをご覧ください。