Claude code 快速迁移
codex 对于 Claude code 专门做了配置入口,我们可以在设置 -- 常规 -- 从其它 AI 应用导入工作内容,选择导入后支持将 Claude code 的 skill、插件、agent.md 以及最近 30 天的聊天记录直接迁移过来;未来是否会支持 cursor 暂不确定,cursor 的迁移暂时得手动处理。
三、从 cursor 视角完成迁移
3.1 配置账号级别指令 (全局指令)
codex 的指令效果和 cursor 的 rule 作用类型,它的作用是告知 AI 在问答时必须遵循的规则,它可能是项目规范,细化到某个技术的要求等等,我们可以直接在设置 -- 个性化 -- 自定义指令添加你希望 codex 遵循的个人规则,这里分享下我的规则。
## 1. 编码前先确认 不要私自假设。先说明假设、权衡和不确定点;有争议时由我决策。 如果我要求先讨论方案,不要修改代码,直到方案确认无疑问后再开始实现。 ## 2. 最小改动 只用解决问题所需的最少代码。不添加投机性功能,不为单次使用建立抽象。 只改必须改的地方,不顺手优化、重构或改动无关代码,保持现有风格。 ## 3. 分步执行 复杂任务先确认技术方案,再按步骤执行;每完成一步先汇报并等待确认后继续。 简单任务可自主迭代,直到验证通过。 ## 4. 优先参考现有实现 实现前先找现有业务或模块作为参考,尽量复用已有模式;不明确时先问我。这个执行会在 codex 会话启动时自动注入到上下文中,所以一般不推荐这个文件包含过多复杂的指令;俗话说的好,指令越多那就等于没指定,所以一般这里存放你希望跨项目且 codex 必须遵守的重要指令。
另外,以上执行的修改等同于修改~/.codex/AGENTS.md,修改方式不同,但本质是同一个文件。
3.2 配置项目级别指令
顾名思义,这个 rule 只会在对应项目上下文提问时,自动注入到对话上下文,codex 的做法和 Claude code 相同,我们只用在项目根路径新建AGENTS.md文件即可,比如 codex 在修改这个项目时必须遵守的技术规范等等。
而我们 notta 项目是一个 monorepo 仓库,因此也不适合项目根路径创建一个 AGENT.md,合适的做法是在不同项目创建属于它自己的项目级别指令,比如:
3.3 配置项目级别 Skills
Skills 简单理解就是给 AI 阅读的 sop 文档,我们可以将工作中重复性高预期明确的事情封装成 skills,具体 skill 如何写这里不展开,最简单的方式是使用skill creator的系统级别 skill 来让 AI 创建。
之前 cursor 的 skill 都在.cursor/skills目录下,将 cursor 的 skills 迁移过来非常简单,我们只用将.cursor改成.agents即可,skills 目录不用做任何修改,之后重启 codex 即可,如图:
3.4 个人级别 skills
与指令相同,skills 也支持配置个人(账号)级别,这种 skill 无论在哪个项目都可以生效,它的目录如下,与项目级别存放地址不同:
// 个人级别 ~/.codex/skills/notta-figma ~/.codex/skills/notta-i18n ~/.codex/skills/notta-spec // 项目级别 .agents/skills/notta-figma/SKILL.md .agents/skills/notta-i18n/SKILL.md .agents/skills/notta-less-guard/SKILL.md3.5 配置 MCP
如果我们将 codex 理解一个内置大模型的 AI 黑盒,MCP 的作用就是让这个盒子能和外界通信,比如阅读 Google doc 文档,拉取 linear bug 信息;codex 配置 mcp 也很简单,在设置 -- MCP 服务器可添加和编辑 mcp,比如我非常喜欢 kiro 的 spec 工作流,所以添加了如下配置,如图:
其中工作目录决定这个 MCP 的作用范围,比如截图是 codex 根路径,那就是个人级别 MCP,如果需要对特定项目生效,再次增加项目路径即可。
3.6 开启记忆 memories
与 cursor 、Claude code 一样,codex 同样支持开启 memories,我们可以在设置 -- 个性化 -- 记忆 -- 启动记忆,之后 codex 会在和你日常沟通中自动提取重要的记忆,记忆是账号级别,也就是跨项目跨对话。
codex 的 memories 类似一个外置的 RAG,比如某个话题之前 AI 犯错过,但对你非常重要,一般 AI 会主动记录记忆,那么下次相同问题讨论 AI 会主动接入记忆避免犯错。
如果你希望迁移 cursor 的 memories,最简单的方式让 codex 阅读 cursor memories 后直接写入自身的记忆文件,一般情况我们不需要手动维护 memories,记忆记录在~/.codex/memories目录下。
3.7 使用 codex 插件
简单来说,插件是 skill、mcp 和 rule 的集合体,比如 linear 插件,它内置了访问 linear 的 mcp,也提前定义了一些处理 linear 的一些 skill 或者指令;比如我们做前端开发阅读让 AI 阅读 figma 设计稿就需要配置 figma mcp,但更简单的办法是直接安装 codex figma 插件,这样 mcp 以及一些 skill 直接会内置,配置上更为简单。
我们能在 codex 左上角的插件中找到你可能需要的插件,点击安装即可。
四、一些 codex 小技巧
4.1 给予 codex 更高权限
默认情况下,codex 使用默认权限,一般项目的修改,读取 codex 自动会帮你完成,但在