乐于分享
好东西不私藏

最详细的保姆级 Codex 教程:从安装到跑通第一个项目,小白照着做就行

最详细的保姆级 Codex 教程:从安装到跑通第一个项目,小白照着做就行

别一上来就问 Codex 能做什么。新手真正要先搞懂的是:把它放在哪个项目里、给它什么权限、让它按什么规则干活。

很多人第一次打开 Codex,最大的感受不是震撼,而是懵。

它看起来像聊天软件,但又能读文件、改代码、开浏览器、跑命令、装插件、接外部工具。你如果什么都没配置好就让它干活,很容易出现三个问题:文件不知道生成到哪、任务上下文越来越乱、权限给大了心里发慌。

所以这篇不讲玄学,不堆概念,只带你把 Codex 从“能聊天”配置到“真的能做项目”。

先给结论

新手第一次用 Codex,最重要的不是模型,也不是插件,而是先建一个干净的项目文件夹。项目位置对了,后面 80% 的混乱都会消失。

第 0 关:先理解 Codex 到底是什么

你可以把 Codex 理解成一个 AI 工作台,而不是一个普通聊天框。

普通聊天框主要给你答案;Codex 更进一步,它可以进入你的项目文件夹,帮你新建文件、改文件、运行命令、测试结果、整理产物,甚至通过插件去操作浏览器和办公软件。

这也是它强的地方,也是新手最容易踩坑的地方。能力越强,越要先画好边界。

Codex 的常见入口

Codex App

电脑上的主工作台,适合新手从本地项目开始。

IDE / VS Code 扩展

适合本来就在编辑器里写代码的人。

CLI / 命令行

适合熟悉终端和开发环境的进阶用户。

Web / Cloud

适合把任务交给云端或远程环境继续跑,后面再学。

第 1 关:安装,别乱找下载包

安装 Codex 的第一原则:只走官方入口或系统应用商店,别去各种网盘找安装包。

Mac 用户按普通软件安装即可。Windows 用户如果习惯点按钮,就走官方页面;如果你愿意用命令,也可以用 Windows 自带的 winget。

Windows 安装命令:  winget install Codex -s msstore  如果后面要让 Codex 跑代码项目,建议顺手检查这些工具:  git --version node --version python --version

如果没有安装 Git、Node.js、Python,也不用慌。你可以直接让 Codex 帮你检查当前电脑缺什么,再根据提示安装。

可以这样问 Codex:  请检查我这台 Windows 电脑是否已经安装 Git、Node.js 和 Python。 如果没有安装,请告诉我每个工具的作用,并给我最稳妥的安装方式。 先不要直接改我的系统设置。

第 2 关:登录,优先用账号,实在不行再接 API

第一次打开 Codex,一般会让你用 ChatGPT / OpenAI 账号登录。新手我建议优先走账号登录,因为插件、浏览器连接、同步能力这些功能,账号登录体验更完整。

如果你没有可用账号,或者想接其他模型,也可以走 API Key 或模型切换工具。但这条路更像“替代方案”,不是新手最省心的主路。

关于接国产模型

有人会用 CC-Switch 这类工具,把 Codex 接到 DeepSeek、GLM 等模型上。核心就两步:填 API Key,填正确的模型名。最容易出错的地方恰恰是模型名,必须按平台文档原样填写,一个字符都别手抖。

第 3 关:认界面,只记住这四个区就够

Codex 的界面入口很多,新手不要一开始就全记。先记这四个区域。

左侧:对话和项目

零碎问题放对话;真正要生成文件、改代码、做资料,放项目。

中间:主对话区

你给任务、它回复方案、展示执行过程的地方。

右侧:文件、预览和变化

看它改了什么、生成了什么、网页或文档长什么样。

设置区:模型、权限、插件、记忆

新手只需要先会调权限、看额度、装插件、设置语言。

第 4 关:Chat 和 Project,千万别用错

这是整篇最重要的一节。

Chat 适合问问题、写文案、做计划、解释概念。它更像普通聊天,不适合管理一堆本地文件。

Project 才是 Codex 真正干活的地方。一个项目对应你电脑上的一个文件夹,Codex 生成的文件、修改的代码、跑出来的结果,都应该落在这个文件夹里。

如果你只记一句话:凡是要产出文件,就开 Project。

项目文件夹怎么建最舒服?

不要把所有任务都塞进一个大文件夹。按主题分项目,比如“公众号文章”“短视频脚本”“个人网站”“自动化工具”。每个项目下面再开不同对话处理不同任务。

推荐的新手文件夹结构:  CodexProjects/   article-studio/     drafts/     assets/     output/   website-demo/     src/     public/   automation-lab/     scripts/     data/     logs/

第 5 关:权限别乱开,先用“自动审查”

Codex 强就强在它能真的动文件、跑命令。但新手最怕的也是这个。

一般会看到几类权限:最保守的默认模式、适合日常的自动审查、更开放的完全访问。名字可能随版本变化,但逻辑差不多。

我的建议很简单:刚上手,用自动审查。让它能自己推进普通任务,但遇到删除文件、动敏感目录、执行高风险命令时停下来问你。

