Codex保姆级教程：从安装到精通，我踩过的坑都给你标好了

我从零开始用 Codex，折腾了整整两天，终于把从安装到进阶的每个环节都跑通了。网上很多教程只讲一半，遇到问题就卡住。这篇我把自己的操作步骤、踩过的坑都整理出来，尽量详细，你可以照着做。

先说清楚背景：OpenAI 已经把原 Codex 桌面应用整体升级为新的 ChatGPT 桌面应用，现在应用内统一整合了 Chat、Work 和 Codex 三个功能入口，本教程我们只聚焦 Codex 功能的使用。

一、安装 Codex（依托 ChatGPT 桌面版）

有科学上网条件的朋友，直接去 OpenAI 官网下载最新版 ChatGPT 桌面版就可以。没有代理的用户，可以直接打开微软应用商店，搜索「ChatGPT」就能下载安装。安装完成后，你可以在系统搜索栏输入「ChatGPT」，如果能搜到对应应用，就说明安装成功了。这里提醒大家：先别急着打开 Codex，我们先把后续的配置工作做完。

二、获取 DeepSeek API Key

Codex 本身需要接入大模型才能正常使用，我自己实测下来 DeepSeek 的 API 性价比很高，适合大多数用户使用。首先打开 DeepSeek 官方的 API 管理地址，登录你的账号。如果你之前没有创建过 API Key，直接点击「创建 API key」，填写一个你方便识别的自定义名称，创建完成后就会得到一串以 sk-开头的密钥。
⚠️ 这里一定要注意：这个 API Key 只会在创建的时候完整显示一次，创建后务必立刻复制保存到本地，如果忘记保存，只能删除旧的重新创建新密钥。

三、配置 CC-Switch 配置工具

因为后续我们可能会切换不同的 API 渠道，手动修改 Codex 的配置文件非常麻烦，所以我推荐大家用 CC-Switch 这个工具，它支持 Claude Code、Codex 等多种 AI agent，核心作用就是帮我们快速切换不同配置，不用反复改文件。

1. 安装 CC-Switch：直接双击下载好的安装包，跟着提示完成安装即可，没有复杂的设置。
2. 新增 DeepSeek 渠道：打开 CC-Switch 后，点击顶部的 OpenAI 图标，再点击「+」号新增一个配置渠道。
3. 填入 API 信息：在预设供应商的下拉选项里选择 DeepSeek，往下滚动页面找到 API Key 的输入框，把刚才复制保存的 DeepSeek API Key 粘贴进去，确认信息无误后点击添加。
4. 开启本地路由：点击 CC-Switch 的设置按钮，找到「本地路由」选项，进入后需要开启两个必须的开关：分别是路由总开关和 Codex 开关。如果这两个开关不打开，Codex 就无法通过 CC-Switch 转发请求，肯定用不了。
5. 切换生效渠道：回到 CC-Switch 的主界面，在渠道列表里选中我们刚刚创建好的 DeepSeek 渠道。
6. 重启 Codex 客户端：重启之后客户端会重新读取本地的代理配置，完成后 Codex 就可以正常通过 DeepSeek API 调用大模型了。

四、Git 安装步骤

Git 是目前软件开发领域应用最广泛的分布式版本控制系统，由 Linus Torvalds 在 2005 年开发，它可以高效帮我们管理代码版本，记录所有修改信息，还支持分支开发和多人协作，Codex 生成的项目代码需要用 Git 做版本管理，这一步虽然看起来枯燥，但必须完成。

1. 双击你已经下载好的 Git 安装包启动安装程序。
2. 点击 Next 进入下一步。
3. 选择安装路径，推荐大家找 D 盘新建一个空文件夹存放，选好后点击 Next。
4. 选择安装组件，这里推荐大家把最后一个带「New!」标记的选项也勾选上，对后续开发会方便很多，勾选完成后继续点击 Next。
5. 后续连续点击 Next，直到出现默认编辑器选择界面，选第二个选项就可以。
6. 继续保持默认点击 Next，最后点击 Install 等待安装完成就可以了。

五、Codex 新手入门操作

打开 Codex 的时候，如果一直停留在启动图标界面，首先检查你的网络连接是否正常。刚进入 Codex 的时候，界面可能默认显示英文，不用着急，后续会根据你的系统语言自动切换，不影响我们操作。Codex 的基础界面结构很简单：主界面左侧是工具栏，右侧是对话输入区，顶部是菜单栏。

