夜雨聆风从 0 到 1 搭建你的 AI 编程 Agent
AI 编程已经进入「Agent 时代」。
以前的 AI 编程工具，只能帮你补全代码。
而现在的 Codex、Claude Code、Cursor Agent，已经开始：
自动阅读项目 自动修改代码 自动执行命令 自动修 Bug 自动生成完整功能
其中，OpenAI 官方推出的 Codex CLI，是目前最火的 AI Coding Agent 之一。
它最大的特点是：
直接运行在你的终端里。
你可以把它理解成：
一个 AI 程序员 一个命令行里的 ChatGPT 一个能直接操作代码仓库的智能体
今天这篇文章，带你完整安装 OpenAI Codex。
包括：
Windows 安装 Mac 安装 Linux 安装 Node.js 环境配置 WSL 安装 ChatGPT 登录 API Key 配置 常见报错解决 第一条 Codex 指令
全部一步一步讲清楚。
一、Codex 是什么？
OpenAI 官方对 Codex CLI 的定义是：
一个运行在终端中的轻量级 Coding Agent。
它可以：
阅读项目代码 修改文件 执行 Shell 命令 自动修复问题 自动生成功能 分析整个仓库
例如：
你只需要输入：
codex
然后说：
帮我分析这个项目的架构
它就会：
自动扫描代码 阅读目录 理解依赖 总结技术栈 输出架构分析
甚至：
帮我把这个 Vue 项目迁移到 React
它都能自动做。
二、安装前准备
先确认你的电脑满足以下条件。
1、系统要求
官方推荐：
Windows 11（推荐 WSL2） macOS 12+ Ubuntu 20.04+ Debian 10+
2、需要 Node.js
Codex CLI 本质上是一个 npm 工具。
所以必须先安装 Node.js。
推荐版本：
Node.js 20 LTS
官方下载：
https://nodejs.org/
安装完成后验证：
node -v
npm -v
如果能看到版本号，说明安装成功。
例如：
v20.18.0
10.8.2
三、Windows 安装 Codex（推荐）
注意：
虽然现在 Codex 已经开始支持 Windows 原生版本，但目前最稳定的方式依然是：
WSL2 + Ubuntu
因为很多 Agent 工具本质上更偏 Linux 环境。
四、Windows 安装 WSL2
1、管理员打开 PowerShell
输入：
wsl --install
然后等待自动安装。
安装完成后：
重启电脑。
2、首次启动 Ubuntu
重启后打开：
Ubuntu
系统会提示你：
创建 Linux 用户名 创建密码
设置即可。
3、更新 Linux 环境
进入 Ubuntu 后执行：
sudo apt update && sudo apt upgrade -y
五、安装 Node.js
Ubuntu 推荐使用 nvm。
1、安装 nvm
执行：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
然后：
source ~/.bashrc
2、安装 Node.js
执行：
nvm install 20
切换版本：
nvm use 20
验证：
node -v
npm -v
六、安装 Codex CLI
现在开始正式安装。
官方 GitHub：
https://github.com/openai/codex
官方推荐安装命令：
npm install -g @openai/codex
等待安装完成。
七、验证安装是否成功
输入：
codex --version
如果输出类似：
0.134.0
说明安装成功。
八、登录 ChatGPT 账号
这是很多人最容易卡住的地方。
运行：
codex
首次启动会出现：
Sign in with ChatGPT
选择后：
浏览器会自动打开。
登录你的 ChatGPT 账号即可。
支持：
Free Plus Pro Team Enterprise
九、国内用户常见问题
1、npm 下载慢
建议切换镜像：
npm config set registry https://registry.npmmirror.com
2、安装失败
先升级 npm：
npm install -g npm
然后重新安装。
3、权限问题
如果出现：
EACCES
不要直接 sudo npm install。
推荐：
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
然后：
export PATH=~/.npm-global/bin:$PATH
十、Mac 安装方法
Mac 最简单。
直接：
brew install --cask codex
或者：
npm install -g @openai/codex
十一、Linux 安装方法
Ubuntu / Debian：
npm install -g @openai/codex
或者直接下载二进制文件。
十二、第一条 Codex 指令
进入你的项目目录：
cd my-project
然后启动：
codex
输入：
帮我解释这个项目
Codex 会自动：
扫描目录 分析代码 理解依赖 总结架构
这时候你会第一次感受到：
“Agent 和 ChatBot 完全不是一个东西。”
十三、Codex 三种工作模式
官方提供三种模式：
1、Suggest（默认）
只能建议。
不会自动执行。
适合新手。
2、Auto Edit
自动修改文件。
但执行命令前会询问。
3、Full Auto
全自动。
可以：
修改代码 执行命令 自动运行
启动：
codex --full-auto
注意：
一定要在 Git 仓库里使用。
十四、我最推荐的新手玩法
别一上来就让它写项目。
最好的入门方式是：
1、让它读项目
解释这个仓库
2、让它找 Bug
帮我找潜在问题
3、让它生成文档
帮我生成 README
4、让它补测试
帮我给这个模块写测试
这是最容易感受到：
AI Agent 已经开始真正参与开发。
十五、Codex 和 Cursor 有什么区别？
很多人会问：
都是 AI 编程，有什么不同？
简单理解：
Codex 最大优势：
官方生态 Terminal 原生 Agent 化能力强 自动化能力高
十六、重要安全提醒
最近已经出现：
恶意 npm 包伪装成 Codex 工具窃取 Token 的事件。
所以一定注意：
只安装官方版本
官方 GitHub：
https://github.com/openai/codex
官方安装包：
npm install -g @openai/codex
不要随便安装：
codex-ui
codex-helper
codexui-android
之类第三方包。
十七、为什么我认为 Codex 会越来越重要？
因为未来的 AI 编程：
不是：
问答式 Copilot
而是：
Agent 自动工作流
未来程序员会逐渐变成：
AI 工作流设计师 多 Agent 协作者 软件架构指挥官
而 Codex、Claude Code、Gemini CLI：
正在成为下一代开发入口。
十八、最后总结
如果你以前只用过：
ChatGPT DeepSeek Qwen 豆包
那么当你第一次真正跑起 Codex 时，
你会明显感觉到：
AI 已经从“补全工具”，变成了“执行型 Agent”。
它开始：
读代码 改代码 执行命令 自动工作
而这，
可能只是 AI 编程的开始。
觉得有用，记得点个赞 👍
后面还会继续更新：
Codex 十大高阶玩法 Codex + MCP Codex 多 Agent 工作流 Codex 自动化开发 Claude Code 对比 Codex AI 编程全景图
关注我，持续更新 AI 实战内容。