Codex 从安装到第一次提交：新手上路清单

团队里开始有同事用 Codex 了，把新人从零到第一次成功提交的过程整理成清单，照着走基本不会卡住。

一、环境准备

Codex CLI 通过 npm 安装，需要 Node 22 以上：

node -v
npm install -g @openai/codex
codex --version

Windows 用户建议在 Windows Terminal 里使用，旧版 cmd 的交互渲染有问题。

二、登录

codex login

会弹出浏览器完成授权。注意登录需要 ChatGPT 订阅账号（Plus、Pro、Team 都包含 Codex 用量），免费账号无法使用完整功能。

三、第一次任务：从只读开始

进到你的项目目录，第一次建议用默认的 Suggest 模式，让它只读不改：

cd your-project
codex "总结这个项目的结构和构建方式"

先观察它的判断质量，建立信任后再放开修改权限。

四、第一个修改任务

选一个有测试覆盖的小需求或小 bug，明确目标和验收标准：

codex "修复 utils/date.js 里时区转换的 bug，tests/date.test.js 里的用例必须全部通过"

要点：给验收标准，不给实现步骤。告诉它"怎样算完成"，让它自己决定怎么做，这是和 AI 协作的正确姿势。

五、新人最容易犯的三个错误

• 一次给太大的任务：拆小任务，一次一个目标，每步可验证
• 不看它的 diff 就接受：每次修改都要过一眼，这是你保持判断力的底线
• 忘了项目里可以放 AGENTS.md：把项目规范写进去，它犯的错会少一大半

六、日常提效速查

codex "根据 staged 改动写提交信息"        # 告别手写 commit message
codex "审查当前分支相对 main 的 diff"      # 提交前的第一道评审
codex "给 src/api 补充 JSDoc 注释"        # 机械性工作全部外包

小结

上手感 comes from 前两三个真实任务，选个小 bug 修起来比看任何教程都快。这份清单会持续更新，配套的工具和资料汇总我也放在了 gptupcn.com，新手照着配一遍能省不少时间。