config-codex-cli

概要

あらゆるマシン（Linux、macOS、Windows）で OpenAI Codex CLI を設定し、OpenAI 互換のバックエンドとして OmniRoute を使用するための、手順を追ったエージェントのワークフローです。OS とシェルを検出し、config.toml と名前付きプロファイルを 7 つ作成して、環境変数を設定し、セットアップを検証します。

クイックインストール

npm install -g omniroute   # or: npx omniroute
omniroute --version

サブコマンド

このファミリーに対応する CLI サブコマンドはまだマッピングされていません。

Codex の長時間実行タスク（#7287）

OmniRoute のデフォルト設定のうち 2 つは、数時間に及ぶ Codex セッションを気付かないうちに中断します。Codex を一晩、または数時間にわたって動かす設定を行う際は、必ずこの点を記載してください。詳しいガイド：docs/guides/CODEX-CLI-CONFIGURATION.md → 長時間実行タスク。

セッションアフィニティ（デフォルトでは無効）

• 設定：sessionAffinityTtlMs（ms。UI では Dashboard → Settings → Routing → Session affinity に Affinity TTL (seconds) と表示されます）。以前の別名：codexSessionAffinityTtlMs。
• デフォルトの 0 は無効を意味します。各ターンが異なるアカウントに割り当てられ、プロンプトキャッシュやセッションの継続性が損なわれる可能性があります。
• Codex のセッションキー（x-codex-session-id、x-session-id、x-omniroute-session、本文の prompt_cache_key / session_id）は、TTL が 0 より大きい場合にのみ、割り当ての固定に使用されます。
• 最大値：86400 秒 / 86400000 ms（24 時間）。TTL は予想されるタスクの長さより長く設定してください（例：約 12 時間なら 43200 秒）。

ストリームのアイドルタイムアウト（デフォルトは 10 分）

• 環境変数：STREAM_IDLE_TIMEOUT_MS（デフォルトは 600000）。FETCH_BODY_TIMEOUT_MS（同じ基準値。0 で無効）も検討してください。
• 合成 SSE ハートビートではアイドル時間の計測はリセットされません。リセットされるのは、実際の上流チャンクを受信した場合のみです。
• アイドル時間が上限を超えると、応答のない推論ターンは強制終了されます（stream_idle_timeout / StreamIdleTimeoutError）。ログで Idle timeout: no data from を検索してください。

数時間にわたる実行に推奨される設定

1. Dashboard → Settings → Routing → Session affinity → Affinity TTL を 43200（12 時間）または 86400（24 時間の上限）に設定します。
2. OmniRoute の環境：

STREAM_IDLE_TIMEOUT_MS=0
FETCH_BODY_TIMEOUT_MS=0

3. OmniRoute を再起動します。Codex の config.toml は通常どおり（wire_api = "responses"、正しい base_url）にしておきます。

デフォルト設定の方針

このスキルでは、コード内の出荷時デフォルトを変更しないでください。sessionAffinityTtlMs は 0 のまま、STREAM_IDLE_TIMEOUT_MS は 600000 のままにします。長時間実行する場合は、利用者が明示的に有効化する必要があります。Discussion #5718 と issue #7287 を参照してください。