本文由 莫潇羽@无忆研习社（www.wuyi.wiki）撰写，转载请注明出处。

快速摘要

如果你正打算把 OpenAI Codex 桌面版当成日常生产工具用起来，只需要记住四层认知就够了：第一，Codex 已经不是当年那个"写代码模型"，而是一个可以读文件、跑命令、控制浏览器、调度自己的 AI 智能体指挥中心；第二，用好它的关键不在"提示词写得多花哨"，而在"目标、上下文、约束、完成条件"这四件套是否齐全，加上"计划模式先规划再动手"；第三，它真正的能力扩展靠三件事——插件（Plugins）负责连外部世界、技能（Skills）负责沉淀重复工作、自动化（Automations）负责让它在后台按时干活；第四，中国大陆用户使用境外模型服务，需要遵守国内网络与内容管理相关规定，涉及 AI 生成的图、视频、语音发布到公开平台，也要按平台要求做好标注和版权确认。 想看完整拆解，往下翻。

一、Codex 是什么：从"写代码模型"到 AI 智能体指挥中心

第一次打开 Codex 桌面端，界面简洁到有点让人怀疑：左边一列窄窄的功能栏，中间就是个对话框。很多人第一反应是——"这不就是又一个 ChatGPT 客户端吗？"

如果就这么用，它九成能力都被浪费了。

从 2025 年 4 月 Codex 正式亮相，到 2026 年 2 月 OpenAI 把它从 CLI 命令行工具正式包装成 macOS 桌面应用，再到 5 月 29 日 Windows 端补齐"电脑操控"能力，Codex 完成了一次身份转变。它不再是"给一段需求返回一段代码"的补全工具，而是一个"你分配任务、它自己拆解、自己调工具、自己动手、自己复盘"的智能体（Agent）。莫潇羽@无忆研习社在实际使用中体会最深的一点是：要用好它，你得先在心里把它从"聊天模型"翻页到"AI 员工"这一栏。

1.1 它跟豆包、通用聊天类 AI 的最大区别

用一张对照就能说清：

一句话：通用聊天类 AI 是"你叫它、它回答"，Codex 是"你派活、它交付"。前者的产品形态里，你还是那个动手的人；后者的产品形态里，你更像是一个团队负责人，Codex 是那个能同时开着好几个窗口、后台悄悄干活的员工。

1.2 Codex 目前的核心能力可以覆盖到哪几类工作

不要以为它只服务程序员，这是最容易被误导的点。莫潇羽平时观察到，真正把 Codex 用得溜的人里，有做视觉设计的、有做电商运营的、有做产品经理的、也有做知识管理的。它能覆盖的工作大概可以归成七类：

• 重复性素材整理：批量改图片尺寸、批量整理文件夹、批量给素材命名。
• 信息采集与结构化：读取网页公开信息、抓取表格、整理成结构化数据。这里要多说两句合规底线——公开信息采集必须遵守目标网站的 robots.txt 协议、用户服务条款以及国内相关法律法规（如《数据安全法》《个人信息保护法》《网络安全法》等）；不要绕过反爬机制、验证码、登录墙；不要采集个人隐私信息、身份识别信息、账号密码信息；不要采集受版权保护的商业内容用于二次分发；平台明确禁止爬虫的（如小红书、抖音等大部分内容平台），一律避开。合规是长期做事的前提。
• 知识库与笔记管理：把资料丢到一个项目文件夹里，Codex 就能扮演"个人知识助理"，帮你整理、检索、生成周报。
• 重复工作流打包：把每次都要做的动作沉淀成 Skill，做一次、用一辈子。
• 本地软件联动：通过 CLI（命令行接口）和 MCP（模型上下文协议）连接本地软件和外部服务，形成一条自动化流。
• 文档与代码生产：写报告、写脚本、改代码、做代码审查。
• 产品原型开发：小程序、网页、桌面小工具，只要不涉及重资产的 3D 建模和视频后期，很多轻量原型 Codex 一晚上就能落地一个可跑的版本。

真正的转折点在思维层面：以前你打开电脑，第一反应是"我要用 PS 干什么、我要用 Excel 干什么"；现在换成"我要让 Codex 帮我干什么，它可以调用哪些工具去完成"。生产工具变了，生产方式就得跟着变。

