2026年 Codex 实战指南：从 GPT-5.6 Sol 说起,别再抱着旧教程不放

如果你最近搜”Codex 教程”,搜出来的多半还是 GPT-5-Codex、GPT-5.2-Codex、GPT-5.3-Codex 那一批老内容。不是说这些教程完全没用,而是到了 2026 年 8 月,Codex 的底层逻辑已经变了一轮——现在再学 Codex,重点不再是”装插件、登录、丢一句 prompt 让它写代码”,而是要搞清楚模型选哪个、Agent 在哪干活、权限开多大、要不要先 Plan、干完了怎么验收。

这几件事想不明白,装再多插件也是白搭。

目前 OpenAI 最新的模型家族是 GPT-5.6,分三档:Sol、Terra、Luna。

其中 Sol 是旗舰,官方把它定位为”面向复杂专业工作的前沿模型”,编程、Agent、架构这类硬任务优先用它。这篇教程就以现在的 Codex + GPT-5.6 为基础重写,不再绕着 GPT-5.3-Codex 打转。

一、Codex 现在到底是个什么东西

很多人对 Codex 的印象还停留在”一个会写代码的聊天机器人”。这个理解已经过时了。

现在的 Codex 更接近一个能直接进项目干活的 Agent:它能读整个仓库、搜文件、改代码、建文件、跑终端命令、装依赖、跑测试、看 Git Diff、做 Code Review,甚至能看图、查资料、调用外部工具。它的工作方式可以概括成一条线:

这四步里最容易被忽略的是最后一步。Codex 告诉你”已完成”,不等于代码真的对了。真正靠得住的判断依据是 Diff、测试结果、终端输出、页面实际效果、Git 状态——这几样东西不看,你其实不知道它到底动了什么。这也是为什么会用 Codex 和只会复制 prompt 之间,差距会越拉越大:前者知道怎么判断它改对了没有,后者只会等它说”Done”。

二、先把版本和模型搞清楚

模型:优先考虑 GPT-5.6 Sol

官方参数(以 OpenAI 文档和你自己客户端 /model 里显示的为准,数字会变):

• Model ID:gpt-5.6-sol
• 上下文窗口:约 105 万 token
• 最大输出:12.8 万 token
• Reasoning 档位:none / low / medium / high / xhigh / max

需要提醒一句:105 万 token 是模型本身的标称上限,不代表你在 Codex 里实际能用到这么多——不同客户端版本对上下文的实际分配会有出入,超过一定阈值(目前官方说明是 27.2 万 input token)还会触发更贵的计费档位。

GPT-5.6 这一代在前端设计判断上也强化了不少,布局、视觉层级、界面审美的把握比上一代更准,做 Dashboard、React、Next.js 项目会有明显感受。

先查版本,别急着用

如果别人已经能选 GPT-5.6 Sol,你这边看不到,先别怀疑是没开放权限,大概率是版本太旧。终端里跑一下:

codex --version

Codex CLI 至少要 0.144.0 才能访问 GPT-5.6,ChatGPT 桌面端的 Codex 模式同理需要对应新版本。旧版本先升级,这是第一步,顺序不能反。

安装方式(三选一)

macOS / Linux 直接装:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

已经装了 Node.js 的,用 npm 更省心:

npm install -g @openai/codex

macOS 用户也可以走 Homebrew:

brew install --cask codex

装完之后,终端输入 codex 就能启动。

登录

普通用户最简单的方式是 “Sign in with ChatGPT”,浏览器授权一下就完事。API Key 也是一种登录方式,但要注意:ChatGPT 套餐的用量和 API 按量计费是两套账,如果你只是日常用 Codex 写代码,没必要专门为它配一把 API Key。另外 GPT-5.6 是按账号和套餐逐步开放的,具体能用哪个模型,以自己 /model 里实际看到的为准。

三、打开 Codex 之后,先别急着写代码

这是我觉得旧教程最容易带偏新手的地方——装完就直接丢一句”帮我写个登录页面”,然后开始踩坑。

