# Claude Code 与 Codex 官方最佳实践对照

两家官方指南收敛于同一操作模型：Context 先行、高歧义时先 Plan、用可运行检查验证、持久化指导、控制权限、可靠后再扩展。

[coding-agents][claude-code][tools]

Claude Code 与 Codex 是 coding agent 市场的两个标杆产品。官方最佳实践的价值不在于「哪个更好」，而在于 如何可靠地操作一个 coding agent——从「选工具」转向「建操作习惯」。

共享操作模型

两家官方指南收敛于八点：

主题	要点
验证工作	提供测试、构建、截图；无检查则人成为唯一验证环
先探索再编码	explore → plan → implement → commit/PR；小改可跳过 plan
丰富 context	`@` 文件引用、截图、URL、日志
配置环境	`/init` 建 `CLAUDE.md`；permissions、sandbox、MCP、hooks、skills
会话管理	`/clear` 分任务；subagents 保主 context；checkpoints、`/rewind`
自动化扩展	`claude -p` 非交互；worktrees 并行；发布前 adversarial review

常见失败： 无关任务混在同一 context-heavy 会话；反复纠正后不 clear 重启；无 verifiable checks 就让 Claude 工作。

主题	要点
Prompt 结构	Goal、Context、Constraints、Done when
Plan 模式	复杂/模糊任务先 plan；可 interview 用户
`AGENTS.md`	开放格式 README for agents：layout、命令、约定、PR 期望、验证标准
`config.toml`	个人 `~/.codex/` + repo `.codex/`；model、sandbox、approval、MCP
测试与 review	创建/更新测试、跑检查、确认行为、`/review`
Skills	单一职责、`SKILL.md`、清晰 trigger
Automations	工作流稳定后再调度后台运行
会话控制	threads、worktrees、resume/fork；避免多 thread 改同一文件

常见失败： durable rules 堆在 prompt 而非 AGENTS.md；未说明 build/test/verify；多步工作跳过 plan；过早给 broad permissions；未稳定就 automate。

维度	Claude Code	Codex
持久 repo 指导	`CLAUDE.md`	`AGENTS.md`
规划	explore → plan → code	Plan mode / PLANS.md
验证	runnable checks + 截图	done when + tests + review loop
权限	auto mode、`/permissions`、`/sandbox`	sandbox、approval policy
长任务	checkpoints、`/rewind`、resume	threads、`/fork`、goals、worktrees
扩展	hooks、skills、subagents、plugins	skills、automations、config profiles

官方实践对应 Harness 五维：