1. 创建专属工作空间：你可以先在电脑本地建立不同项目的独立文件夹，比如我自己常用的命名是 codex-shop、codex-list，把建好的文件夹直接拖到 Codex 的左侧区域，就可以添加为独立的工作空间；也可以通过「添加新项目」选项手动选择现有文件夹。多个工作空间分开承载不同任务，可以避免不同项目的内容互相混淆，方便管理。

2. 创建多个并行任务：在当前项目里输入需求提交，就启动了第一个任务。如果你需要同时处理其他任务，点击左上角的「新建对话」就可以，Windows 系统也可以按快捷键 Ctrl+N，macOS 按 Command+N，然后选择对应的项目提交新需求就行。左侧的任务列表会同时显示所有任务的执行状态，主要分为三种：
• 进行中：代表 Codex 正在处理当前任务
• 等待批准：代表当前任务有创建文件、下载内容、申请权限这类需要用户确认的操作，必须你手动处理后任务才会继续，不会自动往下走
• 完成：代表当前任务已经执行结束

1. 创建无项目归属的通用对话：新建对话后选择「不使用项目」，再输入你的问题就可以。这类对话不会绑定任何工作空间，会统一放在左侧的普通对话区域，适合不需要读写具体项目文件的通用咨询。

六、Codex 核心功能模块详解

1. 用内置浏览器预览页面：选中你要预览的目标对话，点击右侧功能区的图标，再点击加号选择「浏览器」，输入本地访问地址就可以预览，或者你也可以直接点击对话中生成的 index.html 链接，就能直接在 Codex 右侧预览生成的页面效果。

1. 搜索历史对话：点击左侧菜单栏的搜索按钮，或者按快捷键 Ctrl+G 就可以打开对话搜索功能，输入关键词后就能找到标题匹配的历史对话记录。⚠️ 注意：这个功能目前只能搜索对话标题，没办法搜索对话正文内容。

1. 对话重命名：双击你要修改的对话标题，输入方便你识别的新名称保存就可以。建议大家给重要对话的标题加上项目名、功能名或者特殊标记，后续搜索的时候可以快速定位。

1. 归档和恢复对话：点击对话后方的归档按钮，确认后对话就会从当前列表移动到归档列表里。需要恢复的时候，打开「设置→已归档对话」，找到目标对话点击「取消归档」，对话就会回到原来的列表里。不用的对话及时归档，需要的时候再恢复，能帮你更清晰地管理会话列表。

5. 权限管理设置：新建或者打开一个对话后，在输入框下方就能找到权限菜单。Codex 会默认把当前项目文件夹作为沙箱，提供三种权限模式：
• 默认权限：允许 Codex 读写当前项目文件夹内的文件，但是不能修改沙箱外的文件，也不能直接执行需要外部网络的操作；如果需要访问外部文件、联网下载或者申请额外权限，Codex 会主动发起提权请求，得到你的批准后才能继续操作。⚠️ 注意：这里的权限限制是由运行环境强制执行的，不是只提示模型自己遵守，安全性有保障。
• 自动审查：这个模式会自动检查提权操作的风险，低风险操作直接自动放行，高风险操作才需要人工确认，既可以减少频繁审批的麻烦，又保留了必要的安全控制，是日常使用最推荐的模式。
• 完全访问权限：这个模式会解除沙箱限制，允许 Codex 访问修改项目外的文件、使用网络，执行更多更广的电脑操作。首次启用需要你在警告对话框里手动确认。⚠️ 注意：完全访问权限的风险比较高，教程建议日常优先使用自动审查，只有你清楚操作范围和后果的时候，再开启完全访问权限。

1. 节省 Token 消耗：点击对话里的上下文使用量图标，就能查看你已经使用的空间、剩余空间和总容量。当上下文使用达到上限的时候，Codex 会自动压缩历史信息；你也可以输入「/」然后选择「压缩」，手动触发上下文压缩。⚠️ 注意：压缩之后仍然会保留部分关键历史信息，不会全部删除。如果你要开始新的业务或者任务，推荐直接新建对话，既能减少旧信息对模型的干扰，也能避免不必要的 Token 消耗。

1. 添加参考资料：点击输入框附近的加号，选择要添加的图片或者文件上传就可以，也可以复制图片或文件后直接粘贴到输入区域。添加的资料会作为提示词的补充信息，帮助 Codex 更准确地理解你的任务背景和预期结果。

