codex-plugin-cc项目概览：架构、命令、3个技能全解

codex-plugin-cc项目概览：架构、命令、3个技能全解

【免费下载链接】codex-plugin-ccUse Codex from Claude Code to review code or delegate tasks.项目地址: https://gitcode.com/GitHub_Trending/co/codex-plugin-cc

codex-plugin-cc是一个面向 Claude Code 用户的官方 Codex 插件，让你无需切换工具，就能在 Claude Code 内直接调用 Codex 完成代码审查（code review）或委托开发任务。一句话概括：Claude Code 负责对话与调度，Codex 负责重活，两者共享同一台机器上的同一份本地 Codex CLI、同一份登录态与仓库配置。

一、codex-plugin-cc 能帮你做什么？

安装后你会获得两大类能力 🎯：

前置条件很简单：Node.js 18.18+，以及一个 ChatGPT 订阅（含免费）或 OpenAI API Key。

二、项目架构：命令、钩子、脚本、技能四层协作

这个项目（README.md）的目录结构非常清晰，整个插件由四部分组成：

plugins/codex/ ├── commands/ 7 个斜杠命令的提示词定义 ├── hooks/ 生命周期钩子配置 ├── agents/ codex-rescue 子代理 ├── skills/ 3 个内置技能 ├── scripts/ Node.js 运行时代码（核心） └── schemas/ 审查输出 JSON Schema

1. 命令层（commands/）：每个斜杠命令都是一个 Markdown 提示词文件，定义参数、执行模式和输出规则。例如 review.md 规定审查命令只读、不改代码，并引导在任务较大时优先后台运行。

2. 钩子层（hooks/）：hooks.json 注册了三类钩子——SessionStart/SessionEnd负责会话生命周期记录，Stop钩子则驱动可选的"审查门禁"（review gate）：Claude 准备收工时自动触发一次针对性 Codex 审查，发现问题就阻止收工，让 Claude 先修复。

3. 运行时层（scripts/）：核心入口是 codex-companion.mjs，它负责把命令请求转发给本机 Codex。配套模块各司其职，例如 app-server.mjs 封装 Codex app-server 协议，job-control.mjs 管理后台任务，state.mjs 持久化任务状态，render.mjs 负责结果展示。

4. 子代理层（agents/）：codex-rescue.md 定义了codex:codex-rescue子代理。它的定位是"薄转发器"：只负责把救援请求原样转发给运行时脚本，不自己看代码、不自己查进度，保证行为可控、输出可预期。

三、最快上手：4 步安装配置

在 Claude Code 中依次执行：

/plugin marketplace add openai/codex-plugin-cc /plugin install codex@openai-codex /reload-plugins /codex:setup

/codex:setup会检查本机 Codex 是否就绪：缺失且可用 npm 时会询问是否帮你安装（即npm install -g @openai/codex）；已安装但未登录时会提示运行!codex login。安装成功后，你可以在/agents列表里看到codex:codex-rescue子代理，说明一切正常 ✅

一个推荐的首次体验流程：

/codex:review --background /codex:status /codex:result

四、7 个斜杠命令实战指南

/codex:review快速只读审查

审查当前未提交改动，或用--base main审查整个分支。支持--wait（前台等待）和--background（后台运行）。注意它是只读的，绝不修改代码；多文件的大改动建议放后台跑。

/codex:adversarial-review定向压力测试

与review不同，它接受额外的"焦点文本"，可让 Codex 专门质疑某个决策：

/codex:adversarial-review --base main challenge whether this was the right caching design

适合上线前针对鉴权、数据丢失、竞态条件等风险区域做对抗式审查。

/codex:rescue把重活委托给 Codex

通过codex:codex-rescue子代理把调查、修复类任务交给 Codex，常用参数：

• --resume/--fresh：继续本仓库最近一次 Codex 线程，或强制开新线程
• --model/--effort：指定模型与推理强度（spark会自动映射为轻量模型）
• --background：长任务放后台

例如：/codex:rescue --background investigate why the tests started failing。

任务管理与会话迁移

• /codex:status：查看当前仓库正在运行和最近完成的任务
• /codex:result：取回已完成任务的完整输出，附带会话 ID，可用codex resume <session-id>在 Codex 中续跑
• /codex:cancel：取消正在运行的后台任务
• /codex:transfer：把 Claude Code 会话转成持久 Codex 线程，打印codex resume命令，实现"跨工具接力调试"

五、3 个内置技能全解

技能（skills）是插件的"内部规范"，对普通用户不可直接调用，但它们决定了插件的行为质量 🧩

1. codex-cli-runtime：运行时调用契约

定义在 SKILL.md。它约束 rescue 子代理只能发起一次task调用并把输出原样返回，禁止自行探索仓库或追加分析，从机制上防止子代理"越权干活"。

2. codex-result-handling：结果呈现规范

定义在 SKILL.md。核心规则包括：审查结果按严重度排序、文件路径和行号原样保留、"推断"与"事实"严格区分；最关键的一条铁律——呈现审查发现后必须停下，询问用户要修哪些，严禁自动应用修复。

3. gpt-5-4-prompting：提示词工程指南

定义在 SKILL.md。它教 Claude 如何像"操作员"而非"协作伙伴"那样给 Codex 写提示词：用 XML 标签组织<task>、<structured_output_contract>、<verification_loop>、<grounding_rules>等结构化块，并配套三份参考文档——

• prompt-blocks.md：可复用提示块
• codex-prompt-recipes.md：端到端模板
• codex-prompt-antipatterns.md：常见反模式

六、典型工作流与注意事项

三个高频场景：

1. 发版前审查：/codex:review，简单直接
2. 甩锅给 Codex：/codex:rescue investigate why the build is failing in CI
3. 长任务后台跑：/codex:adversarial-review --background，然后/codex:status、/codex:result跟进

配置复用：插件复用本机 Codex 的全部配置，包括~/.codex/config.toml（用户级）和项目根目录.codex/config.toml（项目级，需信任该仓库）。想固定模型或推理强度，在config.toml里配置即可。

两个提醒⚠️：

• 使用量会计入你的 Codex 用量额度
• review gate（/codex:setup --enable-review-gate）会形成 Claude 与 Codex 的反复循环，消耗较快，只在计划密切盯守会话时开启

七、常见疑问

• 需要单独的 Codex 账号吗？不需要额外账号，插件直接使用本机 Codex CLI 的登录态；没登录过则需 ChatGPT 账号或 API Key 登录一次。
• 会另起一套运行时吗？不会。它走的是本机同一个 Codex CLI 与 app server，同一份仓库、同一份环境，行为与直接使用 Codex 一致。
• 我现有的 Codex 配置还能用吗？可以，完全沿用，包括自定义 base URL 等设置。

总结：codex-plugin-cc 用"命令 + 钩子 + 子代理 + 技能"的轻量架构，把 Codex 的审查与执行能力无缝接入了 Claude Code 工作流，是双 AI 工具协作的一个务实范例。

【免费下载链接】codex-plugin-ccUse Codex from Claude Code to review code or delegate tasks.项目地址: https://gitcode.com/GitHub_Trending/co/codex-plugin-cc