Codex Harness是什麼
Codex Harness 是 OpenAI 開源的 AI Agent 底層執行框架。Codex Harness 是驅動 Agent 的外骨骼,負責任務理解、記憶保持、工具調用、進度展示、失敗處理及人類審批等完整執行循環。開發者可通過 CLI、SDK 和 app-server 三大組件,將 AI 智能體無縫嵌入自有產品、運營看板或業務系統,無需再把工作流硬塞進通用聊天框。

Codex Harness的主要功能
-
Agent 執行循環:驅動 AI 智能體完成從任務理解到結果輸出的完整迭代流程。
-
上下文與記憶管理:在長對話中保持上下文連貫,智能壓縮和審查相關信息。
-
工具與技能調用:支持 AI 靈活調用外部 API、數據庫及自定義業務工具。
-
沙箱安全執行:提供隔離的運行時環境,確保文件系統與網絡操作安全可控。
-
流式事件傳輸:支持實時嚮應用前端推送 AI 的思考過程與執行進度。
-
人類審批介入:在關鍵操作前自動暫停並請求人類確認,實現安全的人機協作。
-
會話持久化:支持跨會話保存和恢復對話狀態、線程與任務生命週期。
-
前後端解耦架構:將審批界面與底層執行循環分離,便於無縫嵌入任意業務系統。

微信關注回覆“開源”,加入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的相關問題
Q:Codex Harness 是什麼?和 Codex 模型有什麼區別?
A: Harness 是驅動 AI Agent 的底層執行引擎,負責任務理解、記憶保持、工具調用、沙箱執行、流式事件和審批流程;而 Codex 模型是生成代碼/推理的「大腦」。Harness 是「外骨骼」,模型是「大腦」,兩者配合才能跑通完整 Agent 工作流。
Q:開源協議是什麼?可以免費商用嗎?
A: Apache-2.0 協議,可以完全免費商用。你可以自由嵌入自有產品、修改源碼、二次分發,無需開源你的上層業務代碼。
Q:必須綁定 OpenAI 的 GPT 模型嗎?能用 Claude 或 DeepSeek 嗎?
A: Harness 是模型無關的編排層,架構上不強制綁定 GPT。但當前官方實現默認對接 OpenAI API,若要替換爲其他模型,需自行適配模型調用層。
Q:三大組件怎麼選?什麼場景用哪個?
A:
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 事件,侵入性極低。