Codex CLI 三平台安装指南：Windows 原生沙箱、macOS、Linux 差异详解
更新于 2026-08-04 · 本站教程免费，长期更新
Codex 基础安装教程覆盖了 npm 安装和登录路线，这篇补充平台差异：官方现在提供了独立安装脚本，Windows 也已支持原生运行（不再强制 WSL）。以下命令核实自 openai/codex 官方仓库 README 与 OpenAI 开发者文档，以官方文档为准。
安装方式速查
| 平台 | 官方推荐命令 |
|---|---|
| macOS / Linux | curl -fsSL https://chatgpt.com/codex/install.sh | sh |
| Windows | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" |
| 任意平台（有 Node.js） | npm install -g @openai/codex |
| macOS（Homebrew） | brew install --cask codex |
独立安装脚本默认从 releases.openai.com 下载、失败时自动回落到 GitHub Releases。也可以直接去 GitHub Releases 手动下载对应平台二进制：macOS 分 aarch64-apple-darwin（Apple Silicon）和 x86_64-apple-darwin（Intel）；Linux 是 musl 静态链接版（x86_64 / aarch64），几乎所有发行版可用。
Windows：原生运行与沙箱
早期 Codex 在 Windows 上只建议 WSL，现在官方支持原生 PowerShell 运行，并带 Windows 原生沙箱：agent 模式下会阻止工作目录之外的文件写入、未经你确认的网络访问。沙箱有两档，在 ~/.codex/config.toml 配置：
[windows]
sandbox = "elevated" # 或 "unelevated"
elevated：首选，用专用低权限沙箱用户 + 文件系统权限边界 + 防火墙规则，需要管理员批准初始设置；unelevated：回退方案，用受限 token 和 ACL 边界，强度较弱，适合被企业策略限制无法提权的环境。
仍然偏好 Linux 环境的可以继续用 WSL2（在 WSL 终端里按 Linux 方式安装）。注意 WSL1 已不再支持（Codex 0.115 起沙箱改用 bubblewrap）。
已知坑：全新 Windows 上用 npm 安装后 codex 无输出闪退，多为缺 Microsoft Visual C++ 运行库，安装 VC++ Redistributable 后解决；或改用官方 PowerShell 安装脚本（自带依赖处理）。
macOS 细节
- Apple Silicon 与 Intel 都支持，脚本自动识别架构；
- Homebrew 是 cask（
brew install --cask codex），更新用brew upgrade --cask codex； - Codex 还提供桌面 App（
codex app）和 ChatGPT macOS 应用联动（「Work with VS Code」），命令行之外的选择见 VS Code 插件篇。
Linux 细节
- 官方脚本或 npm 均可；二进制是 musl 静态链接，Alpine 也能跑；
- 服务器/容器里无浏览器登录不便，建议用 API Key 方式（
export OPENAI_API_KEY=...）或先在本机登录后复制~/.codex/auth.json（同一账号自用场景）。
登录与国内路线
登录两条路（ChatGPT 订阅 / API Key 或中转）在基础教程已详细展开，不重复。快速链接：没有 Plus/Pro 账号看ChatGPT 账号与代充专区；走 API 路线看Codex 额度专区，中转原理见这篇。
下一步
Claude Code 的平台专篇见 Windows、macOS/Linux；想在 IDE 里用 Codex 看 VS Code AI 插件教程；报错先查排错指南；全部客户端对比看总览。