让 Claude Code 主控 Codex：完整配置指南 #

背景 #

希望让 Claude Code 负责规划、编写和修复代码，同时调用 Codex 进行分析、审查和风险检查，可以通过 OpenAI 官方的 codex-plugin-cc 插件完成。两者共享当前项目目录和本机 Git 工作区，但职责可以明确分开：Claude Code 负责推进任务，Codex 负责质量门禁。

配置关系 #

这套配置包含四个部分：

Claude Desktop：提供桌面端 Claude 应用，但它不等于 Claude Code。
Claude Code：命令行开发入口，负责主控开发流程。
Codex CLI：由 Claude Code 插件调用的本地 Codex 命令行程序。
codex-plugin-cc：为 Claude Code 增加审查、委派、状态和结果查询命令。

安装 Claude Code #

Claude Code 需要 Node.js 18.18 或更高版本。没有管理员权限时，可以把 Node.js 和包管理器安装到用户目录，然后执行：

pnpm add --global @anthropic-ai/claude-code

确认命令可用：

claude --version

如果系统提示找不到命令，把用户级包目录加入当前用户的 PATH，不需要修改系统 PATH 或申请管理员权限。

安装 Codex 插件 #

在 Claude Code 中添加官方 marketplace，并安装插件：

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

确认插件状态：

/plugins

插件安装成功后，可以使用以下命令：

/codex:setup
/codex:review --background
/codex:adversarial-review --background
/codex:rescue investigate why the build is failing
/codex:status
/codex:result
/codex:cancel

Codex CLI 和认证 #

插件使用本机的 Codex CLI 和 Codex 配置，不会创建单独的 Codex 运行环境。确认 CLI 可用：

codex --version
codex login

Codex 应使用 ChatGPT 登录或 OpenAI API Key。Anthropic 的 sk-ant-... Key 不能直接作为 OpenAI API Key 使用。Claude Code 的 Anthropic 认证和 Codex 的 OpenAI 认证是两套独立配置。

如果 Claude Code 使用了第三方 API 路由或代理，还需要确认该路由有可用额度；否则插件命令可能还没有开始调用 Codex，就先因 Claude Code API 返回 402 而失败。

推荐协作流程 #

1. Claude Code 先规划 #

先阅读项目结构和现有代码，只输出实现计划，不要修改文件。

确认计划后，再让 Claude Code 实施并运行测试：

按计划实施。完成后运行相关测试，并总结修改内容、风险和未覆盖的测试。

2. Codex 审查 #

/codex:review --background

重点关注功能逻辑、边界条件、安全问题、错误处理、性能、兼容性和测试覆盖。审查阶段默认只读，不让两个模型同时修改同一批文件。

3. Claude Code 修复 #

将 Codex 的审查结果交给 Claude Code：

请根据下面的代码审查意见逐项修复。修复后重新运行测试，并说明哪些问题已解决。

4. Codex 复审 #

/codex:review --background

确认上一轮问题已解决，并检查修复是否引入新的回归。

项目规则建议 #

在项目根目录维护 CLAUDE.md，约束 Claude Code 先规划、再修改、最后测试；维护 AGENTS.md，告诉 Codex 默认只审查、按严重程度报告问题，并提供文件路径和行号。

常见问题 #

Claude Desktop 安装成功不代表 Claude Code 已安装；桌面应用和命令行工具是两个独立组件。

Windows 上 Cowork 需要现代 MSIX 安装方式和管理员权限。如果当前账号没有管理员权限，普通 Claude Desktop 仍可使用，但 Cowork 的现代安装和虚拟化依赖可能无法启用。

最终的职责划分可以概括为：Claude Code 负责规划、编写和修复，Codex 负责分析、审查和风险检查。通过串行协作和 Git 检查点，可以避免两个模型同时修改文件造成覆盖。