Codex 保姆级上手:从下载安装到做出第一个可交付小工具

很多人第一次听到 Codex，反应不是兴奋，而是紧张。

“我不会写代码，能用吗？”

“是不是要装一堆东西？”

“会不会把我电脑里的文件改乱？”

“没有国外账号，是不是就不用看了？”

这些问题都很正常。

但如果你只把 Codex 理解成“另一个会写代码的聊天框”，那就低估它了。

Codex 真正值得普通人学习的地方，不是它能不能帮你写几行代码。

而是它开始把一件过去需要开发参与的事，变成一个普通人也能指挥、拆解、验收的工作流。

比如你可以先让它帮你做一个客户跟进小工具。

不是完整 CRM，不是复杂系统。

就是一个能新增客户、记录状态、筛选跟进进度的小页面。

这类工具以前你可能会觉得“要找程序员”。

现在你可以先自己跑出第一版，再让技术人员检查、加固、上线。

这篇就不讲玄的。

我按新手真正会卡住的顺序，把 Codex 从下载安装到第一个可交付小工具，完整串一次。

你不需要先懂代码。

你只需要记住一句话：

Codex 不是拿来许愿的，它是拿来交任务的。

很多人用 AI 工具的习惯，是打开一个聊天框，然后问一句：

“帮我写个系统。”

这种问法放在普通聊天 AI 里还能聊两句。

但放在 Codex 里，效果反而容易变差。

因为 Codex 的核心不是“陪你聊想法”，而是“在一个具体项目里干活”。

它会围绕一个文件夹工作。

这个文件夹可以是一个网站项目、一个小工具项目、一个文档项目，也可以是你准备让它生成新内容的空文件夹。

你把文件夹交给它，它就有了工作场地。

你再告诉它目标、边界和验收标准，它才知道自己该改什么、不该改什么。

这就是 Codex 和普通聊天框最大的区别。

聊天框像顾问。

Codex 更像一个能进入你工作台的执行助手。

所以第一步不是学命令。

第一步是换脑子：

不要问它“你会不会做”。

要告诉它“这件事做到什么程度算完成”。

新手不要一上来就追求最专业。

能装上、能登录、能跑通第一件小任务，比什么都重要。

目前最稳妥的路线有三种。

第一种是桌面 App。

如果你不喜欢终端、不想背命令，优先选这个。

官方 Codex App 支持 macOS 和 Windows。Mac 还要注意自己是 Apple Silicon 还是 Intel 机器，别下错版本。

安装方式就跟普通软件差不多。

下载、安装、打开、登录。

第二种是 CLI，也就是终端版本。

如果你已经习惯命令行，或者你本来就在做开发项目，可以用 CLI。

它的好处是更轻、更直接，适合在一个项目目录里快速让 Codex 阅读、修改、运行代码。

第三种是 Web / Cloud。

这更适合已经有 GitHub 仓库、想让 Codex 在云端处理任务的人。

比如修一个 bug、改一个页面、做一个 PR。

如果你刚开始学，我建议先别急着上云端。

先在本地 App 或 CLI 里跑通第一个小任务。

原因很简单：

本地更容易理解“文件夹、权限、修改、验证”这套逻辑。

等你知道它怎么干活，再去用云端并行任务，心里会稳很多。

打开之后，最常见的卡点是登录。

官方路线通常是 ChatGPT 账号或 OpenAI API key。

如果你有 ChatGPT 账号，直接登录最省事。

如果你使用 API key，也可以走 API key 路线，但要注意：不同登录方式可用功能可能不完全一样。

这里有个新手很容易忽略的点：

不要随便把自己的账号、API key、refresh token 交给来路不明的工具。

现在各种“增强版”“远程版”“一键版”很多。

有些确实方便，有些风险也不小。

尤其是涉及账号凭证、项目代码、公司资料的时候，宁愿慢一点，也要先确认来源。

我的建议是：

第一次学习，尽量走官方入口。

