装好 Codex CLI 之后愣住，是 AI 编程新手的普遍状态：命令会敲了，但接下来登录怎么办、在哪个目录跑、第一个任务怎么下、改完的代码怎么看——没有一条完整的链路可循。这篇就补这条链路：从登录、进项目、初始化，到下第一个任务、看 diff 做审批、验收落地，一步不跳，每步给出要点与易错处。
第一步：登录
终端里敲 codex，首次运行会引导登录：默认走 ChatGPT 账号授权，浏览器弹出授权页，确认后回到终端即完成；也可以改用 API key 的认证方式。两条轨道在功能与计费上的差别，见登录两条轨道一篇。登录态保存在本机的凭据文件里，把它当密码看：不要提交进仓库、不要截图外发。哪天报 401 这类登录失效，处理方法见401 处理一篇。
第二步：进项目，先跑 /init
登录完成后别急着派活，先把终端切到项目根目录再启动 codex——智能体默认在当前目录工作，目录切错、读错仓库，后面全乱。进对目录后先跑一次 /init：它会扫一遍项目结构，生成一份项目说明文件，把技术栈、目录约定、构建命令这些背景写下来，后续每个任务都先读它。这份初始化做得越准，后面的任务跑得越顺，相当于给新同事做完入职介绍。
第三步：下第一个任务
第一个任务建议挑小的、能验证的：一个明确的小 bug、一个说清输入输出的小函数。指令写具体——现象是什么、期望是什么、有什么约束，一句话能验收到对错的任务最合适。信息给足，智能体的第一步定位就准；指令含糊，它只能猜，来回返工。第一次跑通之后，同一个项目里的后续任务会越来越顺，因为上下文与项目说明都已经在手。
第四步：看 diff、做审批
Codex 改代码不是直接落盘，而是先给出 diff 让你过目：改了哪个文件、动了哪几行，批准才应用。这是智能体工作流里人把关的位置，别一路回车放行。看 diff 的思路与代码评审的清单一致——改动是否只覆盖任务范围、有没有顺手改了不该改的、边界情况有没有漏，方法见代码评审清单一篇。审批档位可以调，但首次上手建议保持较严的档位，跑出信任再放宽。
| 步骤 | 这一步要做的动作 | 新手最容易错的地方 |
|---|---|---|
| 登录 | 浏览器授权，也可改用 API key 认证 | 凭据文件被提交进仓库、截图外发 |
| 进项目跑 /init | 切到项目根目录再启动 codex，跑一次 /init | 目录切错、读错仓库，后面全乱 |
| 下第一个任务 | 挑小而可验证的活，写明现象、期望与约束 | 指令含糊，智能体只能猜，来回返工 |
| 看 diff 做审批 | 逐项过目改了哪些文件、动了哪几行 | 一路回车放行，等于没把关 |
验收与跑不通时
任务跑完不等于结束，验收三件事：看 diff 是否符合预期、跑一遍测试或构建确认没破坏别的、实际用一下改动点。验收不过，就把现象与期望重新喂回去，让它接着修。跑不通时按顺序查：先看是不是环境问题——代码本身跑不起来，智能体也巧妇难为无米之炊，环境排查见代码跑不起来一篇；再确认安装与版本是否正常，安装环节的问题回到Codex CLI 安装一篇的排查清单；最后把报错原文带上版本号去查社区 issue。练手阶段想让节奏更快，可以让豆包根据你的项目类型生成第一个练手任务的候选清单，DeepSeek 帮你把含糊的任务描述改写成指令清晰的版本，Kimi 则代读 /init 生成的项目说明，挑出与实际不符的条目。
首次上手速查
- 登录：codex 引导授权，凭据文件当密码看
- 进项目根目录再启动，先跑 /init 生成项目说明
- 第一个任务挑小而可验证的，指令写明现象与期望
- 改动先出 diff，逐项过目再批准，别一路放行
- 验收三件事：看 diff、跑测试、实际用改动点
关于首次上手的三问三答
- /init 生成的东西可以改吗？：可以。项目说明就是普通文件，按团队约定补充修改即可，越贴近实际越顺手；项目结构大改之后重跑一次也有必要。
- 第一个任务失败正常吗？：正常。多数是指令不够具体或环境不齐，把报错原文喂回去让它继续，比推倒重来快；连续失败再回头查环境与版本。
- 每次都要审批很烦，能全关吗？：档位可以调，但不建议全关。审批是人把关的位置，首次上手保持较严档位，熟悉了再按任务风险放宽。