二、安装与登录：桌面版路径与账号方式的合规选择

安装环节看似简单，其实是最多人在这里卡住的地方。莫潇羽@无忆研习社在群里被反复问最多的几个问题基本都集中在"下载不了""登录报错""不知道用哪种账号"这三块，这一章把这些坑一次踩完。

2.1 桌面版当前的安装路径概览

先给一张目前的桌面版时间线：

这里要重点提醒一下 2026 年 7 月 10 日的这次整合——OpenAI 官方公告宣布，原来独立的 Codex 桌面应用会升级为全新的 ChatGPT 桌面应用，把 Chat（聊天）、ChatGPT Work（工作）、Codex（编程与智能体）三大能力整合到同一个客户端里。原有 Codex App 用户可以直接更新，历史任务和项目会保留下来，也可以在设置里把应用图标切回 Codex 图标。旧的独立 ChatGPT 桌面版会以 "ChatGPT Classic" 的身份继续存在一段时间，但新的智能体能力大概率只在新的整合版里更新。

所以本文说的"Codex 桌面版"，从 2026 年 7 月起，读者实际下载到的多半是新版 ChatGPT 桌面应用里的 Codex 模块。界面入口会比早期独立版多一层（先进入应用，再切换到 Codex 标签页），但核心的对话、项目、插件、Skills、自动化能力是一致的，本文讲的方法论完全通用。

Windows 端的独立 Codex 桌面版是在 Mac 之后补齐的，2026 年 5 月 29 日那次更新（Codex App 26.527 版本）才把"电脑操控（computer use）"能力正式带上 Windows。如果你安装的是更早的独立版本，插件里可能还没有"电脑操控"这个选项——这时候不要死磕，直接卸载重装到最新版（或者升级到整合版 ChatGPT 桌面应用）就好。

2.2 从官网正常安装的两条路

先说主路线。打开 Codex 官方页面，点击下载，Windows 用户实际上会跳到微软商店（Microsoft Store），拉起本地的商店应用下载安装包。这条路对绝大多数人是通的，唯一容易翻车的场景是：微软商店本身打不开或者被本地策略限制。这时候不要在原路上反复重试，换第二条路：

通过 rg-adguard 提取安装包。这是一个开源的第三方页面，可以直接把微软商店里的 msix 安装包链接提取出来。操作路径大致是这样的：

• 打开 rg-adguard 的搜索页面。
• 在搜索框粘贴 Codex 在微软商店里的产品链接。
• 页面会列出全部关联文件，找到后缀为 .msix 的那个，右键复制链接下载。
• 下载完毕，双击安装包按照系统提示走完流程即可。

如果之前电脑上已经装过一版，系统会弹出对话框问你要不要"重新安装"或"启动现有版本"。想升级的直接选"重新安装"覆盖旧版即可。这里要额外提一句：Codex 更新迭代非常快（近半年几乎每周都有小更新），当你发现某个选项本文里提到但你界面上找不到，第一步不是怀疑教程写错，而是先检查一下版本号，卸载重装到最新版通常就解决了。

2.3 登录方式：ChatGPT 账号与 API 两条路怎么选

Codex 支持两种登录方式：

• ChatGPT 账号登录（推荐）
• API Key 登录

莫潇羽的建议非常明确：能用 ChatGPT 账号就用 ChatGPT 账号。原因有三：

• 官方账号可以享受完整的会员额度（Plus 或者 Pro 的月度包），Codex 桌面版目前对 Plus/Pro 用户有比较宽松的每 5 小时消息数上限；
• 官方账号能第一时间体验最新模型（比如后续要上线的 Codex Max、GPT-5.3 等），而中转 API 通常慢一个身位；
• 从模型质量上讲，官方账号跑的一定是官方原生模型；一些第三方 API 中转站存在"用国产模型冒充 GPT 系列"的模型混淆风险，同时也存在被临时下线、数据链路不透明等隐患。

API 登录的角色更像"备胎"：当你的 ChatGPT 额度暂时打满、又不想等重置，可以临时切到 API 登录，把手头的项目跑完。API 登录还有一个隐形福利——它不强依赖某些境外网络前置条件，对某些跑不了官方登录的场景是补丁。但如果你追求稳定和第一手能力，主账号还是走 ChatGPT。

