Codex SDK
Codex SDK 是 OpenAI 的官方 Codex 软件开发套件，为应用代码提供一个直接的编程接口，用于启动、续接或流式执行 Codex 任务。它和 Codex App Server 是“把 Codex 作为平台”框架（见 Codex 的「Codex 作为平台」小节）里的集成层之一，面向的是需要在自有代码里编排 Agent 的开发者。
两种集成形态
OpenAI 把它们并排介绍：
| 集成形态 | 定位 | 说明 |
|---|---|---|
| Codex SDK | 程序化工作流 | 应用代码启动 / 续接 / 流式执行 Codex 任务；SDK 简化常见程序化工作流，适合需要 out-of-box 编程接口的场景 |
| Codex App Server | 产品级集成 | 让应用连接本地 Codex 进程，保持对话打开、流事件、中断、暴露工具与审批；给产品团队对生命周期与用户体验的直接控制 |
差别不在底层能力（都复用同一个开源 harness），而在集成粒度：SDK 更适合“在自己的脚本/服务里调用 Codex 任务”；app-server 更适合 Agent 本身就是产品核心时，把循环和审批交回产品掌控。若要做有界的一次性批处理（脚本 / CI / 后台任务），还有更轻的 codex exec（见 Codex CLI / harness 相关条目）。
与 Claude Agent SDK 的对照
OpenAI 的 Codex SDK 与 Anthropic 的 Claude Agent SDK 处于同一类产品位置：把一家厂商成熟的编码 Agent harness 封装成供应用代码调用的库。区别在于起点与工具面——Claude Agent SDK 暴露的是 Claude Code 的文件读写、Bash、搜索、编辑、MCP、权限与 Hook 能力；Codex SDK 暴露的是 Codex harness 对 Responses API（响应 API）、工具调用、沙箱与审批的驱动能力。
与 OpenAI Agents SDK 的区别
Codex SDK 与 OpenAI Agents SDK 常被混淆为同一回事，但它们处于不同的抽象层次：Harness Engineering（驾驭工程） 栈里 codex 是「已闭环的编码 Agent」，Agents SDK 是「组装 Agent 的编排框架」。
| 维度 | Codex SDK | OpenAI Agents SDK |
|---|---|---|
| 本质 | 把完整编码 Agent（Codex harness）封装成可编程接口，任务启动 / 续接 / 流式执行 | 通用 Agent 编排框架：定义 Agent、Tools、handoff、guardrails、tracing、sandbox |
| 循环所有权 | Codex 的 agent 循环、shell、文件编辑、沙箱、审批全部内置，不用从零拼 harness | SDK 帮你运行工具循环与 agent run，但业务流程、多 Agent 责任边界由应用自己设计 |
| 对齐产物 | 相当于 Claude Agent SDK 的位置：成熟编码 Agent 的库化 | 更接近 Responses API 之上的业务编排层 |
| 多 Agent | 以单一编码任务为主（内部可启 subagent） | 原生多 Agent：handoff、manager/specialist、tracing 语义 |
| 典型用法 | 在应用 / 脚本 / CI 里调用 Codex 的编码能力 | 客服分诊、退款、多步研究、多 Agent 工作流 |
一句话区分：Codex SDK 是把「生产写代码的 Agent」当作产品调用的库——你无需从头构建编码 harness；OpenAI Agents SDK 是自己组装 Agent 的工具箱——编排原语由它给，业务责任由你织。 两者都会复用它 harness，但起点相反：Codex 从「已闭环 Agent」出发给接口，Agents SDK 从「编排框架」出发让你组 Agent。既可直接复制编码 Agent 能力，也可用编排框架搭自己的业务 Agent；需要多 Agent handoff 与业务状态时选 Agents SDK，需要现成编码 harness 时选 Codex SDK。
相关概念
- Codex — SDK 所属的 OpenAI 软件 Agent 产品家族
- Codex — SDK 作为集成层之一的架构模式（同父页还含 App Server）
- Responses API（响应 API） — Codex harness 与 SDK 借以驱动模型推理和工具调用的底层 API
- Agent Loop（智能体循环） — 任务启动/续接/流式执行所维持的执行循环
- Claude Agent SDK — Anthropic 的对应产品层
- Harness Engineering（驾驭工程） — SDK 所属的“把 Agent 执行基础设施变成可嵌入组件”的工程面