第一次使用 Codex,可以从一个容易验证的小任务开始:给博客文章列表增加一个空状态提示。这个练习能帮你认识项目上下文、文件修改和结果验收之间的关系。下面的任务文本是本站设计的练习,可按自己的项目改写。
先准备一个可以正常打开的项目
在支持 Codex 的桌面客户端中选择 Codex,打开要处理的项目文件夹。当前官方快速入门也说明了从客户端选择工作位置的流程。不同版本的入口名称可能略有变化,操作时以当前界面为准。查看官方快速入门。
选择包含项目说明和源代码的目录。例如做前端网站时,通常要能看到项目的依赖清单与页面文件。第一次练习可以使用个人测试项目,先确认它原本能够启动,避免同时排查项目初始化和需求实现两个问题。
第一条消息:让它说明项目情况
先做一次简短的项目认识,不必要求读取每个文件。可以发送:
请查看这个项目,说明使用了什么框架、页面入口在哪里,以及如何启动。
找到文章列表的页面,指出没有文章时目前显示什么。
这一步先给我结论,不修改文件。检查回答是否对应你打开的项目。如果目录或框架不对,先更正工作位置,再开始改代码。一个有用的回答应该包含具体文件与可执行的启动方式,而不是泛泛介绍某个框架。
第二条消息:提出一个有验收标准的修改
给文章列表增加空状态:当筛选结果为空时,显示“暂时没有符合条件的文章”。
增加“查看全部文章”入口,点击后清除当前筛选。
沿用现有主题色、按钮和间距,兼容手机。
完成后启动本地页面,验证空结果和正常列表两种情况,说明修改与验证结果。这里把结果、触发条件和验收场景写清楚了。除非你确实需要某种技术实现,否则可以让 Codex 根据项目现有结构选择合适的改法。官方提示指导也强调提供相关上下文与明确的目标。参考官方提示指导。
阅读结果时,重点看四件事
- 改动范围:主要变化是否围绕文章列表和相关组件。
- 触发条件:空状态是否真的只在结果为空时出现。
- 操作结果:“查看全部文章”是否清除筛选,并恢复原列表。
- 验证证据:是否实际打开页面检查,相关命令是否成功完成。
你也可以手动输入一个不会匹配任何文章的关键词,再点恢复入口。这比只看静态截图更容易发现按钮没有连上业务逻辑的问题。
继续迭代时,一次说清一个变化
例如发现手机上按钮过宽,可以直接补充:“手机端按钮跟随文字宽度,其他布局保持当前效果。”如果你自己改过文件,也应告诉 Codex 哪部分要保留,减少下一轮互相覆盖。
常见问题
必须先学习命令行吗?
第一次可以从桌面客户端开始。遇到启动命令时,让 Codex结合项目说明解释命令的用途,再查看实际运行结果。逐渐认识项目已有的命令,比一开始记大量命令更容易上手。
它说完成了,页面却没有变化怎么办?
核对打开的是不是本次启动的地址、端口和页面;再检查是否需要重启服务。把当前地址和实际现象发给它,让它根据页面结果继续定位。
下一步适合练习什么?
继续阅读用 Codex 排查 Bug,尝试把一次可复现的问题完整修好。
参考资料
OpenAI:快速入门 · OpenAI:功能说明。本文为中文操作练习,示例不代表已在读者项目中执行。