Codex Manual

第一次使用

第一次不要让 Codex 大改项目。先让它理解项目，再做一个小而可验证的任务。

打开项目

在终端中进入项目目录：

cd your-project
codex

如果你使用 App，打开 App 后选择项目目录。

第一个提示词

建议从只读任务开始：

请先不要修改文件。帮我解释这个项目的目录结构、启动方式和测试方式。

这个任务能让你观察 Codex 如何读项目、如何总结信息，以及它是否理解当前仓库。

第二个任务

让 Codex 做一个小修改：

请找一个最小的可改进点，先说明方案，等我确认后再修改。

确认后再让它执行：

可以按方案修改。改完后运行相关测试，并告诉我修改了哪些文件。

好任务的格式

一个清晰任务通常包含：

• 目标：你希望完成什么。
• 范围：只改哪些文件或模块。
• 限制：不要做什么。
• 验证：如何确认结果正确。

例子：

修复登录页按钮在移动端换行的问题。只改前端样式，不改接口逻辑。完成后运行前端 lint，并说明影响范围。

新手常见错误

• 一上来就要求“完整重构整个项目”。
• 没说是否允许改文件。
• 没给验证方式。
• 没有检查 Codex 的 diff 就继续让它改下一轮。

把任务拆小，Codex 的结果通常更稳定。