什么是Codex？

Codex 是 OpenAI 推出的 AI 编程助手命令行工具。简单说就是：你在终端里用自然语言说我要做什么，Codex 就能自动写代码、改代码、调bug——全程在你电脑的终端里完成，不需要打开浏览器，也不需要什么复杂的IDE插件。

它和 GitHub Copilot 最大的不同是：Copilot 是在编辑器里补全代码的提议者，而 Codex 是独立工作的执行者——它能自己创建文件、运行命令、处理错误、迭代修改，就像一个真正的程序员坐在你旁边帮你干活。

第一步：安装 Node.js

Codex 依赖 Node.js 运行时环境。打开终端输入：

node -v
npm -v

如果能看到版本号（例如 v22.x.x），说明已经安装了 Node.js，直接跳到第二步。

如果提示 command not found，需要先安装：macOS 用户去下载 LTS 版本，双击安装包一路下一步即可，也可以用 Homebrew：brew install node。Windows 用户同样去下载 Windows 安装包（.msi），运行安装向导，注意勾选 Add to PATH 选项。

第二步：安装 Codex

在终端中输入：

npm install -g @openai/codex

如果下载速度慢，可以先设置国内镜像源：

npm config set registry https://registry.npmmirror.com

安装完成后验证：

codex --version

第三步：配置 API Key

Codex 需要连接 AI 服务才能工作。在终端输入：

codex setup

按提示输入你的 API Key 即可。API Key 可以在 OpenAI 控制台获取。如果你使用的是第三方代理服务，需要在配置文件中指定代理地址。在用户目录下的 .codex 文件夹中创建 config.toml 文件，内容包含 model 和 apikey 配置。

第四步：开始使用

配置好了，就可以开始和 Codex 对话了。常用命令：

# 让 Codex 在当前目录下工作
codex "帮我创建一个React项目，包含一个简单的计数器组件"

# 让它修改已有代码
codex "帮我把这个Python脚本中的时间格式化改成中文"

# 让它解决bug
codex "这个函数报错了，帮我找缘由并修复"

Codex 会自己读取你的代码文件，理解上下文，然后执行操作。

常见问题与避坑指南

Q1: 安装时报错 permission denied？

macOS/Linux用户在前面加 sudo：sudo npm install -g @openai/codex。Windows用户以管理员身份打开 PowerShell 再执行安装命令。

Q2: 安装后输入 codex 提示 command not found？

这是 npm 全局安装路径没加到系统PATH。先运行 npm prefix -g 查看路径，然后把这个路径加到系统的环境变量PATH里。Windows用户在系统属性-环境变量中添加，Mac用户编辑 ~/.zshrc 文件。

Q3: Windows PowerShell 提示无法加载文件，禁止执行脚本？

以管理员身份运行 PowerShell，输入：Set-ExecutionPolicy RemoteSigned

Q4: Codex 说 API Key 无效？

检查 API Key 是否在控制台正确生成、是否有空格或换行、环境变量是否正确设置。

Q5: 国内网络连接超时？

如果使用的是第三方代理服务的API，确保 config.toml 中的 base_url 正确配置了代理地址。

Q6: Codex 和 OpenClaw / Hermes 有什么区别？

Codex 是专注于编程任务的AI工具，核心能力是写代码、改代码、调试。OpenClaw 是通用的AI网关平台，可以接入各种技能扩展。Hermes 是自带自进化能力的AI运行时。简单说：Codex是你的AI程序员，OpenClaw是你的AI管家，Hermes是你的自进化AI助手。三者功能互补，并不冲突。

整体耗时：10-15分钟。 如果一切顺利，十分钟内就能从零开始跑通第一个Codex任务。