1. Codex 是什么

Codex 是 OpenAI 的编码智能体

先给一句结论：Codex 是 OpenAI 官方出品的 AI 编码智能体（Agent）。你给它一个目标，它能读你的项目、直接改文件、跑命令、跑测试，把活儿干完交给你验收。

这跟 ChatGPT 有什么区别？打个比方。你平时用 ChatGPT 写代码，像是查菜谱——它告诉你放盐放糖翻炒三分钟，但锅还得你自己掂。复制代码、切回编辑器、粘贴、改报错，全是你的手工活。

Codex 不一样，它像个直接进了你厨房的厨子。你说「我想吃这个」，它自己翻冰箱（读文件）、开火（跑命令）、炒完端上桌（改完代码跑过测试），你只管尝一口验收。

这个差别落到实际体验，是天壤之别。

OpenAI 你肯定不陌生，就是做 ChatGPT 那家公司。Codex 是它专门为「写代码」这个场景做的工具。官方对它的定义是：“OpenAI’s coding agent that can read, edit, and run code”——能读、能改、能跑代码的编码智能体。

它干的主要是这几类活：

• 写代码：你描述要什么，它顺着项目已有的结构和风格生成代码，不是甩给你一段孤立片段
• 读懂陌生代码库：接手一个没文档的老项目，让它先讲讲架构，比自己啃半天快得多
• 审查代码：帮你找潜在 bug、漏掉的边界条件、逻辑错误
• 调试修复：把报错甩给它，它顺着代码追根因、定位、给修复补丁
• 自动化杂活：重构、补测试、做迁移这类重复劳动，一句话委托出去

四种产品形态

Codex 最容易把新手绕晕的地方在于：它不是「一个软件」，而是同一个智能体的四副面孔。搞不清这点，你会在「该装哪个」上卡半天。

入口	长啥样	跑在哪	适合谁
CLI（命令行）	终端里敲 codex 的命令行工具	你本机	习惯终端、要写脚本做自动化的人
桌面应用	独立图形界面 App，能可视化看 diff	你本机	不想碰命令行、喜欢点界面的人
IDE 扩展	VS Code / Cursor / Windsurf 里的侧边栏插件	你本机	平时泡在编辑器里写代码的人
Cloud（云端）	浏览器打开 chatgpt.com/codex	OpenAI 云端	起长任务挂后台、并行跑多个的人

前三个入口都在你自己电脑上干活——读的是你本机的文件，跑的是你本机的命令。只有 Cloud 不一样：你在浏览器里下个单，OpenAI 在它的云端起一个隔离环境，把你的 GitHub 仓库拉过去改，改完给你交一份 diff，甚至直接帮你提一个 PR。

这四个入口背后是同一套 Codex，配置很大程度上能打通。你写的 AGENTS.md（项目指令文件）、定义的 Skills（可复用指令模板），都能在 CLI、桌面应用、IDE 扩展之间复用。调教一次，多处能用。

CLI：终端中的编码智能体

Codex CLI 是开源的，用 Rust 构建，三大平台（macOS / Windows / Linux）全支持。它是开发者最常用的入口，也是功能最全的一个。

在终端里敲一行 codex 回车，会进入一个全屏交互界面（TUI），有对话区、有输入框、有状态栏，跟桌面应用的信息密度差不多。它还能用 codex exec 做非交互式运行，一句话跑完就退出，适合写脚本和接 CI。

桌面应用：图形界面的编码智能体

桌面应用是官方力推的图形界面入口，目前只有 macOS 和 Windows 有，Linux 暂时没有。

它最大的优势是可视化——你能用图形面板一行行看 diff、多任务并排跑、在界面里直接暂存和提交。对不碰命令行的人来说，这是最友好的入口。

自 v0.144.0（2026-07-09）起，Codex 桌面应用已整合进 ChatGPT 桌面应用，不再单独分发。

IDE 扩展：编辑器里的侧边栏

IDE 扩展支持 VS Code、Cursor、Windsurf、VS Code Insiders。装好后编辑器侧边栏多一个 Codex 面板，你不用离开编辑器就能跟它对话、看 diff。

适合那种「我整天泡在 VS Code 里」的开发者，改动直接在编辑器里看，不用切窗口。

