天工开物KAIWU AI
工具指南 › Codex › Codex 使用指南(完整全套)
核实于 2026-11-07
工具指南·其二核实于 2026-11-07

Codex 使用指南(完整全套)

适用对象
想快速了解工具定位、核心功能和上手路径的中文用户
核对日期
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 左上角切换 ChatGPT 与 Codex

图源:[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]。

图 2 使用情况和计费:5 小时限额与每周限额

图源:[1] 乔巴大战comfyui《【保姆级】Codex新手教程》

⚠️ 套餐价格、各档额度和「Free 包含 Codex」这类说法变化很快。素材 [3] 的「30~150 条」是作者自己给出的数字,以你账号里的用量面板为准。

2. 桌面应用(新手首选)

  1. 打开官方下载页,按电脑系统下载安装包。素材里给过两个地址:chatgpt.com/zh-Hans-CN/codex/get-started/ [1] 和 openai.com/codex [6],都会跳到官方下载页。

  2. 认准新版:官方把旧版桌面应用叫 ChatGPT Classic。要用 Codex,得装同时带 Chat、Work、Codex 的新版 ChatGPT 桌面应用 [5]。

  3. 系统要求:Mac 需要 macOS 14 或更高,Apple Silicon(M1 及以后)和 Intel 处理器都支持 [5]。Windows 可以原生使用,不必先装 WSL [5]。Linux 版目前是预览版(Ubuntu、Debian 用 .deb,Fedora 用 .rpm),没有电脑操作(Computer Use)功能 [5]。

  4. 打开应用,点 Continue to sign in,在浏览器里登录 ChatGPT 账号,授权后会自动跳回应用 [3]。想用 API Key 登录,选 Sign in another way [3]。

  5. 启动检查:切到 Codex,发一句「请用中文解释『项目』『聊天』『文件夹』,暂时不要读取或修改任何文件」。能正常回复就说明登录成功了 [5]。

图 3 Codex 欢迎登录界面:ChatGPT 账号或 API Key

图源:[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]。

图 4 VS Code 中的 Codex 扩展入口

图源:[2] 国培云科《Codex 入门指南》

图 5 IDE 扩展的三种模式

图源:[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]。

第二步:确认装好

  1. 关掉终端,重新打开一个。

  2. 运行 codex --version,能看到版本号就说明装好了 [5]。

  3. 提示找不到 codex:先确认安装是否完成,再检查命令路径(PATH)[5]。

第三步:进入项目目录,启动并登录

  1. 输入 cd 加一个空格,把 Finder(或资源管理器)里的练习文件夹拖进终端,回车。

  2. 运行 pwd(Windows 是 cd)确认当前位置。

  3. 运行 codex,第一次会让你选登录方式,选 Sign in with ChatGPT [5][官1]。

  4. 出现交互界面后直接用中文提要求,比如「介绍当前文件夹里有哪些文件,只读查看,不修改、不安装、不上传」[5]。

图 6 CLI 启动后,顶部显示版本、模型、思考强度和当前目录

图源:[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]。

图 7 主界面的十个位置(官方截图加中文标注)

图源:[5] 硅基光年《3万字Codex从入门到精通》

左侧栏里还有定时任务、插件(包括技能)、代码审查、站点(托管网页)等入口 [3]。顶部的放大镜用来搜索历史对话,铃铛用来看通知 [3]。

2. 建一个项目

  1. 左侧「项目」旁边点 +,选 本地(远程是给另一台电脑用的)[3]。

  2. 填项目名称,再选一个源文件夹 [3]。

  3. 第一次练习,新建一个专门的练习文件夹(比如 codex-practice),只放不含隐私的示例材料 [5]。

  4. 以后要加文件夹:项目菜单 → 编辑项目 → 添加文件夹;有多个文件夹时,用 Make primary 指定主目录 [3][5]。

同一个项目里可以开好几个聊天,它们共享文件夹里的资料。项目用来管一整件事,聊天用来管一个具体结果:比如「个人网站」是项目,「改首页标题」和「检查手机版」各开一个聊天 [1][5]。

3. 发任务前,看一眼输入框

图 8 输入框:交代任务、附材料、选模型、发送

图源:[5] 硅基光年《3万字Codex从入门到精通》

  • 运行位置:本机(This computer / Local)、Worktree、Cloud 三选一。新手先选本机 [2][5]。

图 9 发送前确定任务在哪里运行

