Codex使用指南：新手必备效率提升技巧

最近总有读者在后台问：Codex 到底怎么装？

问的人实在太多，加上这个工具最近确实火，索性把完整流程整理出来，把那些容易踩的坑一次性说清楚。

如果关注 AI 编程，应该对它不陌生。常看到有人靠 AI 编程日入斗金，敲两句中文就把软件跑起来，总觉得我上我也行。

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

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

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

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

? 本文内容大纲导航

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

• Codex 到底是不是你认识的那个老 Codex
• 从零看懂 Codex 在本地电脑的定位
• 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

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

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

一字之差，差之千里。

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

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

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

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

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

局部截取_20260608_191017.png

1.2 先说说它的定位

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

用最接地气的方式解释：

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

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

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

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

整个过程完全透明。

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

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

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

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

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

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

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

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

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

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

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

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

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

node --version
npm --version

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

局部截取_20260608_191726.png

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

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

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

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

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

按这个流程走：

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

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

ApplicationFrameHost.exe_20260608_192450.png

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

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

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

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

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

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

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

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

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

局部截取_20260608_191840.png

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

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

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

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

Codex Installer.exe_20260608_192007.png

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

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

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

npm install -g openai-codex

局部截取_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 没装，这一步就直接断掉了。

解决方案：

• 去 git-scm.com/download/win 下载 Git 安装包
• 双击安装，所有选项保持默认，一路 Next
• 安装完成后，重启 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 安全中心排除项设置界面

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

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

这里你有两个选项：

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

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

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

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

局部截取_20260608_201807.png

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

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

图⑤：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

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

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

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

Codex.exe_20260608_201954 1.png

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

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

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

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

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

② 支持 @ 引用

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

局部截取_20260608_202315.png

③ Plan Mode（计划模式）

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

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

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

局部截取_20260608_202531.png

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

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

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

• 文件变更预览：Codex 准备修改哪些文件、具体改了什么内容，以 diff（差异对比）的形式展示，绿色是新增内容，红色是删除内容。
• 终端输出：Codex 在你电脑里执行的所有命令都会实时显示在这里——它安装了什么依赖、运行了什么脚本、输出了什么结果、报了什么错。
• 任务状态：显示当前任务的执行进度，是在“思考中”、“执行中”还是“已完成”。

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

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

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

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

局部截取_20260608_203121.png

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

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

• 新建对话：开一个全新的空白对话窗口。
• 模型切换：点这里可以切换 Codex 使用的底层 AI 模型。如果你是 Pro 用户，可以在这里切换到 GPT-5.5 Pro。
• 插件（Plugins）：点开这里可以查看已安装的插件，以及从插件市场安装新的功能扩展。我们在第八章详细讲。
• 设置（Settings）：账号信息、主题切换（深色/浅色）、语言偏好、快捷键配置等都在这里。

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

第三步：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

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

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

以安装 Browser Control 为例：

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

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

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

局部截取_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

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 在你电脑里自动写代码、第一次接受了一段修改发现真的能跑——

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

去试吧。