mcpField
C
config-codex-cli

config-codex-cli

github.com/cheaper-inferenceAgent 工作流82.3k1.0k 次安装今天更新
代码仓库

关于 config-codex-cli

这是一套分步技能，用于配置 OpenAI Codex CLI，将 OmniRoute 用作兼容 OpenAI 的后端。它会检测操作系统和 Shell、写入配置与配置档、设置环境变量并验证设置。

主要功能

  1. 01检测操作系统和 Shell
  2. 02写入 config.toml 和七个配置档
  3. 03设置环境变量
  4. 04验证配置
  5. 05提供长时间任务指导

适用场景

  1. 01在 Linux、macOS 或 Windows 上设置 Codex CLI
  2. 02将 OmniRoute 配置为 Codex 后端
  3. 03为 Codex 准备多小时会话

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cheaper-inference/omniroute --skill config-codex-cli

安装后在 Claude Code 中输入/config-codex-cli确认已加载。

详细介绍

概述

分步 Agent 工作流，用于在任意机器（Linux、macOS、Windows）上配置 OpenAI Codex CLI，将 OmniRoute 用作兼容 OpenAI 的后端。此工作流会检测操作系统和 Shell，写入 config.toml 和 7 个命名配置，设置环境变量，并验证配置。

快速安装

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

子命令

此系列尚未映射 CLI 子命令。

长时间运行的 Codex 任务（#7287）

OmniRoute 的两个默认设置会悄然中断持续数小时的 Codex 会话。在为通宵或持续数小时的任务配置 Codex 时，请记录这些设置。完整指南：docs/guides/CODEX-CLI-CONFIGURATION.md → 长时间运行的任务。

会话亲和性（默认关闭）
  • 设置：sessionAffinityTtlMs（毫秒；界面在 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 毫秒（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
  1. 重启 OmniRoute。Codex 的 config.toml 保持常规配置即可（wire_api = "responses"，并使用正确的 base_url）。
默认值决策

对于此技能，不要在代码中更改随附默认值：sessionAffinityTtlMs 保持为 0，STREAM_IDLE_TIMEOUT_MS 保持为 600000。长时间运行任务的操作者必须选择启用。参见 Discussion #5718 和 issue #7287。

评论

支持 Markdown