Codex 入门到进阶教程

101 阅读21分钟

none

先理解:Codex 适合用来做什么

Codex 可以理解为安装在电脑里的 AI Agent。它不只是给建议,还可以在获得权限后读写本地文件、连接 Gmail 和日历、生成文档和网站、操作浏览器、创建定时任务,把一部分重复工作直接做完。

如果只想聊天、问问题,用普通 Chat 就够了;如果要生成文件、整理资料、写代码、做网页、跑自动化任务,就应该放到 Codex 的 Project 里完成。

这篇教程按实际上手顺序讲:

  1. 安装与中文设置

  2. 创建 Project

  3. 编写 AGENTS.md 工作规则

  4. 设置权限

  5. 使用 Skills 和 Plugins

  6. 五个典型实战:办公、邮箱、网站、图像视频、电脑控制

  7. 进阶使用方法

  8. 本地化管理规则,方便以后跨工具迁移

none

Codex、ChatGPT 和 Claude Code 的关系

可以用一句话区分:ChatGPT 更像顾问,Codex 更像能动手的执行者。

ChatGPT 通常负责回答、分析、提出方案;Codex 则可以在电脑上直接创建文件、修改项目、调用工具,把任务落到结果上。

Codex 和 Claude Code 属于同类工具,核心思路接近:都有项目文件夹、规则文档、技能或工具调用机制。学会其中一个,再迁移到另一个会比较容易。

对比项CodexClaude Code
出品方 / 默认模型OpenAI / GPT 系列Anthropic / Claude 系列
入门订阅ChatGPT Plus,20 美元/月20 美元/月起
界面语言有中文界面目前仅英文
内置生图有 GPT Image
手机端ChatGPT App 内置 Codex 远程控制有手机版和 Remote Control
插件体系Plugins 商店一键安装主要靠 MCP / CLI 配置

实际选择时,不必纠结谁永远更强。模型能力会阶段性变化,重要的是把项目文件、规则和技能沉淀在自己电脑里,这样以后换工具也不会从零开始。

none

第一步:安装和初始设置

1. 下载 Codex

打开官网地址:

[1]chatgpt.com/zh-Hans-CN/…

页面会自动识别 Windows 或 macOS,下载后按提示安装即可。

image-IpLtbgJ57oGMdAxJSxhcLjUWnWh

2. 登录账号

新手建议直接使用 ChatGPT 账号登录。也可以填写 OpenAI API key,但如果只是入门体验,账号登录更省事。

3. 切换中文界面

进入左下角设置,在常规语言里选择自动检测或手动选择中文。界面切换后,菜单、按钮和提示都会更容易理解。

image-HY3UbgL80ow5e8xvOW0coPrSn0d

none

第二步:创建 Project

Codex 左侧主要有两个区域:Chat 和 Project。

  • Chat:适合临时问答、查资料、想思路。

  • Project:适合生成文件、整理资料、写代码、做文档、做网站。

只要任务会产生文件,就建议放进 Project。因为每个 Project 都对应电脑上的一个真实文件夹,后续生成的文档、图片、代码和记录都会集中保存在这里,不容易丢。

创建方法

  1. 点击文件图标。

  2. 选择“新建空白项目”或“使用现有文件夹”。

  3. 给项目命名。

  4. 右键项目,选择“在资源管理器中打开”,确认本地路径。

image

image

建议的项目习惯

一个项目尽量只服务一种长期工作,比如:

  • 内容创作项目

  • 工作日报项目

  • 个人网站项目

  • 视频素材项目

  • 产品原型项目

不要把所有任务都塞进一个 Project,否则文件会越来越乱,AI 也更难理解当前上下文。

none

第三步:写 AGENTS.md

AGENTS.md 是 Codex 在项目里开工前会读取的规则文件。它相当于一份工作手册,告诉 AI:你是谁、要什么风格、文件怎么放、哪些事不能做。

很多人觉得 AI 不懂自己,常见原因就是没有写这份文件。没有规则的 AI,每次都像第一次来上班。

AGENTS.md 应该写什么

