如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题
Aug 19, 2026 Codex

将 Codex 作为开发平台:基于开源智能体执行框架构建应用

将 Codex 集成到用户已经熟悉的产品和工作流程中。

作者: Nicolas Bonamy, Derrick Choi

将 Codex 作为开发平台:基于开源智能体执行框架构建应用

大多数人通过 App、命令行界面或 IDE 扩展程序认识 Codex。这些使用方式很重要,但同一套底层系统还有许多其他用途。

这些体验都由开源的 Codex 执行框架提供支持。它帮助模型收集上下文、针对任务进行推理、使用工具、在设定的范围内运行、请求审批,并持续推进工作。

有了这套框架,开发者可以构建更多类型的软件。您无需让每个团队都把工作转移到通用编程助手中,而可以将智能体集成到针对实际工作设计的软件中,例如工程工作流程、运营仪表板、安全调查工具、客户支持控制台,或为某个专业团队定制的内部应用。

可以复用的是智能体循环

一个能完成实际任务的智能体,需要的不只是一条提示词和一次模型回复。它需要理解任务、持续维护上下文、查看相关信息、调用工具、展示进度、处理失败,在必要时请求人工审批,并返回有用的结果。

支撑这些操作的系统就是执行框架。

执行框架的设计可以显著影响结果。在 ARC-AGI-3 测试中,通过保留推理过程并压缩上下文,GPT-5.6 Sol 的得分从 13.3% 提升到了 38.3%,同时输出 Token 数量降至原来的六分之一。

我们构建 Codex 执行框架,用它管理对话状态、以流式方式呈现执行过程、使用工具、落实已配置的沙盒和审批策略,并在多轮对话中持续推进工作。Codex app-server 通过有文档说明的客户端协议提供这些能力。应用可以创建线程、启动对话轮次、接收事件和处理审批请求。

如果您正在开发需要智能体的软件,可以从 Codex 入手,省去从头构建运行时的工作,再决定哪些职责应由应用承担。

开发者可以查看并按需调整的开源执行框架

由于执行框架是开源的,您可以查看应用与模型之间这一层的实现,了解它如何运行,并根据产品需求调整集成方式。

开发者可以从以下几个方面入手,让智能体适应自己的产品:

  • 界面。团队可以保留现有的仪表板、编辑器、队列、地图、记录和审批流程,无需将所有交互都搬到通用聊天窗口中。

  • 上下文和工具。应用可以向智能体提供特定工作流程所需的系统、文档、数据和操作,包括应用自身的 MCP 服务。

  • 运行边界。宿主应用可以决定智能体在哪里运行、可以访问哪些文件或工具、哪些操作需要审批、如何观察执行过程,以及如何将结果写回保存正式记录的系统。

我们以开源组件的形式发布了 Codex CLI、app-server 和官方 Codex SDK。开源组件指南列出了可用组件及其所在位置。

开源部分涵盖执行框架和集成接口。模型访问和托管服务则单独提供。

选择合适的集成层

基于 Codex 构建应用时,可以根据使用场景选择集成方式。

  • 对于脚本、CI 作业或一次性后台任务,codex exec 可以在限定范围内运行智能体工作流程,并返回结构化输出。

  • 如果应用代码需要启动或恢复 Codex 任务,或以流式方式接收任务进展,官方 Codex SDK 提供了可直接调用的编程接口。

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

如果智能体是产品本身的一部分,请使用 Codex app-server。应用可以通过它连接到本地 Codex 进程、保持对话、以流式方式接收事件、中断任务、提供工具并响应审批请求。SDK 简化了常见的编程工作流程,而 app-server 让产品团队可以直接控制智能体的生命周期和用户体验。

围绕工作流程构建软件

比起换个标志再做一个 Codex App,更值得探索的是根据个人或团队已有的工作方式来设计软件。

安全分析师可能需要查看待调查事项队列、近期告警和受影响的服务,并在创建修复工单前完成审批。支持工程师可能需要查阅账户历史、产品日志和内部文档,还需要一份回复草稿。产品团队可能希望在任务看板上将某个事项移到就绪状态时,就能启动范围明确的实施流程。

在这些场景中,界面都是使用体验的重要组成部分。它让智能体了解用户正在查看什么,为智能体提供合适的工具,也让用户可以审阅接下来要执行的操作。

架构图展示了应用管理的界面、业务上下文和用户授权,Codex app-server 提供的智能体循环和沙盒执行能力,以及应用通过 MCP 提供的数据和操作。

图 1. 您的应用负责管理产品上下文、业务规则和工具,Codex app-server 提供智能体循环和沙盒执行能力。

示例:Relay

我们基于 Codex app-server 构建了运营示例应用 Relay。它在一个虚构的货运仪表板旁嵌入智能体,为智能体接入应用自身的 MCP 工具,并要求在重新预订货运服务前获得人工批准。

用户无需从头编写提示词,只要选择一票货物,然后点击比较补救方案等操作即可。应用提供相关上下文,Codex 检索最新的示例运营数据,智能体解释可选方案。任何会产生重大影响的写入操作都需要审批。

Codex 随后可以使用应用的 MCP 工具获取当前数据,再据此建议操作,或在获得批准后执行操作。工具更新底层记录后,应用会刷新业务视图。执行框架负责智能体循环、对话状态、执行动态的流式传输以及与工具的交互,仪表板、记录和操作控件仍由产品管理。

Relay 使用预先填充的虚构数据,但这种集成模式具有通用性。它同样适用于事件响应、账户运营、研究工作流程,以及其他需要智能体在现有产品中工作的应用。

Relay 货运运营仪表板显示了异常事项队列、货运详情,以及正在调查货运延误的 Codex 智能体。

图 2. Relay 将 Codex 嵌入货运运营仪表板,由应用提供 MCP 工具,对会产生重大影响的操作则要求人工审批。

开发者正在构建哪些应用

已有公开案例采用了这种模式:

  • GitHub 和 JetBrains 将 Codex 集成到现有的 IDE 工作流程中。

  • Cisco 在 Cisco Cloud Control 的 App Builder 中使用 Codex SDK。

  • Thrive Holdings 和 Crete 在编制纳税申报表的工作流程中使用 Codex,并将税务专业人员的反馈纳入流程。他们在试点期间处理了 7,000 份申报表,将编制时间缩短了约三分之一。

这些应用场景不限于工程领域。支持团队调查客户问题、运营团队协调工作流程、安全团队对事件进行分类处置、销售团队研究客户情况,以及营销团队策划推广活动,都可以采用同样的模式。在每种场景中,应用都负责提供上下文和工具并处理审批,Codex 则驱动底层的智能体循环。

探索更多应用场景

在许多工作中,关键的上下文就在仪表板、时间线、地图、文档或系统记录里。这些视图的价值远不止美观。人们每天都通过它们了解情况、做出决策并掌控工作进程。

比起用一个通用聊天框取代这些界面,更有价值的做法是为它们加入智能体,拓展原有功能。智能体可以理解当前工作、查阅相关上下文、提出下一步建议,并执行已获批准的操作。

Codex App、CLI 和 IDE 扩展程序展示了执行框架的能力。我们将执行框架开源,让开发者可以查看这些能力的实现方式,将其集成到自己的产品和工作流程中,并按需调整。

如果您想基于 Codex 执行框架进行开发,可以先查看开源的 Codex 代码仓库,然后选择适合产品的集成方式。非交互式作业可以使用 codex exec,通过代码运行智能体工作流程可以使用 Codex SDK,需要保持对话、以流式方式接收事件并处理审批请求的应用可以使用 Codex app-server。