开始之前

能读懂命令行输出、用 git status 与 git diff 查看改动;有一个可回滚的练手仓库。安装与登录从本主题第一篇开始,Windows 用户可先读环境分支,不需要预装 Codex。

这个主题要掌握什么

  • 先确认登录方式与计费来源,再用只读任务验证命令、路径和权限。
  • 权限逐级放开:只读理解、限定范围的写入,最后才讨论非交互运行。
  • 任务压到一次能看完的 diff:改哪个文件、函数签名、行为约束、怎么验证。
  • 用 AGENTS.md 固定测试命令与目录约定;并行改动放进独立 worktree。
Codex 入门
Codex CLI 安装与登录:把第一条命令跑成只读验收

从官方安装脚本或 npm 两条路径装上 Codex CLI,分清 ChatGPT 登录与 API Key 的计费边界,再用一条只读任务同时验证可执行文件、凭据和工作目录。

Codex 入门
Windows 上的 Codex 环境:PowerShell、路径与换行符

在原生 Windows 上确认 Codex 命令来源、选对项目目录,分清 PowerShell 与 WSL 的路径和凭据,再用一条只读任务验证环境;不假设 Windows 必须依赖 WSL。

Codex 进阶
Codex 权限:沙箱和审批是两个开关

把 Codex 的沙箱边界和审批策略分开理解,用只读与工作区写入两组任务观察拒绝行为,并学会从路径、网络和保护目录三个方向诊断权限失败。

Codex 入门
Codex CLI 第一次任务:从一条指令到测试验收

用一个能跑测试的最小仓库走完 Codex CLI 完整链路:只读理解、下达约束、审阅 diff、跑 node --test 验收,并给出卡住时的排查顺序。

Codex 进阶
让 Codex 修一个失败的测试:先复现,再限定改动

用一个 Node 内置测试的小例子,把失败测试当作验收合同:先独立复现,再让 Codex 只改实现,最后用回归结果和 diff 审查确认没有偷改测试。

Codex 入门
Codex 项目上下文:AGENTS.md 写什么、config.toml 边界在哪

Codex 每次运行只读一次指令链。讲清全局与项目 AGENTS.md 的发现顺序、config.toml 的信任边界,以及如何把上下文控制在真正有用的几百字里。

Codex 进阶
Codex 非交互模式:结果、事件流和退出码要分开看

用 codex exec 把 Codex 放进脚本:区分 stdout 最终消息与 stderr 进度,使用 -o、--json 和 --output-schema,并对结构化结果做独立校验。

Codex 进阶
用 Git worktree 隔离两个 Codex 任务

从同一个已提交基线创建两个工作树,让 Codex 在独立分支上改代码;合并前验证、移除前保留改动,并看清工作树共享仓库历史而不是安全沙箱。