七、Codex 任务控制与方向引导

如果在任务执行过程中，你发现 AI 理解的方向不对，一定要及时人工干预，让它停止当前方向，按照你的新要求继续执行，这个操作我们一般叫做 steer，可以理解为给 AI「掌舵」，调整方向。

1. 输入新的引导要求：如果 Codex 还在执行当前任务，你可以直接输入新的要求，比如举个例子「把这个模块的文案改得更温馨一点」，提交之后点击「引导」按钮，Codex 就会暂停原来的执行方向，直接按照新的要求修改。这里要区分两种情况：如果你只输入新消息不点击「引导」，Codex 会先把上一个任务执行完，再排队处理新任务；如果点击了「引导」，Codex 会直接暂停当前任务，优先执行你刚刚输入的新要求。

1. 修改默认跟进行为：如果你想调整后续新消息的默认处理方式，可以打开 Codex 的「设置」，进入「常规」选项，往下翻找到「跟进行为」，这里有「排队」和「引导」两种模式可以选择。⚠️ 注意：如果把默认模式改成引导，后续你输入的任何新消息都会直接打断当前任务，所以教程更推荐大家默认用排队模式，遇到方向不对的时候再手动点击引导就可以。

八、Codex 计划模式使用方法

打开 Codex 新建一个对话，在输入框左侧点击加号，选择「计划模式」就能进入。计划模式的逻辑是：你先提交需求，Codex 不会立刻修改代码，而是先生成一份完整的执行计划，你确认计划可行之后，Codex 才会开始实施；如果计划不符合你的要求，你可以随时调整，直到满意再执行。

提交需求之后，Codex 会生成完整的计划，告诉你它准备怎么做，要改成什么样。你看完计划，如果没有问题，就选择「实施此计划并提交」；如果不满意，Codex 会继续停留在计划模式，等待你补充或者调整要求。计划模式特别适合这些场景：首次搭建项目、重大代码重构、框架迁移、技术栈升级、复杂 Bug 修复这类多步骤的复杂任务。简单的小修改可以直接让 Codex 执行，复杂任务一定要先用计划模式确认整体方案，能少踩很多坑。

除了计划模式，还有批注模式可以帮你精确修改页面：你在右侧浏览器预览页面的时候，点击「批注」，选中你要修改的区域，比如你选中商品价格区域，输入「当前价格太高，改成 20 块钱」，点击对勾确认之后发送给 Codex，Codex 就只会修改你指定的这个区域，完成后页面的价格就会自动变成 20，非常精准。

九、Codex 代码管理技巧

Codex 本身不是传统的 IDE，不会提供完整的代码编辑界面，如果需要你手动查看或者修改代码，可以把 Codex 和 VS Code 这类本机开发工具集成使用，非常方便。

1. 用 VS Code 打开 Codex 项目：在 Codex 里打开当前项目，比如 codex-shop，点击右上角的 VS Code 图标，就能直接在 VS Code 里打开 Codex 生成的项目代码，打开之后你就可以手动修改源码、文本或者配置文件，当然你也可以直接在 VS Code 里打开项目文件夹，效果是一样的。

1. 设置默认代码编辑器：点击右上角 VS Code 图标旁边的下拉箭头，就能看到你本机已经安装的所有开发工具，比如 VS Code、Cursor 或者其他 IDE，你可以直接选择要切换的默认编辑器；也可以进入设置，在常规选项里找到「默认打开目标」，设置默认使用的编辑器。

1. Git 初始化项目：在 Codex 里选中当前项目，让 Codex 帮你把项目初始化为 Git 仓库，并且自动排除不需要提交的文件。初始化完成后，项目里就会生成.git 目录，配合.gitignore 文件就能管理哪些文件需要提交，哪些需要忽略，非常省心。

1. 推送代码到远程仓库：如果你不需要远程仓库可以跳过这一步。打开浏览器访问 Gitee，登录你的账号之后点击右侧加号，选择「新建仓库」，填写仓库名称、归属、存储路径和简介，其他选项保持默认就可以，点击创建就完成了远程仓库的搭建，创建好之后就可以用来托管你当前的项目代码，Gitee 的使用方法和 GitHub 是一样的。

1. 代码回滚操作：当代码多次修改提交之后，如果你发现某一次修改不符合预期，可以通过 Git 版本记录配合 Codex 的分叉功能回到之前的正确状态。这里要区分两个概念：分叉只能回滚对话历史，代码回滚还需要你明确指定对应的 Git 提交记录。

