Codex Router コミュニティドキュメント
日本語
English中文日本語
GitHub
GitHub
ドキュメントを開く
セクションへ移動
最終更新

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

このページでは、macOS の Codex App／CLI に Codex Router をフルインストールする方法を説明します。推奨構成には Control Center、メニューバーホスト、デスクトップウィジェットが含まれ、モデルピッカーを開く前に健全性を確認します。

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 --with-tray

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

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

Control Center とメニューバーアプリ

推奨コマンドは、ネイティブメニューバーホストと Electron Control Center を統合した Codex Router.app をビルドしてインストールします。アプリを開くと Control Center が表示され、ウィンドウを閉じてもメニューバーホストは動作します。Spotlight または ~/Applications から起動でき、再ビルドは次のコマンドです：

./bin/model-router-tray

App bundle は ~/Applications に置かれます。SwiftUI macro と WidgetKit target を含むため、単体 Command Line Tools ではなくフル Xcode App が必要です。インストーラーは DEVELOPER_DIR または Xcode → Settings → Locations → Command Line Tools の選択を尊重し、グローバル設定を変えずに /Applications/Xcode.app も利用できます。Dynamic Island 風オーバーレイは初期状態でオフです。

Xcode が別の場所にある場合は次で再ビルドします：

env DEVELOPER_DIR="/path/to/Xcode.app/Contents/Developer" \
  ~/.local/share/codex-router/bin/model-router-tray

macOS での Kimi OAuth

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

kimi login

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

インストールの検証

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

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

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 インストールガイドをご覧ください。