32 · 从 Claude Code 迁移到 Codex

把 CLAUDE.md、Skill、MCP、Hook、权限和日常工作流迁移到 Codex 的对应方式，指出可复用与必须重写的部分。

如果你之前用的是 Claude Code，迁到 Codex 时，好消息是很多思路是相通的，坏消息是有些东西得重来。这一篇帮你划清「能带走的」和「要重做的」。

「CLAUDE.md」对应 Codex 的「AGENTS.md」。作用类似——都是项目规则文件。但语法和细节不同，不能直接改名就用，要按 Codex 的规范重写一遍，内容思路可以沿用。

「Skill」两边都有这个概念，但目录结构、描述文件格式不一样。你的技能「思路」可以迁移，但「文件」要按 Codex 的格式重新组织。

「MCP」是最值得庆幸的部分：因为 MCP 是一个通用标准，你在 Claude Code 里配的 MCP 服务器，大多可以直接搬到 Codex 用，配置思路基本一致。

「Hook」两边也都有，但触发的时机、配置方式有差异，需要逐个对照调整。

「权限」模型两边不完全一样：同样是「审批」「沙箱」，但具体的档位、字段、默认行为有区别，要重新理解一遍，别想当然。

「日常工作流」层面，很多「心法」是通用的：怎么写任务描述、怎么审查差异、怎么控制上下文——这些经验可以直接带过来。

给你的迁移策略是：先迁移「思路」（心法、流程、MCP 这种通用的），再重写「载体」（规则文件、Skill 文件这种格式绑定的）。别指望一键平移，但也不用从零开始。

最后提醒：迁移是最好的「重新梳理」时机。趁机把原来堆得乱七八糟的配置，趁这次搬家整理干净。

常见误区：很多新手会把这一篇讲的「基本规则」当成「教条」——什么都严格遵守。其实这些规则的核心是「降低风险、提高效率」，理解了动机，规则就自然内化了，不用死记硬背。

五分钟练习：① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来，你对这一篇的理解会深 3 倍。

延伸阅读：学完这一篇，你可以看本组里的下一篇，把相邻的概念连起来读；也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的，多跳几篇会理解更深。

一页速览：如果只能记三件事，① {一}。② {二}。③ {三}。其他细节以后需要再翻这一篇查。