Codex-Collab：在 Claude Code 中调用 Codex 协作
一个 Claude Code 技能，让你在 Claude 会话内直接调度 Codex 运行任务、做代码评审、并行研究，无需切换终端。
SKILL.md 明确披露数据流与状态目录（~/.codex-collab）、提供 read-only 沙箱选项、审批策略可配置、更新需确认，且揭示权限类别的对等消息门控，透明度较好；但要求对所有命令设 dangerouslyDisableSandbox=true，默认 --approval never（自动批准全部动作），并含 danger-full-access 路径，最小权限与强制确认不足，故扣分。
文档自洽、含退出码表、健康检查、降级路径与失败反馈设计；仓库声明测试与类型检查，CI 冒烟测试安装与 health。静态审查无法执行复现，测试文件本身未提供，按锚点不超过 10，且对异常输入的失败反馈仅为声明。
触发条件清晰（用户要求与 Codex 协作或需独立视角）、有降级与环境适配说明、提供中文 README；但核心功能完全依赖 Codex CLI 与 OpenAI 服务，对大陆网络可达性构成依赖，且对不适用的边界描述有限，故扣分。
许可证（MIT）、版本（0.3.2）、发布与更新路径、安装器、维护与贡献文档、中英双语 README 俱备，SKILL.md 分层良好并含 CLI 参考；发布者身份未经验证，未见 changelog 实体文件，维护责任仅依赖单一作者，故未给满分。
目标场景（PR 审查、长任务委派、线程续接）明确，CI 冒烟测试安装与 health 可佐证基本可用；但静态审查无法验证产出可直接使用，与官方 Codex 插件/MCP 的比较优势仅为作者陈述，故不超过 6。
有真实 CI 工作流（三平台冒烟测试）、契约测试声明与双语文档可交叉印证，属可审计一手材料；但测试套件内容与执行结果未随源文件提供，关键主张（Guardian、对等消息）无法独立复现，按静态上限计 5。
- SKILL.md 要求对所有 codex-collab 命令禁用沙箱（dangerouslyDisableSandbox=true），且默认审批策略为 never（自动批准一切动作），用户应在敏感项目中改用 -s read-only 或 --approval on-request/untrusted。
- 核心功能依赖 OpenAI Codex CLI 及其服务端，中国大陆网络环境下可能无法使用或需自行解决可达性；peer 消息还需 Claude Code >= 2.1.224。
- 安装脚本写入 ~/.claude/skills 与 ~/.local/bin（仓库外），升级自 GitHub releases 拉取并本地重建，应审阅 diff 后再确认。
- 发布者身份未经 FollowSkills 验证，本评分基于当前源码静态审查，未执行任何复现。
这个 Skill 能做什么，适合哪些场景？
codex-collab 是连接 Claude 与 Codex 的桥梁，通过 Codex 的 app-server JSON-RPC 协议通信，提供结构化、事件驱动的任务执行、代码评审和线程管理能力。它支持线程复用、可配置的工具调用审批策略，以及双向问答通道（Codex 可在任务中途向 Claude 提问）。在支持原生对等消息的 Claude Code 环境下，Codex 会注册为 Claude 会话可以直接发消息的 peer。项目要求 Bun 与 Codex CLI，采用 MIT 许可证，文档质量高，并附带自更新机制。
通过 codex-collab run 启动 Codex 线程并执行提示任务（支持 --resume 续接对话、--detach 后台运行）；通过 codex-collab review 在只读沙箱中对 PR、未提交改动或指定 commit 做结构化代码评审；用 threads、progress、output、peek 等命令查询线程状态与历史输出；用 ask/answer/next 处理 Codex 任务中的提问；用 approve/decline 处理工具调用审批（含 Guardian 自动审批）；可选 peer up 启动工作区 broker，把 Codex 注册为 Claude 的跨会话消息 peer。
- Claude Code 用户想让另一个模型（Codex）对代码、方案或架构决策提供独立第二意见
- 开发者在提交 PR 前，用一条命令让 Codex 在只读沙箱中跑一次结构化代码评审
- 长期项目维护者希望复用 Codex 线程上下文，连续执行相关任务（如先调研再修复）
- 处理大型重构时把任务后台化（--detach），在独立终端用 follow --watch 实时观察进度
- 需要并行运行多个 Codex 任务、并在任务中途回答 Codex 提问的自动化工作流搭建者
这个 Skill 有哪些优点和局限？
- 结构化 JSON-RPC 通信，事件可解析、进度实时可见
- 线程复用与断点续接（--resume），长对话不丢上下文
- 细粒度审批控制，包括 Guardian 自动审批器与可覆盖的拒绝记录
- fail-open 的双向提问通道，未回答的问题不会卡死任务
- README 与 SKILL.md 文档详尽，含退出码表、错误恢复表和自更新机制
- 强依赖两个外部运行时：Bun 和 Codex CLI，缺一不可
- 原生 peer 消息仅在 macOS/Linux 且 Claude Code >= 2.1.224 可用，Windows 退化为 CLI 模式
- 评审是一次性的：无法对同一次评审追问，需用 run --resume 继续
- 默认自动审批所有 Codex 操作（--approval never），高权限场景需手动收紧
- 声称在 Ubuntu 22.04、macOS、Windows 10 上测试过，但源材料未提供测试套件覆盖情况的独立证据
如何安装这个 Skill？
前置条件：安装 Bun >= 1.0 和 Codex CLI（npm install -g @openai/codex），支持 Linux、macOS、Windows 10。安装步骤：1) git clone https://github.com/Kevin7Qi/codex-collab.git && cd codex-collab；2) Linux/macOS 运行 ./install.sh，Windows 运行 powershell -ExecutionPolicy Bypass -File install.ps1；3) 运行 codex-collab health 验证。技能会装入 ~/.claude/skills/codex-collab/，Claude Code 自动发现；若这是第一个技能，需重启一次 Claude Code。
如何使用这个 Skill？
安装后 Claude 会自动按 SKILL.md 的触发条件调用该技能。手动路径示例：codex-collab run "这个项目是做什么的？" -s read-only --content-only 运行研究任务；codex-collab review --content-only 对默认分支做 PR 式评审；codex-collab run --resume <id> "接着检查错误处理" 续接线程。长任务用 --detach，在另一个终端用 codex-collab follow --watch 观察。注意：run/review 应在后台运行且完成时会自动通知，无需轮询。
这个 Skill 与同类方案有什么区别？
README 提到两个官方替代方案：OpenAI 的 Codex MCP server（适合更简单的交互）和官方 Codex plugin for Claude Code（基于需手动调用的斜杠命令）。codex-collab 的差异化在于自然语言驱动、线程管理和后台运行由工具自动处理，无需用户逐条调用命令。