OpenAI Codex CLI：在终端本地运行的轻量级编码智能体

本文介绍 OpenAI Codex CLI，一个开源的终端编码智能体。该项目让开发者可以直接在本地终端中用自然语言描述编程任务，由智能体完成代码修改、文件操作和命令执行。

项目简介

Codex CLI 是 OpenAI 开源的轻量级编码智能体项目，仓库地址为 openai/codex。截至目前，该项目在 GitHub 上已获得超过 9.2 万 stars，主要使用 Rust（约 96.3%）编写，少量 Python、TypeScript 和 Shell 脚本辅助构建与测试。

与基于浏览器的 Codex Web 或 IDE 插件不同，Codex CLI 直接运行在本地终端中，适合喜欢命令行工作流的开发者。

核心特性

• 本地运行：智能体完全在本地计算机上执行，代码不离开你的环境。
• 自然语言交互：用日常语言描述需求，Codex 自动规划并执行相应操作。
• 多平台支持：提供 Mac、Linux 和 Windows 的安装方式。
• ChatGPT 账号登录：可直接使用 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 计划中的 Codex 额度。
• API Key 支持：也支持通过 OpenAI API Key 使用，需额外配置。
• IDE 与桌面端补充：同一生态还有 VS Code/Cursor/Windsurf 插件，以及独立的 Codex App。

技术栈

• Rust — 核心运行时与 CLI 实现
• Python — 部分脚本与测试工具
• TypeScript / Shell / PowerShell — 构建、安装脚本与平台适配
• Bazel — 构建系统
• pnpm — 前端/Node 依赖管理

安装指南

前置要求

• 稳定的网络连接
• macOS、Linux 或 Windows 系统
• 可选：ChatGPT 账号或 OpenAI API Key

安装步骤

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
npm install -g @openai/codex

# 使用 Homebrew
brew install --cask codex

安装完成后，在终端运行 codex 即可启动。

快速开始

# 启动 Codex CLI
codex

# 登录 ChatGPT 账号或配置 API Key
# 然后直接输入任务描述
"帮我给这个项目添加一个 HTTP 健康检查接口"

首次运行会提示登录，建议选择 ChatGPT 账号登录以获得更完整的额度支持。

使用示例

场景 1：修改现有代码

# 在已初始化的项目目录中启动 Codex
codex

# 输入需求
"把 utils.ts 中的日期格式化函数改成使用 Intl.DateTimeFormat"

Codex 会读取相关文件、给出修改方案，并在你确认后写入变更。

场景 2：创建新功能

# 输入需求
"创建一个 Express 路由文件，包含用户注册和登录两个接口，使用 bcrypt 加密密码"

Codex 会生成对应文件，并提示你运行测试或安装依赖。

场景 3：运行测试或命令

# 输入需求
"运行所有测试，如果失败就定位第一个错误并尝试修复"

Codex 可以调用本地 shell 命令，循环执行测试-修复流程。

注意事项

• Codex CLI 需要联网使用，核心模型调用在 OpenAI 服务端完成，但代码执行在本地。
• 使用 ChatGPT 账号登录通常比单独配置 API Key 更简单，且额度与订阅计划绑定。
• 由于会执行本地命令和修改文件，建议在受信任的代码仓库中使用，并留意 Codex 的每一步操作确认。
• 项目采用 Apache-2.0 许可证，可自由 fork 和二次开发。

项目链接

• GitHub 仓库：https://github.com/openai/codex
• 官方文档：https://github.com/openai/codex/blob/main/docs
• ChatGPT Codex Web：https://chatgpt.com/codex
• 最新 Release：https://github.com/openai/codex/releases