Codex Harness

Codex Harness 是 OpenAI 于 2026 年 8 月 19 日正式完全开源的 AI Agent 底层执行框架，采用 Apache-2.0 协议发布在 GitHub openai/codex 仓库。截至开源当日，仓库已累计获得 107,443 Star 和 16,354 Fork，成为 AI Agent 基础设施领域最受关注的开源项目之一。

Codex Harness 负责驱动 Codex 全系列产品的底层运行——包括 Codex Web、Codex CLI、VS Code 插件和 macOS 桌面应用。它管理 Agent 的核心执行循环：对话状态持久化、上下文压缩与记忆管理、工具调用、沙箱安全执行、流式事件推送以及人工审批介入。官方将这种设计哲学总结为「your application owns product context, business rules, and tools; Codex app-server provides the agent loop」——模型不直接面向用户，而是被 Harness 封装为可控、可审计、可持久化的能力输出。

该框架包含三大核心组件。第一，codex exec 是轻量级 CLI 工具，支持非交互式运行有边界的 Agent 工作流，适合 CI/CD 流水线、一次性脚本和后台批处理任务，返回结构化输出。第二，Codex SDK 提供官方编程接口（TypeScript/Python），支持在应用程序中启动、恢复、流式传输 Codex 任务，精确控制线程和任务的生命周期，并可切换到任何兼容 OpenAI Responses API 的模型提供商。第三，Codex app-server 是产品级嵌入的核心模块，通过 JSON-RPC 协议与应用保持持久会话，支持实时事件流、任务中断、自定义工具暴露和人工审批回调，可将 Agent 无缝嵌入运营看板、客服工作台、内部工具等场景。

Harness 的架构以 Rust 核心（codex-rs）加 TypeScript SDK 双栈实现，定位偏向生产环境嵌入。核心模块包括：app-server 驱动 VS Code 插件和桌面 App 的 JSON-RPC 服务；exec-server 提供非交互式任务执行；sandboxing 实现跨平台沙箱隔离；execpolicy 执行策略与权限控制；skills 提供可复用 Skill 框架；hooks 实现生命周期钩子；tools 是工具调用运行时；mcp-server 支持 MCP 协议。

OpenAI 公布的测试数据显示，在 ARC-AGI-3 基准测试中，仅通过 Harness 层面的优化（保留推理和上下文压缩），GPT-5.6 Sol 模型的得分就从 13.3% 提升至 38.3%，同时输出 Token 数量减少六倍。这证明了 Harness 执行层设计对模型实际表现的决定性影响。

目前已有实际落地案例：税务机构 Thrive Holdings 利用 Codex Harness 构建专业税务申报系统，成功处理 7,000 份申报表并将准备时间缩短三分之一；科技公司思科在其云控制平台中嵌入 Codex SDK，用户可直接用自然语言创建自定义应用，底层复杂逻辑由 Harness 在后台静默处理。

开发者可通过 GitHub 仓库获取完整代码，支持通过 curl 一键安装 CLI，并提供详细的部署文档与 SDK 参考。