用途:把 Claude Code 会话中的任务派发给 Codex 独立执行,如调查缺陷、尝试修复、二次或更省成本的复核、起草等。每次派发是一条完整自包含的提示,需包含交付物、目标文件或目录、约束和必要检查;会话上下文、推理依据和已加载技能都留在本地,Codex 仅凭仓库、自身配置和该提示开始工作。较长的提示应写入文件并用 --prompt-file 传入。
主要能力:通过常驻 broker 以 socket 走 Codex app-server JSON-RPC,提供可恢复线程、后台任务和结构化复审输出。task 会生成可在 codex://threads/<id> 查看的可恢复线程,--resume-last 可续接;后台任务返回 job id,用 status 看进度、result <task-id> 取结果、cancel <task-id> 停止。
使用方式:插件提供 codex-rescue 子代理及 review、adversarial-review、setup 等入口。任务提示由主线程撰写,范围也由主线程选择;codex-rescue 子代理只负责转发一次 task 调用并原样返回 stdout,检查、轮询、取结果和后续处理留在主线程。可把技能绝对路径传给 Codex,让其先读该文件;跨目录时用 --cwd 指定绝对路径,仓库内改动加 --write。前台适合短任务,长或开放式任务用 --background。
限制:不加 --write 时为只读沙箱;工作区根解析为目标的 git 根目录,无法缩到子目录以下,相对路径会从该根解析,需用绝对路径保证落点。--cwd 只移动任务而非缩小范围。沙箱允许读工作区外、拒绝写工作区外;shell 网络默认关闭,需在 ~/.codex/config.toml 中设置 [sandbox_workspace_write] network_access = true,且改动只对之后启动的 broker 生效;web 搜索走独立通道,无需此设置。不要凭空假设模型或 effort 值,可查阅 ~/.codex/models_cache.json;默认不设置 --model 和 --effort。