1. 通过分叉回滚对话历史：如果你想要回到修改前的状态，先找到上一次正确提交对应的对话位置，点击这个位置附近的分叉按钮，选择「派生到本地」，Codex 就会生成一个新的对话窗口，保留分叉点之前的所有对话内容。⚠️ 注意：这个操作只回滚了对话历史，代码本身还没有回滚，还要做下一步操作。

1. 复制 Git 哈希回滚代码：打开 VS Code 左侧的源代码管理面板，找到你想要回到的那一次提交，比如初始化提交，右键点击选择「复制提交哈希」，然后回到 Codex，把复制好的提交哈希发给 Codex，告诉它「把代码回滚到这个提交的版本」，Codex 就会根据这个哈希把代码回退到你指定的版本了。

十、Codex 记忆系统使用教程

每次开启新对话，Codex 都会进入新的上下文环境，大概率不会记得你之前说过的项目背景，为了避免每次都要重复说明项目情况，你可以用 Codex 的记忆系统把项目规则、工作约束、你的个人偏好都保存下来，一劳永逸。

Codex 的记忆系统主要有两种形式：一种是项目级记忆，在当前项目的根目录创建 AGENTS.md 文件，这个记忆只对当前项目生效；另一种是全局记忆，在 Codex 的个性化设置里配置自定义指令，对所有项目都生效。

1. 创建项目级 AGENTS.md：打开当前项目的根目录，新建一个文件命名为 AGENTS.md，⚠️ 注意：文件名里的 AGENTS 建议用大写，这样才能保证 Codex 正确识别这个项目级规则文件。在文件里写入你想让 Codex 记住的当前项目信息，比如项目背景、你的偏好、工作约束都可以。如果你不想手动整理，也可以让 Codex 帮你做，直接给 Codex 发指令：「通读当前项目，把你学到的项目信息整理保存到 AGENTS.md 文件，用中文清晰表述」，完成之后文件里就会自动生成项目概览、运行命令、关键文件、页面结构这些信息，非常方便。

1. AGENTS.md 应该写哪些内容：AGENTS.md 是给 Codex 看的项目规则文件，适合放这些内容：工作约束、验证命令、风险边界、包管理器类型、测试命令、构建命令、代码风格要求、提交前检查规则、特定目录的例外规则。⚠️ 注意：AGENTS.md 不是越长越好，不建议放长篇产品文档、历史会议纪要、临时任务列表、密钥、账号、Token，还有那些可以通过命令自动发现的信息也不用放，避免占用不必要的上下文。

1. 配置全局自定义指令：打开 Codex 的设置，进入个性化选项，找到自定义指令，在这里写入所有项目都需要遵守的工作约定，比如「修改 JS 文件后必须运行 npm test」「安装依赖优先使用 pnpm」「添加新的生产依赖前必须先和我确认」，写完之后点击保存就可以了，所有项目都会遵守这些规则。

十一、Codex 插件与自动化任务

插件可以把第三方服务的能力接入 Codex，扩展 Codex 的功能；自动化可以帮你把重复的任务设置成定期自动执行，解放双手。下面我们用 GitHub 和 Gmail 插件做一个演示。

1. 安装 GitHub 和 Gmail 插件：点击左侧菜单栏的「插件」，在插件市场里找到 GitHub，点击加号安装，安装的时候按照提示登录 GitHub 账号，完成授权。之后再找到 Gmail 插件，同样点击安装，完成你的 Google 账号授权就可以。

1. 确认插件安装成功：回到对话输入框，输入「/」打开可调用能力列表，如果能看到 GitHub 和 Gmail 两个选项，就说明两个插件都已经安装成功，可以正常调用了。

1. 组合插件完成任务：你可以在对话里同时调用 GitHub 和 Gmail，给 Codex 发需求：「帮我查询 GitHub 上最近一个月 AI 相关项目中 Star 增长最多的前 10 个项目，整理好之后通过 Gmail 发送到我的邮箱」，任务完成之后你打开 Gmail 查看，就能收到整理好的项目列表，说明插件可以正常工作。

1. 设置自动化任务：你可以给 Codex 发指令，类似「把刚才这个任务设置成自动化，每周五下午 5 点半发送到我的邮箱」，Codex 就会根据你的描述自动创建自动化任务。