真正该先搞清楚的是:Codex 现在在哪个目录工作? 因为它能直接读写文件,目录一旦选错,后面大概率会遇到找不到代码、改错项目、读一堆无关文件、写到错误目录这类问题。

所以第一条原则很朴素:只把完成任务所需的最小工作目录交给 Codex,不要图省事把整个 Desktop、Documents 或者用户主目录都开放给它。

四、任务放在哪执行:Local、Worktree、Cloud

用 Codex 的时候,除了选模型,还有一件同样重要的事——这个任务在哪执行。

Local:改当前项目,最直接

Codex 直接在你当前项目里读、改、跑、测。适合改页面、修 Bug、调配置这类日常开发,一个 Agent 干一个任务。刚上手的话,默认用 Local 就够了,不用一上来就折腾隔离环境。

Worktree:需要隔离或并行时再上

Worktree 简单理解就是给 Agent 单独复制一份隔离的工作现场。比如你正在 main 分支上开发,同时想让 Codex 重构登录系统——直接在 Local 改很容易和你自己的改动冲突,这时候建一个 Worktree,让 Codex 在独立工作区里改,你手头的代码不受影响。

它特别适合多任务并行的场景,比如一个 Agent 修登录 Bug、一个重构支付页面、一个更新测试,三者互不干扰。但有个坑要提醒:别为了”多 Agent”而硬拆任务。一个十分钟能搞定的活,没必要拆成三个 Agent 分头跑,那只会增加协调成本。

判断标准很简单:单任务优先 Local,需要隔离或者确实要并行了,再上 Worktree。

Cloud:边界清楚、能独立完成的任务

Cloud 相当于把任务丢到远端环境去跑,比如检查整个项目、修复一个明确的 Issue、批量重构、跑测试、代码审查——这类任务的特点是边界清楚:交出去、等结果、看 Diff 就行。如果过程中你需要频繁改需求、看本地页面效果、操作本地应用、随时讨论,Local 或 Worktree 会顺手得多。

五、权限:Codex 真的能动你的文件,别什么任务都开满

这是 Codex 和普通聊天 AI 最大的区别——它不只是给建议,它真的会改你的文件系统。权限大致分三档:

Read-only:只想分析项目、找问题、看代码、做 Review 的时候用。比如”阅读这个项目,找出登录失败的原因,但不要修改任何文件”,这种任务完全没必要开写权限。

Workspace-write:能改当前工作区,但不会不打招呼动整台电脑。大部分正常开发任务用这一档就够了。

Full access:确实有需要更大权限的场景,但不要把它当默认设置,尤其是删除文件、上传内容、修改账号、发布线上内容、操作凭据、跑自动化任务这几类,更要保守一点。

权限越高不代表 Codex 越专业,边界越清楚反而越容易控制它到底在干什么。

六、复杂任务先 Plan,简单任务别绕弯子

以前很多人的习惯是丢一句”帮我重构这个项目”,然后让它直接开改。现在更建议:复杂任务先规划,再执行。

Codex CLI 里输入 /plan,或者直接说”先阅读项目,只给出修改计划,暂时不要修改文件”。

一个有用的 Plan 至少要说清楚四件事:

但 Plan 不是每个任务都要走一遍——“把标题改成 XX”这种事,规划五个步骤纯属浪费时间。

小任务直接做,跨文件、涉及重构、需要定位 Bug 的任务先 Plan。

新手第一次可以这么问

进一个陌生项目,先让它摸底,别急着改:

先阅读整个项目,不要修改任何文件。

告诉我:
1. 这个项目是做什么的
2. 使用什么技术栈
3. 主要目录结构
4. 项目入口在哪里
5. 如何启动
6. 目前有哪些明显问题

等它把项目摸清楚了,再聚焦到具体问题:

检查登录模块。

先分析导致登录失败的原因,
列出准备修改的文件和方案,
暂时不要写文件。

方案没问题了,再放它去改:

按照刚才的方案修改。

