OpenAI Codex 三大开源组件：exec、SDK、app-server 用法全解
· 阅读需 12 分钟
很多人以为"强大的 AI Agent = 好模型 + 好 Prompt"。但实际上，模型之上还叠着一整套底层执行系统（Harness）：理解任务、维护对话记忆、调用工具、实时展示进度、处理失败、请求人类审批。这部分决定了 Agent 能不能真正"干活"，也决定了把 Agent 嵌进产品时的体验上限。
OpenAI 在开源仓库 openai/codex 里把这套 harness 的三个组件开放了出来，分层恰好对应三种不同的接入方式：
| 组件 | 形态 | 一句话 | 适合场景 |
|---|---|---|---|
| codex exec | CLI 子命令 | 非交互式跑完一个任务 | 脚本、CI、一次性后台任务 |
| Codex SDK | TypeScript / Python 库 | 在应用代码里启动/恢复/流式监听任务 | CI/CD、内部工具、应用集成 |
| Codex app-server | 本地 JSON-RPC 服务 | 把 Agent 变成你产品的"一等公民" | 持久对话、实时事件、打断、自定义工具、审批 |
下面逐个过用法，代码片段可以直接跑。