Claude Code
官方文档自称 "the agentic harness around Claude":与自家模型深度耦合的终端编码 Agent,也是把 harness 一词带向大众的产品。
给想弄懂 AI 工程的人的实用指南
Agent Harness 是包在大模型外面的运行时骨架:调用模型、路由工具调用、编排上下文、决定何时停止、用沙盒和审批兜住安全——模型负责思考下一步,Harness 负责让这一步真实发生。
社区常用一个公式:Agent = Model + Harness。同一颗模型,套上 Claude Code 是终端里的程序员,套上 DeepSeek Harness 是能定时整理文档的助手——模型没变,变的是挽具。业内还有句玩笑话:"If you're not the model, you're the harness."
拆一个 Harness
不同产品的实现各异,但骨架高度一致。点击左侧构件,右侧用伪代码展示它的职责——都综合自 Hugging Face 术语指南与各家架构文档。
EleutherAI 发布 lm-evaluation-harness:把"怎么考模型"标准化——固定场景、记录指标。这是 harness 一词最早出圈的用法。
Claude Code、Codex CLI 把"循环 + 工具 + 沙盒"做成终端里的程序员,harness 从评测术语变成用户手里的产品。
DeepSeek Harness 开源"一切皆插件",OpenAI 发文 harness engineering:运行时骨架成为一门显学。
谁在做 Harness
各家叫法不一(harness / 运行时 / scaffolding 偶有混用),内涵高度相似。三个代表,三条路线。
官方文档自称 "the agentic harness around Claude":与自家模型深度耦合的终端编码 Agent,也是把 harness 一词带向大众的产品。
Codex CLI 开源之后,2026 年 2 月官方发文《Harness engineering》:Agent 时代,工程师的角色转向设计、调校和运维这套骨架。
用 "Everything is a Plugin" 把 harness 做成可插拔的开源运行时:模型适配器、工具、审批、连循环本身都能换,也能接别家模型。
此外还有 OpenHands 等开源 harness 与各类自建实现 · 术语边界仍在演化,以各家文档为准。
为什么重要
Hugging Face 术语指南的总结很锋利:"The harness is what makes the agent run."(让 Agent 跑起来的,是 Harness。)社区流传的观察更直白:有团队只换 harness 不换模型,评测名次从三十名开外冲进前五;同一颗模型在不同 harness 里跑分能差出一截——第三方整理,本站未复测,但方向上可信。
上下文窗口里装什么、何时压缩、注入哪些工具结果——模型的"视野"由 harness 编排,context engineering 的主战场就在这里。
模型只产出结构化的"意图"(tool call);读写文件、跑终端、调 API,全部由 harness 在沙盒里落地、回填、留痕。
停止条件、错误重试、步数预算、危险动作审批——Agent 的纪律性不是模型的美德,是 harness 的机制。
依据与事实
EleutherAI 发布 lm-evaluation-harness:评测脚本从此有了统一的名字,"harness" 进入大模型工程词汇表。
SWE-agent 论文提出 Agent-Computer Interface(ACI):为模型设计工具接口,正式成为研究方向——harness 的学术前身。
Claude Code、Codex CLI 相继发布,"循环 + 工具 + 沙盒"被做成千万用户手里的产品,Agent = Model + Harness 成为共识公式。
OpenAI 发文 harness engineering,DeepSeek 开源"一切皆插件"的 harness,Hugging Face 撰文为术语正名——骨架本身成了研究对象。
两个常见误解:① Harness 不是模型的一部分——它跑在你的机器上,属于工程层,换模型不换它也能活;② Harness ≠ Harness.io——那是一家同名的 DevOps 平台公司,纯属重名。另外,社区术语尚未完全统一,读文章时留意语境。
接下来继续了解
它适合谁
选型或自建:理解循环、上下文、审批这些构件,才看得懂产品差异与成本结构。
安全、审计、成本都在 harness 层落袋:审批策略、沙盒、日志是你该问的第一组问题。
ACI、评测方法、harness 与模型协同训练——骨架本身已经是研究对象。
看懂发布会与公告里的新词:再听到 harness,你知道他们到底在说什么。
来源与延伸阅读
01 Hugging Face · Harness, Scaffold, and the AI Agent Terms Worth Getting本页内容整理自以上公开资料,更新于 2026 年 10 月。术语仍在演化中,以各家最新文档为准。
开始动手
剥掉界面、技能与安全件,所有 harness 共享同一颗心脏——一个循环。
while True: r = model.chat(msgs, tools) if not r.tool_calls: break msgs += run_tools(r.tool_calls)
微信扫码关注「大话数据分析」数据 · 分析 · AI 实战