信息卡

一句话定位

Codex 是 OpenAI 官方开源的轻量级编码代理，定位为"runs locally on your computer"，即直接在开发者本地终端里读写代码、执行命令并完成任务的 AI 结对编程工具。除 CLI 主形态外，同一仓库还辐射出 VS Code/Cursor/Windsurf 的 IDE 扩展、`codex app` 桌面应用以及 chatgpt.com/codex 云端版本，构成 OpenAI 编码代理产品矩阵的统一入口。

趋势解读：为什么火

终端原生代理已经成为各大模型厂商的标配战线，Codex 以官方身份开源了整个客户端实现，既透明可审计又允许深度定制，配合 ChatGPT 订阅即可使用的低门槛策略（无需单独购买 API 额度），使其长期稳居编码代理星标榜前列；本月一万七千余星的净增反映出终端代理正从尝鲜走向大众工作流。

核心功能拆解

• 本地终端运行：在用户机器上直接读写文件、执行 shell 命令、迭代开发，尊重项目原有工程结构。
• 多形态覆盖：CLI、IDE 扩展、桌面 App 与云端 Codex Web 四种入口共享一致体验。
• 账号即额度：首次运行推荐 Sign in with ChatGPT，Plus/Pro/Business/Edu/Enterprise 订阅计划的使用额度直接生效。
• 交互式 TUI：终端内的对话式界面，实时展示模型的思考、修改与命令执行过程。

以下为结合公开文档的背景知识补充：Rust 重写后提供多档沙箱模式（read-only / workspace-write / danger-full-access）与审批策略控制文件与网络权限；支持 ~/.codex/config.toml 配置文件、AGENTS.md 项目指令、非交互式 codex exec 子命令用于 CI 场景，并内置 MCP 客户端能力。

架构与技术栈浅析

仓库由早期 TypeScript 版本迁移为 Rust 实现，跨平台编译产物覆盖 Apple Silicon、Intel macOS 与 Linux x86_64 musl 等目标。安装器默认从 releases.openai.com 分发并提供 GitHub Releases 兜底通道，源码归档附校验和以便企业环境离线部署，整体体现了官方项目的供应链规范。

安装与环境要求

官方脚本支持 macOS/Linux/Windows 三平台；另有 npm 全局包 @openai/codex 与 Homebrew cask 两种常备通道，GitHub Releases 页可手动下载对应平台二进制解压使用。

curl -fsSL https://chatgpt.com/codex/install.sh | sh          # macOS / Linux
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"   # Windows
npm install -g @openai/codex                                  # npm 方式
brew install --cask codex                                     # Homebrew 方式

快速上手示例

安装后在任意项目目录启动：

codex       # 进入交互界面，建议选择 Sign in with ChatGPT 登录

登录成功后即可用自然语言下达任务，例如让它梳理模块依赖、修复失败测试或按 issue 实现功能；API key 调用方式也可行但需额外配置步骤。

进阶使用要点

• 用配置文件固化默认模型、审批级别与沙箱档位，减少每次重复输入。
• 在仓库根放 AGENTS.md 描述构建命令与约定，可显著提升任务一次成功率。
• CI 或脚本场景用 codex exec 做非交互调用，配合只读沙箱保安全。
• 强制走 GitHub Releases 时设置环境变量 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false。

典型应用场景

• 日常结对编程：终端里描述需求让代理自己改代码跑测试直至通过。
• 批量例行任务：codex exec 驱动升级依赖、清理告警等机械性工作。
• IDE 内联协作：VS Code 扩展读当前编辑器上下文精准局部修改。

同类生态位对比

对比 Claude Code，两者同为终端代理标杆，差异在于 Codex 与 ChatGPT 订阅体系及自家模型矩阵绑定更紧、且以 Apache-2.0 开源客户端换取定制自由度；对比 Gemini CLI 等追赶者，其生态成熟度与产品形态完整度仍居第一梯队。

资源导航

• 仓库：https://github.com/openai/codex
• 官方文档：https://developers.openai.com/codex
• 云端版本：https://chatgpt.com/codex