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.md

3.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 自动会帮你完成，但在