01 · 认识 Codex 与四种入口

Codex 是什么、几种入口分别干什么，以及它和 ChatGPT、Claude Code 到底有什么区别

📚 系列导航 这是「Codex 小白教程」的第一篇。不要求任何编程基础，咱们先把 Codex 的整体地图看明白。下一篇〈02 · Codex 核心概念速览〉，再集中解释代理、上下文、沙箱、权限、AGENTS.md 等常见术语。

兄弟们，这一篇咱们正式认识一下 OpenAI 的 Codex。

第一次接触 Codex，很多人都会有点懵：

怎么一会儿是桌面端，一会儿是命令行，一会儿又跑进 VS Code 和网页里了？

到底哪个才是真正的 Codex？

其实答案很简单：

它们都是 Codex，只是入口不同。

这一篇暂时不教安装，也不讲复杂配置，只解决三个最基础的问题：

Codex 到底是什么；
几种入口分别适合什么场景；
它和普通 ChatGPT、Claude Code 有什么区别。

看完以后，你应该能知道自己该从哪里开始，而不是刚入门就卡在“我到底该装哪个”。

01 Codex 到底是个啥

先给结论：

Codex 是 OpenAI 推出的 AI 编程代理。

你给它一个目标，它可以读取项目文件、修改代码、执行命令、运行测试，再把结果交给你检查。

它和普通聊天机器人的最大区别，不是“代码写得更漂亮”，而是：

它真的可以动手。

比如你可以直接对它说：

帮我看看这个项目为什么启动失败，找到原因，修好以后再跑一次测试。

接下来，Codex 可以自己完成一整套动作：

查看项目目录；
阅读配置文件；
分析错误日志；
修改相关代码；
执行启动命令；
运行测试；
汇报改了什么。

官方目前将 Codex 定位为能够理解代码库、开发功能、修复问题、执行检查并审查变更的编码代理。Codex CLI 也可以直接读取本机仓库、修改文件并调用电脑上已经安装的开发工具。 (OpenAI Developers )

一个简单类比

普通 ChatGPT 更像一位远程顾问。

你把报错发给它，它告诉你可能哪里有问题、应该怎么修改。然后你再把代码复制回编辑器，自己操作、自己测试。

Codex 更像坐在你电脑旁边的开发搭档。

你告诉它目标，它可以直接打开项目、查看文件、修改代码和执行命令。你主要负责确认方向和检查最终结果。

所以可以用一句话概括：

ChatGPT 更偏向“回答问题”，Codex 更偏向“执行任务”。

不过要注意，现在 Codex 已经深度整合进 ChatGPT。它不是和 ChatGPT 完全无关的另一家公司或另一套账号，而是 OpenAI 在 ChatGPT、桌面端、编辑器和终端中提供的一套代理式工作体验。 (OpenAI )

💡 一句话总结：

Codex 是能进入项目、读取文件、修改代码并运行命令的 AI 编程代理，而不只是一个会生成代码的聊天框。

02 同一个 Codex，几种不同入口

Codex 最容易让新手迷糊的地方，就是入口比较多。

按照当前官方产品形态，你主要会在下面几种地方看到它：

入口	它长什么样	在哪里运行	适合什么人
ChatGPT 桌面端的 Codex 模式	图形界面，可以查看任务、代码差异和多个项目	本机与云端工作流都可接入	不喜欢命令行、想直观看修改结果的人
Codex CLI	在终端中输入 `codex` 使用	你的电脑或服务器	熟悉终端、需要脚本和自动化的人
IDE 扩展	VS Code、Cursor、Windsurf 等编辑器里的面板	你的电脑	平时主要在编辑器里开发的人
Codex Cloud / Web	在浏览器或 ChatGPT 中委派任务	OpenAI 管理的云端环境	想并行处理任务、减少本机占用的人

官方文档目前把 Codex 的可用入口列为 ChatGPT 桌面端、网页端、Codex CLI、IDE 扩展和 Codex Cloud。IDE 扩展能够直接利用编辑器里已经打开的文件和选中代码，也可以在编辑器旁边审查修改。 (OpenAI Developers )

先说明一个最新变化

早期教程经常把它称为独立的“Codex App”。

但从 2026 年 7 月 9 日开始，Codex 已经并入 macOS 和 Windows 的 ChatGPT 桌面应用。原来的 Codex App 用户可以继续保留项目、设置和工作流，也可以把 Codex 设置成桌面应用的默认界面。 (developers.openai.com )

