OpenAI Codex 产品全景
调研时间:2026-06-22 源码 commit:98845e4 仓库:github.com/openai/codex (Apache-2.0)
一句话定位
Codex 不再是单一 API 或单一工具,它是 OpenAI 围绕代码 agent 构建的完整产品族:从终端 CLI 到桌面 App 到 IDE 插件到云端任务到 SDK,覆盖开发者的全部交互界面。
产品矩阵
| 产品 | 定位 | 入口 | 源码证据 |
|---|---|---|---|
| Codex CLI | 本地终端 coding agent(开源核心) | codex 命令 |
codex-rs/cli/ |
| Codex App | 原生桌面和移动体验 | codex app |
app-server-daemon/ |
| VS Code Extension | IDE 集成 | Marketplace 安装 | app-server/README.md |
| IDE 集成 | Cursor/Windsurf 支持 | developers.openai.com/codex/ide | README.md |
| Codex Web | 云端异步 agent | chatgpt.com/codex | README.md |
| Cloud Tasks | 远程任务提交 | codex cloud |
cloud-tasks/src/cli.rs |
| Python SDK | 编程嵌入 | pip install openai-codex | sdk/python/ |
| TypeScript SDK | 编程嵌入 | npm @openai/codex-sdk | sdk/typescript/ |
架构统一性
所有产品界面共享同一个 Rust 引擎 + App-Server 协议:
flowchart TD
subgraph Engine["引擎层 (codex-rs, 124 Rust crates)"]
CORE[Core Engine]
SANDBOX[Sandbox]
MEM[Memory]
end
subgraph Protocol["协议层"]
AS[App-Server<br/>JSON-RPC 2.0]
end
subgraph Surfaces["界面层"]
CLI[CLI TUI]
APP[Desktop App]
VSC[VS Code]
MOB[Mobile]
end
Engine --> Protocol
Protocol --> CLI
Protocol --> APP
Protocol --> VSC
Protocol --> MOB
传输层支持:stdio(默认)/ WebSocket(实验性)/ Unix Socket(控制面)
协议核心原语:Thread - Turn - Item 三层结构
历史演进
| 时间段 | Codex 指代 |
|---|---|
| 2021-2023 | Codex 语言模型 API(code-davinci-002),已弃用 |
| 2025+ | Codex agent 产品族(本文档描述的内容) |
仓库 AGENTS.md 明确声明:Within this context, Codex refers to the open-source agentic coding interface (not the old Codex language model built by OpenAI)
模型支持
内建模型目录
| 模型 | 上下文窗口 | 定位 |
|---|---|---|
| gpt-5.5 | 272K | Frontier model for complex coding |
| gpt-5.4 | 272K (max 1M) | Strong model for everyday coding |
| gpt-5.4-mini | 272K | Fast and cost-efficient |
| gpt-5.3-codex | 272K | Coding-optimized (有升级提示) |
| gpt-5.2 | 272K | Professional work (有升级提示) |
| codex-auto-review | 272K (max 1M) | 自动审批审查 (hidden) |
[源码] codex-rs/models-manager/models.json
第三方 Provider
| Provider | 协议 | 备注 |
|---|---|---|
| Ollama | Responses API | 本地模型,端口 11434 |
| LM Studio | Responses API | 本地模型,端口 1234 |
| Amazon Bedrock | AWS SigV4 | 云端跨 provider |
| 自定义 | Responses API | config.toml model_providers |
重要约束:仅支持 Responses API。Chat Completions API 已被移除。
部署模式
| 模式 | 命令 | 特点 |
|---|---|---|
| 本地 CLI | codex |
TUI 终端交互 |
| App Server | codex app-server |
JSON-RPC 给 GUI 前端 |
| 远程 Daemon | codex app-server daemon bootstrap --remote-control |
SSH 部署,自动更新 |
| Cloud Tasks | codex cloud submit |
异步远程执行 |
| DevContainer | .devcontainer/ |
开发环境(含防火墙) |
认证方式
| 方式 | 适用场景 |
|---|---|
| ChatGPT 登录 | 消费者用户 |
| API Key | 开发者 |
| Personal Access Token | 个人认证 |
| Agent Identity | Agent-to-Agent |
| Bedrock SigV4 | AWS 环境 |
竞品界面对比
| 维度 | Codex | Claude Code | Cursor | Windsurf |
|---|---|---|---|---|
| CLI | 有(核心) | 有(核心) | 无 | 无 |
| 桌面 App | 有 | 无 | 有(IDE) | 有(IDE) |
| VS Code 插件 | 有 | 有(Beta) | N/A | N/A |
| 云端异步 | 有 | 无公开 | 无 | 无 |
| SDK | Python + TS | 无公开 | 无 | 无 |
| 开源 | Apache-2.0 | 部分开源 | 闭源 | 闭源 |
| 本地模型 | Ollama/LM Studio | 无 | 无 | 无 |
产品策略洞察
OpenAI 的 Codex 策略是一个引擎全覆盖:
- 开源 CLI 建立开发者社区和信任
- IDE 插件抢占编辑器入口
- 云端 Agent 服务化变现
- SDK 让第三方构建 on top of Codex
124 个 Rust crate 的 workspace 是巨大工程投入,形成技术壁垒:三平台 OS 沙箱需要系统编程深度,JSON-RPC 协议稳定后形成生态锁定,Responses API 绑定引导开发者选用 OpenAI 模型。
局限性
- 仅支持 Responses API,无法兼容 Chat Completions API 的 provider [源码]
- Cloud Tasks 依赖 OpenAI 托管服务,无法自部署 [源码]
- 移动端体验未开源 [观察]
- 本地模型体验较弱,提示模板针对 GPT-5 系列优化 [源码]
- 定价与 ChatGPT 绑定,企业独立部署选项有限 [推测]
证据等级汇总
| 结论 | 来源 |
|---|---|
| 产品矩阵含 CLI/App/VS Code/Cloud/SDK | [源码] README.md + 各子目录 |
| 124 Rust crates workspace | [源码] codex-rs/Cargo.toml |
| 模型目录含 gpt-5.2 到 gpt-5.5 | [源码] models-manager/models.json |
| 支持 Ollama/LM Studio/Bedrock | [源码] 各 provider crate |
| 仅支持 Responses API | [源码] model-provider-info |
| Cloud Tasks 后端为 chatgpt.com | [源码] cloud-tasks/src/cli.rs |
| App-Server Daemon 支持 SSH | [源码] app-server-daemon/ |
| 与旧版 Codex API 完全不同 | [源码] AGENTS.md 声明 |