建议至少包含三类信息:

  1. 身份和业务:你做什么,服务谁。

  2. 输出要求:语言、文风、格式、命名方式。

  3. 工作原则:先计划还是直接执行、是否需要汇报、能不能删除文件。

可以直接使用下面这份模板,复制到项目根目录,文件名保存为 AGENTS.md

# AGENTS.md — AI 工作手册

## 1. 我是谁
- 身份:[例:自媒体博主 / 电商运营 / 独立开发者]
- 主要业务:[例:做 AI 工具测评内容,发布在 X 和 YouTube]
- 目标受众:[例:25-40 岁、想用 AI 提效的职场人]

## 2. 输出要求
- 语言:简体中文
- 文风:直接、干脆、白话,不堆术语,不绕弯子
- 文件命名:`日期_主题_版本`,例:`0610_codex教程_v1.md`
- 所有产出文件存到本项目对应子目录,不要散落在根目录

## 3. 目录约定
- `/content` — 文章、文案成品
- `/drafts` — 草稿和半成品
- `/assets` — 图片、素材
- `/memory` — 工作记录、复盘笔记
- 发现目录结构混乱时,先整理再开工

## 4. 工作原则
1. 接到任务先列计划,确认后再执行
2. 改文件前先说明要改什么、为什么
3. 任务完成后报告:生成/修改了哪些文件,放在哪里
4. 不确定的事直接问我,不要自己猜着做
5. 同一个错误不犯第二次:我纠正过的做法,记进本文件第 6 节

## 5. 安全红线
- 永远不删除文件,只移动到 `/trash` 目录
- 不碰本项目文件夹以外的任何文件
- 涉及发布、发送邮件、花钱的操作,必须先经我确认

## 6. 我的偏好积累(持续更新)
- [例:标题不超过 20 字,必须有数字或对比]
- [例:报告先给结论,再给过程]

最重要的是第 6 节

第 6 节用于沉淀你的偏好。每次你纠正 Codex,比如“标题太夸张”“表格要放在前面”“不要用营销腔”,都可以让它把这条规则写进第 6 节。

这样下次做同类任务时,它会先读规则,再执行任务,产出会越来越贴近你的习惯。

不想手动写怎么办

可以直接在 Codex 里说:

帮我在项目里创建 AGENTS.md 文件,根据以下信息填写:我的身份是……我的输出要求是……我的工作习惯是……

让它先生成,再由你检查修改。

none

第四步:设置权限

Codex 的权限决定它能替你做多少事,也决定风险大小。对话框附近可以找到权限设置,常见有三个档位。

  • 请求批准:每次联网、执行命令或敏感操作都需要确认。最安全,但流程较慢。

  • 替我审批:简单操作自动执行,风险较高的操作再询问。新手更适合这一档。

  • 完全访问权限:效率最高,但风险也最高,可能影响项目文件夹之外的内容。

image-ILdGbrYHLoaX36xh57LcQOmGnxf

权限使用建议

新项目、新工具、新插件,先用“请求批准”或“替我审批”。

等你确认它的工作方式稳定,再考虑提高权限。涉及删除、覆盖、发送、发布、付款的动作,一定要让它先说明计划,并由你确认。

none

第五步:理解 Skills 和 Plugins

Codex 里有两个重要工具概念:Skills 和 Plugins。

可以记住一句话:

Skill 规定“怎么做”,Plugin 决定“能连接什么”。

Skill:标准作业流程

Skill 本质上是一套写成文档的流程。你可以把固定步骤、格式要求、注意事项写进去,之后每次调用它,Codex 就按这套流程执行。

适合沉淀成 Skill 的任务包括:

  • 小红书文案生成

  • 周报整理

  • 视频脚本撰写

  • 图片风格生成

  • 邮件回复模板

  • 产品需求文档

创建 Skill 时,可以这样说:

用 Skill Creator 帮我建一个 Skill:生成小红书文案,要求口语化、每篇不超过 150 字、结尾必须有行动号召。

调用方式有两种:

  • 输入 / 后选择 Skill 名称。

  • 用自然语言说明“调用 XX Skill 帮我……”。

Plugin:连接外部工具

