ARTICLE · 1041190
Codex保姆级使用教程:从安装到做出第一个小工具!(附案例实操)

文 / 兔八哥
很多同学,装好 Codex 后,第一件事该让它干什么?如果你也卡在这里,先别研究插件。找一件算得清、做得小、结果能自己检查的工作,试一次。
比如给客户报价:服务有几项,每项多少钱,最后减多少优惠。你大概早就会算,只是每次都要重新填、重新核对。这种规则明确的工作,很适合拿来练手。
这篇八哥直接做一个案例:用 Codex 做一个项目报价计算器。 输入服务项目、数量、单价和优惠,得到应付金额。它够小,新手能跟上;也够完整,能把交任务、看结果、改问题走一遍。
你不必先学编程。但报价按什么规则算、算出来对不对,这两件事需要你拿主意。
01 / 安装之前,先认清你要用哪个入口
先说一个会影响你找按钮的变化:截至2026年9月17日,原 Codex 桌面端官方文档已跳转到新版桌面应用说明。新版可以在产品选择器里进入 Codex。旧版本可能直接显示 Codex 工作区。官方快速入门
如果下载后应用名称、侧边栏与旧教程不同,先检查版本和入口,不要急着卸载重装。
第一次先用桌面端。命令行适合习惯终端的人,编辑器扩展适合已有代码项目的人,这两种入口都不是本文的前置要求。
新版还提供 ChatGPT 的 Chat / Work 入口:普通问答用 Chat;研究、文档等交付可以用 Work。本文做小工具,跟着 Codex 这条路线走即可。

图1|操作路线图。按钮名称会随版本变化,按功能找入口。
Windows:打开官方 Windows 安装说明,点击其中的下载链接,按系统提示安装。当前支持 Windows 原生运行,不必为了入门先装 Linux 环境。
Mac:打开官方桌面应用页面,按页面列出的系统和芯片要求选择安装包。安装后,从应用程序中打开。
两种系统装好后,都先用自己的 ChatGPT 账号登录。本文不需要你提前申请 API key;官方另有 API key 登录方式,但部分功能可能不同。
能登录不代表所有功能都已开放。先看自己账号的可用入口和额度,再决定是否需要付费;套餐价格与额度会变化,这里不写一个容易过期的数字。
这里如果还有不会装,或者又疑问的在评论区把问题留下,八哥第一时间简解答。
安装完成的判断标准:能进入 Codex,并能打开一个新任务。 到这一步就往下做,不用先把设置菜单研究一遍。
02 / 给它一张干净的工作台
在电脑里建一个文件夹:Codex练习—报价计算器。
在应用中添加本地项目或打开文件夹,选中它。已有项目可以在项目菜单的 Edit project 中添加文件夹。项目说明
“项目”可以先理解成这一摊工作的资料夹,“任务”则是其中一件具体的事。同一个计算器的修改在原任务里继续,另一项不相干的工作另开任务。
电脑里有这个文件,不等于当前任务能看到。 文件要在任务可访问的目录中,或明确附加给它。第一次就给一个专用文件夹,找成果、查修改都方便。

图2|工作区结构示意,非软件截图;用于理解各区域作用,不对应固定按钮位置。
先认识五处就够了:
- 项目和任务列表:
回到正在做的工作。 - 输入区:
写需求,补文件和截图。 - 模型与权限设置:
决定用什么能力、允许哪些操作;位置因版本而异。 - 执行过程:
看进度、报错、待确认事项。 - 文件与预览:
打开交付物,检查并提出修改。
模型和思考强度,第一次先用默认。后面如果发现它反复理解错复杂逻辑,再考虑提高能力或拆小任务。颜色没改好,通常不值得先换一轮模型。
权限则要看清。Windows 官方文档提供 Ask for approval 等选项。保留适合当前任务的权限边界;“请不要改别的文件”只是文字要求,不能代替权限设置。Windows 权限说明
03 / 第一条需求,别让它猜“专业一点”
提示词示例:“帮我做一个专业的报价系统。”这句话看起来交代了工作,实际上还留下许多空白:怎么算钱?做给谁用?要不要登录?最后交网页还是表格?
如果你没说,它就可能自行补全。做出来越复杂,后面返工越多。
下面这张图,是一条可执行需求的骨架。

