博客

Claude Code 迁移到 Codex 完整指南 2026：对话记录、配置与工作流迁移

快速回答

从 Claude Code 迁移到 Codex，核心步骤是：通过 /export 命令导出 Claude Code 对话历史（JSON 格式）、手动迁移自定义 slash 命令和 MCP 服务器配置，并将两个工具接入同一个 API 网关（如 TeamoRouter），从而实现共用同一 API Key、余额和模型访问。配置文件迁移比较简单，对话上下文的迁移需要手动处理。本文覆盖 2026 年的完整迁移流程。

为什么要从 Claude Code 迁移到 Codex？

2026 年，AI 编程工具的格局发生了显著变化。Codex（OpenAI 出品的智能体编程 CLI）已经发展为 Claude Code 的有力替代方案，在多文件重构、沙箱执行和深度 GitHub 集成方面各有千秋。许多从 Claude Code 起步的开发者正在评估 Codex 是否更适合自己的工作流，或者开始同时使用两者。

常见的迁移理由包括：

  • OpenAI 生态集成： 如果你的团队已经在用 ChatGPT、GPT-4o 或 OpenAI API，Codex 可以原生接入。
  • 沙箱执行模式： Codex 在隔离环境中运行代码，降低意外文件系统修改的风险。
  • GitHub 原生工作流： Codex 对 PR Review、Issue 分类和仓库级操作有一等支持。
  • 成本考量： 根据你的使用模式，某一款工具可能比另一款更具性价比。

不管出于什么原因，迁移并不意味着完全放弃 Claude Code。很多开发者通过统一 API 网关（如 TeamoRouter）同时运行两个工具，根据任务类型灵活切换。

前置步骤：先搭建统一网关

在工具之间迁移之前，先设置统一 LLM 网关。这是性价比最高的一步：Claude Code 和 Codex 都通过标准 API 协议连接（分别为 Anthropic 和 OpenAI 兼容协议），一个同时支持两者的网关意味着一个 API Key、一个账单面板、无需为每个工具单独管理凭证。

推荐： 使用 TeamoRouter 客户端 跳过手动配置。TeamoRouter 原生支持 Anthropic 协议（Claude Code）和 /v1/responses（Codex），两个工具共用同一个 Key 和余额。这还意味着你不需要安装本地路由代理，不会和 VPN 或系统代理冲突。

网关就绪后，迁移分四步：对话历史、slash 命令、MCP 服务器、API 凭证配置。

第一步：导出和导入对话历史

从 Claude Code 导出

Claude Code 的对话历史存储在本地 SQLite 数据库中（通常位于 ~/.claude/history.db）。2026 年你可以通过以下命令导出单个会话：

bash
# 按会话 ID 导出
claude export --session <session-id> --format json --output session.json

# 导出最近 30 天的会话
claude export --recent 30 --format markdown --output claude-history/

JSON 导出包含完整消息树：用户提示、助手回复、工具调用和工具结果。Markdown 导出更便于阅读参考，但会丢失结构化的工具调用数据。

导入到 Codex

Codex 不能原生导入 Claude Code 的历史文件，但有两种实用方法：

  1. 引用式工作流： 将导出的 Claude Code 会话保留为项目中的参考文件。启动新的 Codex 会话时，让它读取导出文件作为上下文：

    text
    codex "阅读 claude-history/session-123.md，继续其中描述的代码重构工作"

  2. CC Switch 桥接： 如果你使用 CC Switch 管理两个工具，CC Switch 可以维护跨供应商的统一会话索引。在 CC Switch 中同时配置 Claude Code 和 Codex，它提供跨工具的统一会话浏览器。

对于团队批量迁移，社区维护的 npm 工具 cc-migrate 可以自动化批量导出 Claude Code 历史并将其转换为 Codex 兼容的上下文文件。

第二步：迁移自定义 Slash 命令

Claude Code 的 slash 命令定义在每个项目的 .claude/commands/ 中（或全局的 ~/.claude/commands/）。Codex 使用类似的模式，路径是 .codex/commands/。

迁移脚本

格式足够相近，大部分命令直接复制重命名即可：

bash
# 复制项目级命令
cp -r .claude/commands/ .codex/commands/

# 复制全局命令
cp -r ~/.claude/commands/ ~/.codex/commands/

不过有几个差异需要注意：

  • Claude Code 使用 %ARG% 作为参数占位符；Codex 使用 $ARG。
  • Claude Code 的 {{selection}} 对应 Codex 的 {{selectedText}}。
  • 系统提示覆盖（Claude Code 的 --system-prompt 标志）在 Codex 中没有直接等效项；改用 Codex 的自定义指令文件。

复制后逐条检查并更新不兼容的语法。

第三步：迁移 MCP 服务器配置

Claude Code 和 Codex 都支持模型上下文协议（MCP），且配置文件格式有意保持兼容。复制 MCP 配置是最简单的一步：

bash
# Claude Code MCP 配置
cat ~/.claude/mcp.json

# Codex MCP 配置（相同格式）
cp ~/.claude/mcp.json ~/.codex/mcp.json

所有能在 Claude Code 中工作的 MCP 服务器（文件系统、数据库、API、网页搜索等）在 Codex 中表现完全一致。除了复制 JSON 文件外不需要任何迁移工作。

第四步：API 和凭证配置

如果你按照前置步骤设置了统一网关，这一步非常简单：两个工具已经指向同一个 TeamoRouter 端点。你的单个 API Key 即可用于两者。

如果你是从 Anthropic API 直连设置迁移过来，以下是配置差异：