2.4 使用境外模型服务的合规提示（重要）

这一段单独拎出来说，因为它不是可有可无的免责声明，而是每一个在国内使用 Codex 的人都必须清楚的边界：

• 境外模型服务（包括 OpenAI 的 ChatGPT、Codex、Claude、Gemini 等）在中国大陆使用需遵守国内网络管理相关规定。你的账号、支付方式、访问链路都应确保符合当地法律法规，不建议采用任何绕过网络管理措施的方式访问境外服务。
• AI 生成内容的发布合规：无论你用 Codex 生成的是代码、文档，还是通过 CLI 调用外部模型生成的图片、视频、语音克隆内容，只要发布到国内公开的自媒体平台（视频号、抖音、小红书、B 站、公众号等），都需要按平台要求做AI 生成内容标注。这是 2023 年以来国家网信办《生成式人工智能服务管理暂行办法》的明确要求，也是各平台社区规则里明确写清楚的红线。
• 商用素材授权：Codex 帮你搜到的字体、图片、音频、视频，如果是要用于商业场景，必须自行核实版权、取得正版授权。AI 帮你找到不等于免费可商用。
• 数据与隐私：让 Codex 帮你处理本地文件时，尽量把银行卡号、密码、身份证信息、公司机密文档从工作目录里剔除。Codex 的电脑操控权限一旦开到"完全访问"，等于是把你电脑的钥匙交给了它，虽然它不会主动"偷"东西，但被恶意提示词攻击的可能性存在，谨慎为上。

一句话总结这一章：装的时候按路径走，登的时候用官方账号，合规意识提前建立。 后面所有的进阶玩法，都是在这三条基础上叠加的。

三、主界面全景：新对话、搜索、插件、自动化、项目、对话、设置七块地

Codex 桌面版的主界面是任务入口，左侧的窄边栏其实是一个 UI 上极简、功能上分工非常清楚的功能选择器。很多人用了半年只用到了"新对话"这一块，其他六块地都荒着。这一章把这七块地一次说清楚，你就明白 Codex 到底给了你哪些抓手。

3.1 七个功能入口一览

3.2 新对话与"上下文"这件事

新手最容易踩的坑之一，是把所有任务都塞进同一个对话窗口。前一秒还在让 Codex 帮你找参考图，下一秒突然让它做一个网页——这时候你会发现，它做出来的网页里居然穿插着上一轮参考图的元素。

原因在于上下文（Context）。上下文是 AI 模型能"看见"的对话历史，它天然会把你之前说过的话作为背景理解你新说的话。这在同一件事的连续追问里是好事，在两件不相干的任务里就是灾难。

• 新对话 = 开一个空房间，跟之前所有事情断开。
• 同一个对话里继续问 = 你带着之前一整摞资料继续和它聊。

所以有个简单的判断标准：只要新任务和上一件事没有直接关系，就用左侧栏的"新对话"起一个新的窗口。这不只是为了避免任务串味，还能省不少上下文 Token（模型每次处理的字数是有上限的，堆得太多它会自动压缩历史信息，压缩多了细节就丢了）。

3.3 搜索：历史对话的"全局 Ctrl+F"

用 Codex 用得深了以后，你的对话列表会像微信聊天列表一样长——这时候就得靠搜索。

搜索的支持范围包括：

• 历史对话的标题与内容
• 项目名称
• 收藏的置顶条目

用法很朴素：点搜索图标，输入一两个关键词，它会把近期匹配的对话列出来。莫潇羽自己有一个使用习惯是——给每一个稍微重要点的对话手动改一个短标题，比如"公司官网首页排版方案 v3""三农电商详情页组件化探索"。Codex 默认会给对话一个模糊的自动标题，改成有识别度的短标题以后，未来搜索就快很多。

3.4 项目与对话的关系：一个是文件夹、一个是"临时对话"

这里有个概念上的差别是很多人一直分不清的：

• 项目（Project）：绑定了一个本地文件夹，Codex 可以直接读取该文件夹里的所有文件，作为任务上下文。适合放需要反复访问的项目（网站、产品线、个人知识库、素材库）。
• 对话（Conversation）：不绑定任何文件夹的"临时对话"，适合一次性、随机的小任务。

