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

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

一、环境准备

Codex CLI 通过 npm 安装,需要 Node 22 以上:

bash 复制代码
node -v
npm install -g @openai/codex
codex --version

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

二、登录

bash 复制代码
codex login

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

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

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

bash 复制代码
cd your-project
codex "总结这个项目的结构和构建方式"

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

四、第一个修改任务

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

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

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

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

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

六、日常提效速查

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

小结

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

相关推荐
一缕82年的清风19 小时前
告别手动搬砖!我是如何搭出一套“AI 全自动自媒体运营系统”,每天 10 分钟铺满 7 大平台的?
chatgpt·claude·gemini
可乐ea3 天前
智能体的模型列表为什么要从三处来源合成:一次让 GPT-6.1 Sol 选不上的发布延迟
人工智能·gpt·chatgpt·智能体框架·模型列表·多源数据合成·客户端工程
dozenyaoyida4 天前
AI与大模型新闻日报 | 2026-11-11
人工智能·chatgpt·大模型·新闻
一缕82年的清风5 天前
Claude Code 跑 DeepSeek 还带自动切号?开源 Magpie 彻底把大厂的协议护城河给拆了!
chatgpt·claude·gemini
Spidermanbaout7 天前
Prompt-Engineering实战-2026年11月2日
人工智能·机器学习·ai·chatgpt·ai编程
ServBay7 天前
OpenAI大规模封号?ChatGPT 用户该如何应对
chatgpt·openai·ai编程
长不大的杨瑞杰8 天前
ChatGPT 广告技术栈架构拆解:多轮意图、LLM 工具编排、ANN 召回与拍卖闭环
人工智能·chatgpt·系统架构·推荐系统·广告
AI砖家9 天前
ChatGPT Images 2.6 正式支持 GIF 生成:一张图片也能动起来,AI 动图创作时代来了!
人工智能·chatgpt
看浪的路人9 天前
第3讲:输出安全——PII 脱敏与有害内容过滤
chatgpt
冯智勇Geo9 天前
看书不如聊书:分享一种新的 AI 阅读方式
chatgpt·ai阅读