夜雨聆风OpenAI前段时间出了个叫Codex的终端AI编程工具，GitHub上已经8万多星了。周末折腾了两天才完全跑通，中间踩了好几个坑。这篇把安装到跑通第一个任务的完整步骤写下来，帮你省掉那些试错时间。
先说Codex是什么
简单说，Codex是一个跑在你终端里的AI编程助手。跟GitHub Copilot那种在编辑器里补全代码的不太一样——你直接在终端里跟它对话，它帮你写代码、跑命令、调试问题。更像是一个能理解你项目的AI同事。
它是开源免费的（GitHub搜openai/codex），最新版本是v0.134.0。支持Mac、Linux，Windows可以通过WSL2跑。新版还加了个 codex app 桌面GUI指令，不过这篇主讲CLI安装。ChatGPT Plus用户直接登录账号就能免费用，非Plus的需要自备API Key。
安装前的准备
需要的东西不多：
· Node.js 22以上版本（用npm安装方式的话）· 终端（Mac用自带终端，Windows用WSL2的终端）· OpenAI API Key（或者在用的第三方API Key）
检查Node.js版本：在终端里输 node --version，如果低于22需要先升级。没有Node.js的去nodejs.org下载安装就行。
Windows用户注意：Windows不支持直接装，需要先装WSL2。具体步骤：打开PowerShell管理员模式 → 输 wsl --install → 重启 → 装好Ubuntu → 在Ubuntu终端里继续下面的步骤。
—
安装Codex（三选一）
方法一：npm全局安装（推荐）
最简单的方式，一行命令搞定：
npm install -g @openai/codex
国内用户如果npm慢，加个镜像参数：
npm install -g @openai/codex --registry=https://registry.npmmirror.com
装完后输 codex --version 检查是否成功，看到版本号就说明装好了。
npm安装过程示意，实际安装时会有进度条和日志输出
方法二：官方一键脚本（Mac/Linux）
curl -fsSL https://openai.com/codex/install.sh | sh
方法三：Homebrew（Mac用户）
brew install --cask codex
三种方法效果一样，推荐第一种。
—
配置API Key（或跳过）
如果你是ChatGPT Plus订阅用户，直接 codex 启动，浏览器弹窗登录OpenAI账号就行，不需要自己准备API Key。非Plus用户才需要自己配API密钥。
打开终端，设置环境变量：
export OPENAI_API_KEY="你的API Key"
不想每次开终端都输一遍，可以把它加到shell配置文件里（~/.bashrc或~/.zshrc）：
echo 'export OPENAI_API_KEY="你的API Key"' >> ~/.zshrcsource ~/.zshrc
国内用户注意：如果你的网络连不上api.openai.com，需要配一个中转。在 ~/.codex/config.toml 里加上：
openai_base_url = "https://你的中转地址/v1"model = "gpt-4.1"
—
跑通第一个任务
配置完，终端里直接输 codex 启动交互模式。第一次运行会在浏览器里弹出登录页面，用OpenAI账号登录就行。
登录成功后，你就可以在终端里跟它对话了。试试最简单的：
codex -q "写一个Python脚本，读取当前目录下的CSV文件并打印统计信息"
加了-q参数就是不进交互模式，直接执行单次任务。不加就进入对话模式，可以连续聊天协作。看个人习惯，我更喜欢对话模式，可以反复修改和追问。
Codex在终端中的工作界面示意
—
踩过的坑和解决方法
1. npm安装报权限错误Mac/Linux用户用npm全局安装时可能遇到EACCES权限错误。解决方法：加sudo，或者配置npm全局路径。最简单的就是 sudo npm install -g @openai/codex。
2. Windows装不上Windows直接用PowerShell安装脚本会有兼容性问题。正确的做法是先装WSL2，然后在Ubuntu里装。装WSL2的方法上面说了。
3. 登录弹窗没反应有时候浏览器登录完，终端没有收到回调。可以试试 codex login 手动触发登录。
4. 国内网络连不上配中转地址就行。在 ~/.codex/config.toml 里改openai_base_url。如果没有这个文件，手动创建就行。配完可以用 codex doctor 检查配置是否正确。
—
一点使用感受
用了几天Codex，最大的感受是它适合那些"你知道要做什么但不想手写"的任务——搭项目脚手架、写单元测试、批量处理文件。不适合你对业务逻辑完全不清楚的时候让它替你决策。
跟Copilot最大的区别是工作流的不同。Copilot是在编辑器里边写边补全，Codex是在终端里对话式协作。两个不冲突，我两个都在用。
