Codex CLI

工具信息

支持平台macOS / Linux / Windows / VS Code / Cursor / Windsurf / Web

收录时间2026/10/16 19:27:44

Codex CLI 是 OpenAI 推出的编码智能体（coding agent），直接运行在开发者本机上，在终端里读取代码、修改文件并执行命令。它与 IDE 插件、桌面应用和云端 Codex Web 共用同一套能力体系，适合习惯在命令行里推进编码任务的工程师与团队。

核心功能

从官方仓库的说明看，Codex 的重点是「本地运行的编码智能体」与多形态接入，而不是单一的命令行补全工具。

本地编码智能体：安装后执行 codex 即可启动，在本机项目目录中完成任务。
多种接入形态：终端 CLI、IDE 插件（VS Code、Cursor、Windsurf）、桌面应用（codex app）以及云端 Codex Web。
账号体系灵活：支持使用 ChatGPT 账号登录，也支持 API Key 方式（需额外配置）。
安装方式多样：官方安装脚本、npm、Homebrew，以及 GitHub Releases 的各平台独立二进制。

界面与体验

Codex CLI 的主要交互界面是终端：在项目目录中运行 codex，选择登录方式后即可开始对话式地推进任务。官方仓库 README 首屏提供了一张 Codex CLI 的启动界面截图，用于展示终端内的实际呈现。

除了终端形态，官方还提供 IDE 插件与桌面应用入口，方便希望留在编辑器或独立窗口中工作的用户；三者共享同一账号与工作流，可按键鼠习惯选择。

完整使用流程

以下步骤整理自官方 README 的 Quickstart，覆盖从安装到验证结果的完整路径。

前置条件：准备 macOS、Linux 或 Windows 环境（Windows 使用 PowerShell 执行安装命令），并确保可访问官方发布源。
安装（macOS / Linux）：curl -fsSL https://chatgpt.com/codex/install.sh | sh。
安装（Windows）：powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"；也可用 npm install -g @openai/codex 或 brew install --cask codex。
首次启动：运行 codex，选择 Sign in with ChatGPT 完成登录。官方建议用 ChatGPT 账号登录，以便使用 Plus、Pro、Business、Edu、Enterprise 套餐中的 Codex 额度。
完成一个核心任务：在目标项目目录中启动 codex，用自然语言描述要修改或排查的内容，由它在本地读写文件、运行命令。
结果验证：检查它在工作区中产生的文件改动与命令输出，确认无误后自行提交；如需在编辑器内继续，可安装官方 IDE 插件。

官方安装脚本默认从 releases.openai.com/codex 下载，失败时回退到 GitHub Releases；如需强制使用 GitHub Releases，可设置环境变量 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false。

亮点与差异

与纯云端编码助手的差别在于，Codex CLI 强调「跑在你自己电脑上」这一形态，同时保留了云端 Codex Web 与桌面、IDE 入口，用户可以在同一产品内切换工作位置，而不用更换账号体系。

开源仓库（Apache-2.0）公开了安装与构建文档，便于团队评估与自建流程。
同时提供 npm、Homebrew、独立脚本与 GitHub Release 二进制，适配不同环境的落地方式。
同一账号可在终端、IDE、桌面、云端之间延续使用，降低工具切换成本。

典型使用场景

在已有代码库里做批量重构、补测试、排查报错，希望智能体直接在本地跑命令。
终端工作流为主的开发者，用 CLI 承接日常改动，减少在编辑器插件间的切换。
团队统一采用 ChatGPT 套餐，希望以同一账号覆盖 IDE 与终端两种使用方式。

定价

官方说明中，Codex 可以通过 ChatGPT 套餐使用，也可以走 API Key 方式（需额外配置）。

方案	价格	适合谁
ChatGPT 套餐内置 Codex	随 Plus / Pro / Business / Edu / Enterprise 套餐提供（具体额度以官方帮助中心为准）	已有 ChatGPT 订阅的个人与组织
API Key 接入	按 OpenAI API 用量计费	需要自定义鉴权、自动化或平台级集成的开发者
开源代码	免费（Apache-2.0）	想自行构建、审计或二次开发的团队

版本与维护状态

仓库持续维护：README 指向 GitHub Releases 提供 macOS（Apple Silicon / x86_64）与 Linux（x86_64 / arm64）等平台的独立二进制包，并设有 open source fund 说明文档。本次抓取未取得可确认的版本号，实际版本请以官方 Releases 页面为准。

局限与注意

默认推荐 ChatGPT 账号登录；使用 API Key 需要按官方文档完成额外配置。
安装依赖对 releases.openai.com 或 GitHub Releases 的网络连通性，内网环境需提前规划代理或镜像。
独立二进制包解压后的文件名带平台标识，通常需要重命名（例如改为 codex）后再使用。
文档站点与产品页在本次抓取中返回 403，未能核对最新参数与界面细节，界面截图以官方仓库提供的图片为限。

常见问题

以下问题整理自官方 README 已明确的内容，未在官方资料中出现的疑问不作推断。

安装脚本能强制走 GitHub Releases 吗？可以，设置 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false（也接受 0、no）后重新执行安装脚本。
想装到编辑器里怎么办？官方提供 VS Code、Cursor、Windsurf 的 IDE 安装入口，见文档站的 IDE 页面。
想要桌面应用或纯云端形态？桌面端可运行 codex app，云端编码智能体为 Codex Web（chatgpt.com/codex）。
用什么许可证？仓库采用 Apache-2.0 许可证。