实用指南
工具讲解 / NPC AI AGENT

Codex:零基础实用指南

从理解项目、修改文件到验证结果,学会与编码 Agent 协作。

Codex 是什么,适合从哪里入门

Codex 是 OpenAI 面向技术工作的 Agent,可以结合可用的项目文件和工具理解代码、提出修改、执行检查。它与在普通聊天中询问“这段代码什么意思”不同:当工作环境和授权具备时,结果可以是文件的实际变化。

新手可以先从读懂项目、调整文案或一个小问题开始。重点不在于一次做多大,而是能说清目标、看懂改了哪里,并确认结果。本站以下网站例子是教学场景,不表示仅凭读完教程就已经对你的项目执行了修改。

桌面、IDE、CLI 与云端是什么区别

入口 适合怎样使用 需要准备什么
桌面工作区 通过图形界面选择项目并查看结果 当前官方应用与项目文件夹
IDE 扩展 在代码编辑器中协作 支持的编辑器与扩展
CLI 在终端里操作项目 命令行环境与对应安装配置
云端工作环境 在托管环境中执行工作 项目连接、依赖与运行设置

官方桌面入口与命名会更新;本期文档在 ChatGPT 桌面应用中介绍 Codex 的使用方式。按当前官方页面选择自己的入口,不要把旧版客户端截图中的按钮位置当作永远不变。

在真正修改前先准备什么

  1. 选一个明确的项目文件夹。第一次不把整个桌面或磁盘作为工作范围。
  2. 保留备份;已有 Git 项目可以先查看当前变更。不要让不相关的用户修改被覆盖。
  3. 说明项目怎样启动,以及你看到的实际问题。有截图、报错和复现步骤时一起提供。
  4. 明确允许的操作:先解释、允许修改文件,还是允许发布到服务器。这些是不同动作。
  5. 设定可观察的结果,例如“按钮点击后显示成功提示”,而不是笼统说“优化一下”。

完整示例:修好网页复制按钮

这是一个静态网站项目,复制联系方式的按钮点击后没有提示。
请先阅读相关HTML和JavaScript,说明当前逻辑和可能原因。
允许修改本地相关文件,不改无关页面,不部署服务器。

期望行为:
1. 复制成功时显示“已复制”。
2. 复制失败时显示可理解的提示。
3. 键盘可操作,手机布局不溢出。
完成后说明改了哪些文件、做过哪些真实检查、哪些还没验证。

这份要求说明了触发、当前表现、期望和操作范围。Codex 需要找到项目中的实际实现,再修改和验证,而不是把网上一段通用代码直接塞进页面。

如何看文件变更,不只看最后一句话

阶段 你应能看到什么
理解 找到了相关文件,知道问题如何触发
修改 文件差异与目标有关,未扩大改动范围
检查 实际运行的命令、页面现象或失败信息
交付 本地成果在哪里,是否发布,仍有什么限制

看到“完成了”不代表页面已经上线。看到测试通过,也要问它覆盖的是逻辑、构建还是实际浏览器交互。一个按钮可能通过语法检查,但点击后仍没有效果。

Skill、插件和项目规则起什么作用

项目规则说明这个项目的约定;Skill 把特定工作的做法与资源组织起来;插件可能增加外部工具或连接。它们帮助 Codex 开展工作,但不能代替真实资料与结果检查,也不会自动赋予所有操作权限。

如果已有项目规则,先让它读取。确实需要新增能力时,再了解对应安装方式;没必要为了修改一行文案先安装几十个 Skill。

出错或不符合预期时怎么继续

提供具体差异,例如“桌面正常,但390px时按钮换行”,并保留截图。让它先解释现状,再做最小完整修复。若依赖缺失、测试无法运行,应报告阻碍,不把未运行写成通过。

如果修改方向不对,可以回到备份或版本记录,先确认哪些改动需要保留,再撤回相关部分。已有其他人的工作时,不要一键清空全部文件变化。

新手最容易混淆的几个问题

不懂代码可以用吗? 可以从明确的小改或只读解释开始,但仍要能判断页面和文件是否达到目标。

有网络工具就能发布吗? 能力与授权不同。本地修改、提交、发送消息和部署应分别说清楚。

是不是每个任务都要最高档模型? 先看实际需要、等待时间与完整流程成本,不只看模型名。

想先熟悉自然语言提问,可读 ChatGPT 指南;项目型 Skill 的用途与条件见 Skills 榜单。

来源与核验

产品与项目信息依据以下一手资料整理;解释、比较方法和演示示例由本站编写,不代表已对每项能力完成实测。原作者与许可见对应项目;具体开放范围以当前官方说明为准。

返回实用指南 浏览提示词与 Skills