图源:[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

  1. 改之前先在 Git 里存一个检查点:git add . → git commit -m "checkpoint before codex task" [2]。

  2. 只给一个很小的目标,比如「只修改 README.md,新增一节『新手如何启动这个项目』,不要改其他文件、不要装新依赖;没写启动命令就说不确定」[2]。

  3. 看改动:桌面应用按 Control+Shift+G 打开审阅区,选 Last turn 看最近一轮改了什么 [5];命令行里跑 git status 和 git diff [2]。

图 10 在 Code changes 里看文件改了哪里

图源:[5] 硅基光年(OpenAI 官方文档截图)

看 diff 时检查这几点 [2]:有没有动你没允许动的文件?有没有加你不认识的依赖?有没有删掉重要配置?diff 能不能支撑它在总结里说的那些话?看不懂代码也没关系,先看「改了哪些文件」,就能避开一大半问题。

6. 交代任务的通用模板

[2][4][5] 都给了类似的结构,合在一起就是:

目标:我要完成什么。背景:相关文件、报错、截图。范围:可以改哪些文件,哪些绝对不能动。约束:不要加依赖、不要改数据结构等。输出:交付什么文件或格式。验收:完成后跑哪些检查;跑不了要说明原因。复杂任务先给方案,我确认后再动手。

素材 [2] 还给了读项目、修 bug、加功能、代码评审、按截图做 UI 五套模板,以及一个「新手 7 天练习计划」:只读项目 → 写项目概览 → 只改 README → 修一个小 bug → 补一个测试 → 让它评审你的改动 → 试一次 Worktree 或云端。


四、核心功能与进阶玩法

1. 模型、思考强度和速度

图 11 模型名称和思考强度的入口

图源:[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]。

图 12 插件页:点 + 号快速安装

图源:[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 是整页图片风格,生成最慢。

图 13 输入 $ 选择已安装的技能

图源:[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]。

图 14 新聊天输入框上方的 Worktree 开关

图源:[5] 硅基光年(OpenAI 官方文档截图)

  • 云端(Cloud):在 Work in 菜单里选 Cloud → 选择或新建环境(连接 GitHub 仓库)→ Publish → 发任务。电脑休眠了任务照样跑,但云端读不到你本机的文件 [5][6]。

图 15 从 Work in 切换到 Cloud

图源:[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]:

toml
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. 权限怎么选

图 16 桌面应用的三种权限模式

图源:[1] 乔巴大战comfyui《【保姆级】Codex新手教程》

模式它能做什么什么时候用
请求批准(Ask for approval)读写当前项目文件夹;要改外部文件或联网时先问你新手默认,大多数任务都够用 [3][5][6]
帮我批准(Approve for me / Auto-review)同上,但多一个负责安全检查的 AI 帮你审批:低风险自动放行,高风险拦下来问你用了一两周以后 [3][5]
完全访问权限(Full access)可以读写电脑上任意文件、联网,全程不问熟悉它的行为、项目有 Git 备份时 [3]
  • 「完全访问」默认不显示:要先到设置 → 常规 → 权限里把它打开,菜单里才会出现。打开开关只是让它出现在菜单里,不会自动改变已有聊天的权限 [1][5]。

图 17 设置里打开额外的权限模式

图源:[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工具!乔巴大战comfyui2026-10-31和 Claude Code 的对比、设置、插件、多任务、定时任务、生图、换模型、手机监工03、07、14、17
2Codex 入门指南,从零基础到实战,看这一篇就够了!国培云科2026-10-18四种入口、提示词模板、Git 检查点、看 diff、7 天练习、AGENTS.md04、10、11
3Codex越来越离谱了!一篇文章带你玩明白这个神级App阿川同学2026-10-21Work 和 Codex 的区别、两种登录、界面各入口、权限、模型与档位、建项目—
4ChatGPT & Codex|从入门到精通东山秋月白2026-10-27Chat、Work、Codex 的选择,整理文件的入门任务,任务六要素—
53万字Codex从入门到精通:零基础小白用户完整图文教程(超级精华)硅基光年2026-10-01安装要求、额度、界面、模型、计划和目标、权限、审阅、技能和 MCP、Worktree、云端、CLI、远程、故障速查01、02、05、06、08、09、12、13、15、16
6Codex保姆级使用教程!打开这2个隐藏开关,10秒让你的GPT智商暴涨优设AIGC2026-10-27思考强度、计划模式、记忆、防休眠、电脑操控—
7我给Codex装了几个插件,才发现之前都用错了三节课服务号2026-10-27插件推荐(文章主要目的是推课)—
8Codex 生成 PPT 常用的三个开源 Skill,收藏起来!程序员大彬2026-10-30三个做 PPT 的技能实测—
9Codex进阶必看!这30个玩法好用到哭三节课2026-10-27未采用(以推课为主,正文信息少)—
10全网最全Codex高级进阶:AI编程大师进阶临床研究与医学统计2026-10-19config.toml 的位置、profile 的思路(多处内容存疑,见第五节)—

官方文档补充(2026-11-07 查阅)

#文档用到的内容
官1OpenAI:Codex CLI安装脚本、登录、常用命令和斜杠命令
官2OpenAI:Codex 高级配置自定义模型服务商、--oss、profile、approval_policy 和 sandbox_mode 的取值
官3DeepSeek:接入 CodexDeepSeek 的 config.toml 写法和注意事项

图片清单

图文件出处
01images/01-选择运行位置.png[5] 图 01(官方截图)
02images/02-主界面十个位置.png[5] 图 03
03images/03-切换ChatGPT与Codex.png[1] 第 11 张
04images/04-欢迎登录界面.png[2] 图 1
05images/05-输入框.png[5] 图 05
06images/06-模型与思考强度.png[5] 图 14
07images/07-三种权限模式.png[1] 第 5 张
08images/08-权限设置.png[5] 图 19
09images/09-查看代码改动.png[5] 图 32
10images/10-IDE扩展入口.png[2] 图 9
11images/11-IDE模式切换.png[2] 图 10
12images/12-CLI终端界面.png[5] 图 41
13images/13-用美元符号调用技能.png[5] 图 37
14images/14-插件页.png[1] 第 18 张
15images/15-Worktree开关.png[5] 图 38
16images/16-切换到Cloud.png[5] 图 42
17images/17-用量面板.png[1] 第 9 张
更新于 2026-11-07来源:用户提供《工具指南_完整全套_含所有MD与图片.zip》;正文保留原文参考来源