用途:通过 Hermes 终端把编码任务交给 Codex——OpenAI 的自主编码代理 CLI,适合构建功能、重构、PR 审查和批量修复 issue。
前置条件:需安装 codex CLI(npm install -g @openai/codex),配置 OpenAI 认证(OPENAI_API_KEY 或 Codex CLI 登录流程的 OAuth 凭据),且必须在 git 仓库内运行——Codex 拒绝在仓库外运行。调用时需 pty=true,因为 Codex 是交互式终端应用。Hermes 本身可用 model.provider: openai-codex,在 hermes auth add openai-codex 后使用 ~/.hermes/auth.json 中 Hermes 管理的 OAuth;独立 CLI 的 OAuth 会话可能位于 ~/.codex/auth.json,不能仅因缺少 OPENAI_API_KEY 就断定认证缺失。
主要用法:一次性任务用 codex exec 'prompt'(可用 mktemp -d && git init 建临时仓库);长任务加 background=true 与 pty=true,用 process 的 poll/log 监控、submit 发送输入、kill 终止。关键参数包括 exec "prompt"(一次性执行)、--full-auto(沙箱内自动批准文件改动)、--yolo(无沙箱无批准,最快也最危险)、--sandbox danger-full-access(禁用 Codex 沙箱)。PR 审查可克隆到临时目录后 codex review --base origin/main;批量修复可用 git worktree 并行运行多个 Codex 进程,完成后推送并创建 PR。
限制与注意:在 Hermes 网关/服务上下文(如 Telegram 驱动会话)中,工作区写入沙箱可能失败,出现 bubblewrap/user-namespace 报错(如 uid map: Permission denied),此时倾向用 --sandbox danger-full-access,并以进程边界作为安全层:明确 workdir、启动前干净的 git status、收窄任务提示、审查 git diff、定向测试、提交前人工或代理确认。规则上始终使用 pty=true,否则会卡住;不要干扰运行中的任务,耐心监控。收费、价格与平台等事实暂未提供。