Plugin 更像外部软件的通行证。安装后,Codex 可以连接 Gmail、Google Calendar、Canva、Vercel 等服务,并获得对应能力。

安装流程通常是:

  1. 打开 Plugins。

  2. 搜索插件。

  3. 点击安装。

  4. 如果需要外部账号,按提示登录并授权。

  5. 回到项目中调用。

常用插件可以按用途选择:

类别插件用途
办公Document / Spreadsheet / Presentation生成和编辑 Word、Excel、PPT
谷歌工具Gmail / Google Calendar / Google Drive处理邮件、日程、云盘文件
设计Canva / Figma继续编辑图片和设计稿
开发部署Vercel / GitHub / build iOS Apps网站上线、代码托管、开发 App
浏览器与电脑Browser Use / Computer Use操作浏览器或电脑界面
视频Hyperframe生成宣传视频
综合工作流Superpowers规划、测试、产出相关流程

不建议一次装太多插件。先安装高频使用的工具,其他用到再装。插件太多会增加 AI 读取信息的负担。

调用插件时,可以在对话里输入 @,选择指定插件。例如:

@document 帮我把这份分析整理成 Word 文档。

none

实战一:用 Codex 生成办公报告

适合场景:每天、每周都要做类似报告,内容结构固定,但资料需要更新。

image

image

操作步骤

1. 安装办公插件

在 Plugins 中搜索并安装:

  • Document

  • Spreadsheet

  • Presentation

分别对应 Word、Excel、PPT 的生成和编辑。

2. 在项目里新开对话

选择对应 Project,点击 Start a new chat,然后输入任务:

分析今天 AI 股票的情况,用 @document 总结成 Word 文档,并用 /imagegen 生成一张总结图放在文档最上方。

这里有两个调用动作:

  • @document:指定用文档插件输出 Word。

  • /imagegen:指定用图片生成技能生成配图。

比起让 AI 自己判断工具,点名调用更稳定。

3. 检查文档并提出修改

文档生成后,打开预览检查:

  • 表格是否清楚

  • 结论是否放在合适位置

  • 图片是否适合放在顶部

  • 文件是否保存在项目目录中

如果不满意,可以直接在预览界面下方提出修改,例如:

把表格放到结论前面,并把最后一段改得更简洁。

4. 扩展为 Excel 和 PPT

在同一对话里继续说:

再用 @spreadsheet 生成一份数据表格,用 @presentation 做一份汇报 PPT。

这样可以围绕同一主题生成文档、表格和演示稿。

5. 设置定时任务

如果这个报告每天都要做,可以继续说:

以后每天早上 8 点,自动搜索当天 AI 股票信息,生成 Word、PPT 和 Excel 报告,存到本项目。

创建后,可以进入自动化界面检查:

  • 状态是否 active

  • 执行时间是否正确

  • 任务说明是否准确

  • 输出位置是否在项目文件夹

常用操作包括:

  • Run now:立即运行一次,验证效果。

  • Edit Automation:修改时间、任务说明、模型或推理强度。

  • 暂停或删除:通过任务旁的更多按钮完成。

none

实战二:用 Codex 管理 Gmail

邮箱适合交给 AI 处理,因为很多任务重复、规则明确,比如筛选邀约、起草回复、整理待办。

1. 安装并授权 Gmail 插件

在 Plugins 中搜索 Gmail,点击安装。按提示登录谷歌账号并授权。

安装完成后,可以到 Skills 页面查看,读邮件、发邮件等相关能力会随插件一起出现。

2. 让 Codex 整理邮件

可以从一个简单任务开始:

最近 7 天我的 Gmail 收到哪些广告合作邀约?整理成列表。

比较好的输出应该包含:

  • 发件人

  • 邮件日期

  • 合作内容

  • 需要回复的问题

  • 原始邮件链接

3. 继续细化处理

拿到列表后,可以继续让它做:

  • “第 2 条感兴趣,帮我起草一封礼貌的回复,问清楚预算和档期。”

  • “把所有没回的合作邀约标记出来,按报价从高到低排。”

  • “每周一早上 9 点,汇总上周所有合作邀约发给我。”

