## 最近，一直有小伙伴问我，codex怎么装？

我基本都是一个一个回的，但是架不住人越来越多，然后再加上最近这个也比较火，我干脆直接放一篇文章来讲一下这个部分。

这个东西， 如果是玩AI编程的应该用的毕竟多，有时候看着别人用 AI 编程日入斗金，敲两句中文就把软件跑起来，以为自己也能行。

结果兴冲冲一装，在 Windows 上报错报得像天书，被 Git、环境变量直接卡死，把电脑折腾成"垃圾堆"。

其实，你不需要懂复杂的编程环境，也不需要去死磕命令行。今天我把 Windows 安装这玩意踩过的坑整理出来，带你 0 到 1 极速通关。

以前我刚接触 AI 编程时，也经常被这套繁琐的环境配置搞得头大。好在踩出了一条傻瓜式速通路线，能让你省去一整天跟报错死磕的无意义损耗。

下面直接上硬货，跟着这套流程有手就行！

**本文内容大纲导航**

**第一部分：Codex 到底是什么东西？**

*   Codex 到底是不是你认识的那个老 Codex
*   从零看懂 Codex 在本地电脑 the 定位
*   Windows 用户 vs Mac 用户有哪些差异

**第二部分：准备工作与前置门槛**

*   到底需要什么级别的 ChatGPT 账号
*   为什么没有稳定的科学网络就无法登录
*   电脑系统有什么硬性指标
*   容易踩坑的两大前置依赖（Git 与 Node.js）

**第三部分：三种安装方式演示**

*   微软商店 Microsoft Store 一键安装（最推荐小白）
*   官网直接下载安装包
*   开发者 CLI 命令行与 SDK 部署

**第四部分：Windows 避坑与报错排除**

*   缺少 Git 环境的红色报错如何解决
*   遇到系统安全拦截与沙箱拦截如何放行
*   中文路径引起的乱码错误如何规避
*   杀毒软件与防火墙白名单添加
*   常见闪退、打不开问题的排除

**第五部分：首次登录与账号绑定**

*   手把手带你登录 OpenAI 账号
*   Plus、Pro 与企业账号的额度差异
*   登录进入后的首个配置习惯

**第六部分：Codex 界面布局拆解**

*   左侧栏（Chat 历史与 Projects）
*   中间对话区（@引用与计划模式）
*   右侧沙箱终端（Diff 预览与任务状态）
*   顶部菜单栏与基础设置
*   普通对话模式与项目模式该怎么选

**第七部分：Projects 项目功能精髓**

*   为什么项目功能才是 Codex 最好用的地方
*   如何创建并绑定第一个本地项目
*   拖入文件夹后 Codex 会执行哪些底层操作
*   认识 AGENTS.md 说明书文件

**第八部分：Skills 技能包与插件扩展**

*   什么是 Skill？它跟直接对话有什么区别
*   认识 Codex 预设的常用默认 Skill
*   第三方插件安装演示（以 Chrome 控制为例）
*   什么时候该写 Skill？

**第九部分：记忆系统与跨对话上下文**

*   Codex 怎么建立短期和长期记忆
*   如何从 Claude Code 导入迁移配置
*   手动维护 memory.md 记忆文件的绝招

**第十部分：高频问题解答 (FAQ)**

*   Codex 跟 Claude Code、Cursor 区别
*   关于额度收费的细节
*   Windows 版与 Mac 版的功能对比
*   API Key 的接入与利弊

**结语**

### 第一章：Codex 到底是什么东西？

#### 1.1 它不是你认识的那个老 Codex

很多人一听到"Codex"这个名字，脑子里冒出来的可能是几年前 OpenAI 推出的一个"代码生成 API"。

![Pasted image 20260608191002.png](/media/202608/6b51fa322a574081b5685e7237839ef98102.png)

Pasted image 20260608191002.png

那玩意早就退出历史舞台了。

现在我们说的 Codex，是 2026 年 OpenAI 全新推出的**独立桌面 AI 智能体产品**。

一字之差，差之千里。

旧 Codex：你调 API 接口，它给你补代码，本质就是一个代码补全服务。

新 Codex：它是一个能直接跑在你本地电脑上的**全能 AI 工作站**，能自己读懂你的整个项目，自己写代码、自己运行、自己检查报错、自己迭代修改，直到把事情搞定。

你就是包工头，Codex 是你雇的全自动施工队。

你说"把这个网页的登录界面改成深色模式"，它就在你电脑里自己写、自己改、自己测，全自动完成。你不用动一行代码。

这才是 2026 年那波 AI Agent 浪潮里，OpenAI 砸出来的核弹级产品。

![局部截取_20260608_191017.png](/media/202608/d15295b20c3a482880642eb10438a9ca4741.png)

局部截取\_20260608\_191017.png

#### 1.2 先说说它的定位

我知道很多人一听"AI Agent"就犯晕，觉得这词太玄乎。

用最接地气的方式解释：

Codex 就像是你招来的一个**本地实习程序员**，区别在于，它：

*   不需要工资
*   24小时在岗
*   从不犯"听不懂需求"这种人类低级错误
*   能同时开多个任务并行处理（你吃饭去了它还在帮你跑）

你把项目文件夹给它，用中文告诉它你想做什么，它就自己在你电脑里的"工作间"里干活。

工作间里发生的一切你都能实时看到——它写了哪些代码、跑了哪些命令、报了什么错、又怎么修的。

整个过程完全透明。

所以它不是你"聊天用的 AI"，也不是什么"问答助手"。