如果你后面确实要接第三方模型、国产模型、代理工具，也先把它当作进阶玩法，不要一开始就把所有变量都叠在一起。

新手最怕的不是功能少。

新手最怕的是：出了问题以后，你不知道问题到底出在账号、网络、模型、工具，还是项目本身。

所以第一轮先跑通最简单路径。

等第一件事成功了，再加复杂配置。

装好登录之后，很多人会犯一个错误：

随便开一个对话，什么都往里面丢。

今天让它写页面。

明天让它整理资料。

后天又让它改另一个项目。

刚开始看起来方便，过几天就乱了。

Codex 更适合按项目管理。

一个项目，对应一个明确文件夹。

一个文件夹，对应一类工作。

比如你今天要做“客户跟进小工具”，就新建一个文件夹，名字可以叫：

客户跟进工具

里面不要一开始就放一堆无关东西。

你可以先放三类材料。

第一类，是你的业务规则。

比如客户信息有哪些字段，跟进状态分几类，哪些内容必须保存。

第二类，是你喜欢的参考样式。

可以是一张截图，也可以是一段文字描述。

第三类，是验收标准。

比如页面能打开，数据能新增，状态能筛选，刷新以后不丢。

注意，这里不是让你变成产品经理。

只是让你在让 AI 动手前，先把“做成什么样”说清楚。

Codex 越强，你越不能只靠一句模糊愿望。

工具强了以后，真正决定结果的，反而是你的任务交代能力。

第一次用 Codex，不要上来就做完整系统。

不要做登录。

不要做支付。

不要做权限。

不要做多端同步。

这些东西不是不能做，而是不适合作为第一步。

第一步要做一个小到不能再小，但你真的用得上的东西。

比如：

客户跟进小工具。

日报生成小页面。

报价单填写器。

选题管理表。

素材检查清单。

会议纪要整理器。

这些东西有一个共同点：

它们不宏大，但能马上验证。

能打开吗？

能输入吗？

能保存吗？

能筛选吗？

能导出吗？

你一眼就能判断它有没有用。

我建议你第一次就用“客户跟进小工具”练手。

原因是它足够通用。

老板能懂，销售能懂，运营也能懂。

而且它可以非常简单：

客户名称。

联系人。

需求描述。

跟进状态。

下次跟进时间。

备注。

就这些字段，已经够你跑通 Codex 的基本工作方式了。

你可以把下面这段改成自己的业务，然后交给 Codex。

不要一上来就让它直接写代码。

先让它读懂任务，再让它分步骤执行。

我想做一个内部使用的客户跟进小工具。  目标： 先做一个本地可运行的单页工具，用来记录客户线索和跟进状态。 这是第一版，不做登录、不做权限、不做云同步。  需要的字段： 客户名称 联系人 联系方式 客户需求 跟进状态 下次跟进时间 备注  第一版功能： 可以新增客户 可以编辑客户 可以按跟进状态筛选 可以按下次跟进时间排序 数据先保存在浏览器本地即可  界面要求： 适合电脑端使用 信息要清楚，不要花哨 新增和编辑入口要明显 空状态要有提示  边界： 不要做登录 不要接数据库 不要新增复杂依赖 不要重构无关文件 如果当前文件夹是空的，请先生成一个最小可运行版本  执行方式： 先阅读当前文件夹 先告诉我你准备怎么做 等我确认后再开始修改 每完成一步，说明你改了什么、怎么验证  验收标准： 页面能打开 能新增一条客户记录 能编辑已有记录 能按状态筛选 刷新后数据不丢 没有明显报错

这段任务单的重点，不是字多。

而是它把几个关键问题说清楚了。

做什么。

不做什么。

先做到什么程度。

怎么判断完成。

这才是普通人用 Codex 最应该学的东西。

你不需要理解每一行代码。

但你要知道自己交出去的任务有没有边界。

Codex 能读文件、改文件、运行命令。

