拆解 Claude Code 的 Harness:51 万行源码里的七个设计判断
作者静态阅读 Claude Code 泄露的约 51 万行 TypeScript 源码,把其 harness 设计归纳为七个判断,核心是模型负责提议、运行时负责裁决。
能拿走七条 harness 约束的具体落法,包括退出原因枚举、工具三层契约、并发安全默认 false、权限默认拒绝、压缩按代价分层;前提是只做静态源码阅读,阈值和顺序会被 feature flag 与环境变量覆盖。
技术方向
怎么把模型跑得更快更省钱:推理加速、显存与成本、服务部署与基础设施选型。
545 条精选近 30 天 539 条共收录 2,452 条
作者静态阅读 Claude Code 泄露的约 51 万行 TypeScript 源码,把其 harness 设计归纳为七个判断,核心是模型负责提议、运行时负责裁决。
能拿走七条 harness 约束的具体落法,包括退出原因枚举、工具三层契约、并发安全默认 false、权限默认拒绝、压缩按代价分层;前提是只做静态源码阅读,阈值和顺序会被 feature flag 与环境变量覆盖。
作者记录了在 macOS 上用 Codex CLI 配好 chrome-devtools-mcp 1.12.0 的完整流程,解决每个新会话弹一次 Chrome 连接授权、AI 开网页抢占前台标签页的问题。
能拿走 quiet 启动器脚本和 Codex 用户级 MCP 配置,让多个 AI 会话复用同一条 Chrome 常驻连接并强制后台开页;代价是首次连接仍要点一次允许,且脚本绑定 1.12.0 包内模块,升级需同步改。
作者在系列第 4 篇中给出生产 Agent 工具执行层的完整做法,按注册、参数校验、鉴权、并行与串行、超时重试、结果写回对话的顺序拆解,技术栈为 TypeScript + Zod。
能拿走一套 Tool Runtime 骨架,含 Zod 参数校验、登录态鉴权、幂等键与错误分类重试,落到软件工厂的 Agent 执行层;代价是要自己接 IAM、下游幂等和沙箱,框架不代劳。
文章把 Agent 终止策略分成三种流派,硬上限数步数、预算计量数花费、行为分析看操作签名和工具模式,并指出硬上限无法区分正常长任务和死循环。作者给出自己的多维度 CycleDetector 实践,含工具四级分类阈值、参数变化时计数减半、连续失败 ErrorStreak 独立安全线,以及先注入提示自愈、再升级人工确认的两阶段响应,兜底硬上限设在 5000 步。
可拿走三档终止策略的对比表和工具四级阈值、减半计数、每维度独立自愈计数器这套配置,落到软件工厂的 Agent 派单流程;代价是要自己实现行为窗口和工具分类,阈值需按场景调。
作者把 CUDA out of memory 拆成加载、条件编码、采样首步、采样中途、VAE Decode、后处理六个失败阶段,主张先保存完整 traceback 和 allocated/reserved 记录定位边界,再逐项验证权重、激活、缓存和碎片等候选原因。
按加载、条件编码、采样首步、采样中途、VAE解码、后处理六个阶段分诊 OOM,配一张处置矩阵和最小复现法,能直接换掉现在一遇 OOM 就砍分辨率的做法;代价是要先存完整 traceback 和 allocated/reserved 记录,作者未在真实 GPU 上验证。
文章给出流式结构化输出在前端边收边渲染的三步做法,用栈式补全器把半截JSON补成合法对象、按帧或50ms节流解析、并规定半截数据只展示不提交。作者实测27000个chunk每个都完整JSON.parse约32.7秒,每50个chunk解析一次降到约0.53秒。
能拿走一套半截JSON补全加节流的完整做法,含35行栈式补全器和按帧节流参数,落到软件工厂的前端流式渲染;代价是要自己处理半截数字闪烁和半截数据误提交。
Nodecode 发布开源智能体,以单进程跑在 SBCL 上,模型只有一个 eval 工具,用 Lisp 在运行中的程序里定义新工具并保留,多数版本更新无需重启即可生效。
可借鉴它把工具定义写成独立文件、git 提交、启动即加载的自改写机制,以及上下文整段保留加按需召回的做法;代价是无沙箱,eval 与聊天消息都按用户权限执行,需放进容器或 VM 再长期跑。
作者基于 @modelcontextprotocol/sdk 1.30 和 Express 5,总结把 MCP Server 从 stdio 换成 Streamable HTTP 后上线前要处理的五件事:鉴权、会话状态、可观测性、超时控制、工具名治理。
能直接抄走 requireBearerAuth 校验、session Map 管理、AbortSignal 超时和工具名前缀白名单四段代码,落到本地模型部署和 Agent 工具接入这条线;代价是 stateful 的 Map 只在单进程内有效,横向扩展要换 Redis。
Browser Use 作者整理了让 Claude Code、Codex、Gemini CLI、Cursor 等编程智能体使用已登录 Chrome 的六种接法,包括浏览器扩展、远程调试端口、Chrome DevTools MCP、claude --chrome、Codex 与 Gemini CLI 的 MCP 接法以及 Manus 云端沙盒。
六种让智能体借用已登录 Chrome 的接法逐条对比,含 --remote-debugging-port 加独立 --user-data-dir 的具体启动参数和 MCP 三件套调用链,可落到本地调试与部署流水线;代价是默认全标签页可见、2FA 仍需人接管。
作者以虚构的运维助手 OpsPilot 为例,用 TypeScript 讲清 ReAct 循环怎么从一次 Function Call 扩展成可停、可失败、可追问的多步 Agent。
能拿走一套 TypeScript 版 ReAct 循环骨架,含 tool_call id 配对、失败写成 Observation、并行等齐、maxSteps 与同参重复检测,可直接替换单次 Function Call 就收工的写法;代价是要自己写各家适配层并处理取消与中断续跑。
德国埃尔朗根-纽伦堡大学(FAU)团队用三个真实馆藏数据集实测 8 个 7B 以下开源 VLM 的结构化 JSON 抽取能力,发现 OCR 专用小模型在 mAP-F1 上几乎全为 0,通用指令模型微调后才是赢家。
能拿走的是选型口径和避坑清单,结构化抽取优先测通用指令 VLM 而非 OCR 专用小模型,微调配 HPO 是主策略,图像预处理和多阶段训练要先验证;代价是结论只对被测版本负责,楼梯表测试集仅 25 张。
作者给出一个只用 Python 标准库、可直接运行的 AI 网关实现,把统一协议、虚拟密钥、分级超时与分类重试、熔断、令牌桶限流和按租户账本收进同一层。代码自带假上游,前两次返回 429 后成功,四个演示场景分别验证重试、预算前置拒绝、租户限流隔离和熔断快速失败。文中指出生产版还需补流式三档超时、取消信号传到上游和有界队列,账本也要从进程内字典换成 Redis 或数据库。
能拿走一份仅用 Python 标准库的网关实现,含虚拟密钥、分级超时、分类重试加抖动、三态熔断、令牌桶和按租户账本,直接换掉业务里散落的厂商调用;代价是账本为进程内字典,多副本需换 Redis,流式三档超时与取消传播要自己补。
dbreunig 在 AGNTCon 的演讲中梳理了上下文工程的演进,指出长上下文带来上下文投毒、分心、混淆和冲突四类失败模式,并给出六种修复手段。这些手段包括上下文增强、工具筛选、上下文隔离、裁剪、卸载和压缩,作者用 DSPy 演示约 16 行代码即可把四种修复装进 harness。
能拿走六种上下文修复手段的具体做法,包括工具筛选、子智能体隔离、按轮裁剪和先判相关性再压缩,落到软件工厂的 agent 编排上;代价是要自己写决策模型和 loadout 函数,还得留意 prompt 缓存。
AgentTrust 发布一套厂商无关的零信任策略层,为 LangChain、CrewAI、AutoGen、OpenAI Assistants、Anthropic Tool Use 等框架上的自主智能体提供权限管控与审计。
能拿走一套可落地的多智能体权限收窄与人工审批方案,含子智能体能力衰减、风险评分阈值 0.65 触发人工复核、ECDSA 签名审计链,代价是需自建 Node 服务并接入各框架运行时。
NeuronDump 是一个 MIT 许可的开源工具,读取 Ollama 和 llama.cpp 使用的 GGUF 文件,展示层、注意力头、词表和权重统计,并可删除未使用部分后写出仍能在 Ollama 和 llama.cpp 中运行的更小 GGUF。
能拿 GGUF 元数据把模型画成可展开的 3D 图,按层、头、专家做剪枝并直接看加载与困惑度变化,落到本地模型部署这条线;代价是要 Rust 1.88 以上自行编译,模拟影响需加 trace 特性,且目前只在 Windows 的 Ollama 模型上测过。
Optio 是 MIT 许可的开源智能体编排平台,可把编码 agent 和自动化跑在自己的 Kubernetes 集群或本机上,从提示词一路走到 pull request。
能拿走的是把编码 agent 跑在 K8s 池化 pod 里、按 git worktree 隔离仓库任务的做法,可接到软件工厂那条线;代价是要自备 K8s、PostgreSQL、Redis 和各家 agent 的凭证。
Radian 是一个 Rust 单二进制编码 agent,启动无需运行时,读文件按行号范围读,上下文窗口快满前自动压缩。它的 radian exec 无头命令把每一步按 JSON 逐行输出,退出码区分完成、失败和超出预算,同一会话文件可在全屏界面里接着跑。
能拿走的是 radian exec 的 JSONL 逐步输出加退出码区分完成失败超预算,把编码 agent 塞进 CI 或别的编排器;代价是 Linux 沙箱要装 bubblewrap,且它只被调度不调度别人。
冬奇Lab 复盘了一次 Jira Skill 模型选型评测,指出原报告单 case 采样、AI 自判对错、任务与真实使用不一致等问题,重测后推翻了原结论。
可拿走脚本逐字判分、100 case×3 采样、按错误模式分严重程度这三条做法,替换掉单 case 加 AI 当裁判的评测流程;代价是要先备好 ground truth 和判分脚本。
Cognition 发布三个 Agent Skills,用于在仓库中定位并修补 PHP、Node.js 和自管理 GitLab 的远程代码执行漏洞,可在 Devin、Claude Code、Codex、Cursor 等读取 SKILL.md 的编码智能体中运行。
三个 SKILL.md 技能按清点、审批门、确认版本存在、镜像内前后跑测试、单仓单 PR 的流程打补丁,可搬进软件工厂的依赖升级线;代价是要 Docker、镜像仓库权限和逐仓人工审批。
mnemonic-proxy 是一个夹在编码 Agent 和本地模型之间的透明 HTTP 代理,Agent 照常发送完整历史,由代理决定模型实际读到什么,旧消息和工具输出被替换成带 id 的一行回执,原文逐字留在磁盘上可随时取回。
能拿走的是透明 HTTP 代理这一层做法,把旧工具输出换成带 id 的一行回执、原文留在磁盘供 recall 取回,并关掉客户端自带压缩;代价是引擎窗口至少 16K、需配 --slot-save-path 才有秒级恢复,且小模型常不主动调 recall。