Codex 保姆级入门教程（上篇）

大家好，我是程序员小灰。

如今的AI编程领域可谓是百家争鸣，Cursor、Trae、ClaudeCode、Codex......全球各大AI巨头都在AI编程这个赛道展开激烈的竞争。

前几天小灰发布了一篇 Claude Code 的入门教程，反响还不错，也有许多朋友在后台留言，询问我们能不能发布一篇关于 Codex 的教程。

没问题，安排上！

今天小灰就来给大家系统性讲解 Codex 这款AI编程工具，聊一聊 Codex 到底能不能打，普通人怎么安装、怎么上手、怎么少踩坑。

文章较长，建议大家先收藏、不迷路。

一、为什么 Codex 值得考虑 ？

Claude Code 好用吗？当然很好用。

然而用过 Claude Code 的朋友都知道，它有两个让人尴尬的特点：

1. 免费额度较少：用着用着就要你充钱，而且还死贵。

2. 封号风险：Anthropic 官方频繁封号，这一点最为致命。

因为以上的这些问题，小灰的粉丝群里经常有人问：”OpenAI 有没有类似的AI编程工具呢？”

答案是“有”，而且稳定性比 Claude Code 要好得多，不但编码能力强，而且还能接入 GitHub，这款产品就是 Codex。

二、什么是 Codex ？

Codex 是 OpenAI 官方出品的 AI 编码工具，能理解你的需求，帮你写代码、跑命令、调 Bug。

Codex 具有四种运行模式，覆盖你能想到的大部分使用场景：

• • CLI（命令行），在终端里跑，适合命令行党，主打一个黑框里掌控全局。

• • App（桌面应用），有图形界面，支持 macOS 和 Windows，适合不想跟终端互相折磨的人。

• • Web（网页版），打开浏览器就能用，不用装任何东西。出差用别人电脑、临时改个代码，随开随用。

• • IDE 插件，支持 VS Code、Cursor、Windsurf。写代码的时候直接在编辑器里调用，不用切窗口，不用复制粘贴，代码上下文自动带过去。

四种运行模式怎么选？

终端党用 CLI，鼠标党用 App，临时救火用 Web，天天写代码用 IDE 插件。

这四种模式没有优劣之分，大家哪种模式用着顺手，就可以优先选用哪种模式。

三、Codex 的最新版本

如果你只是把 Codex 理解成"OpenAI 版 Claude Code"，那现在这个理解有点窄了。

2026年以来，Codex 已经不只是一个命令行编码助手，而是逐步构建为一套"AI 干活系统"。

按官方 Changelog 看，2026 年 4 月 Codex 最核心的变化就三个：

1. Codex App 26.415（2026-04-16 更新）

桌面端从“聊天式编码工具”升级成更完整的 AI 工作台，开始支持内置浏览器、任务侧边栏、GitHub PR 处理、artifact viewer、Memories、多终端、多窗口，以及 Windows 托盘的适配。

2. 模型版本 GPT-5.5（2026-04-23 更新）

GPT-5.5 开始进入 Codex，重点提升复杂实现、重构、调试、测试和验证这类重任务的能力。也就是说，Codex 不只是能写小脚本，而是更适合接真实项目里的复杂任务。

3. Codex CLI 0.128.0（2026-04-30 更新）

CLI 加入可持久化的 /goal 工作流，可以把一个长期目标创建、暂停、恢复和清理；同时新增 codex update，权限、沙箱和插件能力也更细。

从上面的迭代可以看出，对于现在的 Codex，不要只问"它会不会写代码"，更准确的问题是，它能不能接住你工作流里那些重复、复杂、跨文件、需要验证的任务。

不过这篇是入门教程，不会把每个高级功能都展开，你先知道它们存在就行，真用到的时候再按场景深入。

四、Codex 适合什么样的场景？

下面的五种情况，最适合选用Codex：

1. 你已经有 ChatGPT Plus/Pro 订阅，那就优先试 Codex。你每个月交的那 20 刀，终于不只是用来写周报了。

2. 你想要 GUI，不想在终端里和 AI 大眼瞪小眼，想点点鼠标就把活干了。

3. 你被账号稳定性折腾怕了，多一个官方工具，就多一条备用工作流。

4. 你想先低成本试试，Codex 是否包含在你的套餐里，以官方页面和客户端显示为准。能用就先用，别先付费上头。

5. 你喜欢 OpenAI 的模型能力，觉得 GPT 系列写代码、解释代码、改代码都比较顺手。

如果你没有 ChatGPT 订阅，也不想充钱，那也没关系，后面会讲怎么给它接入国内大模型。

五、如何安装 Codex ？

Codex的安装过程并不复杂，一共就几步，只要你的电脑配置不是太差，基本都能跑起来。

1. 环境要求

需要安装Node.js和git。

在本地终端检查一下环境：

node --version npm --version git --version

