1. 先厘清一个认知Codex 不只是聊天框里的代码生成很多从 ChatGPT 网页版过来的开发者拿到 Plus / Pro 后第一反应是在聊天框里让模型帮我写一个爬虫。这能用但远不是 Codex 的正确打开方式。Codex 真正的形态是一套面向软件工程的 Agent 系统它可以读取并理解整个仓库而不是单文件片段跨多个文件规划并执行修改在沙箱里运行测试、安装依赖、执行命令并观察结果根据报错回溯、自我修正直到测试通过通过 CLI、IDE 插件、Cloud Sandbox 三种入口接入你的工作流。换句话说ChatGPT 对话是问一句答一句而 Codex 更接近把任务交给一个能动手的工程师。理解了这一点后续的玩法才有意义。2. 开通 Plus / Pro 后你实际解锁了什么权益差异这里不谈价格只讲对开发工作流有影响的部分能力PlusProCodex 模型访问可用受标准速率限制更高配额与更高并发Cloud 并行任务有限数量更多并行沙箱任务Codex CLI 登录支持支持更长会话推理强度档位可用更宽松的 high effort对于个人项目而言Plus 已经完全够用Pro 的价值在于你把它当作常驻的并行开发 Agent同时跑多个 GitHub Issue 或重构任务时不会被限流打断。一个容易被忽略的点Codex CLI 支持用 ChatGPT 账号OAuth登录也支持直接用OPENAI_API_KEY。如果你是 API 计费用量较大的用户用 Key 方式可以在配额和成本之间做更细的权衡。3. 环境准备与 Codex CLI 安装Codex CLI 是开源命令行工具也是所有玩法里工程感最强、可控性最高的入口。先装工具# 通过 npm 全局安装npminstall-gopenai/codex# 或者用 Homebrewbrewinstallcodex首次运行会引导登录codex如果你走 API Key 路线配置环境变量exportOPENAI_API_KEYsk-...推荐维护一份~/.codex/config.toml来自定义默认行为model gpt-5-codex model_reasoning_effort high # 审批策略建议先用 on-request等信任度建立后再考虑 auto approval_policy on-request # 每次任务默认携带项目上下文 profile default安装完成后可以先跑一个最小验证确认它能正常读写你的工作目录codexexec帮我在当前目录创建一个 hello.py打印当前 Python 版本exec模式适合单次、非交互的自动化任务日常开发更常用的是进入交互式会话codex进入后就是一个带文件读写、命令执行能力的对话终端。你可以直接说需求它会先展示计划再按审批策略执行命令。4. 第一个进阶实战用 Codex 重构一个真实项目假设你手上有一个历史遗留的 Node.js 脚本项目目录结构混乱且没有任何测试。直接丢给 Codex 一个模糊需求通常效果不好正确做法是给它明确的验收标准。启动 Codex 前先建一个任务描述文件task.md# 重构任务 ## 输入 当前目录是一个 Express API 项目路由和业务逻辑全部混在 app.js。 ## 目标 1. 将路由拆分为 routes/ 目录按资源分文件。 2. 将数据库访问收敛到 services/ 目录。 3. 保留原有 API 路径与返回结构不变。 ## 验收标准必须全部满足 - npm test 全部通过 - 新增一个 GET /health 接口返回 200 - 不改变任何现有接口的响应格式。 ## 约束 - 不使用 ORM保持现有 SQL 写法 - 不要升级依赖版本。然后启动会话把这份文件作为上下文输入codex在交互界面中执行请先阅读 task.md然后按其中的验收标准执行重构。 每完成一个阶段先跑对应测试确认通过后再继续。这里有两个关键技巧验收标准驱动Codex 在多步任务中容易顺手改过头把不变的 API 结构当成可优化对象。事先声明不改变响应格式、不升级依赖能显著减少回滚次数。阶段确认让它每完成一个阶段先跑测试相当于给它设置了检查点能避免任务跑偏到后期才发现。如果只想让它干完活不交互可以用exec加非交互参数codexexec--sandboxread-only阅读 task.md 并给出重构方案先不要修改文件先让它做 read-only 规划再切换成可写模式执行是控制风险的好习惯。5. 让 Codex 理解你的项目AGENTS.md 与上下文工程Codex 不是读心术。在陌生仓库里它只能靠文件内容猜测规范。想让输出贴近你的习惯最有效的方式是在仓库根部放一个AGENTS.md。示例# Agents Guideline ## 语言与框架 - 本项目使用 TypeScript 5不使用 JavaScript - 使用 pnpm 作为包管理器禁止生成 package-lock.json。 ## 代码风格 - 文件命名使用 kebab-case - 所有导出函数必须有 JSDoc参数需注明类型 - 测试统一放在 __tests__ 目录使用 vitest。 ## 提交与变更 - 除非明确要求否则不要直接修改 .env 文件 - 每次修改请同步更新 README 中的接口说明。 ## 禁止事项 - 不要引入新的运行时依赖 - 不要手动格式化 TypeScript统一交给 prettier。Codex CLI 会自动读取仓库根目录的AGENTS.md作为系统级项目上下文。这对团队协作尤其有用——把规范沉淀到文件里每个成员启动的 Codex 会话都会遵守同一套规则。进阶一点还可以配合codex exec的配置文件区分不同 profile[profiles.reviewer] model_reasoning_effort high approval_policy on-request在同一次任务中你可以先用default生成实现再用reviewerprofile 做只读审查形成生成—审查的闭环codexexec当前改动做一次只读代码审查按严重程度列出问题这样比单纯让它重写一遍更有工程价值。6. 多文件任务的组织方式把大目标拆成可验证的小任务Codex 擅长单次大任务但面对重写整个后台管理系统这种需求容易在中途产生不可控的偏差。更稳妥的玩法是任务切片。一个推荐的结构.github/agents/ tasks/ 01-split-routes.md 02-move-services.md 03-add-tests.md 04-ci-fix.md每个任务文件都包含输入、目标、验收标准、约束。然后按顺序执行codexexec$(cat.github/agents/tasks/01-split-routes.md)执行完一个、跑一次测试、提交一次再进入下一个。这样做的好处每次会话的上下文更聚焦模型不会在长任务中遗忘早期约束出现问题时回滚范围可控配合 Git 分支可以并行让多个 Codex 任务处理互不冲突的模块。如果再进一步可以把这些任务串进 CIcodex-review:runs-on:ubuntu-lateststeps:-uses:actions/checkoutv4-run:npm install-g openai/codex-run:codex exec 对本次 PR 做只读审查重点关注安全与性能让 Codex 作为 PR 审查的辅助角色是比全自动写代码更稳健的落地方式。7. 和 Cursor、Claude Code 的取舍什么时候用 Codex非小白的开发者大概率同时接触过 Cursor 和 Claude Code这里直接给结论性的对比场景建议编辑器内实时补全、Tab 跟随手写节奏Cursor单个仓库内的多文件 Agent 重构Codex / Claude Code 均可云端沙箱执行、脱离本地环境跑任务Codex 原生优势强大的终端可编程性与自定义 hookClaude Code 生态更丰富需要 ChatGPT 账号内统一管理、网页发起任务CodexCodex 的核心优势在于开箱即用的云端执行环境你可以在网页端开一个 Cloud Sandbox让它安装依赖、运行测试而本地环境完全不受影响。这对于想在 Mac 上检验一段只适配 Linux 的构建脚本这类场景非常友好。实际工程中不少人的折中方案是用 Cursor 做逐行级补全与局部重构用 Codex 做跨文件的大任务与 CI 审查用 Claude Code 做带复杂 hook 的工作流编排。三者不是替代关系。8. 用量控制与排错避免 Plus / Pro 被无谓消耗对于 Pro 用户用量宽裕并不代表可以放任 Codex 反复空转。几个有效的控制手段设低初始推理强度小幅重构用medium只有跨文件架构调整才用high。可以在config.toml中按 profile 区分。强制 read-only 先行规划codexexec--sandboxread-only先规划再动手给我实施步骤它能读文件、能思考但不能写文件和执行有副作用的命令非常适合方案确认阶段。控制沙箱命令范围codexexec--sandboxworkspace-write只允许在当前工作目录内写文件比完全放开更安全适合处理陌生仓库。常见排错清单codex提示未登录重新执行codex走 OAuth或检查OPENAI_API_KEY执行命令一直等待审批检查approval_policy本地个人项目可临时设为on-failure修改了大量无关文件回溯会话后在下一轮明确给出只修改与目标相关的文件其余保持原样的约束并把验收标准写进task.md生成代码风格漂移确认AGENTS.md在仓库根目录且会话是从该目录启动。9. 一个可以立即复用的工作流把前面的内容串起来得到一个适合个人项目的日常流程# 1. 确保项目上下文就绪lsAGENTS.md# 2. 用只读模式先出方案codexexec--sandboxread-only$(cattask.md)# 3. 确认方案后切到可写模式执行codexexec$(cattask.md)# 4. 跑项目自带的验证npmtest# 5. 让 Codex 回看 diff 做一次审查gitdiff--statcodexexec审查当前未提交的改动重点看是否有破坏性变更整个过程没有依赖任何 IDE 插件纯终端即可完成也方便写进脚本或 CI。10. 总结ChatGPT Plus / Pro 开通之后Codex 的正确用法不是在聊天框里多问几句代码问题而是把它作为一个可按验收标准驱动的软件工程 Agent接入你的仓库与流程。如果你只有一分钟记住这四件事先用codex exec --sandbox read-only规划再用可写模式执行把规范写进根目录的AGENTS.md用task.md定义输入、目标、验收标准、约束四要素大任务切片每个切片跑测试后提交再进入下一个。Codex 的上限不取决于 Plus 还是 Pro而取决于你给它提供多少工程上下文、以及你是否愿意用验收标准和检查点去约束它。