Codex 作为平台：基于开放智能体框架进行构建

大多数人通过 App、命令行界面或 IDE 扩展了解 Codex。这些体验很重要，但它们只是同一底层系统的少数几种使用方式。

开源 Codex harness 为所有这些体验提供支持。它帮助模型收集上下文、推理任务、使用工具、在配置的边界内运行、请求批准并推进工作。

这改变了开发者能够构建的东西。你无需要求每个团队将其工作迁移到通用编码助手中，而是可以将智能体引入围绕实际工作设计的软件：工程工作流、运维仪表板、安全调查、客户支持控制台，或为某个专门团队构建的内部应用。

可复用的部分是智能体循环

一个强大的智能体不仅仅是一个提示和模型响应。它需要一种方式来理解任务、随时间维护上下文、检查相关信息、调用工具、展示进度、处理故障、在必要时请求人工批准，并返回有用的结果。

这个外围执行系统就是 harness。

harness 的设计可以实质性地改变结果：在 ARC-AGI-3 上，保留推理和上下文压缩将 GPT-5.6 Sol 的得分从 13.3% 提升到 38.3%，同时将输出 token 减少了六倍。

我们构建了 Codex harness 来管理会话状态、流式执行、使用工具、强制执行配置的沙箱和批准策略，并跨轮次推进工作。通过 Codex app-server，我们通过有文档记录的客户端协议公开这些能力：应用可以创建线程、启动轮次、接收事件并处理批准请求。

如果你正在构建需要智能体的软件，可以从 Codex 开始，而不是发明新的运行时，然后再决定外围应用应该拥有什么。

因为 harness 是开源的，你可以检查你的应用与模型之间的层，了解其行为方式，并调整集成以适配你的产品。

这赋予开发者对使智能体适配其产品部分的控制权：

我们发布 Codex CLI、app-server 和官方 Codex SDK 作为开源组件。我们的开源组件指南列出了可用内容以及每个组件的位置。

开源层是 harness 和集成接口；模型访问和托管服务保持独立。

基于 Codex 构建并不要求每个用例都使用相同的集成方式。

如需可运行的示例，请参阅 Codex SDK 文档。

当智能体本身是产品的一部分时，请使用 Codex app-server。它让你的应用程序能够连接到本地 Codex 进程、保持对话开启、流式传输事件、中断工作、暴露工具并响应审批请求。SDK 简化了常见的编程工作流；app-server 则让产品团队能够直接控制生命周期和用户体验。

最有趣的机遇不是换一个标志来复制 Codex 应用，而是构建能够反映特定个人或团队现有工作方式的软件：

安全分析师可能需要一个调查队列、近期警报、受影响的服务，以及在创建修复工单前的审批步骤。支持工程师可能需要账户历史、产品日志、内部文档和一份回复草稿。产品团队可能想要一个任务看板，将问题移入就绪状态即可启动一个限定范围的实施工作流。

在每个示例中，界面都是体验的重要组成部分。它告诉智能体用户正在查看什么，为其提供合适的工具，并为用户提供一个审查后续操作的地方。

我们基于 Codex app-server 构建了 Relay 作为示例运营应用程序。它将智能体置于一个虚构的货运仪表盘旁，将其连接到应用程序拥有的 MCP 工具，并要求在重新预订货运前进行人工审批。

用户并非从头开始编写提示。他们选择一个货运并点击诸如 比较恢复方案 之类的操作。应用程序提供相关上下文，Codex 检索最新的示例运营数据，智能体解释可用的选项，任何有重大影响的写入操作都需要审批。

随后，Codex 可以使用应用程序的 MCP 工具在推荐操作前获取当前数据——或在获得批准后执行操作。当工具更改底层记录时，应用程序会刷新其业务视图。运行框架负责智能体循环、对话状态、流式活动和工具交互；产品继续拥有其仪表盘、记录和控件。

Relay 使用虚构的种子数据，但集成模式是通用的。相同的模式可用于事件响应、账户运营、研究工作流，或任何智能体应在现有产品体验内工作的其他应用程序。

这种模式已经出现在公开的实现中：

GitHub 和 JetBrains 将 Codex 引入现有的 IDE 工作流。
Cisco 在 Cisco Cloud Control 的 App Builder 中使用 Codex SDK。
Thrive Holdings 和 Crete 在包含从业者反馈的税务准备工作流中使用 Codex。他们的试点处理了 7,000 份报税表，并将准备时间缩短了约三分之一。

这些示例并不局限于工程领域：同样的模式也适用于调查客户问题的支持团队、协调工作流的运营团队、对事件进行分类的安全团队、研究客户账户的销售团队，以及制定营销活动的营销团队。在每种情况下，应用程序提供上下文、工具和审批，而 Codex 则驱动底层的智能体循环。

对于许多类型的工作，核心上下文都基于仪表板、时间线、地图、文档或系统记录。这些视图的存在并非为了美观：它们正是人们实际理解正在发生的事情、做出决策并保持掌控的方式。

机会不在于用一个通用聊天框取代这些界面，而是通过赋予它们一个能够理解工作、调查正确上下文、提出下一步建议并执行已批准操作的智能体，使这些界面变得更加强大。

Codex 应用、CLI 和 IDE 扩展展示了该框架的能力。通过将该框架开源，我们为开发者提供了一种方式，让他们能够检视这些能力、将其集成，并使其适配自己的产品和工作流。

如果你想基于 Codex 框架进行构建，请从开源 Codex 仓库开始，然后选择适合你产品的集成方式：用于非交互式任务的 codex exec、用于编程化智能体工作流的 Codex SDK，或用于需要持久对话、流式事件和审批处理的应用程序的 Codex app-server。