如果没有安装，先补上。这个环节没什么玄学，少一个后面都容易报错。

Node.js 下载地址： https://nodejs.org/zh-cn/download

Git 下载地址： https://git-scm.com/install/windows

这里提醒一下，如果你是 Windows 用户，最省心的方式是优先装 App。CLI 也能用，但如果遇到环境问题，可以考虑用 WSL，或者先跳到 App 部分。

2. 安装 CLI

CLI 适合已经习惯终端的人。两种方式，选一个：

npm 安装

npm install -g @openai/codex

Homebrew 安装（macOS）

brew install --cask codex

验证安装：

codex --version

看到版本号就说明成功了。

如果这里没看到版本号，优先检查 Node.js、npm 全局路径和网络。

3. App 安装

Windows 下载地址：

https://get.microsoft.com/installer/download/9PLM9XGG6VKS?cid=website_cta_psi

4. 云端版

直接访问： https://chatgpt.com/codex/cloud

5. IDE 插件

如果你用 VS Code、Cursor 或 Windsurf，可以装插件：

安装地址： https://developers.openai.com/codex/ide

装完之后在编辑器里就能直接调用 Codex。

到这里你已经有四条路了。新手建议从 App 开始，开发者建议从 CLI 开始，已经有 GitHub 仓库的人可以直接试云端版。

别纠结入口，工具不是对象，不需要从一而终。

六、在 CLI 端使用 Codex

CLI 是 Codex 最像“开发者工具”的形态。你在终端里说需求，它在项目里改文件、跑命令、修问题。

1. 启动

codex

首次启动会让你选择登录方式。

还有可能会报错：Error: account/read failed during TUI bootstrap

这个错误在官方 issue 里已经有人复现，重新登录就恢复了。

这种问题就别硬刚了，先登出再登录，很多时候比你研究半小时日志更有效。

直接执行：

codex logout

或者一步到位：

codex login

浏览器登录一遍基本就好了，很多人都是这样修复的。

2. 登录方式

方案一：Sign in with ChatGPT（推荐）

会打开浏览器，用你的 ChatGPT 账号授权。

方案二：Enter API Key

去 https://platform.openai.com/ 生成一个 API Key，粘贴进去。这种方式按 token 计费，适合已经习惯 OpenAI API 的用户。

3. 模型选择

模型以你当前客户端显示为准。

这里别死记型号，AI 工具更新很快，今天看到的默认模型，过段时间可能就变了。

如果想切换模型，用 /model 命令。

4. 30 秒上手

装好了，先跑一个试试。别上来就让它重构祖传系统，先拿小游戏练手，心态比较健康。

在 D 盘新建一个test文件夹，然后打开终端输入命令：

cd d:\test\

然后输入下面命令：

codex "用 Python 写一个贪吃蛇的游戏"

就这么简单。Codex 会理解你的需求，生成代码，创建文件，甚至帮你运行。

你不需要一开始就告诉它用什么框架、怎么组织代码，它会先根据需求做判断。这就是 AI 编码工具的核心价值：你负责描述目标，它负责拆任务、改文件、跑命令。

试完这一个，你就知道 Codex 大概是什么感觉了。后面再把它放进真实项目里，价值会更明显。

当然，AI 写代码和人写代码一样，都需要你 review。不要把它当成完全不用检查的自动交付机器。

5. 常用命令

Codex的常用命令，我罗列在了下面的表格当中，大家可以尝试使用。

七、在 App 端使用 Codex

1. 启动

App 适合两类人：一类是不想一直待在终端里，另一类是希望同时看项目文件、对话记录和修改内容。

打开方式有两种，一种是直接双击桌面Codex的图标，一种是执行命令codex app。

选择你的偏好后，点击继续，也可以点击跳过，后面再配置。

由于我之前登录过Codex CLI，所以 App 这边不用登录就可以直接使用了。后面的IDE 插件也是一样的道理，同一套登录状态可以复用。

2. 基础使用

点击项目，然后选择使用现有文件夹，找到刚刚上面制作贪吃蛇的那个文件夹test。

可以看到刚刚的对话都已经加载进来了。这一点很关键：Codex 不是只能单次问答，它会围绕一个项目持续工作。

点击右上角的切换文件树，可以看到当前目录下的文件。点击具体文件后，左侧可以预览内容，也可以直接在文件里做注释，让 Codex 按你的反馈继续修改。

这时候它就不只是“问答机器人”了，而是能围绕项目上下文继续修改。

右下角的设置里面还可以查看剩余额度。轻度使用一般够用，但额度策略会变化，最终以客户端显示为准。

由于X的篇幅所限，关于Codex在云端和IDE端的使用、进阶应用技巧、接入国内模型的方法、常见使用问题，我们将在教程的下篇为大家详细讲解，敬请期待~~

也欢迎大家关注我 @XiaohuiAI666 ，学习更多有用的AI和副业经验。