第 28 卷
从Claude Code过来
Q：能把Claude Code的设置直接搬过来吗？
能。CLI里 /import，桌面App里Settings > Import，可以导入设置、当前项目和近期会话（App里还支持
Claude Cowork和Cursor，可以开自动同步）。它会直接改你的 ~/.codex/config.toml，并把旧会话加进历
史，本书实测时CLI里回车就直接导入了，没看到确认。先备份config.toml再导。导进来的会话可以用 codex archive 会话ID 归档，之后还能 codex unarchive。
Q：CLAUDE.md和AGENTS.md能共存吗？
能，但要知道Claude Code怎么读这两个文件。Claude Code从2.1.277起原生读AGENTS.md，规则是：从当前目录往上，只要有一个CLAUDE.md（或CLAUDE.local.md），它就只读CLAUDE.md，同一条路径上的 AGENTS.md整个不读；一个CLAUDE.md都没有，才读AGENTS.md。这个行为可以在Claude Code的 /config
里Project instructions一项改，默认值是 claude-md-or-agents-md，改成 claude-md-and-agents-md 可以两
个一起读。要写进配置文件的话，它在用户设置的 pluginConfigs 下面，写在项目设置里不生效。另外， ~/.claude/CLAUDE.md 不算「路径上有CLAUDE.md」，项目里的 .claude/CLAUDE.md 和 CLAUDE.local.md
算。
所以两边一起用，最省事的做法是只留AGENTS.md：Codex读它，新版Claude Code也读它。如果项目里已经有CLAUDE.md，要么把内容并进AGENTS.md再删掉CLAUDE.md，要么在CLAUDE.md里写一行 @AGENTS.md
导入。别在同一个仓库里一部分目录放AGENTS.md、一部分放CLAUDE.md，Claude Code那边会有规则静默失效。
Skills与扩展
Q：Skill不生效？
1.目录结构对不对：要有 SKILL.md，开头有name和description。
2.放的位置对不对：项目里是 .agents/skills/，个人是 ~/.agents/skills/。
3.会话里 /skills 看它在不在列表里。
- description是不是写清楚了什么时候该用；不放心就显式写 $skill-name。
5.有没有在 [[skills.config]] 里被设成了 enabled = false。
Q：MCP服务器连不上？
会话里 /mcp verbose 看详细状态， /warnings 看启动时的报错。需要OAuth的用 /mcp login 名字。启动慢的服务器在 [mcp_servers.名字] 里把 startup_timeout_sec 调大（默认10秒）。还不行就跑一遍 codex
doctor。
Q：hook没执行？
新的或改过的hook要先审核信任才会跑， /hooks 里看它是不是在等审核；项目里的hook只在你信任了这个项
云端
Q：云端任务失败，常见原因？
1.环境没准备好：发布前看设置报告，确认测试能在环境里跑通。
2.缺环境变量或密钥：在环境配置里补；给外部服务的凭据用Network secret。
3.要联网但没开：环境默认不联网，按需开Package managers预设或加具体域名。
4.任务描述太含糊：云端不会中途来问你，相关文件、预期行为、怎么验证都写进去。
Q：云端的结果怎么拿到本地？
开了PR就在GitHub上合并再 git pull；也可以用 codex cloud apply 任务ID 直接把diff应用到本地。
用久了会遇到的
Q：额度掉得快？
1.看模型：GPT-6 Astra在Plus的5小时窗口里只有5到45条，Luna有350到3,000条。
2.看档位：Max、Ultra、Fast都会成倍消耗。
3.看后台：自动代码审查、定时任务、子agent都在花额度。 /usage 能看历史。
Q：找不到之前的对话？
codex resume --all 不限目录列出全部；归档过的用 codex unarchive。关键结论别只放在对话里：让它把
决策和待办写进项目里的一个markdown，或者用 /export 导出。
Q：它为什么不先问问题就开干？
默认模式下它倾向于边说边做。想先看方案，用 /plan 切到Plan模式；或者在AGENTS.md里写一句：
开始任何非trivial任务之前，先用2-3个问题确认需求范围和验收标准，得到我的回答后再开干。