https://codexer.com/tags/migration/Recent content in Migration on CodexerHugozh-cnSat, 04 Jul 2026 10:00:00 +0800https://codexer.com/posts/2026-07-04-claude-code-to-codex-migration-guide/Sat, 04 Jul 2026 10:00:00 +0800https://codexer.com/posts/2026-07-04-claude-code-to-codex-migration-guide/<p>你用 Claude Code 已经大半年了。</p> <p>你的 <code>.claude/</code> 目录里堆满了精心调教过的配置：十几个 MCP 服务器、五个专用的 subagent、一套精确到命令级别的权限白名单，还有一堆 hooks 脚本。每次 <code>claude</code> 回车，一切都运转得像瑞士手表一样精准。</p> <p>但你也注意到了，Codex 这边的变化越来越快。0.140 版本加入了 <code>/import</code> 命令，0.142 进一步完善了沙箱和 hooks 机制。你开始琢磨：是不是该试试搬过去了？</p> <p>这个问题我问过自己，也帮几个团队实际走过一遍。结论是：<strong>大部分迁移是机械的，小部分需要重新理解，有一个地方必须用额外工具绕过去。</strong> 这篇文章把 12 个配置项一一拆开，告诉你每一步会发生什么。</p> <h2 id="30-秒速览能迁吗">30 秒速览：能迁吗？</h2> <table> <thead> <tr> <th>问题</th> <th>答案</th> </tr> </thead> <tbody> <tr> <td>大部分配置能迁移吗？</td> <td>能。12 个配置项中 9 个可以直接迁或简单改造。</td> </tr> <tr> <td>最快路径？</td> <td><code>codex</code> 里敲 <code>/import</code>，然后手动处理 3 个问题。</td> </tr> <tr> <td>自动迁移覆盖什么？</td> <td>指令文件、MCP 服务器、Skills、slash 命令、自定义 API 端点。</td> </tr> <tr> <td>需要手动处理的？</td> <td>权限模型、hooks 格式、subagent 包装方式。</td> </tr> <tr> <td>唯一的死胡同？</td> <td>Anthropic Claude 模型。原生 Codex 只能用 OpenAI 模型。</td> </tr> <tr> <td>死胡同的解法？</td> <td>注册一个 OpenAI 兼容网关作为 <code>model_provider</code>，继续用 Claude 跑代码。</td> </tr> </tbody> </table> <p>本文基于 <strong>Codex CLI 0.142.5</strong>（2026 年 7 月 1 日）和 <strong>Claude Code 2.1.178</strong> 实测。如果你用的是更老的 Codex，先升级，<code>/import</code> 命令在 0.140.0 之前根本不存在。</p>