codex 学习笔记 — 知识地图

项目概览

OpenAI Codex 是一个开源的 Rust 编码代理 CLI 工具。核心设计包括基于 LLM 的自主代理循环（Agent Loop）、Landlock/Seatbelt 文件系统沙箱、Ratatui 终端 UI、MCP 协议支持，以及 IDE 集成 SDK。项目采用 Cargo workspace 组织多 crate 架构。

架构全景

学习路径

主题依赖关系

各主题之间的前置知识关系：

建议学习顺序：架构概览 → 代理循环 → 沙箱系统 → 终端界面 → 非交互模式 → MCP 协议 → 配置系统 → 应用服务器协议 → SDK 与 IDE 集成 → CLI 调度器

知识索引

核心机制知识点

| 概念 | 主题 | 预计用时 | 术语 | | -------------------- | ---------------------------- | -------------- | ------ | ----------------------------- | -------------------- | | Agent Loop 执行流程 | 代理循环 | 30 min | Agent Loop | | Context 上下文管理 | 代理循环概念 | 20 min | Context Management | | Rollout 执行策略 | 代理循环概念 | 15 min | Rollout | | Apply Patch 补丁应用 | 代理循环概念 | 15 min | Apply Patch |

安全沙箱知识点

| 概念 | 主题 | 预计用时 | 术语 | | ------------------- | ------------------------- | ---------- | ------ | --------------------- | ------------ | | Landlock Linux 沙箱 | 沙箱系统 | 25 min | Landlock | | Seatbelt macOS 沙箱 | 沙箱概念 | 20 min | Seatbelt | | ExecPolicy 执行策略 | 沙箱概念 | 15 min | ExecPolicy | | 文件系统权限隔离 | 沙箱概念 | 15 min | — |

界面与交互知识点

| 概念 | 主题 | 预计用时 | 术语 | | ------------------ | --------------------------- | ---------------- | ------ | -------------------- | ----------- | | Ratatui TUI 渲染 | 终端界面 | 25 min | Ratatui | | 流式输出与差异展示 | 终端界面概念 | 20 min | — | | Exec 非交互模式 | 非交互模式 | 20 min | — | | Ephemeral 临时执行 | 非交互模式概念 | 10 min | Ephemeral |

协议与集成知识点

| 概念 | 主题 | 预计用时 | 术语 | | ------------------------- | ---------------------------- | ----------------- | ------ | ------------------------------ | --------------------- | | MCP 工具协议 | MCP 协议 | 30 min | MCP | | App Server 协议 | 应用服务器协议 | 25 min | App Server Protocol | | Backend Client 后端客户端 | 应用服务器概念 | 15 min | Backend Client | | SDK 开发工具包 | SDK 与 IDE 集成 | 30 min | — |

配置与架构知识点

| 概念 | 主题 | 预计用时 | 术语 | | -------------------- | ------------------------ | -------------- | ------ | -------------------------- | ----------------- | | config.toml 配置 | 配置系统 | 20 min | Config.toml | | JSON Schema 验证 | 配置系统概念 | 10 min | — | | CLI 调度器 | CLI 调度器 | 25 min | — | | Cargo Workspace 组织 | 架构概览 | 20 min | Cargo Workspace |

💡 每个主题包含 4 个页面（概览、概念、练习、代码走读），预计每个主题总计 45–60 分钟。全部 10 个主题约 8–10 小时。

学习进度

• 01 架构概览
• 02 代理循环
• 03 沙箱系统
• 04 终端界面
• 05 非交互模式
• 06 MCP 协议
• 07 配置系统
• 08 应用服务器协议
• 09 SDK 与 IDE 集成
• 10 CLI 调度器