Codex 安装教程

本教程将带你从零开始完成 OpenAI Codex CLI 的安装。整个过程大约需要 15 分钟。

什么是 Codex？

Codex 是 OpenAI 推出的 AI 编程代理工具，可以在终端中运行，也可以集成到 IDE 中。它擅长多文件代码生成和项目级开发任务。

前置要求

要求	说明
操作系统	macOS 10.15+、Ubuntu 20.04+、Windows 10+
Node.js	版本 22.0 或更高
Git	任意较新版本
网络	能够访问 api.openai.com

第一步：安装 Node.js

Codex CLI 需要 Node.js 22+ 运行环境。

推荐使用 Homebrew 安装：

bash

# 安装 Homebrew（如果还没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js（确保版本 >= 22）
brew install node@22

# 验证安装
node --version  # 应显示 v22.x.x
npm --version

Node.js 版本要求

Codex CLI 要求 Node.js >= 22.0。请特别注意版本要求，使用 node --version 确认。

第二步：安装 Codex CLI

使用 npm 全局安装 Codex CLI：

终端命令

npm install -g @openai/codex

如果遇到权限问题，macOS/Linux 用户可以加 sudo 前缀，或使用 nvm 管理 Node.js。

第三步：验证安装

运行以下命令验证安装是否成功：

bash

codex --version

如果看到版本号输出，说明安装成功。

安装完成！

恭喜你！Codex CLI 已经成功安装到你的电脑上了。接下来请阅读"基础配置"教程来完成设置。

常见问题

npm install 报错

bash

# macOS / Linux - 使用 sudo
sudo npm install -g @openai/codex

# 或者配置 npm 全局路径
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
npm install -g @openai/codex

如何更新 Codex？

bash

npm update -g @openai/codex