它是一个能落地干活的、跟你电脑深度集成的**本地 AI 工作伙伴**。

前段时间龙虾很火，那个其实就是一个典型的agent，而现在，codex也基本朝这个靠近了。

![Pasted image 20260608191305.png](/media/202608/f30b42933cfb48e2bea8b8e6e2de341b9308.png)

Pasted image 20260608191305.png

#### 1.3 Windows 用户 vs Mac 用户，有哪些差异要提前知道

这里必须说一个现实：Codex 本身是全平台支持的，Mac 和 Windows 都能装。

但从体验上来说，早期版本对 Mac 更友好。

这不是因为 OpenAI 歧视 Windows 用户。

是因为 Mac 底层是 Unix 系统，很多开发者工具链（比如 Homebrew、bash 脚本、文件权限管理）在 Mac 上跑起来几乎零阻力，而 Windows 有一套自己的底层规则，偶尔会跟 Codex 的沙箱机制摩擦出火花。

具体来说，Windows 用户多了这几样额外门槛：

**① 需要手动安装 Git**（Mac 一般自带或一行命令搞定，Windows 需要单独下载安装程序）。

**② 路径格式不同**（Windows 的路径用反斜杠，Unix 系统用正斜杠，Codex 内部有时候会搞混，导致莫名其妙的路径报错）。

**③ 安全沙箱限制更严**（Windows Defender 和 UAC 权限管理会在 Codex 要执行某些本地操作时跳出来拦截，需要手动放行）。

**④ 中文路径是隐藏炸弹**（如果你的 Windows 用户名或者项目存放路径里带有中文字符，Codex 的某些工具链会识别失败，这一点 Mac 用户完全不会遇到）。

提前知道这几条，你后面装的时候就不会慌。

碰到了，对照着处理就行，都是有解的。

### 第二章：开始之前，你需要准备什么？

#### 2.1 账号门槛：ChatGPT 什么等级的账号才能用

先说最关键的：**Codex 不是独立收费的产品，它的使用额度直接挂靠在你的 ChatGPT 账号上**。

这一点很多人搞不清楚，以为 Codex 要单独买，其实不是。

你登录 Codex 用的就是你的 OpenAI 账号，用量也从你的账号额度里扣。

那各等级账号有什么区别？

**免费用户（Free）**：可以体验 Codex 基础功能，但 Agent 执行复杂任务的额度非常有限，跑几下就触顶，主要用来尝鲜。

**Plus 用户（月付 $20）**：目前来说是最主流的入门门槛，日常个人用途基本够用，能跑中等规模的代码任务，偶尔遇到大型项目会触到速率限制。

**Pro 用户（月付 $200）**：解锁了最高等级的模型（目前是 GPT-5.5 Pro）和更大的 Agent 执行配额，适合重度使用的开发者，长时间跑大项目不带停。

**Business / Enterprise**：团队级套餐，按座位收费，能配置更多权限隔离和 API 访问策略，适合公司团队批量使用。

![Pasted image 20260608191452.png](/media/202608/f35b424ca97b49a4a14ee0d4e93a8a964726.png)

Pasted image 20260608191452.png

![Pasted image 20260608191503.png](/media/202608/8f4348186d154d06b461987e9721c9611460.png)

Pasted image 20260608191503.png

如果你刚开始上手，Plus 会员完全够用了。

实在不想花钱，就用免费账号先摸摸门路，感觉上手了再升级也不迟。

#### 2.2 网络门槛：

这个要说清楚。

Codex 是 OpenAI 的产品，OpenAI 的服务在国内是被屏蔽的。

不管你用什么安装方式——Microsoft Store、官网直接下载、还是命令行——**没有稳定的科学工具，你连第一步登录都完成不了**。

而且这里要强调一点：Codex 不只是你打开的时候需要使用工具，它在后台执行任务的过程中也需要实时联网，因为每一步 Agent 的推理都要调用 OpenAI 的服务器。

所以你要准备的不是"能偶尔上 Google"那种随随便便的工具，而是**稳定、低延迟、能跑得动 AI 推理请求的那种**。

如果你在用 Codex 的时候发现任务跑着跑着突然卡住不动了，或者报连接超时的错误，大概率是连接不稳定，先排查网络再排查其他问题。

#### 2.3 Windows 系统要求：Win10 还是 Win11 有没有区别

官方的最低要求是 **Windows 10（64位，1903 及以上版本）**。

大部分还在用 Win10 的用户，系统已经更新到足够的版本了，问题不大。

但如果你的 Win10 还停在 2018、2019 年的早期版本，建议先把系统更新一下，避免一些底层 API 不兼容的问题。

Windows 11 用户？直接装，没有任何额外障碍。

另外有一点要注意：**Codex 是 64 位应用，不支持 32 位系统**。不过现在 32 位 Windows 用户已经极少见了，基本可以忽略。

#### 2.4 容易踩坑的两大前置依赖：Git 和 Node.js

这是 Windows 用户最容易忽略的一步，也是后面最高频报错的根源。

**Git——Codex 的文件管理基础**

Codex 在分析和操作你的项目文件时，底层会依赖 Git 来追踪文件变更、管理版本。

如果你的 Windows 电脑没装 Git，Codex 在初始化项目的时候就会直接报错罢工。

怎么查你有没有装？

打开 Windows 的命令提示符（CMD）或者 PowerShell，输入这个命令：

git --version

如果返回了类似 `git version 2.x.x` 的字样，说明已经安装好了。

![局部截取_20260608_191704.png](/media/202608/cdd89bc6be7f4b629e3fcdfd9345b8864737.png)