所以你现在看到“Codex 桌面 App”和“ChatGPT 桌面端里的 Codex”，很多时候说的是同一条演进路线。

本机入口和云端入口有什么区别

这个区别非常重要。

本机入口

CLI、IDE 扩展和桌面端的本地项目工作流，主要操作的是你电脑上的项目。

它可以：

阅读本地文件；
调用本地开发工具；
执行测试；
查看 Git 状态；
修改当前项目。

这种模式像是请了一位助手坐在你工位旁边，用你的电脑和开发环境工作。

云端入口

Codex Cloud 则是在 OpenAI 管理的环境中执行任务。

它更像把任务交给远程开发人员：

云端准备独立环境；
拉取或连接代码仓库；
执行修改和测试；
最后交回变更结果。

本地工作流运行在你的设备上，云端任务运行在 OpenAI 管理的环境中。企业工作区也可以分别控制 Codex Local 和 Codex Cloud 的权限。 (OpenAI Help Center )

云端模式比较适合：

跑很久的测试；
同时处理多个任务；
做相互隔离的实验；
不想让任务持续占用自己的电脑。

💡 一句话总结：

Codex 可以从桌面端、终端、编辑器和云端进入；入口不同，但核心都是让代理理解目标并执行工作。

03 Codex 能干什么

Codex 最常见的工作，大致可以分成下面几类。

1. 理解陌生项目

刚接手一个项目，不知道从哪里开始，可以让它先分析：

请介绍一下这个项目的目录结构、主要技术栈和启动流程，不要修改任何文件。

它会读取项目中的关键文件，帮你快速找到入口。

2. 开发功能

你可以直接描述需求：

给这个登录页面增加“显示密码”按钮，保持现有代码风格，并补充测试。

Codex 会尝试找到相关组件、修改代码并执行验证。

3. 修复 bug

把报错和目标一起交给它：

用户退出登录后页面仍然显示旧数据，请找到根因并修复。

它可以顺着调用链、状态管理和缓存逻辑继续排查。

4. 重构代码

例如：

把这个过长的函数拆分成几个职责清晰的小函数，行为不能改变。

5. 补充测试

例如：

给支付金额计算逻辑补充边界测试，重点检查零金额、负数和小数精度。

6. 自动化重复工作

例如：

批量修改接口名称；
更新依赖；
整理格式；
生成迁移脚本；
执行代码审查；
在 CI 中运行固定任务。

Codex CLI 既可以交互使用，也可以通过 codex exec 放进脚本和流水线中执行重复工作。 (OpenAI Developers )

04 Codex 不能替你做什么

知道它能干什么很重要，但知道它不能替你干什么更重要。

不应该完全交给它的事情	原因
决定产品需求	它不知道真实用户、商业目标和团队优先级
独自拍板系统架构	它能给方案，但不了解全部长期约束
保证代码绝对正确	AI 生成的代码仍然可能存在逻辑错误
猜测没说清楚的业务规则	信息不足时，它只能根据常见情况推测
在无人检查的情况下直接上线	修改越大，隐藏风险越多

最危险的使用方式是：

我看不懂代码，但我让它全部修改完，然后直接提交。

这样等于把方向、执行和验收全部交给了一个可能犯错的系统。

更合理的分工应该是：

人负责目标、约束和判断；
Codex 负责分析、执行和重复劳动；
最后由人检查 diff 和测试结果。

官方的 CLI 快速上手也建议在任务前后创建 Git 检查点，这样出现问题时可以快速回退。 (OpenAI Developers )

因此，刚开始使用时最好养成三个习惯：

任务开始前提交一次 Git；
修改完成后查看 diff；
确认测试通过后再提交。

💡 一句话总结：

Codex 是执行能力很强的搭档，但不是可以闭眼托管整个项目的甩手掌柜。

05 Codex 和 ChatGPT 有什么区别

以前可以简单地说：

ChatGPT 负责聊天；
Codex 负责写代码。

但现在这样说已经不够准确，因为 Codex 已经整合进 ChatGPT 的多个入口。

更准确的理解是：

ChatGPT 是通用工作平台

它可以处理：

写作；
学习；
搜索；
数据分析；
图片；
日常问答；
各类知识工作。

Codex 是其中面向执行和开发工作的代理能力

它重点处理：

代码仓库；
文件修改；
命令执行；
测试；
Git；
Pull Request；
自动化任务。

可以这样类比：

