Codex 怎么用?零基础从安装到完成第一个真实任务的路线

OpenAI Codex 是一个能读代码、改代码、跑命令的 AI 编程助手。这篇按零基础的顺序讲清楚:选哪个入口、怎么装、第一个任务怎么提、怎么用 AGENTS.md 让它越用越顺,以及新手最常踩的几个坑。

Codex 教程Codex 怎么用AI 编程Codex CLIAGENTS.md

很多人第一次打开 Codex,输入一句「帮我写个网站」,得到一堆看不懂的文件,然后就放弃了。问题通常不在工具,而在用法:Codex 不是聊天机器人,它更像一个坐在你电脑前的初级工程师,能读你的项目、改文件、跑命令,但需要你把任务交代清楚、把边界划好。

第一步:先选一个入口

Codex 有几种用法:命令行版(Codex CLI)、编辑器插件、桌面应用,以及在网页上把任务交给云端执行。零基础建议从桌面应用或编辑器插件开始,界面直观,能看到它改了哪些文件;熟悉之后再用命令行,速度更快,也更适合批量处理。无论哪个入口,登录都可以用 ChatGPT 账号,背后是同一套能力。

第二步:在一个真实项目里打开它

不要在空文件夹里让它「从零写个大系统」。更好的开始方式是:找一个你手头真实的小项目,哪怕只是一个静态网页或一个 Excel 处理脚本,在这个目录里启动 Codex。它会先读目录结构,再根据你的要求动手。第一次可以先问一句「这个项目是做什么的?怎么运行?」,看它理解得对不对。

第三步:第一个任务要小、要能验证

好的第一个任务长这样:「把首页标题改成 XXX,改完后启动本地服务,告诉我访问哪个地址能看到效果」。它有三个特点:范围小、结果能马上看到、包含验证步骤。等你确认它改对了,再给下一个任务。一次只做一件事,比一次交代十件事成功率高得多。

第四步:用 AGENTS.md 让它记住你的项目

每次都重复「我们用 pnpm」「测试命令是 npm test」「别动 config 目录」很累。Codex 会读取项目根目录下的 AGENTS.md 文件,把项目约定写进去,它每次启动都会遵守。一份够用的 AGENTS.md 只需要写清楚:怎么安装依赖、怎么运行、怎么测试、哪些目录不能动、代码风格有什么要求。可以先让 Codex 帮你生成一份初稿,你再改。

第五步:权限和审批别全放开

Codex 改文件、跑命令前可以要求你确认。刚开始建议保留确认,看它每一步想做什么,既能学到东西,也能拦住误操作。等你对它在这个项目里的行为有把握了,再逐步放宽。另外,开始一个任务前先用 Git 提交一次,改坏了随时能退回,这是用好 AI 编程最便宜的保险。

新手最常见的四个坑

一是任务太大,一句话让它做完整个产品,结果半途跑偏;二是不看它改了什么就直接用,问题越积越多;三是遇到报错只说「不行」,不把报错信息贴给它;四是不写 AGENTS.md,每次对话都从零开始。避开这四个坑,Codex 的可用度会高很多。

如果你想按顺序系统学一遍,从电脑基础、安装配置,到 CLI、MCP、Skills 和团队工作流,可以看 从零上手 Codex,前 8 讲免费,不用登录就能看。想了解 AGENTS.md 的更多写法,可以读这篇 AGENTS.md:把项目约定写进文件。