OpenAI Codex CLI — 架构设计与核心模块原理
1. 项目概述
- 项目:
openai/codex—— OpenAI 的本地编码 Agent(Codex CLI) - 核心定位:在用户本机运行的编码智能体,支撑三种宿主形态:终端 TUI、IDE 插件(经 app-server)、非交互 exec 模式
- 代码规模:Rust workspace 含约 90–115 个 crate(
codex-rs/Cargo.toml),crate 统一以codex-前缀命名;另有codex-cli(Node 包装层)与sdk/ - 主要语言:Rust(核心)+ TypeScript(CLI 分发包装)
- 构建系统:同时使用 Bazel(根目录
MODULE.bazel)与 Cargo workspace
设计哲学(见 codex-rs/docs/protocol_v1.md)是:Core 引擎与 UI 解耦 —— "Codex runs locally, either in a background thread or separate process",并通过一对队列 SQ(Submission Queue,UI→Core) 与 EQ(Event Queue,Core→UI) 通信。任何 UI(TUI、桌面 App、IDE 插件、MCP 客户端)都可驱动同一个 Core。
关键抽象












