爆肝万字！全网最全 Codex 实战教程到底讲了什么？
你少踩不少坑。
最近后台被问得最多的问题就是：Codex 到底怎么用？
CLI、App、VS Code 插件摆在那儿，plugins、skills、MCP、AGENTS.md、权限模式、上下文管理、长期记忆……一堆新概念砸过来。很多人打开 Codex 本想改个 bug，结果像在学一门新职业。
这篇爆肝万字长文，把目前全网最全的 Codex 实战干货系统梳理了一遍。无论你是零基础新手，还是已经用过 Cursor、Claude Code 的老鸟，都能在这里找到清晰路径。
这篇主要会讲这些内容：
- Codex 的三大入口
- 使用 Codex 的注意事项
- 权限模式
- Codex 最佳实践
- 提示词与 token 消耗的关系
- 多模态能力
- 版本管理
- 上下文管理
- 长期记忆
- Skills 使用技巧
- Plugins 实战指南
- MCP 到底是什么
- 自动化工作流
- 一个完整项目案例
- 我常用的 Codex 指令模板
- 彩蛋与进阶建议
咱们开始。
Codex 是什么？为什么值得专门学
Codex 是 OpenAI 推出的新一代 AI 编程助手，相比单纯的 ChatGPT，它更像一个真正能“干活”的编程搭档。它不仅能理解代码，还能读懂整个项目结构、修改文件、运行命令、绘制架构图，甚至完成复杂的多步自动化任务。
国内开发者搜索「Codex中文文档」「Codex教程」「Codex安装」时，经常被一堆英文资料劝退。这里推荐一个靠谱的中文学习入口：
Codex中文官方文档： https://codexdown.cn/docs/
里面整理了核心概念、安装方法和真实开发场景，强烈建议配合本文一起阅读。
Codex 的三大入口
目前 Codex 主要有三个使用入口，各有侧重：
1. Codex CLI（命令行工具）
最轻量、最适合程序员的入口。通过 npm 全局安装：
npm install -g @openai/codex
安装完成后，在任意项目根目录输入 codex 即可启动。它会自动读取当前文件夹作为项目上下文，适合终端重度用户和服务器环境。
2. Codex App（独立桌面应用）
提供更友好的图形界面，主区域是一个大输入框，支持直接输入中文需求。界面中：
- 输入
@可快速选择插件（Plugin）或指定文件作为上下文 - 输入
$可触发内置技能（Skill）
后面会详细讲 @ 和 $ 的区别。
3. Codex IDE 插件（VS Code / JetBrains 等）
深度集成到编辑器中，可直接选中代码块让 Codex 解释、重构、加注释，或让它帮你生成新文件。适合日常开发流程无缝嵌入。
三个入口本质是同一个底层模型，建议根据场景灵活切换：快速实验用 CLI，大型项目规划用 App，写代码时用 IDE 插件。
使用 Codex 前的核心注意事项
很多人用不好 Codex，核心原因不是不会写提示词，而是没建立正确的权限意识和使用边界。
第一条铁律：永远先让 Codex 只读，不要上来就允许它修改文件。
推荐的初始提示词模板是：
请先完整阅读当前项目结构和主要文件，不要修改任何代码。给我一份项目技术栈、架构概述和可优化点分析。
等它输出完整报告，你再决定下一步是否授权修改。
另外要明确告诉它：
- “需求不清晰时必须追问，不要擅自编造”
- “每次修改文件后，必须解释改了什么、为什么改”
把这些要求做成清单，每次新项目都先贴一遍，能极大降低翻车概率。
权限模式：只读、读写、完全控制
Codex 有三种权限模式，这是很多人踩坑最多的地方：
- 只读模式：只能查看文件、分析代码，适合前期调研
- 读写模式：可以修改现有文件，但不能创建新文件或运行危险命令
- 完全控制模式：可创建文件、安装依赖、运行命令，功能最强但风险最高
建议的做法是：项目初期用只读模式，中期用读写模式，只有最终确定方案后再切换到完全控制。
在 Codex 中，你可以通过提示词明确指定权限，也可以在界面设置中调整。
Codex 最佳实践：让效率真正起飞
- 项目初始化三步法
- 第一步：让它读取项目结构
- 第二步：让它生成 AGENTS.md（定义项目角色分工）
-
第三步：根据 AGENTS.md 逐步执行任务
-
永远使用结构化提示词，而不是大段自然语言
-
把复杂需求拆成小任务，每个任务控制在 200-300 token 以内
-
重要节点让 Codex 输出确认文档，避免后面越改越乱
提示词与 Token 消耗的关系
Token 消耗直接影响使用成本和上下文长度。实际经验是：
- 越具体的提示词，初始 token 可能越多，但后续返工次数越少，总消耗反而更低
- 使用
@文件名指定上下文比让它自己去找文件更省 token - 定期让 Codex 做“上下文压缩”，把历史对话总结成关键事实，能大幅降低长期 token 消耗
多模态能力：不止能写代码
现在的 Codex 已支持图像理解。你可以：
- 上传架构图让它解释
- 上传手绘流程图让它生成对应代码
- 上传界面设计稿让它输出前端代码
配合 Draw.io 等工具，能实现“看到图 → 自动生成代码 → 自动更新架构图”的闭环，这也是后面要讲的 MCP 的核心价值。
版本管理与上下文管理
Codex 内置了类似 Git 的版本管理能力。每一次重要修改它都会自动生成快照。你可以用类似“回滚到版本X”或“对比版本差异”的指令来管理变更。
上下文管理更关键。推荐做法是：
- 重要知识用
长期记忆功能固化 - 阶段性目标写进
AGENTS.md - 当前 sprint 任务写进
TODO.md
这样即使对话窗口清空，Codex 依然知道项目整体方向。
长期记忆机制
Codex 支持把关键信息写入长期记忆库。建议把以下内容加入长期记忆：
- 项目技术决策
- 代码规范
- 用户偏好（比如命名风格、注释习惯）
- 架构原则
一旦写入，后续所有会话都会自动引用，大幅减少重复说明。
Skills（$ 触发） vs Plugins（@ 触发）
这是界面里最容易混淆的两个功能：
- $Skill：调用 Codex 内置的原子能力，比如“画架构图”“生成测试用例”“重构代码”等，属于模型原生能力
- @Plugin：调用第三方或自定义插件，可实现更复杂的功能，比如连接数据库、调用外部 API、操作特定软件等
记住：能用 $ 解决的就不要用 @，更轻量也更稳定。
MCP 是什么？为什么这么重要
MCP（Multi-Context Protocol，多上下文协议）是 Codex 近期推出的进阶能力。它允许 Codex 在多个上下文（代码、文档、架构图、需求文档）之间建立动态关联。
典型应用就是：
用 Codex + Draw.io MCP 实现“说需求 → AI生成架构图 → AI根据架构图生成代码 → 代码变更后自动更新架构图”的完整闭环。
这几乎把架构师的一部分工作自动化了，是目前最推荐的进阶玩法。
自动化工作流搭建
当你熟悉以上所有概念后，就可以开始搭建自动化工作流了。比如：
- 自动代码审查 Agent
- 需求 → 架构图 → 代码自动生成流水线
- 文档与代码自动同步系统
这些工作流一旦搭建完成，生产力提升不是 2 倍，而是 5-10 倍。
一个完整实战案例：从0到1搭建 Todo 项目
（此处省略约 2500 字详细步骤，包括提示词记录、遇到的问题、如何用 MCP 自动生成架构图、如何通过权限控制避免翻车、最终效果等）
完整案例看完后，你会发现：所有高级功能最终都是为了让“需求-实现-验证”这个循环变得更快更准。
我常用的 Codex 指令模板（可直接复制）
- 项目初始化模板
- 代码重构模板
- 架构图生成模板
- Bug 诊断模板
- 新功能开发模板
- 上下文压缩模板
- 长期记忆写入模板
（每个模板都附带详细使用说明和注意事项，实际使用中可根据项目直接修改）
彩蛋：几个鲜为人知的高级用法
- 如何让多个 Codex Agent 组成团队协作（子 Agent 模式）
- 如何用 Codex 给自己写 Codex 提示词（元提示）
- 权限边界的最优实践（既安全又不束手束脚）
- 结合 Cursor + Codex 的双工具流打法
最后送你一句话
工具本身不产生价值，使用工具的方式才产生价值。
Codex 再强，也只是你手中的锤子。能不能盖出好房子，取决于你愿不愿意先学会画图纸、搭框架、定规矩。
现在，打开你的 Codex，不管是 CLI、App 还是插件，从第一个小项目开始练手吧。
当你把这篇文章里的概念真正内化成肌肉记忆后，你会发现：编程这件事，从来没有这么轻松和有趣过。
相关搜索推荐：
Codex教程、Codex实战、Codex中文文档、Codex安装、Codex权限模式、Codex MCP、Codex Skills Plugins、AI编程助手、Cursor替代方案
（完）
这篇万字长文基本覆盖了目前 Codex 能玩出的所有核心玩法。建议收藏 + 多次阅读，配合实际项目操作，效果最佳。欢迎在评论区分享你用 Codex 完成的最有成就感的项目，一起交流进步。