Cloud：浏览器里的云端智能体

打开 chatgpt.com/codex，任务在 OpenAI 的云端环境里跑。它有两个好处：一是并行——你可以一口气甩出去三五个任务同时跑；二是隔离——在沙箱里折腾，不碰你本机系统。

适合那种又慢又长的活，比如「跑全套测试再修好失败用例」，丢去云端挂着，过会儿回来收。

能做什么，不能做什么

能力清单上面列过了，这里补最该认清的另一半——它不能干什么。这点比「能干什么」更值钱，因为新手翻车基本都翻在这。

不能做的事	为什么
替你拍板技术方向	选哪套架构、值不值得重构，判断和决策是你的活
保证代码 100% 没 bug	它给的是高质量候选，不是绝对正确答案，改完必须你来 review
猜中你没说清的需求	你没讲明白的业务逻辑，它只能瞎猜，越自动越容易跑偏
在你完全看不懂的情况下全自动托管	你看不懂它改了啥，就没法判断对错，等于闭眼开车

用好 Codex 的心态，就一句话：让 Codex 提供高质量候选方案，而不是绝对正确答案。

人定方向、把关、做判断；AI 负责执行、分析、干重复劳动。这是它的设计哲学——协作，不是替代。

和 ChatGPT、Claude Code 的区别

Codex 和 ChatGPT

它俩同属 OpenAI，但根本不是一个维度的东西。

ChatGPT 像个坐在指挥部的参谋——你把情况描述给他，他给你出主意、画方案，但他不下场，执行还得你自己来。Codex 像个能空降到现场的特种兵——你给个目标，他自己摸进你的项目读文件、跑命令、改代码，把任务执行完再回来复命。

一句话：ChatGPT 你问它答，Codex 你下指令它动手干。

Codex 本身就含在 ChatGPT 的订阅里。ChatGPT 的 Free、Go、Plus、Pro、Business、Edu、Enterprise 计划都包含 Codex 用量（Free 和 Go 额度较少，Plus 起可完整使用 GPT-5.6 系列模型），也可以用 OpenAI API key 按量付费。

Codex 和 Claude Code

这俩常被放一起比。它们骨架几乎一样：都是「能读项目、能动手」的编程智能体，都有本机加云端多种入口，都用一个项目说明文件来调教。

真正的差别在两点：

• 血统不同：Codex 背后是 GPT 系列模型，Claude Code 背后是 Claude 系列模型
• 默认气质不同：Codex 官方力推图形界面的桌面应用，想拉「不想碰命令行」的人；Claude Code 则是终端原生、命令行味儿更浓
• 项目说明文件不同：Codex 用 AGENTS.md，Claude Code 用 CLAUDE.md

别二选一，按活儿派工。需要图形界面、想可视化盯着 diff 的活，用 Codex；钻在终端里、要接一堆自定义脚本的活，两个都行。

30 秒确认你的电脑认不认识它

打开终端（Mac 用「终端」App，Windows 用 PowerShell），敲这一行回车：

codex --version

两种结果都正常：

• 蹦出一串版本号——恭喜，你之前装过 CLI
• 报错 command not found: codex——也完全正常，说明 CLI 还没装，这正是下一章要解决的事

先混个眼熟，CLI 的安装命令长这样（现在别急着敲）：

# 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"

小结

这一章帮你建立了对 Codex 的认知地图：

• 它是什么：OpenAI 官方的 AI 编码智能体，你给目标、它读项目、动手改、跑命令、把活干完
• 四副面孔：CLI、桌面应用、IDE 扩展、Cloud 四种入口，前三种在本机干活、Cloud 在云端跑，底层是同一个 Codex
• 能 / 不能：能读代码、改文件、修 bug、干杂活；但拍板、把关永远是你的活
• 和谁怎么比：ChatGPT 是参谋、Codex 是能动手的特种兵；Codex 和 Claude Code 是同类不同家，按活儿派工

有了这张地图，后面学安装、配置、使用，都是在上面添砖加瓦。下一章咱们把 Codex 世界里的核心术语一次性捋顺——智能体、沙箱、审批模式、MCP、Skills，都是后面天天打交道的词。