Codex 使用指南

搜索全站

输入关键词开始搜索。

页面更新:事实核验:

概念

Codex 是什么

Codex 是面向软件工程任务的编码代理体系。官方产品名是 ChatGPT desktop app;本指南把其中的 Codex 工作面简称为“Codex Desktop”,并以 Desktop 为主,因为它适合把对话、仓库、Browser、权限审批和验证证据放在同一个任务线程里。

是什么

它是什么

你可以在桌面应用里选择项目、开启线程、让 Codex 读仓库上下文、在同一个任务里查看 diff、审批操作,并打开官方称为 Integrated terminal 的终端运行命令。内置 Browser 是用户与 ChatGPT 的共享视图:你可以预览页面、留下视觉反馈或评论,也可以让 ChatGPT 与页面交互;它不是单纯的日志面板。

线程一个目标一个线程,保留上下文、审批、终端输出和最终证据。
Local / WorktreeLocal 直接改当前项目;Worktree 隔离试验和并行任务。
Browser + Git共享预览、视觉评论与页面交互,并审查 diff 和 Git 操作。
Scheduled tasks把稳定重复任务放到后台运行,并在 Scheduled 视图查看结果。

何时使用

什么时候用 / 不用

  • 用 Desktop需要看 diff、页面、截图、浏览器、审批、终端验证和多线程进度。
  • 先用 Local小改动、文档、网页、测试修复和发布验证,优先在当前项目里完成。
  • 改用 Worktree试验性修改、并行任务、自动化后台任务,或不想碰当前工作区时使用。
  • Plan 模式当任务需要先对齐方案再动手时,可在 Desktop 里让 Codex 先输出计划并逐步确认;具体 UI 入口与行为以当前客户端为准,本指南不承诺固定按钮名称。
  • 不用 Codex任务没有明确仓库、没有验收标准,或你不愿让代理读取相关上下文。

示例

可复制示例

我正在 Codex Desktop 里处理这个仓库。
请先读取 AGENTS.md、README.md 和失败测试日志。
目标:解释这个错误,并提出最小修复方案。
约束:只读分析,不要改文件。

真实实例

真实实例:扩充这份网页手册

维护 codex-usage-guide 时,Codex 的主工作面是 Desktop:用户给出页面反馈,Codex 读取 AGENTS.md 和 HTML 文件,在内置终端运行静态链接检查,最后用 Git diff 和验证结果收口。这个例子展示了 Desktop 如何把读取、修改、验证、审查和发布证据放进一个可追踪的线程。

真实任务输入:
请把中文 Codex 指南扩成实战手册。
要求:
- 每个主要页面都有真实实例
- 保持 GitHub Pages 可访问
- 最终报告验证和 commit