夜雨聆风最近，Codex 在 AI 圈热度一路飙升，几乎刷屏。打开公众号、抖音、B站等平台随处可见相关讨论，俨然成了 AI 圈的「现象级工具」。
但我相信更多的朋友和我之前一样，第一次听到 Codex，第一反应不是"哇，好强"，而是：
这玩意到底从哪开始用？
一会儿说 Claude Code，一会儿说 Codex，彻底晕了。
所以这篇教程，不讲跑分、不讲复杂原理，只讲新手第一次真正上手时，最需要搞懂、最需要掌握的东西。
废话不多说，直接开始。
Codex 是什么？
Codex 是 OpenAI 于 2025 年推出的 AI 编程智能体，到 2026 年已成为开发者圈子里最热门的生产力工具之一。
它和我们日常用的聊天机器人有本质区别：不只是问答对话，还能直接读取本地项目文件、编辑文档与代码、执行系统命令、操控各类软件，同时支持联网检索信息。
不少人会把它和 Claude Code 作对比，两者能力上相近，但 Codex 搭配了完整的可视化界面，操作一目了然，更适合新手小白使用。
一、安装 Codex
一切的前提，是先要把 Codex 安装到你的本地电脑。
前提条件：需要有网络环境和 ChatGPT 账号，这个大家只能自己去想办法了。
基本流程：
打开官方入口：https://openai.com/zh-Hans-CN/codex/ 下载 Windows 或 Mac 版 Codex 桌面 App 按提示安装 打开 Codex 用 ChatGPT / OpenAI 账号登录
安装这件事本身不复杂，最重要的是别乱下载。建议只从 OpenAI 官方入口下载。
如果你只是体验，优先用账号登录，不要一上来研究 API Key。
免费账号能不能用，要看当时官方开放策略和额度。长期使用，建议至少准备 Plus 或更高套餐。因为 Codex 一旦进入项目、读文件、改文件、跑长任务，消耗还是比较大的。
二、先别急着干活！
如果你只把 Codex 当成 ChatGPT 的另一个入口，那它确实就只是一个聊天框。
但 Codex 真正厉害的地方，不是"回答问题"，而是能直接进入项目文件，扮演你的工作助手帮你做事。
比如，它可以做这些事：
读取你指定的本地文件 修改项目里的文档和代码 运行终端命令 打开网页查资料 通过插件处理文档、表格、PPT 用 Skills 按固定流程完成任务 通过 MCP 连接外部工具 在 IDE 或云端继续处理项目
对于新手来讲，要先建立一个重要的意识：不要一上来就用 Codex 直接开发项目，而是要先学会了解它。
2.1 Codex 的不同使用方式
Codex 可以在多个入口使用，但小白先看这张表就够了：
| 主推，从这里开始 | ||
建议先把桌面 App 这条路跑通，后面去 VS Code、Cloud、GitHub 都会顺很多。
2.2 了解 Codex 基本组成
打开 Codex 桌面 App 后，界面中间是工作区，左侧栏包含两个主要入口：
- 对话（Chat）
：适合不需要绑定文件夹的任务，与 ChatGPT 网页端体验基本一致，适合日常问答和简单任务。每个对话相互独立。 - 项目（Project）
：这才是 Codex 真正的主战场。适合需要操作本地文件的任务，如生成代码、编写文档、制作 PPT、完成报告。选一个本地文件夹作为项目目录，所有生成的文件都会自动存进去。
Codex 桌面 App 的对话框额外提供了这些功能：
- 添加上下文
：可以附加文件、截图或其他参考内容 - 选择模型
：在不同模型之间切换 - 选择工作目录
：指定在哪个本地文件夹下执行任务 - 计划模式
：只规划不动手，先帮你把方案理清楚，你确认了再开始做。稍微复杂一点的项目，都推荐你先用这个模式过一遍 - 本地模式
：决定文件改在哪里
在对话框左下角，有三档权限选择：
默认权限（最安全、最保守） 一般只能读取工作区内所有文件，但修改文件、执行命令、联网都需要你手动点击确认。适合新手刚上手。
自动审查（日常开发首选） 内置自动风险判断，低风险操作自动放行（如改普通代码、加注释、安装依赖），高风险操作仍会弹框确认（如删除文件、提权等）。新手最推荐。
完全访问权限（风险最大） 可创建/修改/删除任何项目文件，无确认、无拦截、直接执行。几乎无安全限制，误操作可能导致文件丢失。
新手最容易犯的错误：一上来就给完全访问权限。建议始终从"默认权限"开始，熟悉它的行为模式后再逐步放开。
2.3 先做几个基础设置
到这里，先别急着让它改文件，先做设置。
① 跟进行为改为"引导"
跟进行为改成引导，这样中途你想修改的时候可以直接插入，不需要等当前任务做完才能进行新对话。
② 发送方式改为"组合键发送"
开启按组合键发送，而不是按 Enter 就发送。因为你后面写项目需求时，经常会写很长，如果写一半按回车就发出去了，Codex 可能会拿着半截需求开始干活。（别问我是怎么知道的，我吃了很多次亏 😂）
③ 先建项目目录
新手第一次用 Codex，最该先配置的不是模型，而是项目文件夹。这一步是全文最重要的事。
你可以建一个这样的文件夹：
~/codex-projects这个目录以后专门放 Codex 项目。不要把项目直接放在桌面、下载目录、知识库目录等乱七八糟的位置。
为什么？因为 Codex 会读文件、写文件、生成中间数据、跑脚本。如果把项目塞进日常知识库，它可能把一堆日志、配置、代码、缓存都放进去，知识库就被污染了。
每个新项目再建一个独立文件夹：
~/codex-projects/project1~/codex-projects/project2~/codex-projects/project3④ 设置 AGENTS.md
对于 Codex 而言，每开启一个新的对话窗口，它都会进入一个全新的上下文。它不记得之前发生了什么。
AGENTS.md 就是给 Codex 看的项目说明文件，可以描述项目结构、开发命令、测试要求、代码风格和协作边界。
设置分为两个层级：全局级（影响所有项目）和项目级（仅影响当前文件夹）。建议先配置全局规则。
在 Codex 桌面 App 里打开设置，找到"个性化"，填写"自定义指令"即可设置全局 AGENTS.md。比如你可以写：
请默认用中文回答。如果涉及代码或命令，请先用大白话解释目的，再给具体操作。如果要修改文件、运行命令、访问外部账号，请先告诉我风险。如果我的需求信息不完整，请先问我缺什么，不要直接编。对于具体项目，可以在项目根目录下创建一个 agents.md 文件，Codex 开始工作前会自动读取里面的内容作为上下文。
⑤ 权限：不要一上来就 ALL IN
Codex 会请求权限，比如读文件、改文件、运行命令、访问网页、连接账号。
新手最容易犯的错误是：看到确认按钮就点。
如果看不懂权限请求，直接问 Codex："请用小白能懂的话解释：你现在请求的权限会访问什么？为什么这个任务需要它？有没有更低风险的做法？"
⑥ 模型和推理强度：先默认，复杂任务再提高
小白不需要一上来研究每个模型。
普通问答：默认即可 复杂项目：用更强模型或更高推理
一句话：小任务别浪费额度，大任务别省过头。
⑦ 自动化先别急
Codex 有自动化的功能：每天自动总结、每周自动检查、定时抓资料等。
但新手别急，先把手动流程跑通，再自动化。如果你手动都没说清楚"输入是什么、输出到哪里、失败怎么办"，自动化只会把混乱定时重复一遍。
三、进阶功能：插件、技能、MCP
小白最容易把 Plugin、Skill、MCP 混在一起，先看这张表：
记住一个顺序：
先用 Codex 桌面 App 自带能力 → 不够再装插件 → 重复任务沉淀成 Skill → 特殊工具再考虑 MCP
不要一上来装一堆插件、技能。
Skill 是什么、怎么用？
Skill 可以理解为一套固定工作流说明书。比如你经常让 Codex 整理资料，每次都要说"先问我缺什么信息、再整理、再生成对比表、再写报告"。每次都打一遍很麻烦。那就把它写成一个 Skill。
Skill 常见使用方式：先准备或安装可用的 Skill，在发起任务时明确说明使用哪个 Skill，让 Codex 按流程执行，再根据结果继续追问或迭代。
插件是什么、怎么用？
插件就是把一组技能、工具、配置打包起来的安装包。
直接点击右上角的插件 tab 进入插件管理界面：
要做 PPT → 装 Presentations 插件 要处理 Excel → 装 Spreadsheets 插件 要操作浏览器 → 装 Browser/Chrome 插件 要控制电脑 → 装 Computer User 插件
插件不是越多越好，而是越明确越好。 先明确任务，再装插件。
MCP：先知道，但不必急着装
MCP 是让 Codex 连接外部工具或外部资料的一种通道。但对大多数小白来说，前期不用急着配 MCP。等你明确知道要接哪个工具、官方插件满足不了时再研究。
四、跑通第一个小项目
终于可以开发任务了。
建好项目文件夹之后，打开计划模式的开关。计划模式就是只规划不动手，先帮你把方案理清楚，你确认了再开始做。
计划模式最大的价值不是"省时间"，而是强迫你把模糊需求转化为清晰指令。很多新手抱怨"Codex 不听话"，其实根源是自己的需求描述不够具体。
接下来，跟 Codex 说：
帮我做一个「XX社群」介绍的网页，要好看，要有设计感，把功能、定位按层级分类展示出来。把提示词发给 Codex 后，它会先扫描你的项目文件夹，接着自动调用「brainstorming（头脑风暴）」和「frontend-design（前端设计）」两个内置技能：先拆解你的需求，再输出视觉风格选项，并主动问你是否需要先生成视觉预览。这一步建议新手一定要做，避免 AI 直接开发出的风格和你预期偏差太大。
当你确认没毛病之后，就可以开始实施。开发过程基本全自动。做完之后，可以直接用 Codex 的内置浏览器打开看效果。
一个小提示：如果你用 Codex 内置浏览器打开，还有一个非常实用的功能：批注。点开批注之后，可以直接在页面上圈选任何元素，写上修改意见，不用再截图或用嘴描述一大堆。
写在最后
如果你能坚持读到这里，应该已经掌握了 Codex 的常用功能。
概括起来，第一次用 Codex，按这四步检查：
- 先选工作模式
：做代码、网站、脚本选「适用于编程」；写文案、整理资料选「适用于日常工作」 - 先别急着开最大权限
：刚开始建议让 Codex 只在当前工作区内读写文件 - 先配置工作目录
：第一个任务尽量使用空文件夹或测试项目，不要把重要项目直接交出去 - 先观察使用情况
：任务中断、额度告急或响应变慢时，再回到套餐页面确认限制
Codex 新手自检清单
如果你第一次用 Codex，照着勾就行：
☑️ 从 OpenAI 官方入口安装 Codex（拒绝第三方安装包）
☑️ 清楚桌面 App / 网页版 / CLI / VS Code 扩展的核心区别（新手先吃透桌面 App）
☑️ 建立独立的项目根目录（如 ~/codex-projects），每个项目单独建文件夹
☑️ 创建 AGENTS.md 文件
☑️ 能分清插件 / Skill / MCP 的核心用途，不盲目安装
☑️ 仅授权 Codex 访问当前项目文件夹（不开放整个硬盘权限）
☑️ 明确要求 Codex："需求不全时先追问，不擅自编造内容"
☑️ 每次 AI 修改文件后，先让它解释"改了什么、为什么改"，再确认生效
如果这张清单你都能勾上，恭喜你，你已经不是"打开 Codex 只会聊天"的小白了。
最后送一句话：
工具本身不产生价值，使用工具的方式才产生价值。
Codex 再强，也只是你手中的锤子。能不能盖出好房子，取决于你愿不愿意先学会画图纸。
现在，打开 Codex，开始你的第一个项目吧。
原文来源： 腾讯云开发者社区原文链接： https://cloud.tencent.com/developer/article/2680288原作者发布： 2026年6月1日
如果这篇文章对你有帮助，欢迎点赞、在看、转发给同样在学 Codex 的朋友。你在用 Codex 的过程中踩过什么坑？评论区聊聊。
工具本身不稀缺。
稀缺的是，把工具放进正确场景里的判断力。
如果你总有一种信息缺失的恐慌，
总有一种被时代抛弃的焦虑，那就来拥抱AI！
装了Codex只会写代码？你可能浪费了它80%的战斗力 科研人用Codex，70多个学术Skill先装哪个？这份索引就是你的导航地图 5 分钟搞定！WorkBuddy 接入 GPT 及任意 AI 模型全攻略 Cowart 把 Codex 无限画布和图像生成/改图流程接到一起 别再手动找插件了：Codex 真正高级的用法，是让它先读懂你 用 Codex 把论文拆明白 让 Codex 不再自由发挥：AGENTS.md 真正该怎么写 全网最简单：用 Codex Toolkit 给 Codex 配置 DeepSeek、硅基流动这类 /chat/completions 供应商 如何用 Codex 一天干完一周的工作 用 Codex 做文献调研：把“找论文、读论文、写综述”变成一套自动循环