Claude Mods 与 Mutable Software
What it is
Claude Mods 是 Anthropic 推出的 TypeScript/JavaScript 运行时,让 Claude Code 用户以插件形式定制 harness 的执行循环与界面(事件响应、UI 渲染、子 agent 调用)。Thariq Shihipar 视其为 "mutable software"(可变软件)的预演;swyx 在同一框架下提出 Attention Interface:随着模型把越来越多 harness 吸收进权重,剩下的部分转向面对人类,决定 agent 何时打断人、展示什么、哪些决策需要人做。
Why it matters
它代表 harness 从"厂商交付的固定产品"向"用户可改写的运行时"转变。如果 harness 本身成为可编辑对象,Fat Skills, Fat Code, Thin Harness 中"thin harness"的假设就需要重新审视:harness 变薄的是默认实现,变厚的是定制层。在 Human-Agent Interaction 的视角下,这是三家厂商(Anthropic / OpenAI / Cursor)同时探索"人类注意力界面"的产品化路径,只是谁掌握界面设计权不同。
Key points
- 执行循环与 UI 同时可编程:Mods 定制的是 harness 核心循环与界面两个层面,不是 prompt 层包装。适用于 CLI 与 Desktop。事件钩子覆盖 prompt 提交、tool call、turn 结束、界面渲染等。
- 相对 hooks 的实质升级:Mods 在进程内 TypeScript 运行时中执行,作用域暴露对话轮数、token 用量、消息历史等状态;可以 spawn 带完整上下文的子 agent、用 structured output 解析返回结果、修改 UI(hooks 做不到最后一点)。
- Fork 保留缓存:fork 的 agent 继承 prompt cache,使"fork 一个 agent 当分类器"成本极低。Thariq 的标准模式:每个 assistant turn 结束后 fork 一个子 agent 判断"任务是否完成"。
- 六个内置 mods:agents-md、diff、plugin-authoring、sec-default、telemetry、you-should-know。you-should-know 是唯一默认关闭的——它运行一个 side-agent 观察主 agent,把 agent 轨迹中"重要但不易看见"的信息(例如当前编辑的文件有 45 个未提交改动)浮出到提示区。
- 社区样本 ModSmith:swyx 开源的 ModSmith 插件包含 Next Steps Supervisor 等 mods:在编辑文件、运行命令或 >=8 次 tool call 的 turn 结束后,fork 子 agent 生成"下一步建议"按钮。
- 噪声与成本问题:swyx 实测 2026-10-15 之后 111 个 turn 中 99 个触发 Next Steps Supervisor;每次 fork 重读会话,50k token 会话约消耗 5-6k 输入等价 token。当 mod 几乎每个 turn 都发言时,人开始略读——这违背了 Attention Interface 的初衷。
- 信任边界:mods 不是沙箱化的,加载后可读写文件、看到所有 prompt、消耗额度;
--safe-mode下内置 mods 仍运行。第三方 mod 需要阅读代码后再装。 - 三个 Attention Interface 方案对比:ChatGPT Intelligent UI(模型在厂商提供的组件库内为每个回答即时生成界面,控制力最低)、Cursor PR Routing & Approval(团队写策略、固定评审流执行;一个值得注意的规则是修改审批策略的 PR 不能用自己的改动放松审查——策略从 base 分支读取)、Claude Mods(用户与 agent 用代码共建界面本身,可控性最高,责任也转移到用户)。
- mutable software 范式:软件的运行时行为成为用户可修改的表面。swyx 的下一步预期是 harness 主动从会话记录中识别重复摩擦并建议 mod——self-improving harness 的具体形态。
Evidence across sources
| Source | Key Claim | Relevance |
|---|---|---|
| Latent Space — Thariq Shihipar | Mods 能力面(进程内运行时、UI 修改、子 agent、mode 组合)与 Thariq 自用 mods 清单 | 能力定义与 mutable software 命名 |
| swyx — Claude Mods: Flipping the Harness Inside Out | Attention Interface 框架、内置 mods 清单、ModSmith、噪声/成本/信任三问题、三方案对比 | 第二来源;验证框架并把讨论推向"谁设计界面" |
Open questions
- Mods 的定制边界在哪里:哪些 harness 行为仍不可修改?
- 用户改写的 harness 如何升级与回滚,与 自进化 harness 的可组合性如何交互?
- 模型 router mod 与官方可能推出的 auto routing 是什么关系:社区方案会被吸收还是共存?
- swyx 提出的"did it surface something I would have missed / make a decision easier / let me act without distraction"三条测试,能否作为评估任何 Attention Interface 的通用判据?
Prompts for witness
- 如果我能改 Claude Code 的执行循环,第一处改动是什么?它应该成为一个 Mod 还是上游功能?
- 我的个人 workflow 中哪些"一次性分类判断"值得 fork 一个廉价 agent?
- 用 swyx 三条测试评估我自己装的 mods / hooks:有多少是 window-dressing?
- 反向思考:Attention Interface 由模型设计(ChatGPT 路线)真的更差吗?在我的工作流里,"零配置"价值多大?
Related
- claude-code/thariq-claude-code-tuning — Thariq 产品观索引页
- harness-engineering/fat-skills-fat-code-thin-harness — harness 厚薄之辩
- harness-engineering/self-evolving-harness-composability — harness 可组合性
- product-trends/human-agent-interaction — 人类-agent 交互设计六原则
- harness-engineering/agent-code-review-at-anthropic — 审查注意力分配的另一方案
2026-11-01 — From mutable harnesses to mutable personal apps
AI Briefing 2026-11-01 Morning adds a neighboring form of mutability. Patrick Collison describes putting a free-form improvement request in a personal app and letting an agent implement it; he says one user submitted 150 improvements over a few days. This moves the editable surface from the agent harness to the application itself. It is one self-reported example, not evidence that the approach scales reliably.
The same post names the open questions: maintenance, collaboration, security, and reliability. These extend the existing upgrade and rollback questions for mutable harnesses to user-generated changes inside the product.
Source: @patrickc — personal apps as liquid software
Pending Jean review
- harness-engineering/claude-mods-mutable-software —
ai_draft; decide whether user-editable personal apps belong in this concept or need a separate parent after more examples emerge.