第3章：codex 安装配置与环境准备
一、学习目标
完成 Node.js、Codex CLI、登录、工作目录、Git 和测试工具的基础准备。
完成本章后，学员应能把相关概念转化为可执行的 Codex 任务，并能说明任务的边界、风险和验收方式。
二、本章适合谁学习
第一次动手使用 Codex 的学员。
三、核心概念讲解
Codex 的效果高度依赖可运行环境。一个能安装依赖、能运行测试、能查看 Git diff 的项目，比一个只有代码片段的目录更适合训练。环境准备的重点不是把工具装上，而是让 Codex 能看见项目边界、能执行必要命令、能把结果反馈给用户。
在教学时，讲师应避免只展示“神奇结果”。更有效的方式是把任务输入、Codex 的中间判断、文件改动、验证命令和最终总结完整展示出来，让学员理解可复制的方法，而不是记住一次偶然成功的演示。
四、关键知识点
确认 Node.js、Git、包管理器和项目语言运行时。
通过官方 npm 包安装或升级 Codex CLI。
在独立工作目录内运行，避免误操作无关文件。
准备最小可验证命令，例如 lint、test、build。
五、操作步骤或实践流程
明确任务目标：用一句话写清要解决的问题。
补充上下文：说明项目、目录、相关文件、技术栈和限制。
设定边界：说明哪些文件可以改、哪些不能改、哪些操作需要确认。
要求计划：复杂任务先让 Codex 给出步骤，不立即修改。
执行小步修改：每一步都保持可审阅。
运行验证：优先使用项目已有的 lint、test、build 或人工验收清单。
复盘输出：要求 Codex 总结改动、风险和后续建议。
六、典型案例
前端项目没有 lockfile 时，Codex 可能无法判断使用 npm、pnpm 还是 yarn。通过 README 或 AGENTS.md 明确包管理器，可以降低错误率。
推荐示例提示词：
请先阅读当前项目中与本任务相关的文件，输出你的理解、可能影响范围和建议修改计划。暂时不要修改文件。确认计划后，再按最小改动实现，并运行可用的验证命令。最后请总结修改内容、验证结果和剩余风险。
本章实践任务：在示例项目中运行 Codex，让它列出依赖安装命令、启动命令和测试命令。
七、常见错误与避坑指南
没有进入项目根目录就启动 Codex。
未配置 Git，导致无法清晰审阅改动。
环境缺依赖却要求 Codex 直接修 Bug。
避坑原则：凡是会影响生产数据、权限、支付、认证、数据库迁移、凭证、批量删除或外部服务调用的任务，都应提高审批级别，并要求 Codex 先解释风险。
八、课堂练习
整理一份“Codex 环境检查清单”。
练习交付物应包括：任务提示词、Codex 输出摘要、人工审阅意见、验证结果和复盘结论。
九、课后作业
在本地新建一个演示项目，记录安装、运行和测试命令。
作业提交格式建议：
### 任务背景 ### Codex 提示词 ### Codex 执行过程摘要 ### 修改或输出结果 ### 验证证据 ### 人工复盘
十、商业化交付建议
十一、本章小结
本章的关键不是记住单个命令，而是形成“目标明确、上下文充分、边界清楚、过程可审阅、结果可验证”的 Codex 协作方式。只要这个框架稳定，后续无论使用 CLI、IDE、云端任务还是团队流程，都能保持较高质量。
十二、参考资料
Codex Quickstart
openai/codex
OpenAI Codex CLI on npm
OpenAI Codex CLI Tutorial
OpenAI brings Codex to Windows