这正是它强的地方。

但也是新手最应该谨慎的地方。

第一次用，我不建议你直接把权限开到最大。

先让它在每次关键操作前问你。

你看几轮以后，会慢慢知道它通常会做什么。

比如它要新增文件，你可以同意。

它要安装依赖，你先看一下是不是必要。

它要删除文件，你要格外小心。

它要改一堆无关文件，你应该让它停下来解释原因。

这不是不信任 AI。

这是建立工作边界。

AI 工具越像执行者，你越要懂审批。

尤其是公司电脑、客户资料、重要项目，不要随手把整个桌面、下载目录、微信文件夹都丢给它。

先新建一个干净文件夹。

只放这次任务需要的东西。

这一步能减少大部分新手恐惧。

新手第一次用 Codex，最容易崩溃的地方不是安装。

是报错。

页面打不开。

命令跑不通。

依赖装不上。

样式错位。

数据保存失败。

这时候不要连续发十句：

“不行，继续改。”

“还是不行，再改。”

“你重新做。”

这样很容易越修越乱。

更好的方式是让它先诊断。

你可以这样说：

先不要继续修改。 请先判断这个问题属于哪一层： 是运行环境问题、依赖安装问题、页面代码问题、数据保存问题，还是浏览器缓存问题。 请说明判断依据。 然后给我一个最小修改方案，不要大范围重写。

这段话非常有用。

因为它会把 Codex 从“立刻动手修”拉回“先判断原因”。

很多时候，问题不是代码坏了。

可能只是你没进对目录。

可能只是依赖没装。

可能只是端口被占了。

可能只是浏览器缓存。

如果每次都让它大改，最后你会得到一个更乱的项目。

所以记住：

报错时，先诊断，再修复。

这是你从“AI 小白”变成“会指挥 AI 干活”的分水岭。

当你能做出第一个小工具以后，再往下学三件事。

第一，项目规则。

你可以给项目写一份规则文件，告诉 Codex：

这个项目用什么技术。

不要改哪些目录。

每次改完要跑什么检查。

输出总结要包含什么。

这会让 Codex 每次进项目都更稳定。

第二，截图和视觉反馈。

如果页面不好看，不要只说“高级一点”。

这种话太空。

你应该截图给它看，然后指出：

哪个按钮不明显。

哪块留白太大。

哪个标题层级不清楚。

哪个颜色太抢。

哪里在手机上挤到一起。

AI 很擅长根据明确反馈修改。

但它不擅长理解一句“你自己看着办”。

第三，把一次成功沉淀成模板。

比如你这次做客户跟进小工具跑通了。

下次做报价单工具，就不要重新摸索。

你可以把这次任务单、验收标准、报错处理方式保存下来。

这就是你的 AI 工作流资产。

工具会更新。

但你沉淀下来的任务模板，会越来越值钱。

最后给你一份保存清单。

第一，不要一上来做完整系统。

先做一个小功能，能跑通再说。

第二，不要把所有任务塞进同一个对话。

一个项目一个文件夹，一件事一条任务线。

第三，不要把重要文件夹直接交给它。

先用干净目录练手。

第四，不要把账号密钥发给不明工具。

尤其是 API key、token、公司代码和客户资料。

第五，不要只说“做得好看一点”。

用截图和具体问题反馈。

第六，不要让它报错后连续乱修。

先让它判断错误在哪一层。

第七，不要每次都从零开始。

把好用的任务单保存下来。

第八，不要把 Codex 当魔法。

它是执行者，你才是验收者。

这句话很重要。

未来真正会用 Codex 的人，不一定是最会写代码的人。

而是最会把业务目标拆成可执行任务的人。

以前你有一个想法，只能停在脑子里。

现在你可以让 AI 先帮你做出一个能看的版本。

这就是普通人学习 AI 编程工具的意义。

不是为了变成程序员。

而是为了把自己的想法，更快变成可验证的东西。