展开知识库目录
Codex 第一次任务：装好、登录、找一个能回滚的小改动跑通
第一次用 Codex，别让它重构项目。先装好并登录，选一个有明确文件范围、能回滚、能用命令验证的小改动，让它走完读项目、改文件、跑检查、汇报证据的完整闭环。
先安装并完成登录授权
你大概是第一次打开终端装 Codex，心里想的是“AI 帮我写代码”，又不确定它会不会把项目弄乱。先说结论：Codex 能干活，但第一次任务必须挑安全的干——范围小、能回滚、能验证。
装和登录其实就两条命令：npm install -g @openai/codex 装，codex login 登录（浏览器授权，或者配 OPENAI_API_KEY）。之后别急着搞大项目，先找一个“改一句文案”级别的小任务，让它完整走一遍：读文件、改、跑命令、给 diff。
这些情况适合用，另外几种先停一下
- 第一次安装和使用 Codex，想用一个安全任务试水
- 有一个具体的小改动：改文案、改样式、修一个已知 bug
- 想在动手前确认 Codex 能读懂你的项目
- 刚克隆的陌生大项目，还没摸清结构就让它改
- 任务涉及生产环境、数据库或未备份的数据
装好登录后，用一个可回滚的小改动跑通读、改、验、交完整闭环
OpenAI 官方 Codex 文档说明认证支持 codex login 浏览器流程和 API Key 两种方式；AI 编程零基础教程（鱼皮）的节奏也是“先跑通最小任务再谈复杂功能”，第一次任务选小不选大。
- 01
装并验证
依次运行 npm install -g @openai/codex、codex --version、codex login，每一步看到预期输出再继续。
- 02
挑一个小任务
任务限定为单文件级：改文案、改颜色、修一个能复现的 bug，先把“不动什么”写出来。
- 03
让它先读再改
要求 Codex 先读相关文件并复述现状，确认它理解对了，再允许修改。
- 04
跑命令并看 diff
让它运行构建/测试命令并把输出贴出来，最后把 git diff 给你逐行确认，再决定合不合并。
Codex 第一次任务提示词（复制后改 {占位}）
我准备用一个安全的小任务测试 Codex 是否配置正确。项目在{项目路径}。
任务：{一句话任务，例如“把首页 hero 的副标题从 X 改成 Y，其他不动”}
要求：
1. 先读相关文件，用一两句话告诉我当前代码长什么样；
2. 只改动完成任务必需的文件，列出你将修改的文件清单；
3. 改完后运行项目的{构建/测试命令}，把输出结果贴给我；
4. 最后给出改动 diff，并说明每个文件改了哪里；
5. 涉及不确定的地方先问我，不要擅自扩大改动范围。Codex 第一次任务记录（示例）
下面是已经填过变量的示例。复制时请换成自己的文件名、数字和材料位置，别把示例数据原样交出去。
Codex 第一次任务记录（示例）
安装：npm install -g @openai/codex 验证：codex --version → 显示版本号即成功 登录：codex login → 浏览器授权成功 任务：把首页 hero 副标题改为“AI 帮你把论文读进脑子里” 允许改：index.html、assets/home.css 验收：npm run build 退出码 0；diff 只有这 2 个文件
先对症状，别一上来重写整段提示词
codex 命令不存在
- 常见原因
- npm 全局安装没生效
- 怎么修
- 确认 Node 版本≥18，重跑 npm install -g @openai/codex，再开一个新终端。
登录一直转圈
- 常见原因
- 浏览器或网络问题
- 怎么修
- 先运行 codex login --help 查看当前版本支持的认证选项；如果浏览器授权失败，再检查默认浏览器、网络代理或改用 API Key 登录。
它改了额外文件
- 常见原因
- 任务边界没写清
- 怎么修
- 任务里明确“只改动完成任务必需的文件”，并要求先列文件清单再动手。
最后五分钟，逐项打勾
这篇具体参考了什么
Codex 使用场景与工作流
原始资料OpenAI：Codex 认证codex login 与 API Key 两种方式
原始资料awesome-codex-guideCodex 中文手册与排障
正文按公开教程和官方文档重新整理，并换成了可以直接操作的中文场景。产品能力、规则和投稿要求会更新，真正执行前请再打开原始页面核对一次。