局部截取\_20260608\_191704.png

如果提示"不是内部或外部命令"，就说明没装。

去 **git-scm.com** 下载 Windows 版本的 Git 安装包，双击运行，所有选项保持默认，一路 Next 就行，整个过程 3 分钟搞定。

![图①：git-scm.com 官网下载](/media/202608/62b8b16dbb2d450faac6e15ae0457fab5335.png)

图①：git-scm.com 官网下载

**Node.js——部分插件功能的运行基础**

Node.js 不是所有场景都必须的，但 Codex 的一些插件（尤其是涉及前端网页和自动化脚本的功能）会在后台调用 Node 环境。

提前装好，省得用到了再回头来补。

去 **nodejs.org**，下载 LTS（长期支持）版本，同样双击安装，选项保持默认。

安装完以后同样在命令行里验证一下：

node --version npm --version

两个都返回版本号，就是装好了。

![局部截取_20260608_191726.png](/media/202608/a06b31bf363440989f0cef186b6ca2881822.png)

局部截取\_20260608\_191726.png

### 第三章：三种安装方式，哪个最适合你？

Codex 在 Windows 上有三条安装路线，适合不同类型的用户。

我把这三种方式按从简单到复杂的顺序排列，你根据自己的情况选一个就行。

#### 3.1 方式一：Microsoft Store 商店一键安装（最推荐小白）

这是最省心的方式，完全不需要动脑子。

按这个流程走：

**第一步**，点开 Windows 任务栏里的 Microsoft Store（就是那个购物袋图标），或者直接在开始菜单里搜索"Microsoft Store"。

**第二步**，在商店搜索框输入 **OpenAI Codex**，找到带有 OpenAI 官方图标的那个应用。

![ApplicationFrameHost.exe_20260608_192450.png](/media/202608/0ad2d83b7d4f4ef88d2f9af454401f735017.png)

ApplicationFrameHost.exe\_20260608\_192450.png

**第三步**，点击"获取"，等待下载和安装完成。整个过程自动完成，不需要你做任何额外配置。

优点：自动更新、系统级集成做得最好、安装包经过微软签名验证最安全。

有一个常见问题：有的用户在 Microsoft Store 里搜不到 Codex，原因是商店的地区设置问题。

解决办法：按 Win+I 打开设置，进入"时间和语言"→"地区"，把地区改成**美国**，重新打开 Microsoft Store 就能搜到了。

![图③：Windows 设置中的地区切换界面](/media/202608/8b195381c2864c38830b92e114cf997c6862.png)

图③：Windows 设置中的地区切换界面

#### 3.2 方式二：官网直接下载 .exe 安装包

如果 Microsoft Store 搜不到，或者你习惯从官网直接下载软件，用这个方式。

**第一步**，打开浏览器，挂上魔法，访问：**openai.com/codex**

你会看到页面上有下载按钮，选择 Windows 版本，下载 `.exe` 格式的安装包。

![局部截取_20260608_191840.png](/media/202608/e9be1ab24e6348d5b7cd1d527172d9838292.png)

局部截取\_20260608\_191840.png

**第二步**，下载完成后，双击 `.exe` 安装包。

这里 Windows 可能会弹出一个 UAC 提示："是否允许此应用对设备进行更改？"，点击**是**，允许安装程序运行。

**第三步**，安装程序会自动完成剩余步骤，安装完成后桌面出现 Codex 图标，双击打开。

这种方式的版本可能比 Store 版稍早一点，因为 Store 的审核有时候会滞后几天，但通常影响不大。

![Codex Installer.exe_20260608_192007.png](/media/202608/a19073ecb748429e90a8833d90e37b1b8328.png)

Codex Installer.exe\_20260608\_192007.png

#### 3.3 方式三：命令行 CLI 模式安装（进阶程序员）

这个方式是给有开发背景的人准备的，普通用户可以跳过这一节。

Codex 除了桌面客户端，还提供了一个命令行版本，通过 npm 安装：

npminstall-g openai-codex

![局部截取_20260608_192052.png](/media/202608/e28ba56449484f2ba1dfdad1655dff7f5485.png)

局部截取\_20260608\_192052.png

安装完成后，在命令行里输入 `codex` 就能直接启动一个 CLI 交互界面，不需要打开图形化客户端。

CLI 版本的优势是：

*   可以直接集成到脚本和自动化流程里
*   适合在服务器或者远程环境下运行
*   对有 VSCode、Neovim 等编辑器工作流的开发者来说，不需要在客户端和编辑器之间来回切换

另外，OpenAI 也发布了 **Python SDK**：

pip install openai-codex

这让你可以在 Python 脚本里直接调用 Codex 的能力，复用你的登录状态，把 AI Agent 的能力内嵌进你自己的应用。

如果你不知道这段在说什么，跳过就行，用图形界面客户端完全足够。

### 第四章：Windows 专属避坑指南（必看！）

这章是整篇文章含金量最高的部分。

Mac 用户可以没有这一章，但 Windows 用户不能。

我把装 Codex 最高频的五类报错和解决办法全部整理在这里，遇到了对着查就行。

#### 4.1 没装 Git 会怎样？——红字报错全解析

这是 Windows 用户最高频遇到的第一个坑。

症状：打开 Codex，把一个本地文件夹拖进项目区，右侧终端立刻冒出红色报错：

'git' is not recognized as an internal or external command, operable program or batch file.

或者：

Error: Git executable not found. Please install Git.

原因：Codex 在初始化项目时会调用 Git 来扫描文件结构、追踪版本变化，Git 没装，这一步就直接断掉了。

