GitHub - openai/codex

中文 | English

• 仓库地址: https://github.com/openai/codex
• 本地阅读路径: /root/repos/codex
• 本次阅读版本: b0324f9f0
• 阅读日期: 2026-04-16

仓库摘要

openai/codex 是 Codex CLI 及其更广义 runtime 栈的实现源码。这个代码库并不是一个围绕模型调用的薄命令壳，而是一个多 crate Rust 架构，把鉴权、thread 生命周期、命令执行、approval 语义、协议处理、状态持久化和沙箱隔离都当成一级问题来设计。

读完这个仓库后，一个核心判断是：Codex 更适合被理解成 agent runtime，而不是单一终端二进制。CLI 只是其中一个进入面，内部结构明显也在为宿主集成和长生命周期 thread 管理做准备。

高价值发现

• codex-rs/app-server/src/codex_message_processor.rs 是非常高价值的入口，因为它把 login、thread start、turn start、review start 和 command-exec 生命周期这些主路径都暴露出来了。
• 运行时显式支持多种登录流程，包括 API key、ChatGPT、device code 和外部注入的 ChatGPT auth token。
• 命令执行被当成独立子系统管理，而不是模型响应的附带动作。
• 安全是结构性的主线，贯穿配置合成、approval 语义、执行策略和沙箱层。
• 仓库架构表明 Codex 目标不仅是 CLI 使用，还包括 host/app 集成，而不只是交互式终端 session。

关键代码区域

• codex-rs/app-server/
• codex-rs/app-server-protocol/
• codex-rs/core/
• codex-rs/sandboxing/
• codex-rs/linux-sandbox/

本轮阅读中特别提到的路径

• codex-rs/app-server/src/codex_message_processor.rs
• exec_policy.rs
• sandboxing/
• linux-sandbox/

为什么这个仓库重要

这个仓库为很多上层文档里的判断提供了直接证据：Codex 并不只是“模型壳”，而是一套带有持久 thread、宿主协议层、策略化命令执行，以及明确 approval / sandbox 边界的结构化执行系统。