2026年Codex CLI推出0.140及以上版本，新增/import一键导入指令，大幅降低从Claude Code迁移的工作量。两款工具底层逻辑相近，但配置文件格式、权限管控、钩子事件、模型支持存在明显差异，整体迁移本质是文件重命名、格式转换与局部规则重写。本文基于Codex CLI 0.142.5与Claude Code 2.1.178实测，梳理12项配置对应关系、完整迁移步骤、Claude模型兼容网关搭建、高频故障与团队协作方案，覆盖个人开发者与企业团队两种场景。
一、迁移总览与决策判断
1 30秒迁移核心结论
整套迁移仅需20分钟，12项配置中9项可自动导入，剩余3项需要手动调整；唯一核心阻碍是Codex原生仅支持OpenAI系列模型，无法直接调用Claude，需搭建兼容网关解决。
| 问题 | 对应结论 |
|---|---|
| 大部分配置能否迁移 | 9项可完整自动转换，3项需手动修改 |
| 最快迁移路径 | 升级Codex至0.140+，执行/import自动导入，再手动修正权限、钩子、子代理 |
| 自动迁移内容 | CLAUDE.md指令、MCP服务、Skills、斜杠命令、自定义模型端点、会话记忆 |
| 必须手动处理项 | 权限管控规则、钩子事件、Subagent子代理封装 |
| 核心迁移卡点 | Codex原生不支持Anthropic Claude模型 |
| 卡点解决方案 | 配置兼容网关作为自定义model_provider，即可在Codex调用Claude |
阿里云部署AI Agent：OpenClaw/Hermes Agent全网最简单，只需两步，详情👉访问阿里云OpenClaw/Hermes一键部署专题页面了解。
Token Plan Token最便宜/支持多模型切换：👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换，用于多模态模型灵活调用，实现多模型、多工具、多场景下的额度共享与统一管理，兼顾灵活性、稳定性与安全性，大幅降低企业使用大模型的门槛与成本。
2 何时适合迁移、建议保留Claude Code场景
推荐迁移场景
1 团队需要CI/流水线无交互执行AI编码任务，默认只读沙箱管控；
2 希望统一仓库配置，使用TOML分层profile区分生产/测试/本地环境；
3 主力使用gpt-5.5、gpt-5.4等OpenAI官方模型，长期降低调用成本。
建议继续使用Claude Code场景
1 重度依赖ConfigChange配置变更钩子、自定义输出样式功能；
2 长期多轮交互式结对编程，对话驱动工作流；
3 精细化逐命令权限白名单，需要颗粒度极高的操作管控。
迁移前置系统要求
1 Codex CLI版本≥0.140，低于该版本无/import导入能力，执行codex --version核对；
2 本地完整保留.claude目录与CLAUDE.md，迁移完成前不删除原配置；
3 拥有OpenAI密钥，或搭建Claude兼容网关获取接口凭证；
4 当前用户拥有~/.codex目录读写权限。
二、12项配置完整映射对照表
Claude Code采用JSON+Markdown混合配置，Codex统一使用TOML格式，文件存储路径、字段定义存在差异，12项核心配置对应关系如下：
| 序号 | Claude Code配置 | Codex对应配置 | 迁移难度说明 |
|---|---|---|---|
| 1 | CLAUDE.md项目指令 | AGENTS.md，可配置降级读取CLAUDE.md | 自动迁移，仅修改文件名 |
| 2 | .mcp.json MCP服务 | config.toml [mcp_servers]区块 | 自动转换JSON至TOML格式 |
| 3 | .claude/skills技能目录 | config.toml [[skills]] | 完整自动迁移 |
| 4 | .claude/commands斜杠命令 | Codex内置提示词/斜杠指令 | 自动导入，少量微调 |
| 5 | .claude/agents子代理Markdown | .codex/agents/*.toml | 需手动重写封装结构 |
| 6 | settings.json全局配置 | config.toml+多profile | 格式转换，部分字段丢弃 |
| 7 | permissions权限黑白名单 | sandbox_mode+approval_policy | 无法一一对应，手动重定义安全策略 |
| 8 | PreToolUse/Stop等hooks | [[hooks]]事件数组 | 事件映射，ConfigChange无替代 |
| 9 | ConfigChange钩子 | 无对应功能 | 无法迁移，相关自动化需重构 |
| 10 | ANTHROPIC_BASE_URL自定义端点 | [model_providers]自定义服务商 | 自动迁移适配网关 |
| 11 | outputStyle输出样式 | 无对应配置 | 直接舍弃该功能 |
| 12 | Anthropic Claude模型 | 原生仅支持OpenAI模型 | 需搭建兼容网关 |
三、标准分步迁移全流程
完整迁移链路：项目配置审计 → 执行一键导入 → 冲突校验 → 手动修复权限与钩子 → 搭建Claude兼容网关 → 只读模式验证
步骤1：项目配置前置审计
进入待迁移项目根目录，检查CLAUDE.md、.claude目录完整，确认MCP、Skills、子代理无损坏文件，备份.claude目录防止导入覆盖丢失数据。
步骤2：执行Codex一键导入
1 终端进入项目文件夹，启动Codex交互会话：
codex
2 在Codex对话内执行导入指令：
/import
3 导入工具自动扫描本地Claude全部配置，提供导入选项，可按需勾选MCP、技能、指令、历史会话；执行完成输出冲突与未迁移内容报告，生成基础~/.codex/config.toml与AGENTS.md。
步骤3 适配项目指令文件
Codex默认读取AGENTS.md，若希望保留原有CLAUDE.md无需改名，在全局config.toml增加降级读取配置：
[features]
project_doc_fallback_filenames = ["AGENTS.md", "CLAUDE.md"]
project_doc_max_bytes = 32768
写入后重启Codex，两类文档均可自动加载上下文规则。
步骤4 MCP服务格式转换示例
原Claude .mcp.json写法：
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
导入后自动转为TOML格式，无需手动修改：
[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
如需环境变量，可追加env键值对。
5 Subagent子代理手动改造
Claude将子代理存为Markdown，Codex每个子代理独立TOML文件存放至.codex/agents/，示例reviewer.toml：
name = "代码评审代理"
description = "检查代码缺陷与编码规范"
developer_instructions = """
逐行对比代码变更，标注问题并给出修改行号
"""
原有Markdown内提示文本直接复制至developer_instructions字段即可。
6 权限安全策略重构（核心手动项）
Claude细粒度命令黑白名单无法直接迁移，Codex采用沙箱+审批双参数管控，映射规则：
| Claude权限规则 | Codex对应配置 |
|---|---|
| allow允许指定命令 | sandbox_mode="workspace-write" + approval_policy="on-request" |
| ask弹窗确认 | approval_policy="on-request" |
| deny禁止文件读取 | sandbox限制工作区外部访问 |
| Plan只读模式 | sandbox_mode="read-only" |
| 完全免确认执行 | approval_policy="never" + sandbox_mode="danger-full-access" |
通用默认安全配置写入config.toml：
sandbox_mode = "workspace-write"
approval_policy = "on-request"
7 Hooks钩子事件适配
Codex支持PreToolUse、PostToolUse、SessionStart、PreCompact等事件，仅缺失ConfigChange，配置写法示例：
[[hooks.PreToolUse]]
matcher = "^Bash$"
[[hooks.PreToolUse.hooks]]
type = "command"
command = "./.codex/hooks/pre-check.sh"
8 兼容网关：Codex调用Claude模型（核心卡点解决方案）
Codex原生仅支持OpenAI Responses协议，通过自定义model_provider接入兼容网关即可使用Claude系列模型，配置步骤：
1 在~/.codex/config.toml新增自定义服务商区块：
[model_providers.claude-gateway]
name = "Claude兼容网关"
base_url = "网关/v1地址"
env_key = "CLAUDE_API_KEY"
wire_api = "responses"
requires_openai_auth = false
关键参数说明：wire_api必须填responses（2026年起废弃chat协议），requires_openai关闭OpenAI密钥校验。
2 新建独立profile配置文件~/.codex/claude.profile.toml：
model = "anthropic/claude-opus-4.8"
model_provider = "claude-gateway"
3 切换profile启动Codex使用Claude模型：
codex --profile claude
可创建多profile分别对应OpenAI、Claude模型，实现一键切换对比测试。
9 迁移验证
新建只读profile测试整套配置，执行代码重构、文件读取、MCP工具调用，确认技能、钩子、模型均可正常工作。
四、高频迁移报错与修复方案
1 问题：Codex无法读取CLAUDE.md
原因：默认仅读取AGENTS.md；修复：添加fallback降级文件名配置。
2 自定义网关返回401鉴权失败
原因：开启OpenAI密钥校验；修复配置requires_openai_auth=false。
3 启动提示chat协议已废弃
原因：wire_api配置为chat；修改为responses。
4 Subagent调用无响应
原因：agent文件缺失或未主动调用；使用/agent指令加载对应子代理。
5 原有允许命令执行时被拦截
原因：沙箱模式管控更严格；调整sandbox_mode放宽权限。
五、团队协作迁移方案
单人配置分散的问题在团队场景可彻底解决：
1 Claude Code：团队共享settings.json，个人使用settings.local.json覆盖；
2 Codex：仓库根目录统一存放.codex/config.toml纳入版本控制，个人通过本地profile独立调整模型、权限。
团队统一在共享config注册Claude兼容网关，成员本地仅配置密钥环境变量，一套网关多账号共用，统一账单与用量统计。
六、多Profile进阶使用
Codex支持多环境配置文件，区分CI流水线、本地开发、Claude模型场景：
1 CI自动化profile（只读无审批）：
model = "gpt-5.5"
approval_policy = "never"
sandbox_mode = "read-only"
2 日常开发profile：workspace-write读写模式；
3 Claude专用profile：绑定兼容网关调用大模型。
启动时通过--profile参数自由切换，无需频繁修改全局配置。
七、整体总结
Codex 0.140版本推出的/import导入功能大幅降低Claude Code迁移成本，九成配置可自动完成格式转换，仅权限规则、子代理、Claude模型三项需要手动适配改造。核心难点在于Codex原生不支持Anthropic模型，搭建Responses兼容网关即可完美解决。迁移后Codex沙箱安全分层、多Profile环境管理、统一TOML仓库配置更适配企业CI与团队协作；如果重度依赖ConfigChange钩子、精细化命令白名单，可保留双工具并行使用。整套迁移流程20分钟内可完成，完成后既能复用原有全部技能与项目规范，又能享受Codex原生OpenAI模型与流水线自动化能力。