同样的方式也适用于 Google Calendar 和 Google Drive。常用哪个工具,就优先安装哪个插件。

none

实战三:制作并发布个人网站

不会写代码,也可以让 Codex 生成一个基础网站。推荐按四步走:生成、预览、迭代、部署。

1. 写清楚网站需求

提示词不要只写“帮我做一个个人网站”,最好包含身份、内容、链接和风格。

可以这样写:

帮我做一个极简但好看的个人品牌网站,让访客打开就知道我是谁、做什么、在哪关注我。我的信息:名字 XX;YouTube / X / 小红书链接是 XX;代表作品是 XX;在卖的产品是 XX。设计风格:高端科技感的创作者主页,参考 Apple 和 Linear 的极简风。

第一版不必追求完美,先让它做出来,再根据页面实际效果修改。

2. 本地预览和修改

Codex 通常会在本地启动网站,并给出一个本地访问地址。打开后检查:

  • 首屏是否清楚

  • 个人介绍是否直观

  • 链接是否可点击

  • 作品和产品是否展示完整

  • 移动端排版是否正常

修改时直接描述问题,例如:

首屏太空了,增加一句更明确的介绍,并把社交链接放到按钮里。

3. 部署到 Vercel

如果要公开访问,可以使用 Vercel 插件。

步骤:

  1. 在 Plugins 中搜索并安装 Vercel。

  2. 登录并授权。

  3. 回到对话,告诉 Codex:

帮我把这个网站部署到 Vercel。

完成后会得到一个公开网址。

4. 绑定自己的域名

如果不想使用默认的 Vercel 后缀地址,可以购买自己的域名,再让 Codex 协助绑定:

把我的网站绑定到这个域名:XXX。

涉及域名、发布和线上配置时,建议让 Codex 先列出操作计划,你确认后再执行。

none

实战四:生图和做视频

生图:用 imagegen 生成配图

Codex 内置 imagegen 技能。调用方式是在对话中输入 /imagegen,再补充图片需求。

适合用于:

  • 社交媒体封面图

  • 品牌配图

  • 文章头图

  • 带标题的宣传图

如果想让图片风格稳定,可以在项目里增加一份 Design.md,写明:

  • 主色

  • 字体感觉

  • 版式偏好

  • 禁用风格

  • 示例描述

然后在 AGENTS.md 中补充:

做图前先阅读 Design.md,并尽量保持统一视觉风格。

也可以把固定尺寸、排版和文案位置沉淀成一个 Skill,比如“小红书配图 Skill”。

和 Canva 联动

安装 Canva 插件并授权后,可以说:

把刚才生成的图导入 Canva,方便我继续编辑。

这样后续可以在 Canva 里继续调整字体、颜色和元素。

做视频:使用 Hyperframe

安装 Hyperframe 插件后,可以让它根据素材生成宣传视频。比如:

用 Hyperframe 帮我做一个个人宣传视频,这是我的社交媒体和产品链接,你可以去这些网站抓素材、截屏、录屏。

第一版出来后,不要急着重做,按片段提出修改:

  • 开头节奏太慢

  • 字幕太多

  • 产品部分停留时间加长

  • 结尾增加行动号召

接入 AI 视频生成工具

如果某些视频生成平台提供 CLI,Codex 可以协助接入。可以这样下任务:

帮我接入即梦的 CLI,并告诉我如何授权和使用。

它可以下载安装、阅读文档,并把使用方式整理成项目里的 Skill。

注意预算和积分

视频生成经常按积分计费。给 Codex 派这类任务时,一定要限制数量,例如:

只生成 3 个片段,生成前先列出每个片段的内容,等我确认后再开始。

否则它可能一次性发起多个生成任务,造成不必要的消耗。

none

实战五:让 Codex 操作浏览器和电脑

Computer Use 可以让 Codex 看屏幕、移动鼠标、点击和输入。Browser Use 则更适合浏览器内操作。

适合交给它的任务包括:

  • 填写固定格式表单

  • 批量下载网页文件

  • 按步骤完成网页后台操作

  • 浏览器里重复点击和提交

使用前的优先级