一个项目下面可以挂多个对话，每个对话都能读取项目文件夹的内容，同时彼此之间的上下文互相独立。这一点非常好用——你可以在同一个"公司官网"项目里，开一个对话专门做首页，开另一个对话专门做详情页，它们看到的是同一份文件，但不会互相污染。

创建项目的路径是：项目 → 添加新项目 → 选择现有文件夹。选完之后，Codex 会自动扫描这个文件夹的目录结构。

3.5 置顶：把常用项目和对话拎到顶上

对话和项目多了以后，找起来会累。Codex 的解决方案很朴素——右键任何一条对话或项目，选择"置顶"，它就会被固定在列表最上方。莫潇羽的置顶策略大概是：

• 个人知识库（放各种备忘、账号笔记、想法清单）
• 主力项目（当前月正在推进的那一两个）
• 写作模板项目（放各种 Prompt 模板、Skill 模板）

其他一次性对话不置顶，跟着时间流走。这样每次打开 Codex，视线一瞄就知道要干什么。

3.6 排序方式：按项目还是按时间

对话列表的排序有两种模式：按项目分组 和 按时间倒序。

按项目分组是默认模式，直观、有归属感；按时间倒序适合你手上同时推着好几个项目，想快速看到"最近碰过的对话"是什么。可以在设置或者列表顶部切换。莫潇羽偏好按项目分组，视觉上更清爽。

四、账户与额度：五小时和月度双限额到底怎么用

Codex 桌面版的账户菜单看起来简单，但里面藏了一个不看清楚就容易翻车的机制——双限额。

4.1 账户菜单五要素

点开右上角的账户菜单，会看到五块信息：

• 当前账号：显示登录的 ChatGPT 账号
• 个人账户入口：跳到网页端的账户配置
• 5 小时额度：短周期使用额度
• 月度额度：本月度整体额度
• 退出登录：切换账号或者在公共设备上保护账号

前两个和第五个不用多讲，重点在中间两个。

4.2 为什么是"5 小时 + 月度"双保险

第一次看到"5 小时额度"这个提法很多人是懵的——为什么不是每天、每周？

这个设计其实是为了防止单次跑失控。想象一个场景：你启动了一个大型任务，Codex 用高档模型狂读你的仓库、狂调工具，几百万 Token 一小时内烧完，一个月的额度直接一晚上打光。有了 5 小时窗口这层保险后，最多单次窗口耗光的是 5 小时窗口那部分，月度剩余的额度是安全的，等这个 5 小时窗口过后额度自动重置，你还能接着干活。

用法上的建议：

• 早上先"消耗"一发：每天开工第一件事，随便发个消息把 5 小时窗口启动起来（比如让它整理一下昨天的项目变更），这样这条 5 小时时钟就开始跑了，别拖到中午才启动，否则窗口结束时间可能正好卡在你晚上想干活的时间点。
• 看到 5 小时窗口快满，先停下来喘口气：等窗口自动重置就好，不要连续硬撑。
• 月度重置日期看清楚：账户菜单会显示"月度额度将于 X 月 X 日重置"，这个日期以你订阅的开通日为准，不一定是自然月的 1 号。

4.3 模型档位与降档：额度用完不等于没法用

⚠️ 时效提示：OpenAI 模型迭代非常快，本节数据以 2026 年 8 月写稿时的状态为准。GPT-5.2 与 GPT-5.3-Codex 已于 2026 年 6 月 2 日在 ChatGPT 登录的 Codex 中弃用；GPT-5.4 与 GPT-5.4-mini 官方公告将于 2026 年 8 月 31 日退役，替换建议为 gpt-5.6-terra 与 gpt-5.6-luna。请务必以 OpenAI 官方文档的实时数据为准。

截至 2026 年 8 月，用 ChatGPT 登录 Codex 时可选的主力模型大致包括 GPT-5.5 和新推出的 GPT-5.6 系列（Sol / Terra / Luna 三档）：Sol 定位面向复杂长任务的旗舰档、Terra 定位主力工作档、Luna 定位轻量快速档。日常任务用 5.5 或 5.6-Terra 就足够，涉及深度架构或复杂重构再切 5.6-Sol。

