退订Claude Code全面迁移Codex实操指南：一键搬家+配置转换+避坑清单

摘要：Anthropic近期的KYC认证、降智风波让不少Claude Code老用户心凉半截，而OpenAI这边GPT-5.5+Codex组合拳越打越猛——内置浏览器、SSH、Computer Use、一键迁移功能齐上阵，国区用户还能畅快使用不封号。本文基于实操经验+官方迁移文档，手把手带你完成从Claude Code到Codex的全量迁移，包括会话历史、Skills、MCP配置、Hooks的转换，以及迁移后必查的4个兼容性坑点。看完这篇，你可以彻底跟Claude Code订阅说拜拜。

为什么这个时间点切Codex，不是跟风是止损

先说结论：不是Codex有多神，是Claude Code自己在往下掉。

Anthropic最近的操作堪称教科书级别的”如何把忠实用户推向竞品”——先是强推KYC实名认证，再是被社区实锤模型降智，GPT-5.5发布后Claude官方低调承认调整了模型策略。你说订阅费没少交，体验反而打了折，这谁受得了？

反观OpenAI，GPT-5.5在Terminal-Bench 2.0上跑出了82.7%的成绩，而Claude Opus 4.7是69.4%。虽说Opus 4.7在SWE-bench Verified上还以87.6%领先，但日常编码、浏览器操控、文件系统这类Agent任务，GPT-5.5的优势已经非常明显了。

更重要的是使用体验。Codex桌面端（Codex App）现在一天推好几个版本更新，独占功能堆了一箩筐：Computer Use、内置浏览器、SSH远程连接，还有最新上线的”电子宠物”状态指示器和/goal自主迭代命令。最实在的一点——OpenAI对国区用户态度友好得多，封号少，还时不时重置周额度，这点对国内开发者来说是真金白银的差别。

所以本月起，我彻底停了Claude Code官方订阅，全面转Codex。接下来就是把家搬好的问题。

搬家前先摸底：两套系统核心概念对照

别急着动手，先把Claude Code和Codex之间的”物种差异”搞清楚，不然迁过去也是一脸懵。

配置体系完全不同：Claude Code用的是五层级联的settings.json（managed→命令行→本地项目→共享项目→用户默认），找个当前生效的规则得扒五层皮。Codex则是单一的config.toml文件，配合图形界面的模式选择器，read-only、workspace、full access一目了然。

指令文件换了名字：Claude Code的CLAUDE.md，到Codex这边叫AGENTS.md，功能一样——给AI看的项目说明书，声明代码结构、测试命令、命名规范等。好消息是AGENTS.md已经是跨工具事实标准，Cursor、Aider、Windsurf、Gemini CLI都能读。

扩展机制从插件变Skills：Claude Code靠插件市场和MCP Server扩展能力，Codex同样支持MCP，但额外有一套Skills体系。Skills本质上是一个文件夹，核心是SKILL.md文件，采用”渐进式披露”设计——启动时只加载元数据（约100 tokens），任务匹配时才加载完整指令（不到5k tokens），执行时按需拉取脚本和参考文档。Anthropic已将其做成开放标准agentskills.io，OpenAI、Google、Cursor均已跟进。

沙箱从应用层升级到内核层：Codex提供三种沙箱模式，直接在操作系统内核级别隔离，安全性比Claude Code的应用层方案高出不少。

一键迁移：Codex APP内嵌的”作弊级”功能

重点来了。OpenAI这次是真的把”挖墙脚”做成了产品功能——迁移工具直接内嵌在Codex APP里，整个流程比我换手机迁移数据还丝滑。

迁移覆盖范围

先看看能迁什么，你可能比自己想象的带走的东西更多：

• ✅ 指令文件（CLAUDE.md → AGENTS.md）
• ✅ 配置文件（settings.json → config.toml）
• ✅ Skills技能包
• ✅ 过去30天的会话历史
• ✅ MCP服务器配置
• ✅ Hooks钩子
• ✅ 斜杠命令（slash commands）
• ✅ 子Agent配置

配置文件的自动转换是最让我意外的——settings.json到config.toml的格式变换它直接帮你做了，不需要手动重写。

操作步骤（APP方式）

1. 打开Codex桌面端，进入Settings → General
2. 找到”Import other agent setup“，点击Import
3. 勾选你要迁移的内容模块：Tools & Setup（设置、指令、插件、技能）、Projects（现有项目）、Include last 30 days of chats（最近30天聊天记录）
4. 点击Import，等待完成

