Codex：0 基础从入门到精通【附完整路线】

你说想要什么，Codex 可以读文件、写代码、运行检查，把结果做出来。一个自己能用的小工具，往往就是这么开始的。

这篇从安装带你做完第一件事，再把好用的做法留下来，变成不用反复解释的工作流程。

文末还有一份更狠的：17 个板块、90+ 篇 AI 资料包，提示词、AI 绘画、Agent、AI 赚钱全在里面。

打开桌面端，建一个练习项目

先走 官方入门入口，下载桌面端，用自己的 ChatGPT 账号登录。官方页面已统一到 ChatGPT 桌面应用；如果你看到 ChatGPT 和 Codex 的选择，这次制作小工具选 Codex。

不用同时安装命令行和编辑器扩展。桌面端有对话，也能关联电脑里的文件夹，足够完成这次练习。账号能用哪些模型和功能，以你的界面为准，先用现成可用的配置。

在电脑上新建 Codex练习 文件夹，将它作为项目打开。新建一个任务，先发下面这段，确认它工作的地方没选错。

“这是我的第一次 Codex 练习。先告诉我你当前关联的项目路径，以及能读取哪些文件。不要修改文件、不要安装软件、不要联网。如果当前没有可用的工作目录，告诉我如何在这个版本的界面里选择。”

第一步的结果应该很简单：它报出的路径，就是你刚建的文件夹。不要把桌面或整个文档目录都当练习区，之后生成什么、改过什么才找得清。

权限先用默认审核或 Ask for approval。超出项目、联网或安装依赖时，看看它要做什么再确认。权限决定它能动哪里，不是一个越大越好的性能开关。说明在 官方权限文档。

给它一份明确的任务

这次做一个本地待办小工具：能看任务、筛选状态、勾选完成，再导出更新后的清单。不要求账号系统、不接数据库、不发布到网站，先做自己在电脑上能用的版本。

任务说清四件事就够了：材料在哪、要做什么、不能动什么、怎样才算完成。下面是一份完整需求，直接复制。

“我要做一个能在浏览器打开的本地待办小工具。请在当前项目建立 input 和 output 文件夹。先在 input 创建一份明确标注“练习数据”的 CSV：任务,负责人,状态整理会议纪要,我,未完成核对活动物料,小林,进行中提交周报,我,已完成这些都是虚构练习数据，不是我的真实工作。读取这份数据，生成 output/todo.html。页面要显示全部任务，支持按状态筛选、勾选完成和导出 CSV。使用单文件 HTML，不依赖外部资源，双击即可打开。不上传数据、不创建云服务、不覆盖输入文件。先列出实现办法和验收步骤，等我确认再制作。”

第一条指令不用写“你是世界级专家”，也不用一次塞二十个功能。把“能用”的条件讲清楚，它才能围绕这些条件制作和检查。

换成你的真实需求也一样：整理报名表，交代重复报名怎么处理；批量改图片尺寸，交代输出大小和原图是否保留。越具体，后面的返工越容易定位。

确认方案，再让它做

看它返回的方案，确认是不是单文件、是不是本地处理、是不是保留了输入表。发现它准备部署网站或安装一串服务，就直接把范围收回到这次练习。

方案合适，继续发：

“按刚才确认的方案制作。只实现查看、筛选、勾选和导出，不增加其他功能。检查文件能否打开、筛选结果是否正确、导出数据是否保留中文。给我成品文件路径、打开方式和实际检查结果。没做的检查写“未检查”，不要写成已通过。”

不要只看最后一句“完成了”。打开 todo.html，试着筛选“未完成”、勾选一项，再导出文件。你手里拿到能操作的东西，才完成了第一次任务。

这里还有个容易混淆的点：页面里勾选任务，不等于电脑里的原始 CSV 自动更新。要保留修改，就导出新表；关闭、重新打开能否保存状态，也要实际试一次。

如果你要长期保存，可以再增加这个要求。但第一版先验证基本功能，不用在最开始讨论所有可能出现的需求。

改结果，只改你指出的地方

功能正常，页面不好看？截图发过去，圈出哪里太挤、哪里字小、哪个按钮不明显。功能不正常？把操作步骤和结果一起给它，别只发“有问题”。

局部修改用这个模板：

“只修改 output/todo.html 的以下部分：[例如：把状态筛选按钮放到列表上方，增大任务文字]保持现有配色、页面宽度、数据和导出功能不变。不要重做整个页面，也不要读取与这次修改无关的资料。修改后检查这次改动，以及筛选、勾选、导出是否仍然正常。只告诉我改了什么和检查结果。”

遇到故障，换成“我点了什么、期待发生什么、实际发生什么”。例如：勾选第二项后导出，期待状态变为已完成，实际仍是进行中。这样的描述可以直接复现，比让它自己猜省事。

一次满意的结果值得留下。大改前让它保留可用版本，小改就定点执行；别每次为了换一句文字，都把整个流程重新跑一遍。

把常用规矩写进项目

你会逐渐发现有些话每次都要说：原文件别覆盖、结果放哪、回复要短、只改指定范围。这些可以写到项目里的 AGENTS.md，不用每个任务都重新输入。

