引言：Codex 是什么？为什么值得装？

如果你最近关注过 AI 编程工具，一定听说过 Codex 这个名字。它是 OpenAI 推出的终端 AI 编程助手，和 GitHub Copilot 那种"帮你补全代码"的小工具不同，Codex 能干这些事：

• 读你整个代码库（不只是当前打开的文件）

• 跨多文件做修改

• 自动运行 shell 命令

• 在沙箱里隔离执行所有操作

• 从自然语言提示理解你想干什么

简单说，它不是一个只会聊天的 AI，而是一个真正能帮你干活的编程伙伴。

Codex 的安装其实并不复杂，5 分钟足够搞定。下面我会分步骤带你走完整个流程，把容易踩的坑都标出来。

---

第一部分：安装前准备（1分钟）

1.1 检查系统要求

开始之前，先确认你的电脑满足基本条件：

条件	要求
操作系统	macOS 12+ / Ubuntu 20.04+ / Windows 10/11（推荐 WSL2）
运行时	Node.js ≥ 22（硬性要求，版本低了装不上）
内存	最低 4GB（推荐 8GB）
账号	ChatGPT Plus/Pro/Team/Enterprise 订阅

⚠️ 最重要的提醒：先确认账号权限，再动手下载安装。很多新手直接跳进"找安装包"环节，装好后发现无法使用。Codex 目前主要集成在 ChatGPT 的订阅体系中，免费账号用不了，需要 Plus 或更高套餐。

1.2 安装 Node.js

Codex 基于 Node.js 运行。打开终端，先检查一下：

bash

node --version

如果输出版本号且 ≥ v22.x.x，说明已经装好了，跳过这一步。

如果没有装，或者版本太低：

• Windows：访问 nodejs.org 下载 LTS 版本安装包

• macOS：用 Homebrew 装 brew install node

• Linux：用 nvm 装 nvm install 22

装完后重启终端，再次运行 node --version 确认。

---

第二部分：安装 Codex（2分钟）

2.1 最推荐的方式：NPM 安装（全平台通用）

这是官方推荐的主流方式，Windows、Mac、Linux 都能用：

bash

npm install -g @openai/codex

安装完成后验证一下：

bash

codex --version

看到版本号就说明装好了。

🌐 国内用户加速：如果安装慢，可以用淘宝镜像：

bash

npm i -g @openai/codex --registry=https://registry.npmmirror.com

2.2 Windows 用户的其他选择

方式一：微软商店安装（最省心）

对于 Windows 开发者，最稳妥的安装方式是通过 Microsoft Store，能确保获取官方最新版本，还能自动处理更新：

1. 打开 Microsoft Store

2. 搜索 Codex

3. 点击"获取"安装

方式二：WSL2（推荐，体验最好）

Codex 官方说了 Windows 支持还是实验性的，WSL2 是目前最稳的方案。在管理员 PowerShell 里运行：

powershell

wsl --install

重启后在 Ubuntu 中按 Linux 方式装 Node.js 和 Codex。

⚠️ 踩坑提醒：原生 Windows 下跑 Codex，偶尔会有沙盒权限问题，Win10 上比 Win11 更容易出问题。

2.3 macOS 用户的其他选择

方式一：App Store 安装

1. 打开 App Store

2. 搜索 Codex

3. 点击"获取"下载

方式二：Homebrew 安装

bash

brew install --cask codex

⚠️ 踩坑提醒：首次启动时 macOS 可能提示「无法验证开发者」，进入「系统设置 → 隐私与安全性」，点击「仍要打开」。

2.4 Linux 用户

bash

# 安装
sudo npm install -g @openai/codex

# 验证
codex --version

⚠️ 一个小坑：Ubuntu 24.04 用户如果启动时出现沙箱警告，需要额外装 bubblewrap：

bash

sudo apt install bubblewrap

---

第三部分：配置登录（1分钟）

装好了但用不了？大概率是没配置认证。Codex 需要知道你"是谁"。

方式一：ChatGPT 账号登录（推荐新手）

终端里直接运行：

bash

codex

首次启动会自动弹浏览器，用你的 ChatGPT 账号授权登录即可。

方式二：API Key 配置（进阶）

如果你习惯用 API Key，需要手动配置。

获取 API Key：登录 platform.openai.com，在 API Keys 管理页面生成一个新密钥。务必妥善保存，它只会显示一次。

配置方式：

Windows（PowerShell）：

powershell

setx OPENAI_API_KEY "sk-你的密钥"

macOS/Linux：

bash

export OPENAI_API_KEY="sk-你的密钥"

建议把这一行加到 ~/.zshrc 或 ~/.bash_profile 中，避免每次重设。

配置完成后重启终端再运行 codex。

---

第四部分：验证安装（1分钟）

完成所有步骤后，做最后一个测试。

进入一个项目文件夹：

bash

cd your-project-folder
codex

如果能看到对话界面，就说明成功了。试一个简单的指令：

"请用 Python 写一个计算斐波那契数列的函数，并加上注释。"

如果 Codex 流畅地生成代码，说明安装、配置、网络全通，可以正式开工了。

---

新手常见问题 FAQ

Q1：codex: command not found / 找不到命令

原因：npm 全局安装路径没加入 PATH，或安装没成功。

解决：

1. 先运行 codex --version 验证是否安装成功

2. 重新安装：npm install -g @openai/codex

3. Linux/macOS 权限报错时加 sudo

Q2：Windows 找不到 .codex 文件夹

解决：在资源管理器里打开「显示隐藏的项目」，因为 .codex 是隐藏目录。

Q3：配置了 Key 但仍提示未认证 / 401

检查两点：

1. 确认 ~/.codex/auth.json 内容格式正确：{"OPENAI_API_KEY": "sk-xxx"}

2. 重启终端再运行 codex

Q4：一直连不上 / 超时 / 网络错误

检查：公司/校园网络可能需要代理或放行相关域名。

---

结语

到这里，你应该已经把 Codex 装好了。回顾一下，一共就四步：

1. ✅ 确认账号权限 + 装 Node.js

2. ✅ 用 NPM 安装 Codex（一行命令）

3. ✅ 登录验证（账号或 API Key）

4. ✅ 测试验证

Codex 安装本身不复杂，最容易出问题的环节往往是：账号权限未确认、忘记重启终端、网络环境不通——我都给你标出来了。

下一步，就是让它真正帮你干活了。从代码解释、重构、测试生成到完整项目开发，你都可以交给这个随时待命的编程伙伴。🚀