第一次使用 Codex 创建一个项目
从小目标、项目初始化、分步实现到检查与提交,完成第一个可恢复、可验证的 Codex 项目。
约 12 分钟
文章目录 点击展开
第一次用 Codex 做项目,最好选择一个一小时内可以验证的小目标,例如“做一个本地待办清单页面”,而不是直接要求创建大型商业系统。

1. 定义完成标准
写清楚用户能做什么、在哪运行、怎样判断完成:
创建一个静态待办清单页面,支持新增、完成和删除;数据只保存在浏览器本地;手机 375px 不横向滚动;不接入登录和数据库。
2. 让 Codex 先说明技术选择
如果你没有指定技术栈,让它给出一两个适合小项目的选择,并解释依赖和运行方式。不要在不了解后果时接受复杂架构。
3. 初始化 Git 与基础结构
确认目录为空或只包含预期文件,再初始化项目。创建第一个可运行版本后立即提交,作为安全恢复点。
4. 分步骤实现
推荐顺序:页面结构 → 核心交互 → 数据保存 → 样式 → 可访问性 → 测试。每一步都运行项目并检查,不要等到最后一起排错。
5. 审查而不是只看结果
让 Codex 汇报修改文件、运行命令和未解决问题。自己打开 git diff,检查是否出现密钥、绝对路径、危险脚本或无关功能。
6. 完成验证与提交
运行项目提供的检查和构建命令,在目标手机宽度和桌面宽度查看页面。提交信息应说明实际变化,而不是写“update”。
什么时候停止
达到原定完成标准后停止。支付、账号系统、云部署和更多业务功能都是新的阶段,需要重新确认范围,不能因为“顺便”而自动加入。
