Appearance
32 · 从 Claude Code 迁移：旧地图换个工具，照样能找到家
如果你之前用过 Claude Code，迁移到 Codex 时不需要从零开始。
很多心智模型能直接搬过来。 但名字、配置文件、权限模型会变。
先迁移规矩，再迁移配置
换工具时，最重要的不是把按钮和命令一一对应。 最重要的是把你原来的工作规矩搬过来：
- 项目怎么启动。
- 改完怎么检查。
- 哪些文件不能乱动。
这些规矩稳定了，工具差异就没有那么可怕。
第一次练习：先迁移说明书
不要一上来搬所有配置。 先搬项目说明书：
text
请帮我把 Claude Code 里的项目规则，整理成 Codex 可用的 AGENTS.md 草案。
要求：
1. 保留项目目标
2. 保留常用命令
3. 保留禁止事项
4. 改成 Codex 能理解的表达
5. 先给草案，不要写文件说明书迁移顺了，再处理权限、配置和工具。
01 先给定心丸：你的心智模型 90% 能直接搬
这些能迁移：
- 先读项目，再动手。
- 明确目标、范围、限制、验收。
- 看 diff。
- 跑测试或构建。
- 不让 AI 直接做高风险动作。
工具换了，协作原则没变。
02 一张大对照表：旧地名 → 新地名
| Claude Code 习惯 | Codex 里怎么理解 |
|---|---|
| CLAUDE.md | AGENTS.md |
| settings.json | config.toml |
| 权限模式 | 沙箱 + 审批 |
| slash commands | 斜杠命令 |
| 子代理/插件/技能 | Codex 也有相近概念 |
不要强行一一对应。 先理解用途，再找 Codex 里的位置。
03 项目说明书：CLAUDE.md → AGENTS.md
迁移第一步通常是改项目说明书。
提示词：
text
请把这份 CLAUDE.md 改写成适合 Codex 的 AGENTS.md。
要求：
1. 保留项目规则
2. 删除只适用于 Claude Code 的说法
3. 增加 Codex 的验证和汇报要求
先给改写草案，不要直接覆盖文件。04 配置文件：settings.json → config.toml
JSON 和 TOML 格式不同。 不要直接复制。
可以问：
text
请帮我把 settings.json 里的配置按含义映射到 config.toml。
无法映射的项请单独列出来，不要硬转。05 权限模型：权限模式 → 沙箱 + 审批
Codex 里你要重点理解：
- 沙箱范围。
- 审批策略。
- 网络权限。
- 文件写入范围。
迁移时先保守：
text
请给我一套保守的 Codex 权限设置建议。
适合刚迁移项目，优先安全，不追求全自动。06 交互习惯：斜杠命令、会话管理的异同
你以前的命令习惯不一定完全一样。
先问：
text
请列出 Claude Code 里我常用的交互动作，在 Codex 里分别应该怎么做。
只讲对应关系，不要执行。07 别想当然：这些在 Codex 里没有或不一样
迁移时最怕“我以为一样”。
要特别检查：
- 配置项是否同名。
- 权限含义是否一致。
- 插件和 Skill 是否兼容。
- 命令是否存在。
- 默认工作目录是否一致。
08 动手：把一份 CLAUDE.md 改写成 AGENTS.md
练习流程：
- 读取 CLAUDE.md。
- 提取项目规则。
- 删除 Claude Code 专属描述。
- 改写成 AGENTS.md。
- 让 Codex 解释每一条规则。
小结
迁移不是复制文件。 迁移是把旧工具里的好习惯，翻译到 Codex 的结构里。
先迁移心智模型，再迁移配置。