权限选择速查

新手学习:默认或自动审查

适合第一次跑项目、第一次让它改文件。

日常开发:自动审查

效率和安全比较平衡。

熟悉项目后:谨慎提高权限

只给你信任的项目、明确的任务、可回滚的环境。

第 6 关:给 Codex 写“家规”

很多人觉得 Codex 不懂自己,其实是因为没给它规则。

你可以理解为两层规则:全局规则,是你对所有项目的通用要求;项目规则,是某个项目自己的约定。常见文件名叫 AGENTS.md,作用就是告诉 Codex:在这里干活要遵守什么习惯。

新手可以直接让 Codex 生成项目规则:  请为当前项目创建一份 AGENTS.md。 要求: 1. 默认用中文和我沟通 2. 修改文件前先说明计划 3. 不要删除文件,除非我明确同意 4. 完成后告诉我改了哪些文件 5. 能测试就先测试,不能测试要说明原因 6. 输出结论要简洁,不要堆技术黑话

这一步非常值。它相当于给 Codex 套上你的工作习惯,后面每次开新对话,它不用重新猜你的偏好。

第 7 关:插件和 Skills,先装少一点

插件和 Skills 是 Codex 生态里很香的部分。

插件可以让 Codex 连接浏览器、文档、表格、演示、设计、自动化工具;Skills 更像一套可复用的工作流程,比如“生成公众号排版”“整理会议纪要”“检查代码提交”。

但新手不要一口气装一堆。插件越多,入口越多,你越不知道该用哪个。

第一批只建议装这几类

Chrome / 浏览器类:适合网页读取、后台操作、表单流程。

Documents / Spreadsheets:适合文档和表格处理。

Presentations:适合 PPT 大纲和初稿。

你自己高频使用的 Skill:只装真正会反复调用的。

调用技巧:  在对话框输入 / 或 $,通常可以快速调出可用功能、插件或 Skill。 不要每次都去菜单里翻,用熟这个入口,效率会高很多。

第 8 关:Git 是安全网,不是程序员专属

只要你准备用 Codex 改网站、改代码、改项目文件,就一定要知道 Git。

别被名字吓到。你可以把 Git 理解成项目的时间机器。每次改动之前拍一张快照,改坏了就能回退。

如果只是写文章、做表格、生成 PPT,暂时不管也行。但一旦进入代码项目,Git 就是救命绳。

第一次让 Codex 动代码前,可以先说:  请先检查当前项目是否已经启用 Git。 如果没有,请告诉我是否建议初始化。 在你修改任何文件前,请先说明会改哪些地方。 修改完成后,请列出变更文件和验证结果。

第 9 关:跑通第一个真实项目

新手不要一上来就让它改大型项目。第一次实战,建议做一个小而完整的任务:比如生成一个个人主页、整理一个表格、写一个简单网页工具。

重点不是项目多高级,而是你要完整走一遍:建项目、给规则、下任务、看文件、预览结果、让它修改、最后验收。

第一个项目推荐这样布置:  请在当前项目里做一个单页 HTML 工具。 主题:个人任务看板。  要求: 1. 页面能添加任务、标记完成、删除任务 2. 不需要后端,数据可以存在浏览器本地 3. 界面要简洁,适合小白使用 4. 所有文件都放在当前项目文件夹里 5. 完成后告诉我如何打开和测试 6. 如果能运行预览,请帮我检查页面是否正常

这个任务不难,但它覆盖了 Codex 的核心能力:生成文件、写代码、组织项目、解释结果、辅助验收。你跑通一次,后面就开窍了。

第 10 关:别让 Codex 失控,记住这 5 条

Codex 越强,越要有使用纪律。下面这 5 条,新手最好直接背下来。

不要在不清楚的目录里开完全权限

不要让它直接处理密码、支付、密钥和敏感数据

重要项目先启用 Git,再让它改

大任务先让它列计划,小任务再让它直接执行

完成后一定让它说明改动和验证结果

最后给你一套新手固定口诀

以后你每次开 Codex,都按这个顺序来:

Codex 新手 7 步法:  1. 先建项目文件夹 2. 再开 Project 3. 写清楚项目规则 4. 权限先用自动审查 5. 任务先小后大 6. 让它边做边验证 7. 最后看文件、看结果、看改动说明

真正的分水岭

会用 Codex 的人,不是会问一句“帮我写代码”的人,而是会搭项目、定规则、控权限、会验收的人。你把这套流程跑顺,Codex 才会从聊天工具变成你的 AI 工作台。

第一次用,不用追求高级。

先跑通一个小项目,知道文件在哪里,知道它改了什么,知道怎么回滚,知道怎么让它继续优化。

跑通这一次,你就会明白:Codex 真正厉害的地方,不是它能回答问题,而是它可以进入你的工作流,帮你把一个想法一步步做成可用的东西。

别把 Codex 当聊天框。

把它当成一个需要你立规矩、给项目、会执行、能验收的 AI 同事。这样用,才算真正入门。