让 AI 操作电脑不是第一选择。更推荐的优先级是:

  1. 有插件就用插件。

  2. 有 API 就用 API。

  3. 有 CLI 就用 CLI。

  4. 能用浏览器控制就不用全屏控制。

  5. 所有方式都没有,再用 Computer Use。

原因很简单:屏幕控制通常更慢、更耗额度,也更容易受页面变化影响。

使用时的安全要求

给它操作电脑前,最好明确三条:

  • 不允许删除文件。

  • 不允许付款或购买。

  • 提交表单、发送消息、发布内容前必须确认。

如果任务涉及账号后台、隐私信息或重要文件,建议全程盯着看。

none

手机远程控制 Codex

Codex 可以通过 ChatGPT App 远程查看电脑端任务。

绑定步骤

  1. 在电脑端 Codex 左下角点击手机图标。

  2. 弹出二维码。

  3. 打开手机 ChatGPT App,进入 Codex 入口扫码。

  4. 绑定完成后,在手机上查看对话和任务进度。

适合的工作流

例如:

  1. 出门前在电脑上派几个任务。

  2. 路上用手机查看进度。

  3. 发现方向不对,及时补充要求。

  4. 回到电脑前收结果。

如果要绑定多台设备,可以在“管理连线”里处理。涉及他人电脑时,应先获得对方同意。

none

进阶方法一:派任务要交代背景和目的

不要只说“帮我整理文件夹”。这类指令太空,AI 会猜你的用途。

更好的说法是:

帮我整理这个文件夹里的照片和视频,之后我要请剪辑师剪成一支旅行短片。请按时间线、场景和封面候选分类,原始文件不要移动,只复制到整理后的目录。

一个好任务通常包含四个要素:

  1. 做什么

  2. 你是谁或当前场景是什么

  3. 做完要拿去干什么

  4. 什么样算合格

公式可以记成:

任务 + 背景 + 用途 + 验收标准

none

进阶方法二:给文件绝对路径

如果要处理具体文件,不要让 Codex 在电脑里猜。最好直接给它准确位置。

常用方法:

  1. 把文件或文件夹拖进对话框。

  2. 复制完整路径后粘贴。

  3. 从预览界面复制已生成文件的路径。

Windows 可以按住 Shift 右键文件,选择复制文件地址。Mac 可以选中文件后按 Option + Command + C 复制路径。

路径越准确,任务越快,误操作概率越低。

none

进阶方法三:管理上下文

AI 聊久了变得跑偏,常见原因是上下文快满了。上下文相当于当前对话的工作记忆,容量有限。

建议养成三个习惯。

1. 看上下文使用量

对话框附近的小圆环会显示当前对话已经用了多少上下文。左下角设置里还可以查看剩余用量。

一个看当前对话,一个看整体额度,两者都要关注。

2. 80% 左右手动压缩

当上下文接近 80% 时,可以输入 /,选择“精简上下文”。

不要等系统强制压缩,因为强制压缩可能发生在任务执行中间,重要细节更容易丢。

3. 规划和执行分开

大项目建议分成两个对话:

  1. 第一个对话只讨论方案,最后让 Codex 输出方案文件。

  2. 第二个新对话只负责执行,把方案文件路径丢进去,让它照做。

这样执行时上下文更干净,出错概率更低。

模型和推理强度

对话框右下角可以切换模型和推理强度。日常任务通常 high 就够用。更高强度可能更聪明,但会更慢,也更消耗额度。

none

进阶方法四:并行、引导和派生

Codex 不需要一个任务做完再做下一个。合理调度能节省很多时间。

并行

在同一个 Project 中,可以开多个对话同时执行不同任务。它们不共享对话上下文,但都可以访问项目文件夹。

适合并行的任务:

  • 一个对话写文档

  • 一个对话做 PPT

  • 一个对话整理素材

  • 一个对话生成图片

引导插队

任务执行到一半,如果你突然想补充要求,普通发送可能会排到队尾。此时应使用“引导”按钮,让新要求插入当前任务。

image-B39vb0q6xog2gHxVI52cVRZrnlf

派生

