Codex 与 Claude Code 文档速查

先学清楚“规则、上下文、验证、复用”各自负责什么，再去查工具如何实现。你不需要同时使用两个工具，也不必背一张随版本变化的命令表。

本页只整理会影响日常操作的官方入口，不把“哪个更爱追问”“哪个更适合执行”写成产品事实。

按问题找文档

这是资料入口，不是将官方文档整份复制进手册。产品行为与版本边界看原文；如何结合项目做判断，看前面的案例。

三个不能想当然的对应关系

规则文件不同。 Codex 以 AGENTS.md 为项目指令入口；Claude Code 使用 CLAUDE.md。已有一份共享规则时，可以按 Claude 文档通过 @AGENTS.md 导入，不要维护两份逐渐分叉的副本。

Skill 内容与加载方式不同层。 流程说明可以尽量工具无关，但项目目录分别是 .agents/skills/ 与 .claude/skills/。宿主专属字段、权限和自动触发行为需分别测试。

计划、评审不等于授权。 你可以用自然语言要求只读调查或评审，但仍应核对实际工具权限。换一个模式或开新会话，不自动保证所有外部动作都被禁止。

这些机制以本页核对时的官方文档为准；桌面、CLI、IDE 与云端的入口可能不同，遇到命令不识别时先查当前界面帮助，而不是猜另一个产品的同名命令。

例子：同一个检查任务迁移工具

先保留工具无关的任务说明：

只读检查这次笔记改动：
内容是否准确，例子是否标明假设，阅读顺序和链接是否正确。
提供问题位置与依据；没有执行的检查写明原因。
不要修复、提交或发布。

从一个工具换到另一个时，依次确认：

1. 是否在同一仓库状态上工作，文件与未提交 diff 是否齐全。
2. 是否加载了对应规则，而不是只看到了文件名。
3. 是否拥有执行项目检查所需的本地工具。
4. 是否能看到浏览器或其他必要证据；不能时如何补验。

只复制最后一条成功总结，新的工具并没有拿到原始证据。它可能复述结论，但这不构成独立检查。

想比较工具，先比较同一件事

选几项自己常做的任务，例如修改说明、修复可复现 Bug、整理一篇笔记。保持需求与初始仓库一致，记录通过情况、人工纠正、越界操作与总耗时。

某个工具在一个任务上表现顺手，只说明它适合这次配置与场景。需要更可靠的比较时，使用任务集评估，不要把使用印象写成长期排名。

官方文档值得保留为笔记中的参考入口；真正的软件使用入口和用途介绍，才适合放进工具目录。这样既不新增一级栏目，也不把文档和工具混成同一种卡片。