codex-plugin-cc源码阅读指南如何本地跑通并调试【免费下载链接】codex-plugin-ccUse Codex from Claude Code to review code or delegate tasks.项目地址: https://gitcode.com/GitHub_Trending/co/codex-plugin-cccodex-plugin-cc 是 OpenAI 官方出品的 Claude Code 插件让你不用离开 Claude Code就能用Codex 做代码审查code review或把任务委托给 Codex。这篇 codex-plugin-cc 源码阅读指南面向新手带你完整走一遍克隆源码、本地跑通、读懂代码结构再到用假 Codex 做调试全程只需 Node.js 即可上手。 项目速览codex-plugin-cc 能做什么一句话概括把 Codex 的能力搬进 Claude Code。安装后你会获得一批斜杠命令命令作用/codex:review只读代码审查可后台运行/codex:adversarial-review可引导的对抗式审查质疑设计与取舍/codex:rescue把调试/修复任务委托给 Codex/codex:status//codex:result//codex:cancel后台任务的状态、结果、取消/codex:transfer把 Claude Code 会话迁移为 Codex 持久线程/codex:setup检测 Codex 是否就绪管理审查门禁项目采用标准 Claude Code 插件结构核心内容都在 plugins/codex/ 目录下commands/— 各斜杠命令的提示词定义scripts/— 真正的执行逻辑Node.js ESMhooks/— 会话生命周期钩子skills/、agents/— 子代理与技能文件tests/— 单元测试Node 原生 test runner️ 本地环境准备3 个依赖一次配齐1. Node.js 18.18硬性要求见 package.json 的 engines 声明2. 克隆源码本指南所有相对路径都基于仓库根目录git clone https://gitcode.com/GitHub_Trending/co/codex-plugin-cc cd codex-plugin-cc3. Codex CLI调试测试时可暂时不装npm install -g openai/codex 好消息项目的单元测试用假 Codex驱动下文详述所以即使不登录 Codex 账号也能完整跑通测试。✅ 三步在本地跑通 codex-plugin-cc一键安装依赖npm install跑单元测试验证环境 OK 的最快方式npm test该命令实际执行 package.json 中定义的node --test tests/*.test.mjs覆盖 git、进程管理、渲染、状态存储等核心模块。全部通过后说明源码已在本地跑通。构建类型定义可选需要已安装 codex CLInpm run buildprebuild阶段会调用codex app-server generate-ts生成 App Server 协议类型见 tsconfig.app-server.json产物用于 lib/app-server-protocol.d.ts 相关的类型检查。没有 codex CLI 时跳过这一步不影响阅读与测试。️ 源码地图按这个顺序读30 分钟看懂全貌第 1 站主入口 codex-companion.mjs所有斜杠命令最终都落到这个脚本。文件开头的 printUsage 函数 是最好的目录页一眼列出全部子命令setup、review、adversarial-review、task、transfer、status、result、cancel。第 2 站lib/ 下的核心模块模块职责codex.mjs与 Codex App Server 通信、鉴权状态、审查执行state.mjs任务job的持久化存储tracked-jobs.mjs后台任务跟踪、日志、进度上报git.mjs收集 git 变更作为审查上下文render.mjs状态/结果/报告的文本渲染claude-session-transfer.mjsClaude 会话迁移给 Codex第 3 站命令定义与钩子命令的提示词层在 plugins/codex/commands/例如 review.md 规定前台流程就是执行node .../codex-companion.mjs review并原样返回 stdout——提示词决定行为脚本决定结果。钩子配置见 hooks.jsonSessionStart/SessionEnd负责会话生命周期Stop钩子最长 900 秒超时是审查门禁的实现入口。 调试技巧用假 Codex 做单元测试这个项目的测试设计非常值得学习fake-codex-fixture.mjs 会在临时目录里动态生成一个假 codex 可执行文件模拟 App Server 的 JSON-RPC 行为线程创建、轮次、中断等再把它放进 PATH。这样测试完全离线、可重复。想调试某个具体模块时可以直接单跑对应测试文件node --test tests/git.test.mjs node --test tests/process.test.mjs排查思路建议命令输出不对→ 先查 render.mjs 的渲染逻辑状态/结果查不到→ 查 state.mjs 的 job 读写后台任务卡住→ 查 tracked-jobs.mjs 与 process.mjs 的进程树终止逻辑 常见问题排查清单现象处理方式/codex:setup提示 Codex 未安装npm install -g openai/codex后重跑 setup已装但未登录在 Claude Code 中执行!codex login想改默认模型/推理强度编辑~/.codex/config.toml或项目根.codex/config.toml项目级需项目被信任才生效审查门禁循环太长用/codex:setup --disable-review-gate关闭⚠️ 官方提醒审查门禁review gate可能造成长时间的 Claude/Codex 循环、快速消耗用量额度只建议在有人盯屏时开启。 延伸阅读完整功能与命令说明README.md对抗式审查提示词prompts/adversarial-review.mdCodex 提示技巧技能skills/gpt-5-4-prompting/SKILL.md审查输出 Schemaschemas/review-output.schema.json版本发布脚本scripts/bump-version.mjs按入口脚本 → lib 模块 → 命令提示词 → 钩子的顺序通读一遍再配合npm test边改边验证你就能独立维护 codex-plugin-cc 这类 Claude Code 插件了。【免费下载链接】codex-plugin-ccUse Codex from Claude Code to review code or delegate tasks.项目地址: https://gitcode.com/GitHub_Trending/co/codex-plugin-cc创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
codex-plugin-cc源码阅读指南：如何本地跑通并调试
codex-plugin-cc源码阅读指南如何本地跑通并调试【免费下载链接】codex-plugin-ccUse Codex from Claude Code to review code or delegate tasks.项目地址: https://gitcode.com/GitHub_Trending/co/codex-plugin-cccodex-plugin-cc 是 OpenAI 官方出品的 Claude Code 插件让你不用离开 Claude Code就能用Codex 做代码审查code review或把任务委托给 Codex。这篇 codex-plugin-cc 源码阅读指南面向新手带你完整走一遍克隆源码、本地跑通、读懂代码结构再到用假 Codex 做调试全程只需 Node.js 即可上手。 项目速览codex-plugin-cc 能做什么一句话概括把 Codex 的能力搬进 Claude Code。安装后你会获得一批斜杠命令命令作用/codex:review只读代码审查可后台运行/codex:adversarial-review可引导的对抗式审查质疑设计与取舍/codex:rescue把调试/修复任务委托给 Codex/codex:status//codex:result//codex:cancel后台任务的状态、结果、取消/codex:transfer把 Claude Code 会话迁移为 Codex 持久线程/codex:setup检测 Codex 是否就绪管理审查门禁项目采用标准 Claude Code 插件结构核心内容都在 plugins/codex/ 目录下commands/— 各斜杠命令的提示词定义scripts/— 真正的执行逻辑Node.js ESMhooks/— 会话生命周期钩子skills/、agents/— 子代理与技能文件tests/— 单元测试Node 原生 test runner️ 本地环境准备3 个依赖一次配齐1. Node.js 18.18硬性要求见 package.json 的 engines 声明2. 克隆源码本指南所有相对路径都基于仓库根目录git clone https://gitcode.com/GitHub_Trending/co/codex-plugin-cc cd codex-plugin-cc3. Codex CLI调试测试时可暂时不装npm install -g openai/codex 好消息项目的单元测试用假 Codex驱动下文详述所以即使不登录 Codex 账号也能完整跑通测试。✅ 三步在本地跑通 codex-plugin-cc一键安装依赖npm install跑单元测试验证环境 OK 的最快方式npm test该命令实际执行 package.json 中定义的node --test tests/*.test.mjs覆盖 git、进程管理、渲染、状态存储等核心模块。全部通过后说明源码已在本地跑通。构建类型定义可选需要已安装 codex CLInpm run buildprebuild阶段会调用codex app-server generate-ts生成 App Server 协议类型见 tsconfig.app-server.json产物用于 lib/app-server-protocol.d.ts 相关的类型检查。没有 codex CLI 时跳过这一步不影响阅读与测试。️ 源码地图按这个顺序读30 分钟看懂全貌第 1 站主入口 codex-companion.mjs所有斜杠命令最终都落到这个脚本。文件开头的 printUsage 函数 是最好的目录页一眼列出全部子命令setup、review、adversarial-review、task、transfer、status、result、cancel。第 2 站lib/ 下的核心模块模块职责codex.mjs与 Codex App Server 通信、鉴权状态、审查执行state.mjs任务job的持久化存储tracked-jobs.mjs后台任务跟踪、日志、进度上报git.mjs收集 git 变更作为审查上下文render.mjs状态/结果/报告的文本渲染claude-session-transfer.mjsClaude 会话迁移给 Codex第 3 站命令定义与钩子命令的提示词层在 plugins/codex/commands/例如 review.md 规定前台流程就是执行node .../codex-companion.mjs review并原样返回 stdout——提示词决定行为脚本决定结果。钩子配置见 hooks.jsonSessionStart/SessionEnd负责会话生命周期Stop钩子最长 900 秒超时是审查门禁的实现入口。 调试技巧用假 Codex 做单元测试这个项目的测试设计非常值得学习fake-codex-fixture.mjs 会在临时目录里动态生成一个假 codex 可执行文件模拟 App Server 的 JSON-RPC 行为线程创建、轮次、中断等再把它放进 PATH。这样测试完全离线、可重复。想调试某个具体模块时可以直接单跑对应测试文件node --test tests/git.test.mjs node --test tests/process.test.mjs排查思路建议命令输出不对→ 先查 render.mjs 的渲染逻辑状态/结果查不到→ 查 state.mjs 的 job 读写后台任务卡住→ 查 tracked-jobs.mjs 与 process.mjs 的进程树终止逻辑 常见问题排查清单现象处理方式/codex:setup提示 Codex 未安装npm install -g openai/codex后重跑 setup已装但未登录在 Claude Code 中执行!codex login想改默认模型/推理强度编辑~/.codex/config.toml或项目根.codex/config.toml项目级需项目被信任才生效审查门禁循环太长用/codex:setup --disable-review-gate关闭⚠️ 官方提醒审查门禁review gate可能造成长时间的 Claude/Codex 循环、快速消耗用量额度只建议在有人盯屏时开启。 延伸阅读完整功能与命令说明README.md对抗式审查提示词prompts/adversarial-review.mdCodex 提示技巧技能skills/gpt-5-4-prompting/SKILL.md审查输出 Schemaschemas/review-output.schema.json版本发布脚本scripts/bump-version.mjs按入口脚本 → lib 模块 → 命令提示词 → 钩子的顺序通读一遍再配合npm test边改边验证你就能独立维护 codex-plugin-cc 这类 Claude Code 插件了。【免费下载链接】codex-plugin-ccUse Codex from Claude Code to review code or delegate tasks.项目地址: https://gitcode.com/GitHub_Trending/co/codex-plugin-cc创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