这里有一个隐藏福利：主力模型的额度用完后，次一档模型的额度是分开计算的。也就是说，你可以在紧张的时刻切到低一档的模型继续干活，速度和智能会掉一点，但基本任务依然能完成。

一个月里有一次额度重置的机会（写稿时的规则，请以官方定价页面的实时数据为准），可以主动触发一次重置。这个机会莫潇羽建议留到关键节点用——比如项目上线前那一两天，其他时间就按节奏走。

如果你的定时任务、自定义智能体、保存好的配置里还引用了老模型（比如 gpt-5.4、gpt-5.3-codex），建议提前迁移到 5.5 或 5.6 系列，避免退役日期一到任务失效。

4.4 API 登录的额度是另一套账本

如果你还额外配了 API 登录，那 API 的费用是走 Token 计价、按量扣费，跟 ChatGPT 订阅额度是分开的两套账。这就是为什么前面说"ChatGPT 额度打满时可以临时切到 API"——两套额度互不相通，可以做互备。

但 API 登录有个隐性代价：部分插件在 API 登录模式下会失效（因为插件的授权链路是走 ChatGPT 网页端登录的）。所以 API 更适合"跑纯代码任务、纯文本对话"，不适合"依赖浏览器插件、Figma 插件的复杂工作流"。

五、设置中心 15 项关键配置一次讲清

设置中心是 Codex 里"入口小、影响大"的地方。这一章莫潇羽把 15 个一级设置入口全部串一遍，重点标注哪些是首次安装必调、哪些是日常运行必看、哪些是高阶玩家专属。

5.1 15 项设置入口全景表

下面挑几个最容易踩坑的重点展开。

5.2 首次安装必调：常规、外观、语言

Codex 默认是英文，第一次打开先做三件事：

• 在"常规"里把语言切换成中文（切完记得手动重启一次 Codex，否则不生效）
• 在"外观"里选深色主题、把字体调大一号（长时间盯屏幕，深色对眼睛更友好）
• 在"常规"里把工作模式切换成"日常工作"或"编程"两种模式之一

这里的"工作模式"是 Codex 用来判断你主要用途的一个开关，选"编程"意味着它会在权限、工具选择、默认行为上更向开发场景倾斜；选"日常工作"则更偏向办公与创作。莫潇羽个人建议做设计、做运营、做产品的朋友选"日常工作"，做代码的朋友选"编程"。

5.3 权限相关：默认权限、自动审查、完全访问权限

这是设置中心里最重要的三个开关，藏在"常规"和"电脑操控"里。

莫潇羽个人的做法是分层管理：写代码、跑本地项目的时候，开自动审查减少反复弹窗；控制浏览器、操控整台电脑的时候，才短暂打开完全访问权限，任务结束立刻关。

安全原则可以总结成三句话：

• 能用低权限完成的任务，不用高权限。
• 能在项目目录内完成的任务，不扩大到整台电脑。
• 涉及批量修改前，优先用 Git 或者做备份保留回滚点。

5.4 环境与工作树：让 Codex 在正确的地方干活

"环境"配置的是 Codex 执行任务时依赖的开发环境，比如 Node 版本、Python 版本、系统依赖。开发者用得多，普通用户如果不跑代码可以不管。

"工作树"是一个非常有意思的概念——它让 Codex 可以在同一个 Git 仓库上开出多个独立的"平行副本"，多个智能体可以并行工作而不互相干扰。对于自动化任务和多任务并行场景，这是刚需。莫潇羽的建议是：普通场景保持默认，跑重要项目前手动确认一下工作树选的是不是当前工作分支。

5.5 MCP 服务器：给 Codex 接外脑的接口

MCP（Model Context Protocol，模型上下文协议）是一个开放协议，让 AI 模型能以标准化的方式跟外部工具与服务通讯。你可以把它理解成"给 Codex 装一个通用的插头"，插头接上什么就多一种能力。

举几个典型的 MCP 服务器：

• Context7 MCP：文档检索服务，让 Codex 可以直接查最新的第三方库文档
• Playwright MCP：让 Codex 可以打开浏览器做端到端测试
• 阿里云可观测 MCP：把日志服务、应用监控、云监控接入 Codex
• 文件系统 MCP：让 Codex 访问指定目录下的文件

