从 Claude Code 或 Cursor 迁移到 Codex:/import 命令与桌面端导入配置指南

以前在 Claude Code 或 Cursor 里辛辛苦苦配好的指令文件、技能、插件和项目记忆,换到或双持 Codex 时不用手动重抄一遍。本文根据 OpenAI 官方 Import 文档,讲清桌面端 Settings > Import 与命令行 /import 的完整映射规则与自动同步开关。

NNathaniel bigo··原创首发·AI 辅助撰写
9 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 Plus 账号

结论先说

  1. 官方内置了一键无损搬迁向导,不需要自己写转换脚本:桌面 App 支持从 Claude Code、Claude Cowork 和 Cursor 导入;Codex CLI 支持在空闲会话敲 /import 从 Claude Code 或 Cursor 导入。
  2. 对原工具 100% 只读安全:导入过程只读取并复制转换你选中的配置,绝不会修改或删除你原有的 CLAUDE.md、Cursor 规则或历史记录,非常适合长期双持。
  3. 不仅能导静态规则,连近期对话和项目记忆都能带过来:CLI 的 /import 支持导入最近 30 天内最多 50 条对话,还会把 Claude Code 的项目记忆映射进 Codex 的记忆库。
  4. 桌面端支持开启「自动同步(Automatic updates)」:打开后你在原工具里更新了配置或技能,桌面端会自动跟进同步,省去反复手动重导。

跨工具导入到 Codex 的配置映射表

图:本站根据 OpenAI Codex 官方文档 Import from another agent 整理的示意图

本文根据 OpenAI Codex 官方文档《Import from another agent》整理,核对日期 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 或 Anthropic 官方网站。

适用于谁

  • 搜「claude code 迁移到 codex」「cursor 配置导入 codex」「codex /import 怎么用」的开发者;
  • 平时双持两套编码工具交替使用(选型对比见 /guides/cursor-vs-claude-code-vs-codex),不想每次改一条项目规范或新写一个 Skill 都在两边手工复制粘贴的人;
  • 刚装好 Codex 桌面 App 或 CLI,想把最近正在做的半截项目对话和自动记忆无缝接过来继续干活的人。

一、它到底能把哪些东西自动转过去?

按官方映射说明表,向导会同时扫描你本机用户目录的全局设置和你所选项目仓库里的本地文件,逐项转换落位:

  • 指令文件(如 CLAUDE.md 与规则) → 自动转换为 Codex 标准读取的 AGENTS.md(读取优先级规则见 /guides/codex-agents-md-how-it-reads);
  • 配置文件(如 settings.json) → 映射写入 Codex 的 config.toml(各字段含义见 /guides/codex-config-toml-complete-guide);
  • 技能(Skills)与插件(Plugins) → 导入到 Codex 对应的技能与插件目录(技能加载机制见 /guides/codex-skills-how-to-use-install);
  • 既有项目目录、近期对话与记忆 → 自动绑定相同路径的本地项目,并将 Claude Code 的项目记忆(Project memories)与近期对话记录带入 Codex。

对于需要外部第三方账号 OAuth 登录的插件或 MCP 连接器,出于安全隔离原则,导入向导不会强行偷拷外部令牌,而是在导入完成后弹出一张状态卡片,提醒你点击补完最后一步授权即可使用。

从 Claude Code 或 Cursor 导入四步

图:本站根据 OpenAI Codex 官方文档 Import from another agent 整理的示意图

二、桌面 App 与 Codex CLI 分别怎么操作

方式一:在桌面端导入并开启自动同步

  1. 打开桌面客户端,进入 设置(Settings) → 导入(Import)(如果左侧尚未单独列出该栏,可在 通用(General) 下找到 导入其他智能体配置(Import other agent setup));
  2. 点击 导入(Import),勾选你要读取的来源工具(Claude Code、Claude Cowork 或 Cursor),点继续;
  3. 在「选择要导入的项目与资产(Select items to import)」清单里,按需勾选指令、技能、项目目录或近期会话,确认开始;
  4. 如果你是双工具并行重度用户,回到 设置 → 导入 页面打开自动更新(Automatic updates)开关,以后原工具里的改动就能自动同步过来,同页面还能随时回看导入历史记录。

方式二:在 Codex CLI 命令行用 /import 导入

如果你主要在终端或远程开发机 SSH 环境工作:

  1. 启动一个空闲的 codex 会话,直接输入 /import 回车;
  2. 在菜单里选择 Claude Code 或 Cursor;
  3. 勾选要迁入的用户级设置、当前项目文件与近期聊天记录(最多拉取最近 30 天内的 50 条会话;若连接了远程守护进程,CLI 会自动扫描对应远程机器上的配置与历史);
  4. 导入完成后核对一眼生成的 config.toml 与 AGENTS.md 即可直接接着写代码。

刚从其他编码工具切过来体验 Codex 时,如需了解 ChatGPT Plus 与 Pro 订阅各自包含的本地与云端配额规则,也可参考 /chongzhi/chatgpt-plus 的整理说明。

常见问题

Q:项目里原本已经手写了一份 AGENTS.md,再跑导入会不会把我写好的内容冲掉?

保险起见,在已存在自定义 AGENTS.md 或 config.toml 的仓库运行导入前,建议先做一次 git status 确保工作区干净(或先提交保存),导完后用 git diff 审阅向导合并进去的条目,删掉不需要的旧工具专属习惯描述。

Q:为什么有些 Claude Code 里的特殊斜杠参数或专属环境变量导过去没反应?

两套工具的底层沙箱实现和独有实验开关并不完全一一对应(比如特定厂商模型别名或实验性团队环境变量)。通用性最高的是项目构建命令、目录规范与标准 Markdown 技能,工具独有的高级权限项建议导入后对照 config.toml 手工微调一次。

