Harness 是什麼?從 Claude Code 看代理的執行系統
內容修訂與來源核對:2026/10/19。原發表日期保留;以下為修訂內容。
Harness 可以理解為「讓代理人跑得起來的周邊系統」。模型決定下一步之後,還需要程式去執行工具、接回結果、管理上下文,並決定什麼時候暫停或交由人確認。
常見工作
- 整理當前任務、對話與工具回傳的內容。
- 執行模型提出的工具呼叫,處理失敗與後續回合。
- 管理任務狀態、工作階段及操作確認。
- 提供擴充點,讓 Skills、工具或子代理人加入流程。
這是理解系統的整理方式,各產品實作不一定相同,也沒有一份通用的必備元件清單。
以 Claude Code 為例
Claude Code 把模型與程式開發工具放在同一個工作環境中,也提供子代理人等擴充機制。子代理人可以有自己的任務與上下文,但如何分工、允許哪些工具,仍要依設定和產品文件判斷。
Codex 官方的 Harness 說明也把上下文、工具與執行控制視為平台的一部分。這有助於理解:換模型不等於更換整套工作系統。
Harness 與框架怎麼選
直接使用現成代理工具,通常已經在使用它的 Harness。需要自己組流程、接服務或保存跨步驟狀態時,才考慮程式框架。兩個詞的範圍可能重疊,不宜用「最高階」排名。
舊稿以二手文章的原始碼外洩敘事推論內部架構;本次未取得足以支持那些細節的官方證據,已移除相關判斷,改以公開文件介紹可確認的概念。