架构概览

OpenAI Codex 的整体架构设计：Cargo workspace 多 crate 组织、核心模块划分、代理循环与沙箱系统的分层结构。

涵盖内容

章节	核心主题
概念	分层架构、核心组件、数据流
练习	架构图绘制、组件交互分析
代码走读	Cargo workspace、crate 组织、模块入口

核心概念

Codex 采用 Cargo workspace 多 crate 架构设计：

• codex-rs/core：核心代理循环、上下文管理、沙箱抽象
• codex-rs/tui：基于 Ratatui 的交互式终端界面
• codex-rs/exec：非交互式执行模式
• codex-rs/cli：命令行入口与模式调度
• codex-rs/mcp：MCP 协议集成
• codex-rs/app-server：应用服务器协议
• sdk/：IDE 集成 SDK

前置知识

• Rust 编程基础
• Cargo 构建系统
• LLM API 调用基本概念
• 终端 UI 框架基本概念

学习路径

读完本主题后，你将理解：

• Codex 的 Cargo workspace 组织和 crate 依赖关系
• 核心代理循环的入口点和执行流程
• 各模块之间的通信和协作方式
• 从 CLI 入口到代理执行的完整调用链

→ 下一步：代理循环