1. 查看编辑自动化任务：点击左侧菜单栏的「自动化」，就能看到你刚刚创建的任务，进入编辑页面，你可以修改运行环境、绑定项目、重复时间、使用的模型、推理强度，也可以点击「立即运行」测试任务是否正常。⚠️ 注意：这类重复的信息收集任务，一般不需要选最高级的模型，选成本更低的模型就可以满足需求，能帮你省不少费用。

十二、Codex Skills 使用教程

这里我们不展开 Skills 的底层原理，直接给大家演示三种常见的使用方案：官方 Skills、第三方 Skills、自己编写的 Skills。

1. 找到并安装官方 Skill：打开 Codex 左侧的「插件」，切换到「技能」页面，在技能列表里找到官方提供的 PDF Skill，如果还没安装就先安装，已经安装好了就可以直接用。

1. 调用官方 PDF Skill 生成文件：在对话输入框输入「/」，选择 PDF Skill，然后提出你的需求，比如「在当前目录下创建一个 PDF 文件，把所有历史对话都放进去」，等待 Codex 执行完成之后，打开生成的 PDF，检查内容是否正确就可以。

1. 安装第三方 Skill：下载好第三方 Skill 之后先解压，然后创建一个项目目录，比如命名为 CodexSkills，在目录里创建.codex\skills 路径，把解压好的 Skill 文件夹复制到这个 skills 目录里就完成安装了。

十三、Codex MCP 配置教程

MCP 全称是模型上下文协议，可以理解为给 AI 大模型准备的标准化工具箱，用来连接第三方文档、外部工具和共享信息，我们这里以接入 GitHub MCP 为例给大家演示。

Codex 本身可以通过 Git 命令做基础的版本管理，但是创建 PR、管理 Issue、查看 PR 评论这类操作，更适合通过 GitHub API 完成，所以我们可以借助 GitHub MCP 扩展 Codex 的能力。

1. 进入 MCP 服务设置：打开 Codex，点击左下角的设置，进入设置页面后找到 MCP 服务，点击「添加服务器」。MCP 支持本地部署和远程 HTTP 两种方式，我们这个演示选择远程方式。

1. 填写 GitHub MCP 服务信息：选择流式 HTTP，填写服务器名称，比如命名为 github_mcp_server，再粘贴 GitHub MCP 的 URL 地址，之后需要填写你的 GitHub Token 作为访问令牌。

1. 创建 GitHub Token：打开 GitHub，点击头像进入菜单里的 Settings，找到 Developer settings，进入 Token 页面创建新的 Token，填写 Token 名称，比如 Codex-GitHub，选择授权时长，按照你的需求勾选权限范围，最后创建完成复制 Token。⚠️ 注意：Token 属于敏感凭证，一定不要公开分享，也不要写到项目代码或者普通文档里，避免泄露。

1. 保存配置重启 Codex：回到 Codex 的 MCP 配置页面，把复制好的 Token 粘贴到令牌位置，其他配置保持默认，点击保存，保存之后退出 Codex 再重新打开，让 MCP 配置生效。

1. 验证 MCP 是否正常工作：在 Codex 里输入需求，比如「用 GitHub MCP 帮我查看当前项目最近的 5 个 Issue，按照优先级排序」，如果你的仓库里没有 Issue，会返回空列表；你添加 Issue 之后再次查询，如果能正常返回问题列表和优先级排序，就说明 MCP 已经正常工作了。

十四、Codex 常见问题解答

1. 设置中文无效怎么办：安装 Codex 之后，Codex 需要请求 OpenAI 下载中文语言包，如果你没有代理，就算在 Codex 里设置中文也不会生效，这是正常情况。

2. Codex 怎么配置代理：如果你用账号直接接入 Codex，必须给 Codex 配置代理，不然发任何消息都会一直显示 Reconnection，无法正常使用。配置方法很简单，在.codex 目录创建一个.env 文件，写入以下内容：
HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890
ALL_PROXY=http://127.0.0.1:7890
NO_PROXY=localhost,127.0.0.1
保存之后就生效了。

最后提醒大家：Codex 现在更新迭代很快，本教程是基于当前最新版本整理的，如果后续界面有调整，请以实际版本为准。遇到问题不用慌，大部分问题都是网络或者权限设置的问题，日常使用建议多开计划模式确认方案，谨慎使用完全访问权限，就能避开大部分坑。