Codex：运行在终端里的 OpenAI 编码代理

项目地址：https://github.com/openai/codex  协议：Apache-2.0  Stars：124,953  更新：2026-09-18

一、产品深度介绍

（一）它是什么

Codex CLI 是 OpenAI 推出的、运行在本地电脑上的编码代理（coding agent）。官方对自己的定位十分直白：一个「运行在你终端里的轻量级编码代理」。它不属于某个 IDE 的内联补全插件，而是一个可以在命令行里直接对话、读代码、改代码、跑命令的代理式工具。

Codex 其实是一整个产品家族，CLI 只是其中贴近开发者的一种形态。如果你希望在编辑器里使用，可以把 Codex 装进 VS Code、Cursor、Windsurf 等 IDE；如果你想要桌面应用体验，可以运行 codex app 或访问 Codex App 落地页；如果你是想要完全托管的云端能力，则可以使用基于云的 Codex Web。本文聚焦最贴近开源仓库的本地 CLI 形态。

（二）技术表现

从仓库本身的工程结构可以看清它的技术取向：

• 核心语言为 Rust：仓库主语言即 Rust，核心代理逻辑以 Rust 实现，强调性能与本地运行的安全边界。
• 构建系统采用 Bazel：根目录带有 Bazel 构建配置（MODULE.bazel、.bazelrc 等），适合大型 Monorepo 的增量构建。
• 前端与脚本生态用 pnpm/Node：仓库以 pnpm 工作区管理，配合 Node.js 工具链。
• 多语言 SDK：提供 Python 与 TypeScript 等 SDK，方便把 Codex 的能力嵌入到自己的工程里。
• 跨平台交付：发布产物覆盖 macOS（arm64 / x86_64）、Linux（x86_64 / arm64 musl）与 Windows。

小黑配图：小黑坐在终端前，把一句自然语言需求交给 AI 编码代理，代理在隔离沙箱里自主读码、改码、跑测试并交回补丁。

二、主要功能特点与应用场景

Codex CLI 的核心能力可以概括为一个「对话即改动」的循环：你用中文或英文描述想要完成的任务，它读取当前代码库、规划修改、在受控环境里执行命令，然后把生成的补丁交给你确认。它不是一个只做行内补全的插件，而是一个能跨文件、跨步骤完成工作的代理。

• 自然语言改代码：描述需求即可让它新增功能、重构或修复缺陷。
• 读库与解释：让它在庞大的代码库里定位逻辑、解释某段实现。
• 执行命令与验证：在沙箱里运行构建、测试和静态检查，用结果反哺下一步改动。
• 生成可审阅补丁：所有改动以补丁形式呈现，由你决定是否接受。

适用场景包括：日常编码时的快速实现与重构、定位和修复仓库里的 bug、为改动补上单元测试、给陌生代码库做结构讲解，以及作为自动化流水线的一环在本地执行代码级任务。

三、如何安装与使用

在 macOS 或 Linux 上，最便捷的方式是运行官方安装脚本：

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

在 Windows 上，使用 PowerShell 安装脚本：

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

也可以通过包管理器安装：

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

# 使用 Homebrew 安装
brew install --cask codex

安装完成后，直接在终端运行 codex 即可启动。启动后选择「Sign in with ChatGPT」，用你的 ChatGPT 账号登录——官方推荐 Plus、Pro、Business、Edu 或 Enterprise 计划用户直接登录使用。若使用 API Key 方式，则需要额外配置鉴权。想要桌面应用体验，运行 codex app 即可打开桌面端。

独立安装器默认从 https://releases.openai.com/codex 下载资源，若元数据或资源不可用会自动回退到 GitHub Releases。如果你的网络环境更希望强制走 GitHub Releases，可以设置环境变量 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false（取值 0 或 no 同样有效）。

四、官方地址与获取方式

• GitHub 仓库：https://github.com/openai/codex
• 官方文档：https://developers.openai.com/codex
• IDE 集成：developers.openai.com/codex/ide（VS Code、Cursor、Windsurf）
• 桌面应用：运行 codex app，或访问 Codex App 落地页
• 云端版本：chatgpt.com/codex（Codex Web）

五、与同类方案对比

与 IDE 内联补全相比，Codex CLI 的优势在于它是一个能跨越文件、跨步骤完成任务的代理，而不只是补全下一行；与云端 Agent 相比，它的优势在于代码始终留在本地，由你在终端里掌控执行边界。它本质上更接近「把代理装进你的终端」，而不是把补全塞进编辑器。

六、核心机制深度解析

Codex CLI 的运行可以抽象为一个「读—想—做—回报」的代理循环。你给出任务后，模型先理解意图与你的代码上下文，再在受控环境里读取文件、执行命令，把结果反馈给模型继续推理，最终产出一份可由你审阅的补丁。

这种设计的重点在于「人在回路」：模型提出的每一个实质性改动都以补丁形式交给你确认，命令执行也被约束在受控环境里，避免代理在不受监督的情况下随意改动系统。对于企业用户，还可以通过 ChatGPT 的企业计划把使用纳入组织级的合规与权限边界。

七、实用技巧

• 桌面体验一键开启：不想折腾终端时，直接运行 codex app 获取桌面应用形态。
• 编辑器里用：在 VS Code、Cursor、Windsurf 中安装 Codex 扩展，把代理能力放进你的日常工作流。
• 内网 / 离线部署：直接到 GitHub Releases 下载对应平台二进制，并设置 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false 强制走 GitHub 源。
• 选择正确二进制：macOS 选 arm64 或 x86_64 归档，Linux 选 x86_64 或 arm64 的 musl 归档，解压后重命名为 codex 即可。
• 用 API Key 自托管模型：如果不走 ChatGPT 登录，可改用 API Key 接入，但需要按官方文档做额外鉴权配置。

八、最新更新动态

Codex 仓库非常活跃，截至 2026-09-18 仍有高频提交，累计提交数已超过一万次。从近期的演进方向可以观察到几个重点：安装器默认优先从 releases.openai.com 拉取资源并回退 GitHub Releases；桌面端在 Windows 上打包了原生语音运行时；Code Mode 逐步默认切到托管模式；围绕 MCP（模型上下文协议）的策略评估与按应用暴露工具的能力持续完善；守护进程支持把固定包恢复到最新稳定版。

这些动态说明 Codex 正从「单纯的命令行代理」向「覆盖终端、IDE、桌面与云端的统一编码代理平台」演进，安装与运行体验是近期迭代最密集的部分。

九、常见问题 FAQ

十、总结

Codex 把「用自然语言驱动代码改动」这件事搬进了你自己的终端。它的价值不在于又一个补全插件，而在于用一个能在本地读取代码、执行命令、产出补丁的代理，把开发者的意图和最终改动之间的工程步骤封装起来，并始终把确认权留在你手里。配合 Apache-2.0 的开源协议、Rust 实现的本地安全边界，以及覆盖终端、IDE、桌面与云端的家族形态，它适合希望把 AI 代理纳入本地工作流、又不愿把代码轻易送出本机的开发者与团队。

在撰写本文的过程中，我主要参考了 openai/codex 仓库的 README.md、官方文档 developers.openai.com/codex，以及仓库 LICENSE 与发布说明。文中数据以官方公开信息为准，可能随版本更新而变化。