图3|先给规则和交付标准,再谈风格。
在新任务中直接发送下面这段。演示业务和数字是教学用的,不代表你的实际报价策略。
请在当前项目文件夹制作一个中文项目报价计算器,供一人公司内部试算。可以添加和删除服务项目。每行包含服务名称、数量、单价、小计;小计=数量×单价,合计=所有小计相加。优惠填写固定金额,应付=合计-优惠。单价与优惠最多填写两位小数;每行小计先四舍五入到分,再将各行小计相加,避免显示金额与合计对不上。金额显示两位小数;数量和单价不接受负数;优惠不能超过合计。输入为空或无效时给出提示,不显示误导性的应付金额。页面注明“内部试算,未计算税费”。刷新后不保留数据,要在页面说明。交付一个 index.html,样式和逻辑放在文件内,不依赖外网,不做登录、支付或客户信息收集。页面在电脑和手机宽度下都可使用。请直接完成文件,检查计算与异常输入,给出文件链接、打开方式、已验证与未验证项目。
这段需求最值得留意的是“不做登录、支付或客户信息收集”。少做这些,第一版就能把精力放在计算上。等你确认它有用,再考虑增加功能。
还有一点:如果你希望它真正动手,就写“创建文件并给出链接”。只问“这个该怎么做”,它可能合理地只解释做法。
04 / 执行中看什么,什么时候插话
你不需要逐行看懂技术输出。先盯住三个信号:它是否在做约定的内容,有没有等待你处理的事项,有没有反复卡在同一个错误。
如果它把固定金额优惠做成百分比,就直接纠正:
优惠是人民币金额,不是折扣百分比。按“合计减优惠金额”计算,请同步修改界面和验证用例。
如果它开始加登录、数据库和在线支付,就收回范围:
本次只完成可本地打开的单文件版本。先把计算和输入校验做好,新增功能留到下一版。
如果它申请权限,先看具体操作和理由。复制练习文件、运行检查,与删除资料、对外发送、公开部署,是不同的动作。不要因为按钮是英文就全部同意。
想得还不清楚时,可以先让它列方案;需求已经清楚,就让它做完一版。 一直在方案上打转,你就没有可检查的实物。
05 / 打开成品,亲手算一遍
等它给出 index.html,点击文件链接,或在项目文件夹中找到文件,用浏览器打开。
如果它只说“已完成”,没有给文件,补一句:
请告诉我最终文件的完整位置,给出可点击链接,并说明要用什么打开。
为了让你知道成果应该长什么样,本篇配套制作了一个演示计算器。发布包中的演示文件叫“报价计算器.html”,与上面要求生成的 index.html 是同类文件。下面是演示文件的真实浏览器画面;你生成的样式可以不同,计算规则应该一致。

图4|本篇演示文件实图。输入两项服务、优惠200元,应付2000元。
照着输入:需求梳理,数量2、单价500;方案制作,数量1、单价1200。
你可以不用信它,先自己算:2×500=1000,1×1200=1200,合计2200。再输入优惠200,应付必须是2000。
这组数字的作用,是给你一个独立于AI的对照结果。界面再好看,也不能替它证明计算正确。
正常金额算对以后,再试几种容易出问题的输入:
优惠输入3000:应提示超过合计,不能给出负数应付。 数量清空或改成负数:应提示输入问题。 删除一行:合计应该立即更新。 单价输入0.10、数量3:小计应为0.30。 把浏览器窗口缩窄:输入框、删除按钮和结果仍能正常使用。

图5|本篇演示文件实图:优惠超过合计时,隐藏应付数值并提示修正。
这些检查覆盖了正常输入、边界情况和实际操作。还没有覆盖税费、正式合同、多人协作,所以这个版本只作内部试算,不应直接当完整报价系统交付客户。
06 / 报错时,把问题说成“能重现的事”
“不对,重新做。”它得重新猜一次。
假设你生成的版本出现负数应付,可以这样反馈(配套演示已拦截该输入):
在 index.html 中,合计2200时输入优惠3000,页面显示负数应付。预期是提示“优惠不能超过合计”,并暂时不显示应付金额。请只修这个问题,保留现有样式,重新验证这组输入。

