Codex 官网访问 + 完整安装教程：macOS / Windows / Linux 一次跑通（2026）

上周有个朋友问我，Codex CLI 到底怎么装？折腾了一晚上各种报错。我自己当时也踩了不少坑，干脆写一篇从头到尾跑通的教程，macOS、Windows、Linux 三个系统全覆盖。

Codex 到底是什么

Codex 不是一个单独的产品，是 OpenAI 在 2025 末重启的一组编程入口的统称。它包括桌面应用、IDE 插件、CLI 工具和云端浏览器版本。

对于开发者来说，CLI 版本是最灵活的。但直连 api.openai.com 的体验并不稳定------DNS 解析延迟、连接超时是常态。解决办法是把请求转发到 OpenAI 兼容网关，比如 ofox.io。

安装前的准备

Node.js 版本要求

需要 Node ≥ 22（官方最低测试版本 22.22.0）。先检查一下：

bash 复制代码

node -v

版本不够的话，用 nvm（macOS/Linux）或 nvm-windows（Windows）升级就行。

获取 ofox.io API Key

在 ofox.io 注册账号
进入控制台 → API Keys → Create new key
复制密钥（只显示一次，别忘了存）

macOS 安装

方式 A：Homebrew（推荐）

bash 复制代码

brew install --cask codex

方式 B：npm 全局安装

bash 复制代码

npm install -g @openai/codex

方式 C：桌面应用

从 developers.openai.com/codex 下载 .dmg 文件安装。

Windows 安装

npm 安装

PowerShell 里运行：

powershell 复制代码

npm install -g @openai/codex

装完找不到命令的话，需要把 npm 全局目录加到 PATH。先跑这个看路径：

powershell 复制代码

npm prefix -g

然后把返回的路径加到系统 PATH 环境变量里。

Microsoft Store

搜索"Codex by OpenAI"也能一键装，但不推荐作为主要安装方式。

Linux 安装

npm 安装

bash 复制代码

npm install -g @openai/codex

二进制安装

bash 复制代码

mkdir -p ~/.local/bin
curl -L -o /tmp/codex.tar.gz \
  https://github.com/openai/codex/releases/latest/download/codex-x86_64-unknown-linux-musl.tar.gz
tar -xzf /tmp/codex.tar.gz -C ~/.local/bin/
chmod +x ~/.local/bin/codex

配置 Codex CLI 连接 ofox.io

这步最关键。编辑或创建 ~/.codex/config.toml（Windows 在 %USERPROFILE%\.codex\config.toml）：

toml 复制代码

model = "openai/gpt-5.3-codex"
model_provider = "ofoxio"

[model_providers.ofoxio]
name = "OfoxIO"
base_url = "https://api.ofox.io/v1"
env_key = "OFOXIO_API_KEY"
wire_api = "responses"

设置环境变量

macOS / Linux （写到 ~/.zshrc 或 ~/.bashrc）：

bash 复制代码

export OFOXIO_API_KEY="sk-ofox-xxxxxxxxxxxx"
source ~/.zshrc

Windows（PowerShell）：

powershell 复制代码

[Environment]::SetEnvironmentVariable("OFOXIO_API_KEY", "sk-ofox-xxxxxxxxxxxx", "User")

跑一下试试

bash 复制代码

mkdir codex-test && cd codex-test
codex

进去之后随便给个任务：

复制代码

写一个 Python 的 fibonacci(n) 函数，要求带类型注解和单测

能正常生成代码就说明全通了。

常见错误排查

错误信息	原因	解决方案
`401 Unauthorized`	环境变量没加载或 Key 拼错	重新 source 配置文件；检查 API Key
`404 - Endpoint not found`	base_url 配置有误	检查末尾别多 `/`，确保是 `https://api.ofox.io/v1`
`model not found`	模型 ID 写错了	用 `openai/gpt-5.3-codex`，注意大小写

日常检查清单（90 秒搞定）

node -v ≥ 22.22.0
codex --version 返回版本号（≥ 0.130.0）
cat ~/.codex/config.toml 确认 wire_api = "responses"
echo $OFOXIO_API_KEY 不为空
codex 能进入交互模式

全部通过就没问题了。

Codex 和 Claude Code 怎么选

说句实话，Codex CLI 跟 OpenAI 系模型配合最顺，Claude Code 长上下文表现更稳。如果你主要用 GPT 系列，Codex 是首选；如果项目上下文特别长或者需要跨文件理解，Claude Code 可能更合适。两个都装着，看场景切换就行。