ChatGPT 像一家综合服务公司，Codex 是里面专门负责进入现场、操作工具和完成工程任务的执行团队。

Codex 当前包含在多个 ChatGPT 套餐中，不同套餐的额度和能力有所不同，具体限制可能持续变化，应以官方计费和套餐页面为准。 (OpenAI Help Center )

06 Codex 和 Claude Code 有什么区别

Codex 和 Claude Code 属于同一类产品：

它们都是能读取代码库、修改文件和运行命令的 AI 编程代理。

Claude Code 官方目前同样提供终端、IDE、桌面端和浏览器入口，并且能够理解代码库、编辑文件、执行命令和完成开发任务。 (Claude Platform Docs )

两者可以先这样理解：

维度	Codex	Claude Code
开发公司	OpenAI	Anthropic
主要模型体系	GPT / Codex 系列	Claude 系列
项目说明文件	`AGENTS.md`	`CLAUDE.md`
常见入口	ChatGPT 桌面端、CLI、IDE、Cloud	CLI、IDE、桌面端、Web
能否读取项目	能	能
能否修改文件	能	能
能否运行命令	能	能
工作流特点	与 ChatGPT、云端任务和多代理工作流结合紧密	终端工作流成熟，同时覆盖 IDE、桌面和网页

两者没有必要强行二选一。

更实际的选择方式是：

已经长期使用 ChatGPT，希望账号、桌面端和云任务统一管理，可以优先尝试 Codex；
已经使用 Claude，或者喜欢 Claude Code 的工作流，可以继续使用 Claude Code；
团队有条件，也可以根据任务和模型表现灵活切换。

不要只问“谁更聪明”。

真正影响结果的还有：

项目上下文是否完整；
提示词是否清楚；
权限有没有配置合理；
测试是否可靠；
任务有没有拆得足够具体。

💡 一句话总结：

Codex 和 Claude Code 是同类不同家的编程代理，核心能力接近，主要差别在模型体系、生态和具体工作流。

07 动手：30 秒检查是否安装了 Codex CLI

虽然这一篇不正式讲安装，但你现在可以先做一个完全安全的小检查。

打开终端。

macOS 可以打开“终端”，Windows 可以打开 PowerShell，然后输入：

codex --version

接下来可能出现两种结果。

情况一：显示版本号

例如：

codex-cli 0.x.x

说明你的电脑已经安装过 Codex CLI。

情况二：提示找不到命令

macOS 或 Linux 可能显示：

command not found: codex

Windows 可能显示：

'codex' 不是内部或外部命令

这也完全正常，只说明还没有安装。

当前官方提供的 macOS 和 Linux 安装命令是：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows PowerShell 安装命令是：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

也可以通过 npm 安装：

npm install -g @openai/codex

安装完成后，进入项目目录运行：

codex

第一次启动时，按照界面提示选择登录方式即可。以上安装方式均来自 OpenAI 当前维护的官方文档和开源仓库。 (OpenAI Developers )

暂时不想碰终端也没关系。

你可以先从 ChatGPT 桌面端里的 Codex 模式开始，等熟悉基本操作以后，再学习 CLI。

08 小结

这一篇，我们先把 Codex 的地图看清楚了。

Codex 是什么

它是 OpenAI 的 AI 编程代理。

你给目标，它可以读取项目、修改文件、运行命令并执行测试，而不只是回复一段代码。

它有哪些入口

目前主要可以从这些地方使用：

ChatGPT 桌面端；
Codex CLI；
IDE 扩展；
Codex Cloud 和网页端。

它适合做什么

理解代码库；
开发功能；
修复 bug；
重构代码；
补充测试；
自动化重复任务。

它不能替你做什么

决定真实需求；
独自拍板架构；
保证代码绝对正确；
在没有人工检查的情况下直接上线。

它和其他工具的关系

ChatGPT 是通用平台，Codex 是偏执行和开发工作的代理能力；
Codex 和 Claude Code 属于同类工具，主要差别在模型、生态和工作流。

现在你应该已经能用一句话向别人解释 Codex：

Codex 是 OpenAI 的 AI 编程代理，它不只是告诉你代码怎么写，还能进入项目、修改文件、运行命令并完成任务。

下一篇〈02 · Codex 核心概念速览〉，咱们会一次性讲清楚后面经常出现的术语：

代理循环、上下文、沙箱、权限、审批、AGENTS.md、Skills 和 MCP。

这些词现在看着有点多，但拆开以后，其实一点也不复杂。