图6|位置、操作、实际结果、预期结果。一次讲清,便于复现。
如果是排版问题,就附截图,指出哪一块被挡住;如果是数值问题,就附输入与期望值。让反馈带上证据,比多加几个“认真检查”管用。
修好后,再问一句:你检查了代码、运行了计算测试,还是实际打开页面操作过?
这三种验证能说明的问题不同。比如检查代码不能证明手机上没有遮挡,浏览器能打开也不能证明所有金额算对。没验证的部分要列出来,不要被“全部完成”四个字糊过去。
07 / 功能很多,按你的工作来选
小工具走通之后,再看其他能力,就容易理解了。

图7|从工作需求选择能力;插件、浏览器等功能取决于当前环境与授权。
资料和文件处理。 让它基于指定资料整理、改写或批量修改,写清原文件在哪里、输出另存到哪里。涉及多份资料,要求标注来源,便于回查。
网页和代码修改。 给出需要改变的行为与复现步骤。先做小范围修改,再检查,避免一次重做整个项目。
搜索与浏览器。 查资料要日期和来源;操作网站要确认当前环境是否支持、账号是否连接。不是每项任务都能自动跨过登录和权限限制。桌面端能力说明
Skill。 把反复交代的工作步骤和标准保存起来,例如“内部小工具必须检查负数、空值、计算和窄屏”。它适合固定做法。
插件。 是可安装的能力包,可能包含 Skill,也可能包含连接外部服务的工具。安装完不一定等于账号已连接,具体看插件要求。Skills 与插件说明
定时任务。 适合已经跑通的重复工作。例如每周整理指定目录的项目更新。涉及本地资料时,电脑要开机、应用要运行、文件要能访问。定时任务说明
先不要装满一屏插件。遇到具体缺口再加:缺资料连接,找对应工具;总要重复写规则,整理 Skill;每周做相同步骤,再考虑定时。
08 / 第二次做,才开始积累自己的流程
第一次完成后,把真正有用的要求留成一份“制作规则”:输入要校验,输出要可打开,计算有对照数据,改错后重新检查,未验证内容明确列出。
等这套规则用顺,再请它整理成 Skill:
请使用 $skill-creator,把我们已经验证过的小工具制作流程整理成 Skill。包含输入检查、交付格式、计算与异常用例、人工验收步骤。用另一个小需求试跑,检查是否漏项。
如果当前没有 skill-creator,就先让它把规则保存为一份说明文件,下次明确附上。重点是留下已经验证过的做法,没必要为了保存几条规则先折腾安装。
这个练习做完,不代表每项工作都值得开发工具。 如果你已经有一张好用的报价表,而且报价规则很少变化,继续用表格就行。更值得做成工具的情况是:重复发生、规则稳定、输入输出明确,而且你能判断结果是否正确。涉及主观判断、例外很多的工作,先让AI辅助整理,不要急着全自动。
最后记一笔时间账:准备资料、等待生成、检查、修改,分别花了多久。四项相加,再与自己原来的做法比较。
如果第一次花了很久,不一定白费。看第二次能否沿用文件、规则和验证方法;如果每次都要从头解释、从头查错,就先修流程,别急着宣布提效。
第一版先留着用两次。哪里每次都要手动补,哪里经常填错,再改哪里。别在还没用过的时候,把所有想得到的功能都加上。
你做什么业务?最想交给 Codex 的一项工作是什么?现在最耗时的是哪一步? 欢迎把这三件事写在留言里。
兔八哥 · AI经营实验室
把AI用进业务,把效果算清楚。
资料核对:2026年9月17日。安装、入口和可用能力以当前官方说明及实际账号为准。文中演示为教学制作;不包含作者提效数据或客户效果承诺。*