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

AI エージェントで Codex Router をインストール（AGENTS.md）

AI エージェントに Codex Router をインストールさせるのが最も手軽な方法です。リポジトリには機械可読な AGENTS.md 手順が用意され、ガイド付きインストーラーがプロバイダー選択・認証情報設定・検証を担当します。このページでは貼り付ける指示文、エージェントが行うこと、キーと既存設定を守る安全境界を説明します。

Codex タスクに貼り付ける

Install the router from this public repository:
https://github.com/duolahypercho/codex-router

Follow AGENTS.md. Preserve my existing Codex models, profiles, settings, and
ChatGPT login. Use only the provider authentication I choose, safely migrate
only recognized older versions, run the Codex doctor, and leave the final app
restart to me. Never ask me to paste a token or API key into chat.

互換性のある認証がすでにあれば、エージェントは最後のアプリ再起動以外をすべて完了できます。API キーは非表示のローカルターミナルプロンプトでのみ入力します——エージェントがチャット経由で中継することはありません。

エージェントが行うこと

AGENTS.md に従い、エージェントは以下の手順を順に実行します：

  1. ホストプラットフォームを読み取り、Codex・Git・Node.js 22.19+・uv または Python 3.10+ を確認。読み取り専用チェックのみ許可され、許可なくパッケージマネージャーやランタイムはインストールしません。
  2. 安定したチェックアウトを使用（macOS/Linux：~/.local/share/codex-router、Windows：%LOCALAPPDATA%\codex-router）。サービスはチェックアウトの絶対パスを保存するため、一時クローンは使いません。
  3. 要求されたプロバイダー ID（例：deepseek、kimi-oauth、grok-api、anthropic-api）を特定し、既存認証があれば configured を使用。
  4. Kimi OAuth は有効な kimi login セッションを再利用するか、公式 CLI を対話ターミナルでのみ実行。API プロバイダーは PTY で provider-key PROVIDER set を実行し、非表示プロンプトに直接値を渡します。
  5. 読み取り専用の旧バージョン検出を実行し、リポジトリが認識する旧インストールにのみ --migrate-known を渡します。未知のルーターを自動的に移行・停止・削除・置換することはありません。
  6. インストーラーを実行（macOS/Linux：./install.sh --target codex --auto --providers IDS --migrate-known。Windows は PowerShell 版）。
  7. ./bin/model-router codex doctor を実行。コア設定、設定プライバシー、カタログ、呼び出し元ケーパビリティ、内部キー、サービス、ルーター健全性、選択済み認証情報が OK である必要があります。
  8. 管理対象レイヤーが失敗した場合は doctor --fix（認識済みの旧インストールのみ --migrate-known を追加）、それでも失敗する場合はサポートバンドルを作成。
  9. Codex は終了させません。 あなたが完全終了、再起動、新規タスク作成、新モデル選択を行います。

エージェントが守る安全規則

  • OAuth トークンや API キーをチャット、コマンド引数、ログ、環境スニペット、追跡ファイルに貼り付けさせません。
  • 推論設定、プロファイル、プロジェクト、トラスト、MCP 設定、機能、ChatGPT 認証を保持します。
  • 4100–4103 ポート（または Grok OAuth フォワーダーの 4108 ポート）上の未知プロセスを終了させません。
  • 生成された /_codex-router/.../v1 設定パスを機密のローカル認証として扱い、完全な管理 URL をチャットや公開イシューに貼り付けません。
  • インストールタスク内で Codex App を再起動・終了させません。

インストール後に確認すること

エージェントが成功を報告した後：

  1. Codex を完全に終了し、再起動して新しいタスクを作成。
  2. モデルピッカーを開き、ルーティングされたモデルが表示されることを確認。
  3. 必要なら ./bin/model-router codex status（またはトレイのステータス表示）で脱敏された健全性サマリーを確認。
  4. 問題があればトラブルシューティングを開くか、doctor --fix を実行。

エージェント駆動の流れはリポジトリの AGENTS.md に記録されたものと完全に一致しており、エージェントが行ったことはすべてそのファイルと照合できます。