Built 26/04/16 13:13commit cc1e88d
GitHub OpenAI Codex Repository
中文 | English
摘要
这个仓库提供了直接实现证据,说明 Codex 并不是一个套在模型前面的 CLI 薄壳。源码展示的是一个多 crate Rust runtime,把 thread 生命周期、宿主协议处理、鉴权、命令执行、approval 语义、状态持久化和沙箱隔离都当成明确子系统来实现。
来源
- 原始文件: raw/openai/codex/github-openai-codex-repository.zh.md
- 对应英文 raw: raw/openai/codex/github-openai-codex-repository.md
- 上游仓库: https://github.com/openai/codex
- 本地阅读副本:
/root/repos/codex - 本次阅读版本:
b0324f9f0 - 阅读日期: 2026-04-16
核心内容
- 主要实现集中在
codex-rs/下,整体更像一个多 crate runtime,而不是单一终端应用。 codex-rs/app-server/src/codex_message_processor.rs是很强的架构入口,因为它把 login、thread、turn、review 和 command-exec 这些请求主线都串起来了。- 运行时对 thread 和 review 生命周期有显式管理,而不是把所有工作都降成一次性执行。
- 命令执行通过专门的 command-exec 操作管理,而不是藏在通用 agent 输出处理里。
- 仓库中能直接看到 approval policy、execution policy 和 sandboxing 都属于 runtime 主干。
- app-server 与 protocol 相关 crate 的存在说明 Codex 的目标也包括被嵌入、被托管,而不只是作为独立终端二进制运行。
主要代码区域
codex-rs/app-server/codex-rs/app-server-protocol/codex-rs/core/codex-rs/sandboxing/codex-rs/linux-sandbox/
主要判断
- Codex 更应被理解成“带 CLI 进入面的 agent runtime”,而不是“背后连了模型的 CLI”。
- thread / turn orchestration 在代码里足够核心,可以把长生命周期 session 看成产品能力,而不是实现细节。
- 安全架构不是后贴的补丁,而是贯穿配置构建、approval handling、执行策略和沙箱映射层的主线。
- 这个实现也解释了,为什么外部 orchestrator 或 host system 能把 Codex 当成基础设施接入,而不只是一个给人手工操作的工具。
实践意义
如果要分享或评估 Codex,这个仓库是最强的一手证据来源,能把讨论重点从“模型能力”转到 runtime 设计、执行控制和宿主集成能力上。