Codex保姆级安装教程,10分钟轻松装好!

最近在国内 AI 传播圈子，Codex 的声量明显超过 Claude Code，脱 CC 向 Codex 的趋势很明显！

身边朋友找我咨询推荐 AI 工具，我也会优先安利 Codex。

工欲善其事，必先利其器。

之前文章已经写了怎么合规订阅 ChatGPT Plus手把手教你如何正规订阅ChatGPT Plus，苹果/安卓操作全都有！今天就来分享下怎么正确安装好 Codex，成功登录，跑完第一次测试。

全篇通俗易懂、无废话、照着点就能成功。

一、新手必读：到底该装哪一个版本？

OpenAI 官方目前给出四种 Codex 入口，很多人乍一看很困惑。

我给你直白分级：

新手铁律：优先安装 Codex App！

不要一开始就折腾 API Key、CLI、环境变量、第三方模型等。先把软件跑通，再研究进阶玩法。

避坑提醒：不要在百度随便搜安装包！第三方捆绑软件、旧版本非常多。一定要走 OpenAI 官方渠道。

官方快速入口（收藏保存）：https://developers.openai.com/codex/quickstart

二、Windows 安装流程

Windows 用户，我只推荐 App，最简单、报错最少。

1、打开官方下载页

复制打开上面给到的 Quickstart 官方页面。

页面会清晰展示四个选项：App、IDE、CLI、Cloud。

直接点击 App。

2、下载并安装

选择 Windows 下载按钮，会跳转应用商店。

点击「获取/安装」，静静等待自动部署完成。

⚠️ 如果商店打不开：检查网络、关闭代理、更换浏览器。

3、打开软件 + 登录

安装完成，开始菜单搜索打开 Codex。

这里有一个关键选择：

✅ Sign in with ChatGPT（新手必选）

❌ 不要用 API Key

跳转浏览器授权，登录你的 ChatGPT 账号，确认授权后返回软件。

能看到项目选择页面，代表安装+登录全部成功。

三、Mac 安装流程

1、进入官方下载页面

同样打开官方 Quickstart 页面，选择 macOS 安装包。

2、区分芯片版本（非常重要）

Mac 一定要选对安装包，不然打不开、闪退。

• Apple 芯片（M1-M4）：选 Silicon 版本
• 老旧 Intel 芯片：单独下载 Intel 安装包

如果不清楚自己的芯片版本，点击左上角苹果图标 → 关于本机，即可查看芯片类型。

3、安装+权限放行

下载后将 Codex 拖入应用程序。

若提示「无法验证开发者」：

系统设置 → 隐私与安全性 → 允许打开。

4、账号登录

和 Windows 一样，优先 ChatGPT 账号登录。

授权完成，进入项目页即为成功。

四、CLI 命令行安装（适合进阶玩家）

如果你听不懂「终端」是什么，直接跳过这一章，不要硬装。

1、前置依赖

CLI 必须提前安装两个环境：

• Node.js（运行依赖）：https://nodejs.org/
• Git（版本管理）：https://git-scm.com/downloads

安装完成，终端输入以下命令，能输出版本号即为正常：

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

2、安装命令

Windows / Linux 通用：

npm install -g @openai/codex

Mac 安装过 Homebrew 可直接执行：

brew install codex

3、基础使用命令（收藏备用）

codex          # 启动软件
codex --version # 查看版本
codex login     # 重新登录
codex logout# 退出登录

五、IDE 编辑器插件（程序员专属）

日常使用 VS Code、Cursor、Windsurf 写代码的人，直接装插件最舒服。

官方 IDE 入口：https://developers.openai.com/codex/ide

安装流程

1. 打开编辑器，进入扩展商店
2. 搜索 Codex，认准 OpenAI 官方发布
3. 安装后重启编辑器
4. 侧边栏打开 Codex，ChatGPT 账号登录

首次测试输入：

请先读懂当前项目，不要修改任何文件，给我一份简单介绍。

六、网页云端版（适合 GitHub 开发者）

普通小白不用碰，简单说下用途：

绑定 GitHub 仓库，在线自动化管理代码、合并分支、提交更新。

网页入口：https://chatgpt.com/codex

流程：登录账号 → 授权 GitHub → 绑定仓库 → 发起任务。

七、第一次测试任务

安装完毕后，不要上来写复杂代码、不要直接丢正式项目。

先用空文件夹跑一次最简单任务，验证读写权限。

测试指令（直接复制）

请在当前文件夹新建一个 README.md
内容只写：这是我的第一个 Codex 测试项目。

能正常生成文件、写入文字，说明：

你的 Codex 已经完全安装成功。

最小验活成功后，可以再做一个简单代码任务。

比如输入：

请用 Python 写一个简单的猜数字小游戏，并告诉我怎么运行。

如果你的电脑没有 Python，Codex 可能会提示你需要安装 Python。

这个时候不要慌，说明 Codex 已经开始进入真实开发流程了。

第一次测试的目的不是做出多复杂的项目，而是确认：

• Codex 能登录
• Codex 能读取文件夹
• Codex 能创建文件
• Codex 能解释它做了什么
• 如果要运行命令（比如安装Python），它会提示你确认
• 你知道在哪里看它改了哪些文件

这一步成功，就说明安装和首次使用已经跑通。

八、常见问题

1. 提示 codex: command not found

说明系统找不到 Codex 命令。

先试：codex --version

如果仍然找不到，可能是 npm 全局路径没有加入 PATH。

可以查看 npm 全局路径：npm config get prefix

Windows 小白如果不熟悉 PATH，不建议继续卡在这里。先用 Codex App。

2. 登录后没反应

可以先退出再登录。

如果还是不行，检查：

• 浏览器是否完成授权
• 是否登录了正确的 ChatGPT 账号
• 网络是否能正常访问 OpenAI
• 当前账号是否有 Codex 入口

3. 浏览器授权失败

可以尝试：

• 换一个浏览器
• 退出 ChatGPT 后重新登录
• 清理浏览器缓存
• 检查网络
• 确认没有登录错账号

4. 账号没有 Codex 入口

Codex 的可用性和额度会跟账号、订阅、工作区、地区、企业设置有关。

以你客户端和官方页面显示为准。

如果你是公司或学校账号，也可能被管理员限制。

5.  使用ChatGPT登录 还是 API Key？

我给你一句永久记住的话：

只要你不是专业开发，永远优先 ChatGPT 账号登录。

✅ ChatGPT 账号登录（推荐）

• 无需自己生成密钥
• 跟随订阅权益，计费简单
• 云任务、同步记录全部可用

❌ 新手不推荐 API Key

• 单独计费、容易超额扣费
• 部分云端功能直接限制
• 小白极易搞错配置

持续更新 Codex 零基础操作教程，通俗易懂、全部可落地。

关注我，把 Codex 玩明白，用上先进生产力！