犀牛鸟 2026 研究笔记 estelledc.github.io

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 策略是一个引擎全覆盖:

124 个 Rust crate 的 workspace 是巨大工程投入,形成技术壁垒:三平台 OS 沙箱需要系统编程深度,JSON-RPC 协议稳定后形成生态锁定,Responses API 绑定引导开发者选用 OpenAI 模型。


局限性


证据等级汇总

结论 来源
产品矩阵含 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 声明