图 02 / OpenAI Codex CLI

Codex CLI 运行架构

基于本地 codex 仓库 main @ 2351d9e1b6 的 Cargo 依赖和源码整理:终端界面与 exec 通过 app-server-client 在进程内(或连接远程 daemon)使用 app-server;SDK 与 IDE 等外部客户端经 stdio、Unix socket 或 WebSocket 走同一 JSON-RPC 协议;app-server 再驱动 codex-core 的智能体循环。

使用入口

客户端接入层

协议服务层

智能体内核

模型 · 工具 · 存储

codex 终端界面

TUI · ratatui

codex exec

非交互 · CI 自动化

TypeScript SDK

子进程调用 exec

Python SDK

app-server · stdio

IDE 扩展等客户端

JSON-RPC 外部客户端

app-server-client

进程内 · 远程 daemon

app-server-transport

stdio · Unix · WebSocket

codex app-server

Thread/Turn会话与轮次
事件通知流式进度
审批请求命令 · 补丁
账号配置登录 · 插件

codex-core

ThreadManager多会话管理
Turn 循环模型 ↔ 工具
上下文AGENTS.md · 压缩
工具路由shell · patch · MCP
安全策略execpolicy · 审批
扩展Skills · Hooks

模型 API

codex-api → /responses

MCP 服务器

rmcp-client · stdio / HTTP

命令执行与沙箱

Seatbelt · bwrap · Windows

本地持久化

rollout JSONL · SQLite

写入会话