就这么几步。迁移完成后界面会显示”Imported agent setup”，并标注上次导入时间。如果后续Claude Code那边又有改动，随时可以再次Import同步。

CLI用户的Plan B：migrate-to-codex技能

有些朋友不用桌面端，纯CLI工作流，或者APP迁移后有些零碎东西没带上，这时候就该第二个方案出场了。

Codex专门做了一个迁移技能：migrate-to-codex。这个技能开启后会另起一个新线程，把所有未成功映射的配置项列出来，让你逐条手动跟进。而且它会清晰区分哪些是用户级别（全局）、哪些是项目级别（当前仓库），CLI用户用起来特别顺手。

核心的映射关系如下：

值得一提的是，如果你之前用的是Superpowers这类跨平台技能库，迁移就更简单了——它本身就兼容Claude Code、OpenCode和Codex三大平台，只需要在Codex端设置CODEX_SKILLS_PATH环境变量指向技能目录即可。

迁移后必做的4项检查

迁完不等于能用。自动迁移解决了格式转换，但有些东西必须亲手过一遍，不然踩坑踩到怀疑人生。

① 技能和Agent里的工具权限

Codex的权限策略和Claude Code不完全对应。在config.toml中，approval_policy有四个可选值：untrusted、on-failure、on-request、never。迁移过来后默认可能是最保守的策略，你得根据实际需要调整。特别是那些之前设了自动执行的Skills，到Codex这边可能变成每步都要你确认，效率直接腰斩。

###② MCP服务器的认证信息

MCP配置虽然格式帮你转了，但里面的API Key、OAuth Token这些敏感信息是不会自动带入的——也不应该自动带入，安全考量。你需要手动在config.toml的[mcp_servers]段或者对应的MCP服务配置里重新填一遍。

如果你之前用了Claude Code自带的MCP Server能力，可以考虑反向操作：让Codex做主控，把Claude Code通过claude mcp serve以MCP Server方式挂载进来。核心配置长这样：

[mcp_servers.claude]
command = "claude"
args = ["mcp", "serve"]

这样既能用Codex的主流程，又能复用Claude Code打磨好的MCP工具链，算是个过渡期的黄金方案。

③ Hooks的行为变化

Claude Code的Hooks和Codex的hooks.json在触发时机和参数传递上有差异。特别是那些依赖特定文件路径的Hook——Claude Code的项目配置在.claude/下，Codex在.codex/下——路径变了，Hook可能直接哑火或报错。逐个测试一遍最稳妥。

④ Prompt模板里的路径和参数

自定义的Prompt模板如果硬编码了.claude/路径或者引用了Claude Code特有的参数名，迁移后也需要对应改成.codex/路径和Codex的参数格式。这一步没有捷径，grep一把全搜出来改掉。

关于成本：两边定价其实差不多，但Codex更值

很多人担心切换后费用会不会涨。实际上两边的订阅档位几乎是一一对应的：

钱是一样的钱，但你从Codex这边拿到的是GPT-5.5的27.2万token默认上下文（长上下文模式可达105万）、内核级沙箱、更频繁的功能更新、对国区友好的态度，以及持续进化的桌面端体验。这笔账怎么算都是Codex更划算。

如果还想进一步省钱，也可以考虑第三方API中转+国产模型的组合方案。比如DeepSeek官方已经提供了兼容Anthropic API的接入方式，智谱GLM和Kimi K2也有对应的编程套餐和平替方案。不过这条路适合愿意折腾的技术党，普通开发者还是官方订阅最省心。

最后说几句掏心窝的话

退订Claude Code不等于跟Anthropic老死不相往来。免费版的Claude Web处理日常对话完全够用，很多现有的工作流短期也离不开Claude Code的MCP生态，搭配第三方中转继续跑没问题。但作为主力编码工具，Codex在2026年中这个节点上确实是更好的选择。

迁移本身没什么门槛，半小时以内搞定。关键是迁移后那4项检查别偷懒，花个一小时过一遍，后续能省无数排错时间。

OpenAI这波迁移工具，说白了就是在Anthropic后院放了一把火——降低切换成本永远是最有效的抢人手段。但对我们用户来说，有竞争才有进步，两家互相卷，最终受益的是开发者。

文章来源：大国Ai导航整理，参考资料来自CSDN技术博客、开发者迁移文档、OpenAI官方开发者文档及社区实测数据。原文灵感源自公众号”字节笔记本”。