# Codex CLI 三平台安装指南：Windows 原生沙箱、macOS、Linux 差异详解

> Codex CLI 在 Windows/macOS/Linux 上的官方安装方式各是什么？Windows 现在支持原生 PowerShell 运行和沙箱了吗？本文核实官方仓库与文档，讲清一键脚本、npm、Homebrew 各方式与平台差异。
> 更新于 2026-08-04 · 难度 初级 · 来源 https://aicdks.com/guides/codex-cli-platform-guide

[Codex 基础安装教程](/guides/install-codex-cli-china)覆盖了 npm 安装和登录路线，这篇补充**平台差异**：官方现在提供了独立安装脚本，Windows 也已支持原生运行（不再强制 WSL）。以下命令核实自 [openai/codex 官方仓库 README](https://github.com/openai/codex) 与 [OpenAI 开发者文档](https://developers.openai.com/codex/windows)，以官方文档为准。

## 安装方式速查

| 平台 | 官方推荐命令 |
| --- | --- |
| 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](https://github.com/openai/codex/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` 配置：

```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 插件篇](/guides/vscode-ai-extensions)。

## Linux 细节

- 官方脚本或 npm 均可；二进制是 musl 静态链接，Alpine 也能跑；
- 服务器/容器里无浏览器登录不便，建议用 API Key 方式（`export OPENAI_API_KEY=...`）或先在本机登录后复制 `~/.codex/auth.json`（同一账号自用场景）。

## 登录与国内路线

登录两条路（ChatGPT 订阅 / API Key 或中转）在[基础教程](/guides/install-codex-cli-china)已详细展开，不重复。快速链接：没有 Plus/Pro 账号看[ChatGPT 账号与代充专区](/category/ai-账号与服务-chatgpt)；走 API 路线看[Codex 额度专区](/category/api-中转与额度-codex-额度)，中转原理见[这篇](/guides/what-is-api-relay)。

## 下一步

Claude Code 的平台专篇见 [Windows](/guides/claude-code-windows-install)、[macOS/Linux](/guides/claude-code-macos-linux-install)；想在 IDE 里用 Codex 看 [VS Code AI 插件教程](/guides/vscode-ai-extensions)；报错先查[排错指南](/guides/codex-claude-code-troubleshooting)；全部客户端对比看[总览](/guides/ai-coding-clients-overview)。