当前位置：首页 > news >正文

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

news 2026/5/26 6:35:57

上周有个朋友问我，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）。先检查一下：

node -v

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

获取 ofox.io API Key

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

macOS 安装

方式 A：Homebrew（推荐）

brew install --cask codex

方式 B：npm 全局安装

npm install -g @openai/codex

方式 C：桌面应用

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

Windows 安装

npm 安装

PowerShell 里运行：

npm install -g @openai/codex

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

npm prefix -g

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

Microsoft Store

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

Linux 安装

npm 安装

npm install -g @openai/codex

二进制安装

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）：

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）：

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

Windows（PowerShell）：

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

跑一下试试

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`，注意大小写