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

Ai教程1小时前发布 大国Ai
2 0 0

摘要: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.jsonconfig.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用户用起来特别顺手。

核心的映射关系如下:

源(Claude Code) 目标
CLAUDE.md / AGENTS.md AGENTS.md
.claude/commands(斜杠命令) .agents/skills/(Codex Skills)
.claude/agents(子代理) .codex/agents/
.mcp.json(MCP服务配置) .codex/config.toml
.claude/settings.json(Hooks) .codex/hooks.json

值得一提的是,如果你之前用的是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 / ChatGPT Claude Code
入门 Plus $20/月 Pro $20/月
中阶 Pro 5x $100/月 Max 5x $100/月
重度 Pro 20x $200/月 Max 20x $200/月

钱是一样的钱,但你从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官方开发者文档及社区实测数据。原文灵感源自公众号”字节笔记本”。

© 版权声明

相关文章

暂无评论

none
暂无评论...