山石 SHANSHI

工具对照:Codex 与 Claude Code

前面的判断都是通用的。这一页只集中说明两个工具真正不同的机制:规则文件、权限、计划、Review、Skill、Hook、MCP、会话和自动化。不要把工具差异放到主线前面,它应该是最后的速查表。

本章目标

  • 能把一个概念在 Codex 和 Claude Code 之间快速对应。
  • 知道哪些是官方机制,哪些只是个人使用经验。
  • 能设计两个工具配合的工作流。

先区分机制和经验

  • 官方机制:文件名、加载规则、权限模式、配置位置、Review、Hook、MCP、Skill。
  • 个人经验:哪个更爱追问、哪个执行更快、哪个适合长任务,只能作为起步建议。
  • 不强行等价:工作流可以映射,但不代表每个功能名都有一一对应物。
  • 最终标准:拿真实代码库跑一周,看哪个组合让返工、验证缺口和 review 噪音更少。

概念对照

  • 项目规则文件:Codex = AGENTS.md;Claude Code = CLAUDE.md,可导入 AGENTS.md 保持单一事实源。
  • 权限机制:Codex = sandbox + approval;Claude Code = permission modes + allow / deny / ask + hooks。
  • 先看方案:Codex = 明确要求先计划、Plan / Goal 等工作流;Claude Code = plan mode。
  • 上下文管理:两边都需要 clear、compact、resume;Claude Code 的 checkpoint / rewind 更显式。
  • 评审:Codex 有 Review pane 和 /review;Claude Code 可以用 fresh subagent 或 code review workflows。
  • 复用:Codex = Skills、commands、hooks、MCP、automations;Claude Code = commands、skills、subagents、hooks、MCP、routines。
  • 外部上下文:两边都支持 MCP;有成熟 CLI 时优先 CLI。

什么任务更适合哪个

下面是使用倾向,不是硬规则。默认配置、项目类型、个人习惯都会改变体验。

  • 已经想清楚、要快速执行的改动:Codex 直接推进很顺手。
  • 还没想清楚、需要反复澄清的功能:Claude Code 的采访和 plan mode 很适合。
  • 本地 diff review 和行级反馈:Codex App 的 Review pane 很实用。
  • 需要细粒度 Hook、subagent 角色和 checkpoint:Claude Code 机制更显式。
  • 批量、异步、定时工作:优先选你当前项目里权限、环境和验证链路最成熟的一边。

怎么组合使用

  • 探索/架构讨论:交给更愿意澄清的一方,别急着改。
  • 机械执行/批量改动:交给边界写清后能快速落地的一方。
  • 评审:用另一个新上下文或另一个工具做 fresh review。
  • 共用资产:先写工具无关流程,再分别落到 AGENTS.md、CLAUDE.md、Skill、命令或 Hook。
  • 外部能力:尽量共用同一套 CLI、MCP 和项目规则,减少双份维护。