解决方案：

1.  去 **git-scm.com/download/win** 下载 Git 安装包
2.  双击安装，所有选项保持默认，一路 Next
3.  安装完成后，重启 Codex（不只是关掉窗口，要彻底退出右下角托盘里的进程，再重新打开）

安装完后在 CMD 里输入 `git --version` 验证，看到版本号就代表成功。

#### 4.2 安全沙箱弹框来了别慌，这是什么东西？

当 Codex 尝试在你的电脑上执行代码（比如跑一段 Python 脚本、安装一个 npm 包）的时候，Windows 会弹出提示框。

常见的有两种：

**UAC 提示**："是否允许此应用对设备进行更改？"

这个是 Windows 内置的用户账户控制机制，它在问你：Codex 想要修改你电脑上的文件，你同意吗？

**直接点"是"**，这是正常流程。

**Windows Defender 拦截**：Defender 有时候会把 Codex 自动生成并执行的脚本判定为"不明来源的可执行文件"而拦截掉。

解决方案：在 Windows 安全中心→病毒和威胁防护→管理设置里，把 Codex 的安装目录（通常在 `C:\Users\你的用户名\AppData\Local\Programs\Codex\`）添加到**排除项**里，之后 Defender 就不会再拦截它了。

![图④：Windows 安全中心排除项设置界面](/media/202608/c4172ceaaa4e4848a577d1f0d0311d138789.png)

图④：Windows 安全中心排除项设置界面

#### 4.3 路径带中文是一个隐形炸弹

这个坑非常隐蔽，而且很难被新手察觉。

症状：Codex 打开了，看起来一切正常，但当它尝试读取某个文件或者执行某个任务的时候，报出奇怪的乱码错误，或者提示"路径无效"。

根本原因：**你的 Windows 用户名是中文，或者项目文件夹存放在带有中文字符的路径里**。

比如你的用户名是"张三"，那你的用户目录就是 `C:\Users\张三\`，Codex 某些工具链在处理这条路径时会解析失败。

又比如你把项目放在了 `D:\我的项目\Codex测试\` 这样的路径里，同样会出问题。

解决方案有两个：

**方案一（推荐）**：把所有 Codex 项目统一放在纯英文路径下，比如 `D:\Projects\codex-test\`，从源头避开这个问题。

**方案二（治本）**：如果你的 Windows 用户名是中文，可以新建一个纯英文用户名的账户，用那个账户来跑 Codex。

#### 4.4 防火墙和杀毒软件拦截，怎么放行？

有的用户安装了第三方杀毒软件（比如火绒、卡巴斯基、360等），这些软件对"陌生程序联网"和"本地脚本执行"非常敏感。

Codex 启动时需要联网调用 OpenAI 服务器，运行时需要在本地执行各种脚本命令，两者都可能触发第三方安全软件的拦截。

解决方案：

在你使用的安全软件里，把 Codex 的主程序路径添加到**信任列表**或**白名单**里。

具体操作因软件而异：

*   火绒：安全中心→信任区→添加
*   360：隔离沙箱→信任程序
*   Windows Defender：如前面 4.2 所述，添加排除项

添加白名单后，重启 Codex 再试。

#### 4.5 安装完打不开，常见闪退怎么处理

症状：双击 Codex 图标，进度条一闪，程序直接消失，什么都没出现。

或者出现了启动画面，但几秒后闪退回桌面。

常见原因和对应处理：

**原因一：.NET 运行时版本不够**

Codex 依赖 .NET 运行时，如果你的系统里没有安装足够新的版本，程序会静默闪退。

处理：去微软官网下载最新版 **.NET Desktop Runtime**，安装后重启再试。

**原因二：显卡驱动太旧**

Codex 的界面渲染依赖 GPU 加速，某些老旧显卡驱动会导致渲染崩溃。

处理：去 NVIDIA 或 AMD 官网更新显卡驱动到最新版本。

**原因三：安装包损坏**

如果下载过程中网络不稳定，安装包可能不完整。

处理：删除 Codex，重新从 Microsoft Store 或官网下载，确保下载过程网络稳定。

### 第五章：第一次登录与账号绑定全流程

装好了，打开了，然后呢？

很多人卡在第一次登录这里——界面是英文的，弹出来一堆选项，不知道选哪个。

这章把整个登录流程手把手拆解清楚。

#### 5.1 打开 Codex，怎么登录 OpenAI 账号

**第一次打开 Codex，它会显示一个欢迎界面，上面有一个"Sign in"按钮。**

![Codex.exe_20260608_201745.png](/media/202608/e1a358a8be3145eeafba265bf48ef9b33262.png)

Codex.exe\_20260608\_201745.png

点击之后，它会打开你的系统默认浏览器，跳转到 OpenAI 的登录页面。

这里你有两个选项：

**① 用 OpenAI 账号直接登录（推荐）**

输入你注册 OpenAI 的邮箱和密码，登录即可。

登录完成后，浏览器会自动重定向，Codex 客户端会检测到登录成功，主界面随即解锁。

整个过程就像你在浏览器里登录 ChatGPT 一样，没有任何额外步骤。

![局部截取_20260608_201807.png](/media/202608/5feeaec5e8c644b3a10aea452e6dc1e29965.png)

局部截取\_20260608\_201807.png

**② 用 Google / Microsoft 账号授权（如果你的 OpenAI 是第三方登录的）**

如果你当初注册 OpenAI 用的是 Google 或者 Microsoft 账号快捷登录，在登录页面选对应的按钮就行，流程完全一样。

![图⑤：Codex 登录及浏览器弹出 OpenAI 登录页](/media/202608/2682df2af80c419baecbfa5eee1580565697.png)

图⑤：Codex 登录及浏览器弹出 OpenAI 登录页

登录完成后，回到 Codex 客户端，主界面会自动刷新，显示你的账号头像和名称，说明登录成功。

#### 5.2 Plus / Pro / 企业账号的额度有什么区别

登录完成之后，Codex 会根据你的账号等级自动激活对应的功能。

这里有几个重要的差异要了解清楚：

**模型版本**

Free 和 Plus 用户默认使用的是 GPT-4 系列，在 Codex 里对应的是标准 Agent 能力。

Pro 用户可以解锁更强的 GPT-5.5 Pro 模型，对于处理复杂的大型代码库、多文件联动任务，推理能力明显更强。

**并行任务数量**

这是一个很实用的区别。

Codex 支持同时开多个 Agent 任务并行执行，你可以让它同时处理"修复这个 bug"和"写这个功能的测试用例"两件事。

Free 用户同时最多跑 1 个任务。

Plus 用户可以同时跑多个任务（具体数量随 OpenAI 策略调整，目前一般是 5-10 个）。

Pro 用户并行任务数量更多，适合重度多任务处理场景。

**速率限制**

简单说就是：用得太猛会触发临时限速。

Free 和 Plus 在高强度使用时（比如连续让 Codex 跑大量代码任务），会遇到"Rate limit exceeded"的提示，需要等一段时间才能继续。

Pro 用户的速率限制阈值高得多，日常基本感觉不到限速。

#### 5.3 登录完成后，第一个界面长什么样

登录成功后，你看到的主界面是一个干净的三栏布局。

别被它的简洁骗了，这个界面里藏的功能相当多。

![Codex.exe_20260608_201843 2.png](/media/202608/6be0a0f38d094d358f66d65021fb5e766719.png)

Codex.exe\_20260608\_201843 2.png

我们在第六章里会完整拆解每一个区域的功能。

但在进入第六章之前，先做一件事：

**点击左上角的设置图标，进入 Settings**，把界面语言和 AI 回复语言的偏好都确认一下。

![Codex.exe_20260608_201954 1.png](/media/202608/46d9a1967ce941e3929636dba5817e861476.png)

Codex.exe\_20260608\_201954 1.png

Codex 默认是英文界面，但你在对话区发中文，它也完全能理解并用中文回复，这一点不用担心。

### 第六章：彻底认清 Codex 的界面布局

登录之后，映入眼帘的是一个看起来极简、但实际功能密度很高的主界面。

这章我们把每一块区域都彻底拆解清楚，让你做到"看一眼就知道这块是干嘛的"。

![Pasted image 20260608202200.png](/media/202608/ceadab19b3cd496cbc11f13b2c17066b5837.png)

Pasted image 20260608202200.png

#### 6.1 左侧栏：这是你的"监工文件夹"

左侧栏分成两部分：**对话历史**和**项目列表**。

**对话历史（Chat History）**

这里存放着你跟 Codex 的所有聊天记录。

跟 ChatGPT 一样，每开一个新对话，左侧就会多一条记录。你可以随时点回去翻看之前的对话，Codex 会记住那次对话的上下文。

**项目列表（Projects）**

这是 Codex 比普通 AI 聊天工具强大得多的地方。

你可以在这里添加本地文件夹作为"项目"，每个项目就像是 Codex 的一个独立工作空间。

当你选中某个项目进入后，Codex 会自动扫描这个文件夹里的所有文件，建立完整的文件结构图和依赖关系图。

然后你在中间的对话区发出指令，它就能"记住"你这个项目的全貌，给出精确的上下文相关的代码建议和修改方案。

这跟你把代码段粘贴给 ChatGPT 是完全不同的体验。

#### 6.2 中间区：这是你的"嘴巴"，用中文下命令的地方

中间区就是主要的对话输入区域，跟 ChatGPT 的聊天界面长得很像。

但有几个细节要注意：

**① 输入框支持拖拽文件**

你可以直接把文件（比如一张截图、一份 PDF、一个代码文件）拖进输入框，Codex 会读取并分析它的内容，然后根据你的指令去处理。

![局部截取_20260608_202301.png](/media/202608/358c89e7661e4cfba36e6e5f8b107b058353.png)

局部截取\_20260608\_202301.png

**② 支持 @ 引用**

在输入框里输入 `@`，会弹出一个菜单，可以引用当前项目里的特定文件、特定函数，让你精确告诉 Codex "就改这个文件里的这个部分"。

![局部截取_20260608_202315.png](/media/202608/17a4686707c64215b32070267b8757e32865.png)

局部截取\_20260608\_202315.png

**③ Plan Mode（计划模式）**

在输入框旁边有一个切换按钮，叫 **Plan Mode**。

开启后，Codex 在动手执行之前，会先输出一份"我打算怎么做"的行动计划，等你确认没问题了再开始实际执行。

对于重要的代码变更，强烈建议开启这个模式，避免它直接动了你不想动的地方。

![局部截取_20260608_202531.png](/media/202608/44c1256e49ae4ea180b57d66ace327366012.png)

局部截取\_20260608\_202531.png

#### 6.3 右侧区（沙箱终端）：这是 AI 的"手"，自动写代码的地方

右侧区是 Codex 最核心也最神奇的区域——**本地沙箱终端**。

当你在中间对话区发出指令后，右侧会出现：

**文件变更预览**：Codex 准备修改哪些文件、具体改了什么内容，以 diff（差异对比）的形式展示，绿色是新增内容，红色是删除内容。

**终端输出**：Codex 在你电脑里执行的所有命令都会实时显示在这里——它安装了什么依赖、运行了什么脚本、输出了什么结果、报了什么错。

**任务状态**：显示当前任务的执行进度，是在"思考中"、"执行中"还是"已完成"。

这个区域让你对 Codex 的每一步操作都做到心里有数，不是黑盒。

你可以随时点击"Stop"中断正在执行的任务。

执行完成后，右侧会有"Accept Changes"（接受变更）和"Reject Changes"（拒绝变更）按钮，你确认之后，修改才会正式写入你的文件。

这个机制非常重要：**Codex 的修改默认是可撤销的**，它在你确认之前不会真正改动你的原始文件。

![局部截取_20260608_203121.png](/media/202608/8b76673db3004a539629fd011f84d5607345.png)

局部截取\_20260608\_203121.png

#### 6.4 顶部菜单栏：设置、插件、模型切换都在这里

顶部菜单栏比较精简，但几个按钮都挺重要：

**新建对话**：开一个全新的空白对话窗口。

**模型切换**：点这里可以切换 Codex 使用的底层 AI 模型。如果你是 Pro 用户，可以在这里切换到 GPT-5.5 Pro。

**插件（Plugins）**：点开这里可以查看已安装的插件，以及从插件市场安装新的功能扩展。我们在第八章详细讲。

**设置（Settings）**：账号信息、主题切换（深色/浅色）、语言偏好、快捷键配置等都在这里。

![Pasted image 20260608203148.png](/media/202608/e65745bba51845e18989275e7a63b3228423.png)

Pasted image 20260608203148.png

#### 6.5 对话区 vs 项目区：两种模式的区别是什么

很多新用户搞不清楚一件事：什么时候该用普通对话，什么时候该创建项目？

我用一句话区分：

**普通对话区 = 零散的一次性任务**（写个脚本、解释一段代码、回答一个问题）。

**项目区 = 需要持续跟踪和修改的完整工程**（开发一个完整的网站、一个桌面应用、一个自动化系统）。

如果你只是想让 Codex 帮你写一段 Python 脚本，普通对话完全够用，不需要创建项目。

但如果你有一个实际的代码库，你想让 Codex 深度理解它的结构然后做持续的开发和维护，就应该创建项目，把代码库文件夹拖进去。

这样 Codex 每次回答你都能基于完整的项目上下文，而不是靠你临时粘贴代码片段来"盲猜"。

### 第七章：Projects（项目）功能深度认识

Projects 是 Codex 真正区别于普通 AI 聊天工具的核心功能。

很多人装完 Codex 之后只用它聊天，完全没有用过 Projects，等于只用了它 10% 的能力。

这章把 Projects 从头到尾讲透。

#### 7.1 什么是 Project，为什么要用它

一句话解释：**Project 是 Codex 跟你的本地文件夹建立深度绑定的工作空间。**

当你创建一个 Project 并绑定了一个本地文件夹后，Codex 会做这几件事：

**① 全量扫描文件结构**：读取文件夹里的所有文件，建立一张"地图"，知道哪些文件在哪里、互相之间有什么调用关系。

**② 建立代码索引**：对代码文件进行语义层面的理解，不只是知道文件名，而是理解每个函数、每个类是做什么用的。

**③ 持久化记忆**：你在这个 Project 里的所有对话和修改历史都会被保存，下次打开 Codex 继续工作时，它还记得你上次说到哪里、改到哪里。

这意味着什么？

意味着你可以告诉它"把上次那个登录功能里的 token 过期时间从 7 天改成 30 天"，它能直接定位到正确的文件和代码段，精准修改，不需要你再粘贴代码片段。

这才是真正的"AI 跟你一起工作"，而不是"你伺候 AI"。

#### 7.2 如何在 Windows 上创建你的第一个 Project

操作非常简单：

**第一步**：点击左侧栏的"New Project"按钮，或者在左侧栏空白处右键选择"Add Project"。

**第二步**：弹出文件夹选择对话框，找到你想绑定的本地文件夹，点击"选择文件夹"。

这里要注意前面说过的中文路径问题——如果你的文件夹路径里有中文，可能会出现问题，尽量选英文路径的文件夹。

![局部截取_20260608_203230.png](/media/202608/0e631dd5f75c42768cd60757e3c9dd818109.png)

局部截取\_20260608\_203230.png

**第三步**：Codex 开始扫描文件夹。这个过程取决于文件夹的大小，小项目几秒钟，大型项目可能需要一两分钟。扫描完成后，左侧栏会出现这个项目的条目，点进去就进入了项目工作空间。

#### 7.3 把本地文件夹拖进去，Codex 会做什么

很多人第一次把文件夹拖进去之后，看着右侧终端在"嗡嗡"运转，不知道它在干嘛。

我来逐步解释：

**阶段一：初始化（Initializing）**

Codex 首先会检查这个文件夹是否已经是一个 Git 仓库。如果不是，它会在你的文件夹里自动执行 `git init`，建立 Git 版本管理基础（这就是为什么前置安装 Git 这么重要）。

**阶段二：依赖扫描（Dependency Analysis）**

Codex 会读取项目里的依赖配置文件——Python 项目读 `requirements.txt`，Node.js 项目读 `package.json`，Go 项目读 `go.mod`——建立完整的依赖关系图。

**阶段三：代码索引（Code Indexing）**

Codex 对项目里的所有代码文件进行语义索引，这一步让它能理解"这个函数是干嘛的"，而不只是"这个文件叫什么名字"。

全部完成后，你就可以开始工作了。

#### 7.4 AGENTS.md 是个什么神秘文件

在一些 Codex 项目教程里，你会看到提到一个叫 `AGENTS.md` 的文件，它是做什么用的？

**AGENTS.md 是你给 Codex 写的"项目说明书"。**

你可以在项目根目录手动创建这个文件，在里面写上这个项目的背景信息、你的代码规范、你的偏好设置，比如：

*   这个项目用的是什么框架、什么语言规范
*   代码注释要求用中文还是英文
*   函数命名规则是驼峰式还是下划线式
*   哪些文件是只读的，不要去改
*   这个项目的核心功能是什么，背景是什么

Codex 每次在这个项目里工作时，都会优先读取 `AGENTS.md`，把这些规则当成自己的行为准则。

这相当于你给新来的实习生写了一份"入职培训手册"，让它从第一天起就按你的规矩干活，不用你每次都重复交代。

### 第八章：认识 Skills（技能包）与插件系统

Codex 的插件（Plugins）和技能（Skills）系统，是它能"无限扩展能力边界"的根本原因。

光靠默认功能，Codex 就已经很强了。

装上合适的插件，它能做的事情会超出你的想象。

#### 8.1 Skill 是什么，跟普通对话有什么区别

Skill 本质上是一套**预设的任务流程模板**。

普通对话是开放式的：你告诉 Codex 你想做什么，它自己想怎么做就怎么做。

Skill 是约束式的：它提前定义好了"这类任务该怎么一步步执行"，Codex 按照这个流程走，结果更稳定、更可预期。

打个比方：你让一个厨师"做点好吃的"，他可能做出各种各样的菜。但你递给他一份菜谱，他按步骤来，出品就会标准化很多。

Skill 就是那份菜谱。

这对于需要反复执行同类任务的场景非常有价值——比如每次写完文章都要排版、每次提交代码都要跑测试、每次部署都要执行一套固定的操作流程。

把这些写成 Skill，以后一句指令就能触发整套流程，不需要每次重新解释一遍。

#### 8.2 Codex 内置了哪些默认 Skill

Codex 出厂自带了几类核心 Skill，覆盖最高频的开发场景：

**代码理解类**：快速分析一个陌生代码库的结构、读懂某段复杂逻辑、追踪函数调用链。

**代码生成类**：根据你的描述生成完整的功能模块、写单元测试、生成 API 接口文档。

**代码审查类**：对你的代码进行安全性扫描、性能优化建议、代码规范检查。

**数据分析类**：读取 CSV 或数据库文件，用 Python 进行数据清洗、统计分析、可视化。

**产品设计类**：根据需求描述生成原型思路、系统设计方案、数据库结构建议。

除了内置 Skill，OpenAI 还开放了 Skill 创建接口，任何人都可以编写自定义 Skill 并分享给社区。

![局部截取_20260608_203321.png](/media/202608/b88960a32c26437680a35cc8653b39ca4642.png)

局部截取\_20260608\_203321.png

#### 8.3 如何安装第三方插件（以 Chrome 控制为例）

Codex 目前最受关注的第三方插件之一是 **Browser Control 插件**，能让 Codex 直接控制 Chrome 浏览器。

以安装 Browser Control 为例：

**第一步**：点击顶部菜单栏的"Plugins"图标，进入插件管理页面。

**第二步**：在插件列表里找到 Browser Control，或者在搜索框里搜索。

**第三步**：点击"Install"安装，安装完成后重启 Codex 生效。

![局部截取_20260608_203341.png](/media/202608/8df1018fa0ff4abc8093e30cf0193d243609.png)

局部截取\_20260608\_203341.png

安装完 Browser Control 之后，你就可以在对话里对 Codex 说："打开 Chrome，访问这个网页，把页面上的所有产品名称和价格复制出来整理成表格。"

Codex 会真的打开你的 Chrome 浏览器，像人一样操作：点击链接、滚动页面、点击按钮、读取文本，然后把结果整理好给你。

这是普通 AI 聊天工具完全做不到的事情。

#### 8.4 什么时候应该用 Skill，什么时候直接对话就够

一个判断标准：

**如果这件事你只做一次** —— 直接对话，不需要 Skill。

**如果这件事你会反复做，而且希望每次的执行方式保持一致** —— 考虑创建或使用一个对应的 Skill。

另一个维度：**任务的复杂度**。

如果是一个需要多个步骤、中间有判断和分支逻辑的复杂任务，用 Skill 来定义流程会让执行更稳定，不容易跑偏。

如果是一个一句话就能说清楚的简单任务，直接对话比写 Skill 更快。

### 第九章：记忆系统，Codex 怎么"记住"你

用 Codex 用到第二天，你会发现一件事：它好像不记得你昨天说过什么了。

这不是 bug，是 AI 的正常工作机制。

但 Codex 提供了几种手段，让它能"记住"跨对话的重要信息。这章讲清楚这套机制。

#### 9.1 Codex 是怎么建立上下文记忆的

Codex 的记忆分为两个层次：

**对话级记忆（短期记忆）**

在同一个对话窗口里，Codex 能完整记住从开头到当前的所有内容。这就是为什么你在一个长对话里，它能基于你前面说的内容给出一致的回答。

但一旦你关闭这个对话窗口、开一个新对话，"短期记忆"就清空了。新对话里的 Codex 不知道你在上一个对话里说过什么。

**项目级记忆（长期记忆）**

这是 Codex 的"长期记忆"机制，通过两种方式实现：

一是 `AGENTS.md` 文件（我们在第七章提过）：把你的项目规则和背景信息写在这里，Codex 每次进入这个项目都会读取，相当于持久化的"工作手册"。

二是 Memory 文件：Codex 允许你创建一个专门的记忆文件（比如 `memory.md`），在里面记录重要的上下文信息，然后在需要的时候通过 `@` 引用把这个文件带入对话，让 Codex "读一下自己的记忆"再继续工作。

![局部截取_20260608_203553.png](/media/202608/fc603d86c878485e8397519dacf523687143.png)

局部截取\_20260608\_203553.png

#### 9.2 如何从 Claude Code / Cowork 导入迁移你的记忆

如果你之前用过 Claude Code 或者其他 AI 编程工具，已经积累了一套工作流、提示词模板或者配置文件，不需要重新来过。

Codex 支持从其他工具一键导入配置和记忆。

导入后，Codex 会把原有工具的系统提示词、项目规则、历史偏好等内容转换为自己的格式，无缝接续你的工作流。

#### 9.3 记忆丢了怎么办，手动配置 Memory 文件

如果你不打算做复杂的迁移，最简单的做法是：**手动维护一个 memory.md 文件**。

在你的项目根目录里新建一个 `memory.md`，把你最重要的上下文信息写进去，比如：

\# 项目背景这是一个面向中文用户的 AI 工具教程站点，技术栈是 Next.js + TypeScript。# 代码规范- 所有注释使用中文- 函数命名用 camelCase- 组件命名用 PascalCase# 当前进度- 首页已完成- 文章详情页正在开发中- 评论功能待开始

以后每次开始工作，在新对话的第一句话里这样写：

"请先读一下 @memory.md，然后我们继续上次的工作。"

Codex 会先把这个文件的内容读进上下文，然后带着这些"记忆"跟你继续对话。

这个方法虽然不够自动化，但非常实用，适合不想搞复杂配置的普通用户。

### 第十章：你最想问的问题都在这里

学完前九章，你已经完整了解了 Codex 从安装到核心功能的全貌。

但我知道脑子里还有一堆问题没解答。

这章把最高频的几个问题集中回答。

#### 10.1 Codex 跟 Claude Code、Cursor 有什么区别

这三款工具经常被拿来比较，我来用一句话定位它们：

**Cursor**：AI 增强的代码编辑器。它的核心是"代码编辑器 + AI 补全"，你还是主要在自己写代码，只是 AI 帮你补全、提示和审查。适合有编程基础、习惯 VSCode 工作流的开发者。

**Claude Code**：Anthropic 出的终端级 AI 编程 Agent，主打命令行界面，能力跟 Codex 高度重叠，区别在于底层是 Claude 模型，不是 GPT 系列。在对代码语境的理解和长任务规划上各有优势。

**Codex（OpenAI）**：独立桌面 AI 工作站，主打"你只需要说中文指令，AI 全自动完成"。强调自主性和端到端的项目管理能力，插件生态更丰富，跟 OpenAI 的 ChatGPT 账号体系深度绑定，对已有 ChatGPT 用户迁移成本最低。

三者不是严格的竞争关系，有些人会同时用。

如果你完全不懂编程，Codex 的上手门槛最低，从"说话"就能开始工作。

如果你有编程基础，三款都值得试试，根据自己的工作流选一个主用的就行。

#### 10.2 Codex 是完全免费的吗

不是。

Codex 的客户端本身是免费下载的，但使用需要消耗 OpenAI 账号的额度。

免费账号有基础体验额度，Plus 用户每月 20，Pro用户每月200。

另外，如果你是通过 API Key 使用（而不是登录 ChatGPT 账号），是按实际 token 消耗计费的，密集使用的话费用可能比订阅 Plus 更高，也可能更低，取决于你的使用量。

对于大多数普通用户，Plus 订阅是性价比最好的选择。

#### 10.3 Windows 版功能比 Mac 版少吗

从官方声明来看，Windows 版和 Mac 版的功能是对等的，不存在平台特有的"专属功能"。

但实际体验上，由于 Mac 的开发者工具链更成熟、沙箱限制更宽松，某些涉及本地系统深度集成的操作在 Mac 上会更顺滑。

Windows 版本的工程团队在持续优化，差距在缩小，但目前确实存在某些边缘场景体验上的细微差异。

不过对于 90% 的日常使用场景，Windows 版本完全够用，不会有明显的功能缺失感。

#### 10.4 能用 API Key 代替账号登录吗

可以。

Codex 除了支持 ChatGPT 账号登录，也支持用 OpenAI API Key 直接接入。

在 Settings 里找到"API Key"设置项，输入你的 API Key 即可切换到 API 模式。

API 模式的优势：不受账号等级限制，直接按用量计费，适合重度用户或者希望精确控制成本的场景。

API 模式的劣势：需要有 OpenAI 的 API 访问权限（并非所有账号都有），而且某些跟 ChatGPT 账号体系深度绑定的功能（比如记忆同步）在 API 模式下可能体验不完整。

对于普通用户，用账号登录就行，不需要折腾 API Key。

看完这十章，你已经从"Codex 是什么"走到了"能独立配置和使用 Codex 的完整流程"。

剩下的，就交给你自己去跑起来了。

第一次把文件夹拖进去、第一次看着 AI 在你电脑里自动写代码、第一次接受了一段修改发现真的能跑——

那种感觉，比我说一万句话都有力。

去试吧。

最全的Codex使用指南