文档核验 2026-08-11 · 待自动实测

Codex CLI（OpenAI）

一句话定位：OpenAI 开源、本地运行的终端编码 Agent（Rust 编写，追求速度），能读 / 改 / 跑你当前目录里的代码；ChatGPT Plus / Pro / Business / Edu / Enterprise 套餐内含 Codex 额度，也可用 OpenAI API Key。 适用场景：在终端里让 AI 直接改代码、跑命令、做本地代码评审；配合 VS Code / Cursor / Windsurf 扩展；用 MCP 扩展第三方工具与上下文。

一、前置依赖

系统：macOS / Linux / Windows（原生 PowerShell 或 WSL2）
账号：登录 ChatGPT 账号（套餐含 Codex 额度，推荐）或 OpenAI API Key
Node.js：仅在使用 npm 安装方式时需要

二、安装步骤

macOS / Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh

无人值守安装（CI / 脚本用）：

curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh

Windows（原生 PowerShell）

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

其他安装方式（macOS 也可用）

npm install -g @openai/codex     # 需 Node.js 环境
brew install --cask codex        # Homebrew（macOS）

也可从 GitHub Release 直接下载对应二进制（含 macOS arm64 / x64、Linux musl 等）： https://github.com/openai/codex/releases

独立安装器默认从 https://releases.openai.com/codex 下载，不可用时回退 GitHub Releases；可设 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false 强制走 GitHub。

三、最小可用配置

首次运行会提示登录：

codex

ChatGPT 账号登录（推荐，套餐含额度）
或 API Key：export OPENAI_API_KEY="sk-..." 后运行 codex

审批模式（决定 Agent 能自动做到哪一步）：

codex                # 默认 Suggest：只读 + 提议，改动需你批准
codex --auto-edit    # 自动改文件，跑命令前仍询问
codex --full-auto    # 在沙箱内自主读写执行（目录级、断网沙箱）

四、国内环境坑

账号 / Key：OpenAI 服务在国内访问受限，API Key 与 ChatGPT 登录可能需要代理或海外环境。
网络：安装脚本与 npm 包来自国外源，必要时给终端配代理，或换 npm 镜像源。
沙箱：Windows 上 Full Auto 模式使用 Windows 沙箱；如需 Linux 原生环境用 WSL2。

五、常见报错 → 解决

现象	解决
`codex: command not found`	重载 shell；确认安装脚本成功，或改用 `npm install -g @openai/codex`
登录 / 鉴权失败	确认 ChatGPT 套餐含 Codex 额度，或检查 `OPENAI_API_KEY` 是否正确
更新	重跑安装脚本，或 `codex --upgrade`（npm 方式：`npm update -g @openai/codex`）
卡住 / 超时	确认网络稳定；`CTRL-C` 取消当前步让 Codex 继续

六、实测状态

🟡 文档核验（2026-08-11）：安装命令与步骤取自 OpenAI 官方文档，尚未在本机沙箱实跑验证。后续由站点 CI 定时实跑并更新徽章。

七、官方链接

官方文档（CLI）：https://developers.openai.com/codex/cli/
快速开始：https://developers.openai.com/codex/quickstart
GitHub：https://github.com/openai/codex
npm：https://www.npmjs.com/package/@openai/codex

踩坑交流 / 1v1 配置，加微信 hhummingg