要求:
不要修改数据库结构;
不要修改无关代码;
完成后运行测试;
如果测试失败继续排查。

这一套走下来,比一句”帮我修登录”稳定得多——差别就在于每一步都给了边界和验收标准。

七、看 Diff,比背 Prompt 模板重要得多

Codex 改完代码后,别只看它说”Done”就完事,直接打开 Diff 看:新增了什么、删了什么、动了哪些文件、有没有顺手改了无关代码、有没有把原来的逻辑删掉。看完 Diff,再跑测试、打开页面检查、看终端有没有报错,最后用 /review 走一遍代码审查,确认没问题再 commit。

完整流程大致是:

这个顺序里,Diff 和测试是防止”看起来做完了,其实改错了”的最后一道关。

八、常用命令,先记这几个就够

新手没必要第一天背全部命令,先掌握这七个:

命令	作用
/status	查看当前任务状态
/model	切换模型和 Reasoning 档位
/plan	复杂任务先出计划
/permissions	控制 Agent 权限
/diff	看它到底改了什么
/review	对改动做代码审查
/init	初始化项目规则(生成 AGENTS.md)

九、AGENTS.md:让 Codex 记住项目规矩,别每次都重复说

跑一下 /init,Codex 会帮你在项目里生成一份 AGENTS.md,可以理解成”Codex 在这个项目里的员工手册”。比如:

# 项目规则

这是 Next.js + TypeScript 项目。

- 使用 Tailwind CSS
- 保持现有目录结构
- 不要修改数据库 Schema
- 不要添加无关依赖
- 修改完成后执行 npm test
- 能局部修改就不要整体重写
- 不要修改与当前需求无关的文件

写好这份文件,以后就不用每次都重复”不要改数据库、别整个项目重构、记得跑测试”这些话。

AGENTS.md 和 Memory 不是一回事

两者容易被混着用,其实分工很清楚:AGENTS.md 是明确规则,适合写项目结构、代码规范、测试方式、绝对不能碰的内容;Memory 是长期使用中积累的偏好,比如你惯用什么测试框架、提交信息喜欢什么格式、文件通常放哪。

如果某条规则很重要,写进 AGENTS.md 比指望隐式记忆靠谱得多。

十、Skill、MCP、Plugin,一句话分清楚

这三个词很多人看到就开始乱装,其实用一句话就能区分:

• Skill = 教 Codex 怎么做一件事(把重复工作固化成 SOP)
• MCP = 给 Codex 接外部工具(GitHub、Figma、Sentry、浏览器、内部数据库……)
• Plugin = 把一套 Skill + MCP + 连接器打包安装

举个例子,如果你每次发布网站都要检查代码、跑测试、生成 Changelog、检查版本、部署,与其每次重写 prompt,不如做成一个 Skill,让它变成固定流程。MCP 则是让 Codex 接触外部世界的接口层——比如接上 Figma MCP,它就能读设计稿、找到对应组件、改代码、再打开浏览器检查页面,这时候它已经不只是代码生成器,而是一个跨工具的 Agent。

新手完全没必要第一天装 20 个 Plugin。更合理的顺序是:一件事重复做了 → 做成 Skill;需要接外部系统了 → 上 MCP;确实需要一整套能力包了 → 才考虑 Plugin。缺什么补什么,不是装得越多越强。

十一、Automation 和 Goal:让 Codex 定时干活、朝目标推进

一些重复任务可以交给 Automation,比如每天检查依赖、每周生成更新日志、定时跑测试、定期整理文档。但有个提醒必须放在前面:先手动跑通,再自动化。一个自己都没测过的 prompt,不要直接扔给它长期无人值守运行,尤其涉及真实写入、发布、删除这类动作。

/goal 和 Automation 不是一回事——Automation 管的是”什么时候启动任务”,/goal 管的是”这个长期任务最终要做到什么程度”。比如”把项目里的旧测试全部迁移,并让现有测试全部通过”是一个能验证的 Goal;但”持续优化我的项目”就不合适,因为它没有明确的终点,Codex 判断不出什么时候算完成。

