- 适用对象
- 想快速了解工具定位、核心功能和上手路径的中文用户
- 核对日期
- 2026-11-07
本页目录
本指南综合了 10 篇公众号教程(2026-10-01 ~ 10-31)。文中的 [1]~[10] 对应文末的「参考原文」。命令行安装和接入其他模型这两部分,素材里讲得少,补充了 OpenAI 和 DeepSeek 的官方文档,用 [官1]~[官3] 标注,查阅日期 2026-11-07。每张图下方注明出处。素材之间说法不一致或可能过时的地方,用 ⚠️ 标出。
一、定位:它是什么,适合谁
Codex 是 OpenAI 的编程智能体。你用中文说出要做的事,它就能进入一个项目文件夹,读文件、改文件、跑命令,再把改动(diff)拿给你看 [2][5]。它的出发点是写代码,现在也能做文档、表格、PPT、网页、生图这类日常工作 [1][3]。
它现在在哪里:2026 年 7 月 9 日起,原来单独的 Codex App 合并进了新版 ChatGPT 桌面应用。打开应用后,左上角的产品菜单可以在 ChatGPT 和 Codex 之间切换;ChatGPT 里又分 Chat 和 Work 两种模式 [3][5]。
图源:[1] 乔巴大战comfyui《【保姆级】Codex新手教程》
Chat、Work、Codex 怎么选 [3][4][5]
| 入口 | 适合 | 例子 |
|---|---|---|
| Chat | 问问题、讨论、改写,不动本地文件 | 「用小学生能懂的话解释网页是什么」 |
| Work | 交付完整成果:报告、文档、表格、PPT | 「根据这些材料整理一份活动方案」 |
| Codex | 操作项目文件,还要看清过程(命令、diff、Git) | 「检查这个网页为什么打不开,修好后验证」 |
Work 和 Codex 的能力有不少重叠,主要差别在界面:Work 只给你看进度和成品,Codex 会把终端命令、代码差异、Git 状态都摊开 [3]。如果发现 Codex 改不了本地文件,先看看左上角是不是停在了 ChatGPT 的「聊天」模式 [1]。
和 Claude Code 比 [1]
门槛:Codex 的桌面端就是普通 App,设置页面全是中文,不用敲命令;ChatGPT 账号注册也比较容易,素材作者认为封号风险比 Claude 小。
风格:两边能做的事基本一样。素材 [1] 的作者觉得 Codex「太较真」:小需求容易被它做成一个大工程(作者叫它「过度防御性编程」),同一个需求,用 Claude Code 写一两天能完成,用 Codex 可能要三四天。作者的用法是:前期方案让 Codex 做得全,执行时再用 Claude Code 做减法。
独有优势:用 ChatGPT 会员登录时,生图(GPT-image)不另外收费 [1]。
有哪些入口 [2][5]
| 入口 | 适合谁 | 怎么用 |
|---|---|---|
| 桌面应用 | 新手、不写代码的人 | 选好项目,直接发任务(本指南主线) |
| IDE 扩展 | 天天在 VS Code、Cursor、Windsurf、JetBrains 里写代码的人 | 从编辑器侧边栏打开 |
| CLI 命令行 | 习惯终端、要写脚本或接 CI 的人 | 在项目目录里运行 codex |
| Web / 云端 | GitHub 上的项目,要后台长时间跑 | 在云端环境里执行,结果是 diff 或 PR |
二、准备与安装
0. 先选路线
| 你的情况 | 推荐路线 | 看哪几步 |
|---|---|---|
| 不写代码,想用它办公、做网页、生图 | 桌面应用 + ChatGPT 账号 | 第 1、2 步 → 第三节 |
| 程序员,习惯终端 | CLI | 第 1、4 步 |
| 主要在编辑器里写代码 | IDE 扩展 | 第 1、3 步 |
| 额度用完了,或者想用国内模型 | CLI 或桌面应用 + 自定义模型 | 第四节「8. 接入其他模型」 |
1. 账号与额度
用 ChatGPT 账号登录(推荐):用的是你 ChatGPT 套餐里的额度,能第一时间用上最新模型;云端任务也只有这种登录方式能用 [3]。
用 API Key 登录:按 API 用量另外计费;模型更新会慢一点,云端任务用不了 [2][3]。
免费版能不能用:素材 [5] 引用官方说明,Codex 包含在 Free、Go 在内的各档 ChatGPT 套餐里,只是限额不同;云端功能 Free 和 Go 不包含。素材 [3] 的作者不建议用免费账号,因为额度太少;他说 Plus 每 5 小时能发 30~150 条消息,够正常用一天,重度用户可以考虑 Pro。
怎么看用量:设置 → 使用情况和计费,能看到 5 小时限额、每周限额和重置卡;主界面左下角也有快捷入口 [1]。CLI 里输入
/status查看 [5]。一条消息不等于固定消耗:同样一条消息,「解释一个词」和「改整个网站再跑测试」的消耗差得很远。模型越强、思考强度越高、任务越长,消耗越多 [5]。
图源:[1] 乔巴大战comfyui《【保姆级】Codex新手教程》
⚠️ 套餐价格、各档额度和「Free 包含 Codex」这类说法变化很快。素材 [3] 的「30~150 条」是作者自己给出的数字,以你账号里的用量面板为准。
2. 桌面应用(新手首选)
打开官方下载页,按电脑系统下载安装包。素材里给过两个地址:
chatgpt.com/zh-Hans-CN/codex/get-started/[1] 和openai.com/codex[6],都会跳到官方下载页。认准新版:官方把旧版桌面应用叫 ChatGPT Classic。要用 Codex,得装同时带 Chat、Work、Codex 的新版 ChatGPT 桌面应用 [5]。
系统要求:Mac 需要 macOS 14 或更高,Apple Silicon(M1 及以后)和 Intel 处理器都支持 [5]。Windows 可以原生使用,不必先装 WSL [5]。Linux 版目前是预览版(Ubuntu、Debian 用
.deb,Fedora 用.rpm),没有电脑操作(Computer Use)功能 [5]。打开应用,点 Continue to sign in,在浏览器里登录 ChatGPT 账号,授权后会自动跳回应用 [3]。想用 API Key 登录,选 Sign in another way [3]。
启动检查:切到 Codex,发一句「请用中文解释『项目』『聊天』『文件夹』,暂时不要读取或修改任何文件」。能正常回复就说明登录成功了 [5]。
图源:[2] 国培云科《Codex 入门指南》(OpenAI 官方截图,界面可能已更新)
装不上、找不到功能怎么办 [5]
应用打不开:先核对系统版本、芯片和下载来源。不要随手执行网上来路不明的「修复命令」。
登录后没有跳回应用:看看浏览器里是不是还在等你确认。
找不到某个功能:先在应用菜单里点 Check for Updates;更新后还没有,可能是账号、工作区或灰度发布的限制,不一定是装错了。
3. IDE 扩展 [2][5]
VS Code、Cursor、Windsurf:在扩展市场搜索 Codex,安装后点侧边栏的 Codex 图标;没找到图标,可以在命令面板里运行 Codex: Open Codex Sidebar [5]。
Xcode 和 JetBrains 有各自的集成入口,不能照搬 VS Code 的菜单 [5]。
扩展里有 Chat、Agent、Agent (full access) 三种模式。新手从 Chat 或普通 Agent 开始,不要一上来就开 full access [2]。
图源:[2] 国培云科《Codex 入门指南》
图源:[2] 国培云科《Codex 入门指南》
4. CLI 命令行完整安装
第一步:选一种安装方式
| 方式 | 命令 | 来源 |
|---|---|---|
| macOS / Linux 官方安装脚本 | curl -fsSL https://chatgpt.com/codex/install.sh | sh | [官1] |
| Homebrew(macOS) | brew install --cask codex | [5] |
| npm(各系统通用,需要先装 Node.js) | npm install -g @openai/codex | [5] |
Windows:官方 CLI 页面有单独的 Windows 安装说明,这次没有读到原文。可以先用 npm 安装,或者以官网为准。桌面应用在 Windows 上默认用 PowerShell 跑命令,也可以改成 WSL2;改了要重启应用 [5]。
第二步:确认装好
关掉终端,重新打开一个。
运行
codex --version,能看到版本号就说明装好了 [5]。提示找不到
codex:先确认安装是否完成,再检查命令路径(PATH)[5]。
第三步:进入项目目录,启动并登录
输入
cd加一个空格,把 Finder(或资源管理器)里的练习文件夹拖进终端,回车。运行
pwd(Windows 是cd)确认当前位置。运行
codex,第一次会让你选登录方式,选 Sign in with ChatGPT [5][官1]。出现交互界面后直接用中文提要求,比如「介绍当前文件夹里有哪些文件,只读查看,不修改、不安装、不上传」[5]。
图源:[5] 硅基光年(OpenAI 官方示例图,版本号不代表最新)
第四步:日常命令
| 命令 | 作用 | 来源 |
|---|---|---|
codex | 在当前目录启动交互会话 | [官1] |
codex resume | 重新打开当前仓库最近的会话 | [5][官1] |
codex exec "任务" | 不进入交互界面,直接执行,适合脚本和 CI | [官1] |
codex --image 图片路径 | 第一条提示附带一张图片 | [官1] |
codex --search | 这次运行允许联网搜索 | [官1] |
codex cloud | 把任务提交到云端环境 | [官1] |
codex mcp | 管理 MCP 服务 | [官1] |
codex login status | 查看本机登录状态 | [5] |
/init | 生成 AGENTS.md | [官1] |
/model | 切换模型和思考强度 | [5][官1] |
/status | 查看当前配置和用量 | [5][官1] |
/permissions | 设置权限 | [官1] |
/review | 审查未提交的改动、某次提交或某个分支 | [官1] |
/exit | 退出会话(不会注销,也不会撤销已保存的文件) | [5] |
更新:沿用原来的安装渠道。Homebrew 用 brew upgrade --cask codex,npm 再跑一遍 npm install -g @openai/codex,官方脚本重新运行一遍安装命令 [5][官1]。单独更新 CLI 不会顺带更新桌面应用,两边的版本可能不一样 [5]。
三、上手流程:跑通第一个任务
1. 认识主界面
左边找项目和聊天,中间交代任务、看进度,下面选模型、发送,右边检查成品 [5]。
图源:[5] 硅基光年《3万字Codex从入门到精通》
左侧栏里还有定时任务、插件(包括技能)、代码审查、站点(托管网页)等入口 [3]。顶部的放大镜用来搜索历史对话,铃铛用来看通知 [3]。
2. 建一个项目
左侧「项目」旁边点 +,选 本地(远程是给另一台电脑用的)[3]。
填项目名称,再选一个源文件夹 [3]。
第一次练习,新建一个专门的练习文件夹(比如
codex-practice),只放不含隐私的示例材料 [5]。以后要加文件夹:项目菜单 → 编辑项目 → 添加文件夹;有多个文件夹时,用 Make primary 指定主目录 [3][5]。
同一个项目里可以开好几个聊天,它们共享文件夹里的资料。项目用来管一整件事,聊天用来管一个具体结果:比如「个人网站」是项目,「改首页标题」和「检查手机版」各开一个聊天 [1][5]。
3. 发任务前,看一眼输入框
图源:[5] 硅基光年《3万字Codex从入门到精通》
运行位置:本机(This computer / Local)、Worktree、Cloud 三选一。新手先选本机 [2][5]。
图源:[5] 硅基光年(OpenAI 官方文档截图)
+ 号菜单:添加文件和文件夹、选项目、目标(Goal)、计划模式、绘图模式、录制技能(Mac)[3]。
@:引用插件或文件 [3][5]。$:调用技能,比如$imagegen生成图片 [3][5]。/:打开命令菜单 [5]。权限:「+」号旁边那个按钮,第一次用选「请求批准」(见第五节)[3]。
模型和思考强度:右下角(见第四节第 1 小节)。
图片:按住 Shift 把图片拖进输入区,确认出现缩略图后,再写清楚「这张图是什么、看哪里、要做什么」[5]。
4. 第一个任务:先读,不急着改
推荐的第一句话 [2]:
请暂时不要修改任何文件,用中文向我解释这个项目:1. 这个项目大致是做什么的?2. 主要的目录分别是做什么用的?3. 入口文件可能在哪里?4. 如果我想跑起来,通常要执行哪些命令?5. 有哪些你不确定的地方?请直接说「不确定」,不要猜。
不写代码的人,可以换成整理文件夹 [4]:
请先读取当前文件夹,告诉我里面有哪些文件、分别是什么类型,并推荐一个更清楚的分类结构。暂时不要修改或移动任何文件。
确认分类方案后再说:「按刚才的方案整理,不要删除原始内容,不要覆盖同名文件,拿不准的保留在原位置并列出来。」做完以后,打开文件夹亲眼看一遍 [4]。
5. 第一次改东西:只改一小处,然后看 diff
改之前先在 Git 里存一个检查点:
git add .→git commit -m "checkpoint before codex task"[2]。只给一个很小的目标,比如「只修改 README.md,新增一节『新手如何启动这个项目』,不要改其他文件、不要装新依赖;没写启动命令就说不确定」[2]。
看改动:桌面应用按
Control+Shift+G打开审阅区,选 Last turn 看最近一轮改了什么 [5];命令行里跑git status和git diff[2]。
图源:[5] 硅基光年(OpenAI 官方文档截图)
看 diff 时检查这几点 [2]:有没有动你没允许动的文件?有没有加你不认识的依赖?有没有删掉重要配置?diff 能不能支撑它在总结里说的那些话?看不懂代码也没关系,先看「改了哪些文件」,就能避开一大半问题。
6. 交代任务的通用模板
[2][4][5] 都给了类似的结构,合在一起就是:
目标:我要完成什么。背景:相关文件、报错、截图。范围:可以改哪些文件,哪些绝对不能动。约束:不要加依赖、不要改数据结构等。输出:交付什么文件或格式。验收:完成后跑哪些检查;跑不了要说明原因。复杂任务先给方案,我确认后再动手。
素材 [2] 还给了读项目、修 bug、加功能、代码评审、按截图做 UI 五套模板,以及一个「新手 7 天练习计划」:只读项目 → 写项目概览 → 只改 README → 修一个小 bug → 补一个测试 → 让它评审你的改动 → 试一次 Worktree 或云端。
四、核心功能与进阶玩法
1. 模型、思考强度和速度
图源:[5] 硅基光年(OpenAI 官方文档截图)
模型:点输入框右下角的模型名称。拿不准就选「默认」,让系统自己挑 [3]。截至 10 月的素材,复杂编码选 GPT-6.1 Sol,最难的任务选 Astra,范围明确、重复性高的任务可以用 Luna 或 5.6 Terra [3][5]。
思考强度:从轻到重分几档。日常用中或高,难题再往上调;越高越慢,也越费额度 [3][5][6]。
Ultra:最高一档,除了想得更深,还会把任务拆给多个子代理同时干,额度消耗也更大 [3][5]。
闪电按钮(快速模式):速度大约是标准模式的 1.5~2 倍,但更费额度,赶时间时再开 [3][6]。
⚠️ 模型名称和档位说法不一。素材 [5] 写的是 Light、Medium、High、Extra high 四档(Light 在 CLI 里叫 Low);素材 [3] 写的是轻度、中、高、极高、Ultra 五档。官方公告 GPT-5.5 已于 2026-10-14 从 ChatGPT 登录的产品中退役 [5]。所以旧教程里要求固定选某个模型的,以你自己的菜单为准。
2. 计划模式与目标(Goal)
计划模式:输入
/plan,或者在 + 号菜单里选。它会先查看资料、问清要求,再给出方案,你确认后才动手 [3][5][6]。注意要确认已经退出计划状态,否则反复发「开始」,只会收到一份又一份新计划 [5]。目标:输入
/goal,适合要持续做很久、但有明确终点的任务。写清楚结果、限制和完成条件,比如「三个复现步骤都通过、390px 宽度下没有横向滚动」[5]。中途插话:设置 → General → Follow-up behavior。Steer 会把新消息插进正在进行的工作,适合纠偏;Queue 会排到下一轮,适合补充下一件事 [5]。
停止不等于撤销:停下来以后,已经写入的文件不会自动恢复。先让它列出改过哪些文件、还有哪些进程在跑,再决定怎么处理 [5]。
3. 记忆与规则:个性化设置和 AGENTS.md
设置 → 个性化里有「Codex 指令」和「Codex 记忆」两项 [1][6]:
Codex 指令:全局生效的长期习惯,相当于 Claude Code 的全局 CLAUDE.md [1]。官方说明这里会更新个人的
AGENTS.md[5]。Codex 记忆:开启后会跨聊天记住你的工作习惯,但记到的内容有限,刚结束的聊天不一定马上能被引用 [1][5]。
项目里的 AGENTS.md:放在项目根目录,写启动、测试、lint 命令、代码风格、不能动的目录、PR 要求等 [2][5]。CLI 里输入
/init可以自动生成 [官1]。判断标准是:同一件事第二次提醒它的时候,就该写进 AGENTS.md [2]。写好之后,开个新任务让它复述当前规则,核对它有没有读到 [5]。
4. 插件、技能和 MCP
插件:左侧栏 插件 → 搜索 → 点 + 号或 Install 安装 [1][7]。装好以后在输入框里用
@调用 [1]。
图源:[1] 乔巴大战comfyui《【保姆级】Codex新手教程》
素材里推荐的插件 [7]:
| 场景 | 插件 | 作用 |
|---|---|---|
| 设计 | Canva | 一句话生成海报、封面、社媒配图 |
| 设计 | Figma | 生成可以继续编辑的设计稿 |
| 视频 | HyperFrames(HeyGen) | 把脚本或文章快速做成视频 |
| 视频 | Remotion | 专业动效、转场、数据可视化视频 |
| 办公 | Presentations / Spreadsheets | 生成 PPT 初稿;整理 Excel、算公式、出图表 |
| 浏览器 | Chrome | 打开网页、抓数据、点击、填表 |
技能(Skill):一份可以反复调用的工作说明书。输入
$选择已安装的技能 [3][5];也可以让$skill-creator帮你写一个 [5]。素材 [8] 实测了三个做 PPT 的开源技能:dashi-ppt-skill 胜在浏览器里编辑方便,ppt-master 兼顾设计感和可编辑性,codex-ppt-skill 是整页图片风格,生成最慢。
图源:[5] 硅基光年(OpenAI 官方文档截图)
安装技能的小技巧:官方或知名的技能,直接说「帮我安装 XX skill」就行;个人作者分享的技能,最好附上 GitHub 地址,免得它装错 [1]。
从 Claude Code 搬过来的技能:可能要调整一下才能用。可以让 Codex 自己去读 SKILL.md 做适配 [1]。
MCP:设置 → MCP servers → Add server,按服务方的说明选择 STDIO 或 Streamable HTTP,保存后点 Restart;需要登录的,点 Authenticate 授权 [5]。命令行里用
codex mcp管理 [官1]。卸载要分开做:卸载插件后,单独连接的 MCP 服务可能还连着,需要另外断开 [5]。
5. 多任务、子代理、Worktree 和云端
多任务并发:新开几个聊天,各干各的。左侧会显示每个任务的状态:转圈是在跑,蓝点是做完了,有时候在等你批准 [1]。打开设置里的「宠物」,桌宠会实时显示每个任务的进度 [1]。
注意:两个聊天如果指向同一个文件夹,可能会改到同一个文件,分开聊天不等于分开文件 [5]。
子代理:直接说「用两个子代理分别检查 A 和 B,只读不改,完成后合并结论」就行 [5]。
Worktree:Git 项目里,新聊天的输入框上方有 Worktree 开关。打开后,它会建一份独立的工作副本,改动不影响原目录;做完以后用 Hand off 交回本机,或者用 Create branch here 保留成一个分支 [5]。
图源:[5] 硅基光年(OpenAI 官方文档截图)
云端(Cloud):在 Work in 菜单里选 Cloud → 选择或新建环境(连接 GitHub 仓库)→ Publish → 发任务。电脑休眠了任务照样跑,但云端读不到你本机的文件 [5][6]。
图源:[5] 硅基光年(OpenAI 官方文档截图)
GitHub 评审:配好云端和 GitHub 集成后,在 PR 评论里写
@codex review,它会在具体代码行上留下评审意见 [2]。
6. 定时任务、预览、浏览器和电脑操作
定时任务:左侧栏 → 定时任务,或者直接在聊天里说「每周一上午 9 点(北京时间)检查项目文档……」。保存后去 Scheduled 里核对实际的计划。本地任务需要电脑开着、应用在运行 [1][5]。建议先手动跑成功一次,再设定时 [5]。
实时预览:生成的视频、文档、HTML、音频,点一下就能在右侧预览;右键文件名还能「在资源管理器中打开」[1]。
内置浏览器:按
⌘+T新建标签页,在输入框里用@Browser让它看网页;用 Annotate 在页面上框出问题位置,再回聊天里让它处理 [5]。操作你的 Chrome:设置 → Computer Use → 安装浏览器扩展,然后用
@Chrome[5]。操作桌面应用:插件里启用 Computer Use。Mac 第一次用要授予屏幕录制和辅助功能权限;以后在设置 → Computer Use 里可以收回授权 [5][6]。
防休眠:设置 → 常规 → 运行时防止系统休眠,免得长任务跑到一半被锁屏打断 [5][6]。
7. 手机远程监工
在电脑上打开设置 → Connections → Control this Mac or PC,完成验证后用手机扫配对码;然后在手机 ChatGPT App 里打开 Codex(部分版本叫 Remote),就能看进度、补充要求、批准操作 [1][5]。任务仍然在你的电脑上跑,电脑要保持唤醒和联网 [5]。
8. 接入其他模型:API Key 与 config.toml 配置
适合三种情况:额度用完了想临时换模型 [1]、想用国内模型,或者公司有自己的模型网关。
8.1 用 OpenAI API Key 代替 ChatGPT 账号
桌面应用:登录页选 Sign in another way,填 API Key [3]。
CLI:第一次运行
codex时选择 API Key 登录 [官1];用codex login status查看当前登录方式 [5]。这样会按 API 用量计费,云端任务也用不了 [2][3]。
8.2 在 config.toml 里加一个自定义模型服务商
Codex 的配置文件是 ~/.codex/config.toml,Windows 在 C:\Users\你的用户名\.codex\config.toml [10][官2]。官方的写法是这样的 [官2]:
model = "模型名"
model_provider = "myprovider"
[model_providers.myprovider]
name = "我的模型服务"
base_url = "https://服务商给的地址"
env_key = "MY_PROVIDER_API_KEY" # Key 放在这个环境变量里
wire_api = "responses" # 使用 Responses API然后把 Key 设成环境变量:
macOS / Linux:
export MYPROVIDERAPI_KEY=你的Key,想一直生效就写进~/.zshrc。Windows PowerShell:
$env:MYPROVIDERAPI_KEY = "你的Key"。
几点说明:
wire_api = "responses"表示服务商需要支持 OpenAI 的 Responses API。不支持的服务商接不上,要先看对方有没有专门写「接入 Codex」的文档 [官2][官3]。本地模型:运行
codex --oss,再在配置里写oss_provider = "ollama"或"lmstudio",就能用 Ollama、LM Studio 跑的本地模型 [官2]。想保留几套配置随时切换,可以用 profile:
codex --profile 名字[官2][10]。
8.3 示例:接入 DeepSeek
DeepSeek 官方给了专门的 Codex 接入文档 [官3]:
modelprovider = "deepseek",[modelproviders.deepseek]里写baseurl = "https://api.deepseek.com/"、wireapi = "responses"。Key 用
experimentalbearertoken直接写进配置文件(注意这是明文,别把这个文件分享出去)。还需要建一个
~/.codex/models.json模型目录文件。官方提供 macOS / Linux 和 Windows 的一键配置脚本。模型名、哪些模型支持联网搜索和识图,以官方页面为准。
切换后要重启 ChatGPT 客户端;历史会话会按登录方式分组显示,恢复原来的配置就能看到之前的会话。
8.4 换模型的几个坑 [1]
得开新窗口:同一个聊天中途换模型会报错,只能新开一个。
交接靠文档:项目目标、进度、技术路线这些要单独写成文档保存在本地,换窗口时让新聊天先读这份文档。
能力有差异:素材 [1] 写的时候,DeepSeek 不能识图,也不能生图,涉及图片的部分要提前规划好,或者交回 ChatGPT 模型处理。DeepSeek 新的接入文档说
deepseek-flash已经支持图片输入 [官3],以实测为准。素材 [1] 的作者用的是第三方切换工具 CC Switch(他写的是 Claude Code 接 DeepSeek 的版本,思路相同)。
⚠️ 素材 [10] 里的 config.toml 示例用的是
gpt-5.3-codex、o4-mini这些较早的模型名。它写的approval_policy = "full-auto"也不在官方取值里:官方示例用的是on-request、never,并说明已经不再支持untrusted[官2]。照抄之前要先核对官方文档。
五、避坑与注意
1. 权限怎么选
图源:[1] 乔巴大战comfyui《【保姆级】Codex新手教程》
| 模式 | 它能做什么 | 什么时候用 |
|---|---|---|
| 请求批准(Ask for approval) | 读写当前项目文件夹;要改外部文件或联网时先问你 | 新手默认,大多数任务都够用 [3][5][6] |
| 帮我批准(Approve for me / Auto-review) | 同上,但多一个负责安全检查的 AI 帮你审批:低风险自动放行,高风险拦下来问你 | 用了一两周以后 [3][5] |
| 完全访问权限(Full access) | 可以读写电脑上任意文件、联网,全程不问 | 熟悉它的行为、项目有 Git 备份时 [3] |
「完全访问」默认不显示:要先到设置 → 常规 → 权限里把它打开,菜单里才会出现。打开开关只是让它出现在菜单里,不会自动改变已有聊天的权限 [1][5]。
图源:[5] 硅基光年(OpenAI 官方文档截图)
权限分两层:沙箱决定它能碰到哪里,审批决定它什么时候要先问你。在提示词里写「不要改文件」只是行为要求,真正的限制要靠权限设置 [5]。
审批时看四件事:做什么、对什么做、为什么需要、影响多大 [5]。对
rm -rf、sudo、curl ... | sh、安装你不认识的包、访问项目以外的目录要特别小心;看不懂的命令就拒绝,或者让它先解释 [2]。
⚠️ 素材 [1] 说这三种模式「对应 Claude Code 的默认模式、允许编辑和完全访问」。这个类比不准确:「帮我批准」是由 AI 自动审查风险,更接近 Claude Code 的 Auto 模式,不是「自动接受编辑」[5]。
⚠️ IDE 扩展里的模式名叫 Chat、Agent、Agent (full access) [2],和桌面应用的叫法不同。
2. 隐私与安全
API Key、数据库密码、生产环境令牌、客户隐私,都不要贴进提示词、日志或截图 [2]。
「本地执行」不代表内容不出电脑:聊天记录和上下文可能会存在云端 [5]。
分享聊天时:一打开分享对话框就开始上传快照,不是点了 Copy link 才上传;快照也不会自动更新 [5]。
截图前遮住账号、左侧历史记录、文件路径和配对二维码 [5]。
3. 常见问题速查 [5]
| 现象 | 先查什么 |
|---|---|
| 一直没有新回复 | 是不是在等你批准或回答问题 |
| 改不了本地文件 | 是不是停在了 ChatGPT「聊天」模式 [1];是不是选成了 Cloud |
| 文件改动比预期多 | 审阅区切到 Last turn,分清哪些是本轮改的,哪些是仓库里原有的改动 |
| 找不到聊天 | 设置 → Archived chats 里取消归档 |
| 手机看不到电脑 | 是不是同一账号和工作区;电脑有没有唤醒、联网 |
| 额度见底 | 等重置、用重置卡、升级套餐,或者换模型(见第四节第 8 小节)[1] |
4. 其他提醒
聊天的「完成」不等于任务完成:要求它交代清楚「文件在哪、怎么打开、哪些验证过、哪些没验证」[5]。
防「过度开发」:素材 [1] 的作者反复强调只做他的真实需求,Codex 还是把一个小功能做成了一整套「企业级证据与权限体系」。小任务要把范围写死,做完看 diff。
先找现成的:要做新项目时,先让它去 GitHub 上找有没有能直接用或二次开发的开源项目,再决定自己开发、改现成的,还是直接用 [1]。
语音输入:素材 [1] 的作者觉得自带的语音识别一般,推荐用豆包输入法或微信输入法。
⚠️ 说法有出入或存疑的地方:
素材 [2] 的截图来自独立 Codex App 时期,和现在合进 ChatGPT 桌面应用后的界面不完全一样 [3][5]。
素材 [10] 里的规则文件
rules.md、会话保留天数cleanupPeriodDays、codex --teleport、/codex-rename、allowedTools等说法,在其他素材和官方 CLI 页面里都找不到对应,有的更像是 Claude Code 的配置项,不建议照用。它讲 Context Compaction(上下文压缩)、用 Profile 切换工作模式的思路可以参考。素材 [9] 和 [7] 的主要目的是推课程,正文信息量有限,本指南只采用了 [7] 里的插件推荐。
六、参考原文
| # | 标题 | 公众号 | 发布 | 本指南用到的内容 | 用图 |
|---|---|---|---|---|---|
| 1 | 【保姆级】Codex新手教程,手把手教你玩转最好的Agent工具! | 乔巴大战comfyui | 2026-10-31 | 和 Claude Code 的对比、设置、插件、多任务、定时任务、生图、换模型、手机监工 | 03、07、14、17 |
| 2 | Codex 入门指南,从零基础到实战,看这一篇就够了! | 国培云科 | 2026-10-18 | 四种入口、提示词模板、Git 检查点、看 diff、7 天练习、AGENTS.md | 04、10、11 |
| 3 | Codex越来越离谱了!一篇文章带你玩明白这个神级App | 阿川同学 | 2026-10-21 | Work 和 Codex 的区别、两种登录、界面各入口、权限、模型与档位、建项目 | — |
| 4 | ChatGPT & Codex|从入门到精通 | 东山秋月白 | 2026-10-27 | Chat、Work、Codex 的选择,整理文件的入门任务,任务六要素 | — |
| 5 | 3万字Codex从入门到精通:零基础小白用户完整图文教程(超级精华) | 硅基光年 | 2026-10-01 | 安装要求、额度、界面、模型、计划和目标、权限、审阅、技能和 MCP、Worktree、云端、CLI、远程、故障速查 | 01、02、05、06、08、09、12、13、15、16 |
| 6 | Codex保姆级使用教程!打开这2个隐藏开关,10秒让你的GPT智商暴涨 | 优设AIGC | 2026-10-27 | 思考强度、计划模式、记忆、防休眠、电脑操控 | — |
| 7 | 我给Codex装了几个插件,才发现之前都用错了 | 三节课服务号 | 2026-10-27 | 插件推荐(文章主要目的是推课) | — |
| 8 | Codex 生成 PPT 常用的三个开源 Skill,收藏起来! | 程序员大彬 | 2026-10-30 | 三个做 PPT 的技能实测 | — |
| 9 | Codex进阶必看!这30个玩法好用到哭 | 三节课 | 2026-10-27 | 未采用(以推课为主,正文信息少) | — |
| 10 | 全网最全Codex高级进阶:AI编程大师进阶 | 临床研究与医学统计 | 2026-10-19 | config.toml 的位置、profile 的思路(多处内容存疑,见第五节) | — |
官方文档补充(2026-11-07 查阅)
| # | 文档 | 用到的内容 |
|---|---|---|
| 官1 | OpenAI:Codex CLI | 安装脚本、登录、常用命令和斜杠命令 |
| 官2 | OpenAI:Codex 高级配置 | 自定义模型服务商、--oss、profile、approval_policy 和 sandbox_mode 的取值 |
| 官3 | DeepSeek:接入 Codex | DeepSeek 的 config.toml 写法和注意事项 |
图片清单
| 图 | 文件 | 出处 |
|---|---|---|
| 01 | images/01-选择运行位置.png | [5] 图 01(官方截图) |
| 02 | images/02-主界面十个位置.png | [5] 图 03 |
| 03 | images/03-切换ChatGPT与Codex.png | [1] 第 11 张 |
| 04 | images/04-欢迎登录界面.png | [2] 图 1 |
| 05 | images/05-输入框.png | [5] 图 05 |
| 06 | images/06-模型与思考强度.png | [5] 图 14 |
| 07 | images/07-三种权限模式.png | [1] 第 5 张 |
| 08 | images/08-权限设置.png | [5] 图 19 |
| 09 | images/09-查看代码改动.png | [5] 图 32 |
| 10 | images/10-IDE扩展入口.png | [2] 图 9 |
| 11 | images/11-IDE模式切换.png | [2] 图 10 |
| 12 | images/12-CLI终端界面.png | [5] 图 41 |
| 13 | images/13-用美元符号调用技能.png | [5] 图 37 |
| 14 | images/14-插件页.png | [1] 第 18 张 |
| 15 | images/15-Worktree开关.png | [5] 图 38 |
| 16 | images/16-切换到Cloud.png | [5] 图 42 |
| 17 | images/17-用量面板.png | [1] 第 9 张 |