添加 MCP 服务器的命令行示例是这样的（这里以 Context7 为例）：

codex mcp add context7 -- npx -y @upstash/context7-mcp
codex mcp list

对普通用户来说，MCP 大多数场景其实用不到，但一旦你开始把 Codex 用到"生产级"（比如做代码审查、日志排查、自动化测试），MCP 是把它从"能用"变成"很好用"的关键。

5.6 使用情况与计费：日常必看

前面第四章讲过双限额，具体的额度进度就在这里看。除了 5 小时窗口和月度进度，这里还能看到：

• 本月度 Token 消耗曲线
• 分模型的调用次数（GPT-5.5、GPT-5.3 各用了多少）
• 插件调用次数
• 计划模式的使用记录

这些数据帮你判断"哪些操作在偷偷烧额度"。如果发现某一天消耗突然拉高，通常不是模型贵，而是你不小心开了"快速倍率"或者跑了一个反复循环的大任务。

六、用好 Codex 的黄金四要素：目标、上下文、约束、完成条件

如果全文只能记住一件事，请记住这一节。Codex 的效果差距 80% 不是模型带来的，是 Prompt 的结构差距带来的。OpenAI 官方在 Codex Prompting Guide 里明确列出了四件套：Goal（目标）、Context（上下文）、Constraints（约束）、Done When（完成条件）。

莫潇羽@无忆研习社把这四件套翻译成人话就是——你要什么、参考什么、别越界、什么算做完。

6.1 为什么这四件套是刚需

先看一个反例。假设你随手扔给 Codex 一句：

"帮我采集一些三维 IP 作品图。"

它可能会：

• 打开一个不知道从哪儿冒出来的图片站
• 采集三张一看就是低质量的搜索结果
• 采集完扔到 C 盘一个自动生成的文件夹里
• 也没告诉你来源
• 也不知道是不是你想要的风格

问题在哪？在于目标模糊、无上下文、无约束、无完成条件。Codex 会尽量按最合理的默认去猜，但它猜的可能不是你想要的。

现在换成四件套版本：

目标（Goal）：采集 100 张三维 IP 作品的参考图。
上下文（Context）：文件夹里有 3 张我已经准备好的参考图，代表我要的风格标准——毛绒、针织、羊毛毡质感，可爱风格，干净背景色。
约束（Constraints）：只从 Pinterest、Behance、站酷这类设计师平台采集，不要采集小红书和抖音（平台对采集有严格限制）；严格按参考图的风格标准来筛，宁缺勿滥；采集时保留图片来源链接和作者信息。
完成条件（Done When）：目录里出现 100 张符合风格的图，按"编号-作者-来源"命名，输出一份 Markdown 汇总文件列出所有链接。

同一件事，两种问法，结果差距会很大。

6.2 每一件套的展开与举例

6.2.1 目标（Goal）：先说"要做什么"

目标要具体到可以判断成功与否。反例是"帮我优化一下这个页面"——"优化"是没法判断的。正例是"把首页的加载时间从 3 秒降到 1 秒以内""把这段嵌套 if-else 改成早返回模式"。

一个可以套用的目标句式：

• 「把 X 从 A 状态改成 B 状态」
• 「产出一份 X，包含 A、B、C 三部分内容」
• 「实现一个 X 功能，用户可以做到 A、B、C」

6.2.2 上下文（Context）：给它一份"参考资料"

上下文的用处是让 Codex 在你的规则和背景里工作，而不是在通用世界的默认里工作。上下文包括但不限于：

• 相关文件（贴附件、指定文件路径）
• 参考图/参考网站（把链接、截图给它）
• 品牌规范（Logo 用什么颜色、字体用什么、间距怎么走）
• 既有代码结构（这段功能会用到项目里哪些模块）
• 业务背景（你是谁的公司、面向什么用户、要达成什么）

一个很实用的技巧：把上下文放到"项目"里而不是每次都贴一遍。项目文件夹里的所有文件 Codex 都能直接读，比你每次复制粘贴要省事得多。

6.2.3 约束（Constraints）：告诉它不能做什么

约束是很多人容易漏掉的一环。没有约束，Codex 会自己找一条它觉得"合理"的路，可能就是你不想要的路。约束的常见维度：