让 Codex 帮你建文件，内容先少一点。规则太多、互相矛盾，比没有规则更难判断到底该按哪条执行。

“在当前项目根目录创建 AGENTS.md。如果已有同名文件，先读取并提出合并方案，不覆盖。加入这些项目规则：1. 只读取当前任务需要的文件。2. 原始材料放 input，生成结果放 output。3. 不覆盖原始材料，不删除文件；确需处理时先说明。4. 小修改只动指定范围，不顺手重做样式或功能。5. 完成后交成品路径和检查结果，不把大段日志贴给我。6. 需要付费服务、安装依赖或上传文件时先确认。这些规则只写到当前项目，不替我设置全局偏好。”

写好后，新开一个任务，问它“当前加载了哪些项目规则”，确认它确实读到了这个文件。不同目录的规则有作用范围，不能靠在某个对话里说“记住了”，就假定所有项目都知道。

以后确实要所有本地项目共用，再考虑全局文件。官方说明区分了全局与项目规则，以及目录覆盖顺序：AGENTS.md 文档。

稳定的流程，再做成 Skill

项目规则管“做事时遵守什么”，Skill 可以保存“这件事按哪几个步骤做”。比如每周读取待办表、核对字段、汇总未完成事项、输出一份周报。

先手动做几次，确认输出格式好用，再保存。第一次结果还没看，就急着装几十个 Skill，反而不知道问题出在数据、步骤还是技能本身。

在 Codex 里调用内置的 $skill-creator，用下面这份需求描述你的流程。入口名称随界面可能不同，也可以直接要求使用技能创建器。

“使用 skill-creator，把刚才确认的待办汇总流程做成一个 Skill。名字：todo-weekly-report。仅在我要求“整理待办周报”时使用，不用于修改待办页面。输入：我指定的 CSV 路径。步骤：核对字段 → 按状态汇总 → 列出进行中和未完成事项 → 输出周报。只使用表内信息，不补编负责人、截止日期或完成原因。输出 Markdown 文件和数据缺失清单，保留输入文件。先做指令型 Skill，不引入 API、联网或额外脚本。优先放在当前项目的技能目录，告诉我实际位置与调用方式。”

Skill 建好，拿一份新表再试：不要重新解释流程，只让它“使用 todo-weekly-report 整理这份表”。结果仍符合要求，才说明这套流程能复用。

官方 Skill 文档 解释了指令文件、触发描述和安装范围。需要的是稳定步骤，就保存步骤；需要访问外部软件，还得有对应工具和授权，Skill 本身不会凭空提供连接。

需要外部能力，再接插件

先看手头任务缺什么。要读另一个系统的数据，接那个系统；要生成特殊格式，补对应能力。不要为了“进阶”，把所有能找到的插件都装上。

插件可能包含 Skill，也可能连接外部工具。找到以后先看它要哪些权限，再拿一件小任务验证。安装成功、授权成功、实际拿到结果，是三次不同的确认。

这段能帮你把范围讲清楚： “这次任务需要：[填写一个明确能力]。先检查现有工具是否已经能完成，不重复安装。如果确实缺能力，查官方文档或可信项目说明，推荐一个必要插件。说明它提供什么、需要什么授权、是否收费。先别安装，也别读取我其他应用的数据；等我确认再接入。”

第一次练习里的本地待办工具不用接插件。只有当你想把它扩展到某个真实系统，才处理那一侧的数据来源和授权。官方 插件说明 可以用来核对能力来源。

最后，把重复工作排上日程

待办周报已经手动做对，才适合排成每周任务。定时执行会重复你的要求，要求里有歧义，也会重复出错；先把数据路径、输出位置和失败处理说清楚。

在已有任务里提出排期要求，可以沿用当前上下文。下面只是创建定时任务的提示词，复制时把路径换成自己的：

“请在这个任务里创建每周五 17:00 执行的定时任务，时区为我的本地时区。使用 todo-weekly-report，读取 [待办 CSV 的实际路径]。输出到 [周报文件夹]，文件名包含运行日期，不覆盖旧报告。输入缺失或字段不匹配时停止生成，告诉我具体缺什么。不发送邮件、不改任务状态、不连接其他应用。创建后给我确认执行时间与来源路径，并说明在哪里暂停或修改。正式排期前先按同样要求手动运行一次，让我验收。”

用桌面本地项目运行，电脑要开机、应用要运行、输入文件也要还在。网页任务不能直接读取你电脑上的文件夹，别把两种运行环境混成一种。条件见 官方定时任务文档。

第一轮生成后看看报告，确认读的是新表、输出到了正确位置。先验一次，再继续每周运行，比排完日程就完全不看靠谱。

今天从练习文件夹开始，做出小工具，亲手点一遍。用顺了就保存项目规则；等一件事能重复做好，再把它变成 Skill 和定时任务。

还有一份大礼包送给你👇

从提示词、AI 绘画、AI 视频，到 Agent、AI 赚钱、AI 学习路线，一共 17 大板块、90+ 篇资料，关注我的公众号后即可领取。