小白也能学会的Codex实战课

📅 2026/7/26 23:21:23
小白也能学会的Codex实战课
小白也能学会的Codex实战课从零到第一个PR一、Codex是什么一个帮你写代码的AI队友简单说Codex是OpenAI推出的能独立完成编程任务的AI智能体。你可以把它理解成一个经验丰富的“AI程序员队友”——你告诉它“修好登录页的样式Bug”它会自己读代码、改代码、跑测试最后提交一个Pull Request。和ChatGPT的区别ChatGPT只给你代码建议剩下的得自己动手而Codex直接在你的仓库里干活帮你把代码改完。二、环境配置30分钟搞定准备工作一个GitHub账号一个ChatGPT账号Plus/Pro/Team均可一个准备用来练习的代码仓库建议从简单的个人项目开始别一上来就动公司核心库安装步骤在电脑上安装Node.js环境打开终端输入安装命令bashnpm i -g openai/codex终端中输入codex按提示完成GitHub授权登录在ChatGPT网页版左侧边栏找到Codex图标连接你的仓库小窍门首次尝试建议从桌面App或VS Code插件入手操作界面对新手更友好。三、从第一个任务开始把任务拆成三个阶段循序渐进阶段任务示例目的是什么只读“帮我分析这个项目的目录结构”熟悉Ask模式小改“把README里的xxx改成yyy”体验简单修改带验证“修复tests里那个失败的用例”体验完整闭环给新手的核心建议先让Codex用Ask模式给出修改方案确认没问题后再切换到Code模式让它真正动手。不要一上来就让AI直接改代码。四、让Codex听懂你写一份AGENTS.md这是新手最容易忽略、却最重要的一步。AGENTS.md是放在项目根目录的一份说明文档相当于给Codex看的“项目规则手册”。示例内容markdown# AGENTS.md ## 编码风格 - Python代码遵循PEP8规范 - 变量名用英文不用拼音 - 所有函数必须写文档字符串 ## 测试要求 - 修改代码后必须运行测试 - 测试覆盖率不低于80% ## 提交规范 - PR标题格式[类型] 简短描述 - 每个PR只解决一个问题有了这个文件Codex产出的代码会更符合你的项目标准。五、遇到问题怎么办Codex改错了地方→ 直接在对话中点“拒绝”告诉它“撤销这次改动换一个方案”Codex请求权限→ 看清楚它要操作什么文件有疑问就拒绝并追问代码修改不完整→ 继续对话“还有xxx地方也需要改一并处理”记住一句话Codex是帮你干活的队友不是你的领导——所有决策最终由你来做。六、几点实用建议从小项目练手先在个人测试仓库里玩熟再上真实项目权限先紧后松默认开启“每次修改前需确认”模式熟悉后再放开多问为什么Codex改完代码后追问一句“为什么这么改”能学到不少东西保持Review习惯AI不是万能的你仍然是代码质量的最终守护者结语学会用Codex不是让你放弃编程基本功而是让你多一个得力的AI队友。它能帮你处理重复劳动让你把精力集中在更有价值的设计和决策上。从今天起试着对Codex说一句“帮我把这个登录接口加上单元测试”——然后看看会发生什么。迈出第一步你就已经超越了很多观望者。