Codex
把 Codex 放进真实仓库:先完成安装与登录,再控制改动范围、补足项目上下文,并在合并前用测试和 diff 验收。
开始之前
能读懂命令行输出、用 git status 与 git diff 查看改动;有一个可回滚的练手仓库。安装与登录从本主题第一篇开始,Windows 用户可先读环境分支,不需要预装 Codex。
这个主题要掌握什么
- 先确认登录方式与计费来源,再用只读任务验证命令、路径和权限。
- 权限逐级放开:只读理解、限定范围的写入,最后才讨论非交互运行。
- 任务压到一次能看完的 diff:改哪个文件、函数签名、行为约束、怎么验证。
- 用 AGENTS.md 固定测试命令与目录约定;并行改动放进独立 worktree。
按顺序读: Codex CLI 安装与登录:把第一条命令跑成只读验收 Windows 上的 Codex 环境:PowerShell、路径与换行符 Codex 权限:沙箱和审批是两个开关
从官方安装脚本或 npm 两条路径装上 Codex CLI,分清 ChatGPT 登录与 API Key 的计费边界,再用一条只读任务同时验证可执行文件、凭据和工作目录。
在原生 Windows 上确认 Codex 命令来源、选对项目目录,分清 PowerShell 与 WSL 的路径和凭据,再用一条只读任务验证环境;不假设 Windows 必须依赖 WSL。
把 Codex 的沙箱边界和审批策略分开理解,用只读与工作区写入两组任务观察拒绝行为,并学会从路径、网络和保护目录三个方向诊断权限失败。
用一个能跑测试的最小仓库走完 Codex CLI 完整链路:只读理解、下达约束、审阅 diff、跑 node --test 验收,并给出卡住时的排查顺序。
用一个 Node 内置测试的小例子,把失败测试当作验收合同:先独立复现,再让 Codex 只改实现,最后用回归结果和 diff 审查确认没有偷改测试。
Codex 每次运行只读一次指令链。讲清全局与项目 AGENTS.md 的发现顺序、config.toml 的信任边界,以及如何把上下文控制在真正有用的几百字里。
用 codex exec 把 Codex 放进脚本:区分 stdout 最终消息与 stderr 进度,使用 -o、--json 和 --output-schema,并对结构化结果做独立校验。
从同一个已提交基线创建两个工作树,让 Codex 在独立分支上改代码;合并前验证、移除前保留改动,并看清工作树共享仓库历史而不是安全沙箱。