Codex CLI 是 OpenAI 推出的一款开源编码助手，它能够在你的本地计算机上读取、修改并运行代码，帮助你更快地构建功能、修复错误以及理解陌生的代码库。你可以在 GitHub 的 openai/codex 仓库中找到其源代码。

安装

你可以通过首选的包管理器进行安装：

# 使用 npm 安装
npm install -g @openai/codex

# 在 macOS 上也可以使用 Homebrew 安装
brew install codex

快速上手

安装完成后，在终端运行以下命令即可启动：

codex

我们推荐你登录自己的 ChatGPT 账户来使用 Codex，它已包含在 Plus、Pro、Team、Edu 或 Enterprise 等订阅计划中。你也可以使用 API 密钥进行身份验证，但这需要额外的配置。

核心用法

Codex CLI 在一个交互式的终端界面中运行。你可以向它下达任何指令，它会读取你的代码库、进行编辑并执行相关命令。你还可以通过提示词（包括图像输入）轻松地引导它的工作流程。

审批模式

为了确保安全，Codex CLI 设计了不同的审批模式。默认模式功能强大且相对安全：

  • 自动模式 (Auto)：这是默认模式。在此模式下，Codex 可以在当前工作目录中自动读取文件、进行编辑和运行命令。但是，当它需要访问工作目录之外的文件或进行网络连接时，会请求你的批准。

  • 只读模式 (Read Only)：如果你只想与 Codex 对话或在动手前进行规划，可以使用 /approvals 命令切换到此模式。

  • 完全访问模式 (Full Access)：在此模式下，Codex 可以不受限制地读取文件、编辑代码、运行命令并访问网络，且无需任何批准。请谨慎使用此模式。

模型与推理

我们推荐使用 GPT-5 模型来获得最佳的编码体验。默认的推理级别是 medium（中等），对于复杂任务，你可以通过 /model 命令将其升级到 high（高）。

此外，也支持通过 API 密钥认证和 --model 标志来使用旧版模型。

脚本化执行

除了交互式界面，你还可以使用 exec 命令以非交互方式运行 Codex：

codex exec "修复 CI 失败的问题"

常见问题

支持哪些平台？

Codex CLI 官方支持 macOS 和 Linux。对 Windows 的支持仍处于实验阶段，我们建议在 WSL (Windows Subsystem for Linux) 环境下运行。

如何更新 Codex？

根据你的安装方式，选择对应的命令进行更新：

# 如果使用 NPM 安装
npm install -g @openai/codex@latest

# 如果使用 Homebrew 安装
brew upgrade codex

要了解更多关于高级配置、MCP 等详细信息，请查阅 openai/codex GitHub 仓库中的代码和文档。

👉 如果你需要 ChatGPT 代充 / Claude / Claude Code / 镜像 / 中转 API：