派生会复制一个带完整历史的新对话。派生前的上下文一致,派生后可以分别尝试不同方案。

适合用于:

  • 同一网站做两个视觉版本

  • 同一篇文章做两个风格版本

  • 同一套方案做保守版和激进版

none

进阶方法五:把成功流程沉淀成 Skill

Codex 不会因为你每次临时聊天就自动变懂你。真正让它越来越顺手的方法,是把成功流程写进 Skill。

可以按三步走:

  1. 先让它完成任务。

  2. 对第一版结果提出修改意见。

  3. 满意后,让它把这些意见整理成 Skill。

可以这样说:

把我以上提出的所有修改意见收敛成一个 Skill,命名为“我的视频风格”,下次做同类任务直接照这个执行。

这样下次再做同类任务,它会先读取 Skill,而不是重新猜你的偏好。

这套方法可以概括为:

个人化 → 系统化 → 自动化

先把通用流程改成自己的,再固化成 Skill,最后配合定时任务自动运行。

安装别人分享的 Skill 前先评估

看到网上的 Skill,不建议直接安装。可以先把链接发给 Codex:

这个 Skill 适合我当前项目吗?会不会和现有规则重复?请先评估,再决定是否安装。

如果你的项目规则已经很完善,很多通用 Skill 反而会增加读取负担。

none

把规则养在本地,方便以后迁移

不要把全部记忆只放在某个平台内部。更稳妥的做法,是把规则、偏好、Skill、工作记录都放在项目文件夹里。

这样无论以后继续用 Codex,还是换到 Claude Code 或其他工具,都可以让新工具读取同一个项目文件夹,不必从零开始。

none

用 SSOT 管理多工具规则

不同工具读取的规则文件名不同:

  • Codex 读取 AGENTS.md

  • Claude Code 读取 CLAUDE.md

  • Gemini 可能读取 GEMINI.md

如果每个文件都单独维护,时间久了很容易不一致。解决方法是使用 SSOT,也就是 Single Source of Truth,单一事实来源。

核心思路:只维护一份真正的规则文件,其他文件都指向它。

第一步:创建核心规则文件

在项目根目录新建:

CORE_RULES.md

把原来 AGENTS.md 里的内容放进去。以后只修改这一份。

第二步:移除旧规则文件

确认内容已经搬到 CORE_RULES.md 后,删除原来的:

AGENTS.md
CLAUDE.md

第三步:创建符号链接

最省事的方法,是直接让 Codex 做:

把我项目里的 AGENTS.md 和 CLAUDE.md 做成指向 CORE_RULES.md 的符号链接(symlink),做完后验证:打开 AGENTS.md 应该能看到 CORE_RULES.md 的内容。

如果要手动操作,可以打开终端进入项目文件夹。

Windows PowerShell:

New-Item -ItemType SymbolicLink -Path AGENTS.md -Target CORE_RULES.md
New-Item -ItemType SymbolicLink -Path CLAUDE.md -Target CORE_RULES.md

Mac / Linux:

ln -s CORE_RULES.md AGENTS.md
ln -s CORE_RULES.md CLAUDE.md

验收方法:

  1. 打开 AGENTS.md,内容应和 CORE_RULES.md 一样。

  2. CORE_RULES.md 里新增一行规则并保存。

  3. 再打开 AGENTS.md,确认新增内容同步出现。

注意:这里需要的是符号链接,不是 Windows 右键菜单里的“创建快捷方式”。快捷方式生成的是 .lnk 文件,AI 不一定能正确读取。

none

最后先做三件事

不用一次把所有功能都学完。先完成这三步,就能真正开始用起来:

  1. 安装 Codex,登录账号,切换中文,创建第一个 Project。

  2. 在项目根目录写好 AGENTS.md,至少包含身份、输出要求和安全红线。

  3. 选择一个每周重复做的任务,把流程沉淀成第一个 Skill。

后续再逐步增加插件、定时任务和自动化流程。Codex 的价值不在于一次性会多少功能,而在于把重复工作持续沉淀下来。

引用链接

[1]undefined: chatgpt.com/zh-Hans-CN/…

[2]chatgpt.com/zh-Hans-CN/…