Codex Harness OpenAI 开源的 AI Agent 底层执行框架
Codex Harness是什么
Codex Harness 是 OpenAI 开源的 AI Agent 底层执行框架。Codex Harness 是驱动 Agent 的外骨骼，负责任务理解、记忆保持、工具调用、进度展示、失败处理及人类审批等完整执行循环。开发者可通过 CLI、SDK 和 app-server 三大组件，将 AI 智能体无缝嵌入自有产品、运营看板或业务系统，无需再把工作流硬塞进通用聊天框。
Codex Harness" loading="lazy" />Codex Harness的主要功能
· Agent 执行循环 ：驱动 AI 智能体完成从任务理解到结果输出的完整迭代流程。
· 上下文与记忆管理 ：在长对话中保持上下文连贯，智能压缩和审查相关信息。
· 工具与技能调用 ：支持 AI 灵活调用外部 API、数据库及自定义业务工具。
· 沙箱安全执行 ：提供隔离的运行时环境，确保文件系统与网络操作安全可控。
· 流式事件传输 ：支持实时向应用前端推送 AI 的思考过程与执行进度。
· 人类审批介入 ：在关键操作前自动暂停并请求人类确认，实现安全的人机协作。
· 会话持久化 ：支持跨会话保存和恢复对话状态、线程与任务生命周期。
· 前后端解耦架构 ：将审批界面与底层执行循环分离，便于无缝嵌入任意业务系统。
如何使用Codex Harness
· 获取开源代码 ：前往 GitHub 的 openai/codex 仓库克隆项目，即可解锁完整的 Harness 工具库。
· CLI 快速执行 ：用 codex exec 命令行工具运行有边界的 Agent 工作流，适合脚本和 CI 自动化任务。
· SDK 编程集成 ：通过 TypeScript 或 Python 版官方 SDK，在代码中精准启动、恢复或流式传输 Codex 任务。
· App-Server 产品嵌入 ：部署 Codex app-server，通过 JSON-RPC 协议将 Agent 循环深度集成到自有业务系统。
· 暴露业务工具 ：将应用自身的 API、数据库及操作接口通过 MCP 协议暴露给 Harness，让 AI 调用真实业务数据。
· 配置审批流程 ：在前端接入审批界面，Harness 会在关键操作前自动暂停并请求人类确认，实现安全的人机协作。
· 流式事件监听 ：订阅 Harness 的流式事件输出，在应用前端实时展示 AI 的思考过程与执行进度。
· 注入业务上下文 ：向 Harness 传入产品界面状态、用户行为及业务规则，让 AI 基于真实场景而非通用聊天框工作。
Codex Harness的核心优势
· 开源可嵌入 ：开发者可将 AI Agent 执行循环直接嵌入自有产品、运营看板或业务系统，无需把工作流硬塞进通用聊天框。
· 前后端彻底解耦 ：应用层掌控界面、上下文、工具与审批流程，Harness 层专注 Agent 循环与沙箱执行，通过 JSON-RPC 协议实现通信分离。
· Harness 设计即性能 ：在 ARC-AGI-3 基准上仅优化 Harness（保留推理+上下文压缩），GPT-5.6 Sol 得分从 13.3% 飙升至 38.3%，Token 消耗减少 6 倍。
· 沙箱安全执行 ：内置隔离运行时环境，严格控制文件系统、网络访问与运行时审批，确保 Agent 动作可控、可审计、可回滚。
· 原生 Human-in-the-Loop ：在关键操作前自动暂停并请求人类确认，审批通过后才继续执行，天然适合容错率极低的业务场景。
· 流式事件与持久会话 ：支持实时向前端推送 AI 思考与执行进度，并可跨会话保存和恢复线程状态，适配长周期工作流。
· 模型无关的执行引擎 ：Harness 是编排层而非模型层，可与不同底层模型配合，聚焦「如何管理模型」而非绑定特定模型。
Codex Harness的项目地址
· 项目官网 ：https://developers.openai.com/blog/codex-as-a-platform
· GitHub仓库 ：https://github.com/openai/codex
Codex Harness的同类竞品对比
对比维度 | Codex Harness | LangGraph
核心定位 | 将 Agent 循环作为可嵌入产品的底层执行引擎 | 基于图状态机的 Agent 工作流编排框架
架构设计 | 前后端分离：应用层控制界面/审批，Harness 处理执行循环 | 节点-边模型：开发者定义显式状态流与检查点
审批机制 | 原生内置 Human-in-the-Loop，关键操作自动暂停请求确认 | 需开发者手动在节点间插入中断/审批逻辑
沙箱执行 | 内置隔离运行时，控制文件系统、网络与工具访问 | 无原生沙箱，需依赖外部容器/环境隔离
集成方式 | JSON-RPC 协议连接 App-Server，流式事件实时推送 | 作为 Python/JS 库直接嵌入代码，检查点持久化
适用场景 | 已有成熟业务界面的产品，需 AI 在底层执行且人类掌控审批 | 需要精确控制多步骤状态流转的复杂工作流编排
Codex Harness的应用场景
· 财税合规自动化 ：嵌入税务准备工作流，AI 处理复杂税务逻辑并自动填充申报表，税务师在关键字段审批确认，已验证处理 7,000 份申报表、准备时间缩短约三分之一。
· 企业云平台应用构建 ：如 Cisco App Builder，客户在其云控制平台内使用自然语言创建自定义应用，Harness 在幕后处理权限校验与底层逻辑流转。
· 物流调度异常处理 ：在物流看板中嵌入 Agent，调度员点击「Investigate delay」后，Agent 自动调用 MCP 工具获取实时运单数据、分析延误原因，任何改单操作都需人工审批。
· 运营仪表盘嵌入 ：将 Agent 直接集成到现有运营看板中，实时分析业务指标、触发异常告警、执行修复动作，无需切换至独立聊天界面。
· 安全运维审批 ：安全分析师在预警队列中直接调用 Agent 排查受影响服务状态，高危操作自动触发 Human-in-the-Loop 审批后执行。
Codex Harness的相关问题
A： Harness 是驱动 AI Agent 的底层执行引擎，负责任务理解、记忆保持、工具调用、沙箱执行、流式事件和审批流程；而 Codex 模型是生成代码/推理的「大脑」。Harness 是「外骨骼」，模型是「大脑」，两者配合才能跑通完整 Agent 工作流。
Q：开源协议是什么？可以免费商用吗？
A： Apache-2.0 协议，可以完全免费商用。你可以自由嵌入自有产品、修改源码、二次分发，无需开源你的上层业务代码。
A： Harness 是模型无关的编排层，架构上不强制绑定 GPT。但当前官方实现默认对接 OpenAI API，若要替换为其他模型，需自行适配模型调用层。
Q：三大组件怎么选？什么场景用哪个？
codex exec → 脚本、CI 流水线、后台一次性任务，返回结构化结果。
Codex SDK → 你在写应用代码，需要编程式启动、恢复或流式传输任务。
Codex app-server → Agent 要成为产品的一部分，需要持久对话、实时事件、中断工作和审批处理。
Q：已有业务系统，如何接入 Harness？
A： 通过 Codex app-server 的 JSON-RPC 协议连接。你的应用负责提供「产品界面 + 业务上下文 + 审批流程」，Harness 负责「Agent 循环 + 沙箱执行」，双方通过 Context in / Events out 双向通信。
Q：Human-in-the-Loop 怎么实现？对业务侵入大吗？
A： Harness 在检测到「需审批的操作」时自动暂停 Agent 循环，通过流式事件向前端推送审批请求；用户确认后 Harness 继续执行。业务端只需实现一个审批 UI 并响应 JSON-RPC 事件，侵入性极低。