相关教程

参考资料

  • OpenAI Codex 官方文档:Import from another agent — https://learn.chatgpt.com/docs/import-from-another-agent
  • OpenAI Codex 开发者中心 — https://developers.openai.com/codex

Nathaniel 的更多内容

  1. 01

    LangGraph 流式输出(Streaming)详解:逐字 Token 流、节点进度与自定义事件写法

    多步智能体如果等全部节点跑完才返回,网页前端就会白屏干等十几秒。本文按 LangGraph 官方文档讲清 updates、messages、custom 与 values 四种 stream_mode 的区别,以及组合订阅逐字打字机输出加工具内部实时进度的完整代码。

    其他 AI 工具0
  2. 02

    LangGraph 持久化与长期记忆怎么配:Checkpointer、Store 与 PostgreSQL 实战

    在生产环境跑 LangGraph,单靠 InMemorySaver 一重启就会丢失全部对话。本文按官方文档讲清线程内短期检查点(Checkpointer)与跨线程长期记忆(Store)的分工,以及用 langgraph-checkpoint-postgres 对接 PostgreSQL 的完整步骤。

    其他 AI 工具0
  3. 03

    LangGraph 多智能体怎么写:Supervisor 主管包与 Subgraph 隔离子图实战

    在 LangGraph 里把单个图扩展成多智能体协作有两条官方路线:快速原型用预置包 langgraph-supervisor,大型生产系统用原生子图(Subgraph)嵌套。本文讲清两种写法的完整代码、私有状态隔离防 Token 膨胀技巧以及检查点传播规则。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入审批怎么写:interrupt 暂停图运行与 Command 恢复实战

    企业之所以选 LangGraph,很大程度看中它能安全挂起等待人工审批(Human-in-the-Loop)。本文按官方最新规范讲清 interrupt() 动态暂停、Checkpointer 必备条件、Command(resume=...) 恢复执行,以及防止副作用重复运行的重入规则。

    其他 AI 工具0
  5. 05

    多 Agent 协作平台怎么选:Dify、扣子(Coze)、n8n 与 LangGraph 多智能体机制对比

    搜「多agent协作平台」时,Dify、扣子、n8n 和 LangGraph 都宣称支持多智能体,但底层的调度方式完全不同。本文跳过基础安装,专门从多 Agent 角色跳转、子代理工具调用、上下文隔离与私有化部署四个维度帮你一次选准。

    其他 AI 工具0
  6. 06

    企业微信有官方 MCP 和 CLI 吗:@wecom/cli 安装初始化、长连接机器人与接入教程

    搜「企业 微信 有 mcp 吗」不用再东拼西凑民间群机器人脚本了:企业微信官方已推出 @wecom/cli 命令行工具并内置 stdio 模式的 MCP Server。本文按官方开发者文档讲清安装、智能机器人长连接初始化、业务命令与接入 Claude Code 步骤。

    Claude其他 AI 工具0

同产品的其他教程

  1. 01

    MCP 收费吗:开源协议免费边界、第三方 API 账单与隐形 Token 开销说明

    搜「mcp 收费 吗」的人常担心装多了插件会被扣费。MCP(模型上下文协议)本身和官方 SDK 采用 MIT 协议完全免费;实际使用中可能产生费用的只有两处:挂载过多工具占用的大模型上下文 Token,以及部分外部商业数据源自带的 API 套餐。

    Claude其他 AI 工具0
  2. 02

    MCP 协议最新版本更新了什么:无状态架构、OAuth 2.1、结构化输出与异步 Tasks 详解

    搜「mcp 重大 更新」「mcp 协议 更新」想补齐规范演进脉络?本文对照 modelcontextprotocol.io 官方规范更新日志,梳理从 Streamable HTTP 到无状态优先架构、OAuth 2.1 资源服务器、Elicitation 交互补参与异步 Tasks 扩展的核心变化。

    Claude其他 AI 工具0
  3. 03

    A2A 和 MCP 有什么区别:工具连接协议与智能体通信协议的边界和配合

    很多人问「有了 MCP 为什么还要出 A2A,两者是不是二选一的竞争关系」。两份官方规范都明确写明它们是上下互补关系:MCP 负责给单个智能体挂载工具与数据源,A2A 负责让多个独立黑盒智能体跨团队、跨框架互相派单协作。

    Claude其他 AI 工具0
  4. 04

    LangGraph 怎么使用 MCP:用 langchain-mcp-adapters 接入本地与远程工具

    想让自建的 LangGraph 状态图直接调用现成的 MCP 服务器,官方标准方案是安装 langchain-mcp-adapters 并使用 MultiServerMCPClient。本文讲清 stdio 与 streamable_http 两种配置写法、异步图运行及按节点分工具技巧。

    Claude其他 AI 工具0
  5. 05

    LangGraph 入门教程:Python 安装、核心概念与跑通第一个状态图智能体

    面向搜「python 安装 langgraph」和「langgraph 中文 文档」的初学者:本文按 LangChain 官方最新 Graph API 规范,讲清安装步骤、State/Node/Edge 四大概念,并从零写出第一个带工具调用循环的 StateGraph。

    Claude其他 AI 工具0
  6. 06

    Claude Agent SDK 子代理怎么写:AgentDefinition 配置、权限收敛与 Python/TS 示例

    在 Python 或 TypeScript 里用 Claude Agent SDK 编排多角色协作,核心是配置 ClaudeAgentOptions 的 agents 字段与 AgentDefinition。本文讲清必开的 Agent 委派权限、工具收敛、模型分级与完整代码示例。

    Claude0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~