设置项 Claude Code Codex
环境变量 ANTHROPIC_API_KEY OPENAI_API_KEY
Base URL 覆盖 ANTHROPIC_BASE_URL OPENAI_BASE_URL
默认模型 claude-sonnet-4-20250514 gpt-4o
配置文件 ~/.claude/settings.json ~/.codex/config.json

使用 TeamoRouter 时，两个工具共用一个 API Key。 统一方案消除了多 Key 管理的麻烦：

bash
# TeamoRouter 统一配置
export TEAMOROUTER_API_KEY="tr-your-key-here"

# Claude Code
export ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"
export ANTHROPIC_API_KEY="$TEAMOROUTER_API_KEY"

# Codex
export OPENAI_BASE_URL="https://api.teamorouter.com/openai"
export OPENAI_API_KEY="$TEAMOROUTER_API_KEY"

关于 API 路由和网关设置的更多信息，请参见 TeamoRouter AI API 网关，它提供 Claude、GPT、Gemini、DeepSeek 等模型的统一接入。

迁移后的 Claude Code 对比 Codex：有什么变化

迁移完成后，注意以下关键工作流差异：

方面 Claude Code Codex
编辑方式 行内 diff 应用 沙箱执行 + 文件写入
上下文窗口 200K tokens 200K tokens
多文件范围 Agent 驱动探索 仓库级感知
终端访问 直接（你的 shell） 沙箱（隔离环境）
Git 集成 基础（commit, diff） 深度（PR Review, Issue 分类）
付费模式 Anthropic API / Pro OpenAI API / ChatGPT Plus

沙箱执行模式是最大的调整点。Codex 不能直接在终端中运行命令；它在隔离环境中运行代码并将结果写回文件系统。这更安全，但对于快速的 shell 操作可能感觉更慢。

迁移检查清单

  • 设置统一 API 网关（推荐 TeamoRouter），实现双工具共用一个 Key 和余额
  • 导出 Claude Code 会话历史（JSON 用于结构化、Markdown 用于参考）
  • 复制 slash 命令从 .claude/commands/ 到 .codex/commands/
  • 修复参数占位符语法（%ARG% 改为 $ARG，{{selection}} 改为 {{selectedText}}）
  • 复制 MCP 服务器配置（mcp.json）从 Claude Code 到 Codex
  • 为网关设置环境变量（ANTHROPIC_BASE_URL / OPENAI_BASE_URL）
  • 在 Codex 中运行一个测试任务，与上次 Claude Code 会话对比输出质量
  • 验证计费：运行一个会话，确认网关面板上的费用显示正确

保留两个工具：混合使用方案

迁移不必是全有或全无。2026 年很多团队同时运行 Claude Code 和 Codex，使用 TeamoRouter 这样的网关作为统一路由层。这种混合方案让你可以：

  • 用 Claude Code 处理复杂推理和架构任务（Claude 的长上下文推理更强）
  • 用 Codex 做 PR Review、Issue 管理和沙箱执行（GitHub 集成更优）
  • 两个工具共用一个 API Key 和余额
  • 按任务切换工具，无需重新配置凭证

如果你在并行评估两个工具，可参见我们详细的 Claude Code vs Codex 对比，了解任务级别的基准测试和成本分析。

常见问题（FAQ）

能把 Claude Code 的完整对话历史迁移到 Codex 吗？

不能原生导入。Codex 没有直接导入 Claude Code SQLite 历史数据库的功能。最好的方法是将 Claude Code 会话导出为 JSON 或 Markdown 文件，然后在启动新的 Codex 会话时引用这些文件。社区工具 cc-migrate 可以自动化批量导出和格式转换。

Claude Code 的 MCP 服务器能在 Codex 中使用吗？

可以。两个工具都使用模型上下文协议（MCP），配置文件格式相同。将 mcp.json 从 ~/.claude/ 复制到 ~/.codex/ 即可。所有类型的 MCP 服务器（文件系统、数据库、API、网页搜索）都可以跨工具兼容。

需要为 Claude Code 和 Codex 分别准备 API Key 吗？

使用统一 API 网关就不需要。TeamoRouter 通过单个 API Key 同时支持 Anthropic 协议（Claude Code）和 OpenAI /v1/responses（Codex），统一计费、统一余额管理。参见 TeamoRouter AI API 网关 了解设置方法。

Codex 比 Claude Code 便宜吗？

取决于你的使用模式和 API 供应商。Codex 倾向于发出更多 API 请求（因为其基于循环的智能体模式），但每次请求通常更短。Claude Code 发送更长的上下文但轮次更少。使用 TeamoRouter 这样的网关，提示词缓存命中率大于 99%，浮动费率低至官价 1-2 折，两个工具的实际花费都比直接付官方原价要低得多。

切换后最大的工作流差异是什么？

Codex 在沙箱执行环境中运行，这意味着它不能直接在终端中运行命令。命令在隔离容器中执行，结果写回文件系统。Claude Code 直接在你的 shell 中运行。这是最大的调整点：更安全，但对于快速终端操作可能感觉更慢。

能同时使用 Claude Code 和 Codex 吗？

可以，这在 2026 年越来越普遍。许多开发者使用统一网关（如 TeamoRouter）配合 CC Switch，在一个面板中管理两个工具，按任务切换：Claude Code 用于深度推理和架构，Codex 用于 PR Review 和沙箱执行。两个工具共用同一 API Key 和余额。

准备好接入了吗？登录控制台 · 购买额度 · 创建 API Key，三步即可开始。
获取 API Key查看帮助文档
关闭文章
Claude Code 迁移到 Codex 完整指南 2026：对话记录、配置与工作流迁移 · TeamoRouter