• 数据来源约束：只从 A 站点、不要碰 B 站点。合规提醒：采集网站数据前请先阅读该站点的服务条款和 robots.txt，尊重版权，尊重反爬机制，不要采集个人隐私数据。
• 技术栈约束：必须用 X 框架、必须兼容 Y 版本、不许改 Z 接口。
• 风格约束：字体必须用 A、颜色必须走 B 色板。
• 输出格式约束：只能是 Markdown、只能是 HTML、只能是 PNG。
• 操作范围约束：只在这个文件夹里改、不许动别的目录。

6.2.4 完成条件（Done When）：什么算做完

这一环是让 Codex 在"任务是不是完成"上有客观判据。没有完成条件，它可能"觉得差不多了"就停了；也可能陷入无限循环，反复优化下去。

完成条件的写法：

• 「共产出 N 张图片」
• 「测试通过率达到 X%」
• 「输出一份 X 报告，包含 A、B、C 章节」
• 「打开浏览器验证功能可用后再停」

这里插一句：Codex 的 Goal 模式（/goal 命令）就是把这四件套结构化的产物。你启动 /goal 之后，Codex 会自动生成一份"目标 - 范围 - 约束 - 完成条件"清单，还会在每一轮任务结束前跑一次审计，逐条对照证据判断有没有完成，避免它"跑一半就自称完成"。要用 /goal，得先在 config.toml 里启用 features.goals。

6.3 一个可以直接抄的 Prompt 模板

莫潇羽自己每次给 Codex 分配复杂任务，用的都是这个模板：

# 目标（Goal）
[用一句话说清楚要做什么，具体到可以判断成功/失败]

# 上下文（Context）
- [相关文件/参考图/参考链接]
- [业务背景/项目规范]
- [已有的相关模块/代码]

# 约束（Constraints）
- 数据来源：[允许/禁止的数据源]
- 技术栈：[必须使用/不能改动的技术]
- 输出格式：[Markdown/HTML/PDF/图片]
- 操作范围：[只允许在哪些目录内操作]

# 输入（Inputs）
- [如果有需要处理的输入数据，列在这里]

# 完成条件（Done When）
1. [可验证的产出 1]
2. [可验证的产出 2]
3. [可验证的产出 3]

# 停止条件（Stop If）
- [遇到什么情况直接停下等我确认]

把这个模板贴进去，替换掉方括号里的内容，Codex 的输出会比"随手一句话"稳定几个数量级。

七、计划模式与模型选择：先规划再动手

有了黄金四要素以后，还有两个操作层的开关会决定 Codex 的最终表现——计划模式和模型档位。

7.1 计划模式（Plan Mode）：动手前先出方案

计划模式的定位很清晰：在真正动手改文件之前，先让 Codex 出一份实施计划给你看。

它跟"追求目标模式（Goal Mode）"的区别是这样的：

启用计划模式的方式：点击输入框旁边的加号，选择"计划模式"，或者用斜杠命令 /plan。开启后，Codex 会先跟你确认目标、澄清模糊点，然后给出一份分步骤的实施计划表，等你点"提交"才开始动手。

一个真实的对比感受：没开计划模式，Codex 像那种听你说完就闷头干、干完不对再让你返工的乙方；开了计划模式，它像那种先跟你对齐一次需求、把关键节点确认清楚再动手的乙方。前者省你打字，后者省你返工。莫潇羽建议：任何涉及"改代码、动本地文件、跑真实项目"的任务，都默认开计划模式。

有一个细节要提醒：Plan 模式与 /goal 目标模式之间是"Plan 优先、Goal 挂起"的关系。/goal 依赖延续机制自动往下推，而进入 Plan 模式后，/goal 会被挂起——UI 上依旧显示"Goal active"，但目标不会自动推进任务，需要等你退出 Plan 模式后 /goal 才会继续跑。所以想让 /goal 无人值守跑一段长任务，记得先退出 Plan 模式再启动 /goal。

7.2 模型档位：低、中、高、超高的选择逻辑

Codex 提供了四个思考深度档位——低、中、高、超高（不同版本命名略有差异，但对应关系是一致的）。莫潇羽的建议是：