十二、新手学习顺序建议:分四步走

把 Sol、Terra、Luna、Worktree、Cloud、Skill、Plugin、MCP、Automation、Goal、Memory 一股脑扔给一个新人,大概率会懵。更实际的路径是分四阶段:

第一阶段:学会控制 Codex。 只做四件事——选对项目、新建任务、分清 Read-only 和 Workspace-write、看懂 Diff。做到”知道它在哪工作,也知道它改了什么”,已经甩开一大批只会复制 prompt 的用户了。

第二阶段:学会走完一个完整任务。 加入 Plan、终端、测试、/review,形成”Plan → Execute → Verify”的完整闭环。

第三阶段:学多 Agent 协作。 开始用 Worktree 配合并行任务,比如一个 Agent 修 Bug、一个改 UI、一个补测试,互相不干扰。

第四阶段:按真实需求扩展能力。 需要固化流程了学 Skill,需要接外部系统了学 MCP,需要整套能力包了学 Plugin,任务变成长期或者需要目标导向了再碰 Automation 和 Goal。

核心思路就一句话:先学边界和验证,再学高级功能,而不是反过来。

十三、Reasoning 档位怎么选

GPT-5.6 支持 none / low / medium / high / xhigh / max 六档,官方把 Medium 作为比较均衡的起点。简单记:日常开发用 Medium;复杂 Bug、多文件任务、重构用 High;真正难啃的问题、需要长时间分析的场景才上 XHigh 或 Max。改个按钮颜色没必要拉满,大型架构问题再考虑往上提。

十四、Sol、Terra、Luna 怎么选

三档定位不同:Sol 能力优先,适合复杂 Coding、Agent、Debug、架构、大项目;Terra 在能力和成本之间取平衡,适合大量日常开发任务;Luna 速度和成本优先,适合高频、简单、批量任务。注意 API 列出的模型不代表你的 Codex 模型选择器一定全部展示,具体能选什么,以 /model 里的实际选项和账号权限为准。

如果你准备长期使用 Codex ,有可用的海外支付方式，建议优先走 GPT 官方渠道订阅，更直接也更稳妥。 如果你暂时无法完成海外支付，可以考虑官方代充方案。推荐一直自用的官方代冲网站（自助升级,正规稳定）：cnmGPT.com。定位就是面向 GPT 套餐升级的专业自助代充平台，国内用户可以直接完成对应套餐的升级，比较适合没有海外支付条件、又需要稳定使用 Codex 的用户。

十五、一个可以直接拿去用的完整 Prompt

第一次让 Codex 改项目,可以直接套这个模板:

先阅读当前项目,不要立即修改代码。

第一步:
确认项目技术栈、目录结构以及和当前任务相关的文件。

第二步:
分析我要解决的问题,给出最短可靠的实现方案。

第三步:
告诉我:
- 准备修改哪些文件
- 为什么修改
- 是否需要增加依赖
- 最后准备如何验证

确认方案后再开始修改。

修改要求:
- 不修改无关代码
- 不随意重构整个项目
- 优先复用现有实现
- 不增加不必要依赖
- 保持当前代码风格

修改完成后:
1. 运行相关测试
2. 检查终端错误
3. 查看 Diff
4. 对本次修改执行 Review
5. 最后汇总修改文件、修改原因和验证结果

这类 prompt 有用,不是因为写得长,而是因为它交代清楚了四件事:材料、边界、目标、验收方式。少了任何一件,Codex 的输出质量都会打折扣。

最后

不要把”Codex 说完成了”当成任务真的完成了。真正的完成,是代码改对了、测试通过了、Diff 没越界、结果符合目标——这四条同时满足,才算数。

本文更新于 2026 年 8 月。Codex 和 GPT-5.6 迭代很快,模型名称、套餐权限、具体的上下文和计费数字请以 OpenAI 官方文档和你自己客户端的实际显示为准。