• 低：适合极简任务，比如"帮我改一个变量名""统计一下文件行数"，速度快、成本低。
• 中：日常写代码、写文档、做搜索的默认档位。
• 高：复杂任务、需要多步推理、跨文件修改。推荐日常主要档位。
• 超高：真正难的架构设计、大型重构、深度调试。速度会慢很多、消耗额度也高，用在"值得等"的问题上。

同时 Codex 提供多个基础模型可选（写稿时是 2026 年 8 月，请以 OpenAI 官方页面的实时数据为准）：GPT-5.5 和 GPT-5.6 系列（Sol / Terra / Luna） 是当前主推。大部分场景 GPT-5.5 或 5.6-Terra 加"高"档位是甜蜜点；复杂长任务用 5.6-Sol 加"超高"档位；主模型额度打满时切到 5.6-Luna 兜底。老一代的 5.2、5.3-Codex 已经弃用，5.4 系列即将在 2026 年 8 月 31 日退役，配置里如果还挂着老模型请及时更新。

7.3 标准速度和快速倍率：额度与速度的取舍

Codex 还有一个速度开关：标准 vs 快速。

• 标准速度：正常速度、正常额度消耗。
• 快速倍率（比如 15 倍、20 倍）：明显更快，但每一次调用会消耗相应倍数的额度。

这个开关的意思很直接——用额度换时间。莫潇羽的做法是：日常写代码保持标准；需要 demo、赶交付、跑演示的时候临时切快速。如果发现 5 小时额度掉得快，第一件事就是检查是不是不小心把快速倍率打开了。

八、插件系统：让 Codex 长出手脚

有了目标、有了模式，Codex 还需要"手脚"才能真正干活。这些"手脚"，就是插件（Plugins）。

8.1 插件的本质：给 AI 装外部能力

一个特别形象的类比：Codex 本身是一台裸机手机，插件就是你装的一个个 App。裸机能打字、能算数，装了美图秀秀能修图、装了 QQ 音乐能放歌、装了浏览器能上网。给 AI 装插件，也是同样的逻辑——每装一个插件，Codex 就多一种和外部世界交互的能力。

打开插件面板会看到几十上百个插件，密密麻麻。不必都装，抓住几个高频的先跑通：

对做设计和运营的朋友，浏览器插件、GitHub 插件、电脑操控插件是三件套，装好这三个基本就能玩得转日常场景。

8.2 安装插件的正确姿势

安装插件的路径是：插件面板 → 搜索目标插件 → 点击"+" 号安装 → 完成外部服务的授权。

以 Figma 插件为例，安装后 Codex 会引导你在网页端登录一次 Figma 账号，完成授权后 Figma 的图层数据 Codex 就能读到了。同理，GitHub 插件要你授权仓库读写权限，Sentry 插件要你授权项目访问权限。

一个隐藏坑：用 API Key 登录 Codex 时，很多插件（尤其是需要 OAuth 授权的）会失效。所以第 2 章那个"能用官方账号就用官方账号"的建议，插件层再验证一次它的价值。

8.3 插件与技能（Skill）的区别，一次讲清

这一对概念混淆最严重。莫潇羽@无忆研习社用一句话区分：

• 插件（Plugin）是连接器——把 Codex 连到外部世界的一个"通道"。
• 技能（Skill）是操作手册——告诉 Codex "遇到某类任务应该按什么步骤、什么标准来做"。

再用一张表把它们钉死：

一个技能可以调用多个插件（比如"电商详情页生成 Skill"里可能同时调用浏览器插件抓取数据、调用 Figma 插件读取模板、调用文件系统插件保存产物）；反过来，一个插件也可能被多个技能复用。它们是叠加关系，不是替代关系。

8.4 GitHub 插件的隐藏福利：让 Codex 帮你装其他 Skill

装完 GitHub 插件后有一个特别好用的用法——你不需要下载 Skill 安装包，直接把 GitHub 上的 Skill 项目链接甩给 Codex，让它帮你装。

比如你在 GitHub 上找到一个高星（Star 数很高）的 PPT Skill 项目，操作方式是：

把这个 GitHub 链接复制过来：
https://github.com/xxx/pptx-skill

对 Codex 说：帮我安装这个 Skill，如果已经装过就不用重装了。

Codex 会自己去克隆项目、识别 SKILL.md、检查依赖、写入本地