← 全部文章

配置

能用 token 为自己回本的 Claude Code 技能与钩子

你安装的每个技能都是一份小小的订阅,每次会话都要用上下文支付,不管它有没有触发。钩子则是完全不同的一种购买——而钱的去向大部分就在这个差别里。

本文由 Ted Mavera 撰写,他是 HarnessUp 的产品经理,HarnessUp 正是文中所述工具的开发者。本博客的文章在人工智能的协助下撰写,并在发布前由团队审阅。

一台米白色陶瓷机器上装着五个技能卡盒,每个卡盒把橙色硬币圆片送入各自的玻璃管,旁边立着黄铜沙漏,前方摆着一枚脱落的卡盒。

为什么写这篇文章

现在到处都是 Claude Code 技能清单:前十名、最适合前端的、会改变你工作流的。它们都没告诉你的是,清单上的每一条都是一次购买,用和工作本身相同的货币支付,而且不管那天你用没用它,都会扣费。清单排的是有用程度。没人排成本。

这篇写的是后半部分。不是因为技能是笔坏买卖——其中有些是整个 harness 里最好的买卖——而是因为,一个能回本的技能和一个悄悄给每次会话加税的技能之间的差别,是可以测量的差别,而几乎没人去测。

加一个技能时花钱的两种方式

技能有定义,而定义的一部分从会话开始那一刻就在模型的上下文里,这样 agent 才知道这个技能存在、什么时候该用它。那部分就是固定成本:每次会话、每段对话都付,与技能是否真的运行无关。技能真的运行时,它的正文被载入,它的指示塑造接下来的轮次。那是可变成本。

被忽略的是固定那一半,而它以最不有趣的方式累积。十个技能,每一个在会话末尾看起来都很小,合起来却成了每段对话每一轮都要重读的一块。这和其他任何上下文的算术一样:放在对话顶部的东西不是收一次钱,而是一次又一次。

钩子的工作方式不同,而这正是清单最常弄错的地方。钩子是 harness 在某个事件上运行的命令——工具调用之前、编辑之后、会话停止时。大多数钩子根本不增加 token:它们增加延迟,并改变接下来发生的事。一个拦住无用写入、拒绝重复读取或在编辑后编译项目的钩子,花掉你几毫秒,却能退给你整整一轮。用 token 来算,好的钩子近乎免费;坏的钩子贵,不是因为它们读了上下文,而是因为它们失败、重试,或者对什么都触发。

在留下一个技能之前,怎么给它定价

四个问题,按这个顺序。它给开场上下文增加了什么?运行时它增加还是减少了几轮?它产生多少输出?以及,在正常的一周里它到底触发几次?

决定大多数情况的是第四个问题。一个每月触发两次、却每次会话都待在上下文里的技能,是你很少用到的某样东西的订阅。同一个技能,如果写得好,成本只是它在那两次触发时省下的东西的一小部分——但前提是那两次是真的。

我们的面板有一个正好对准这一点的界面。Optimize Harness 显示每个技能、子 agent、插件和服务器的实测成本,旁边配一个关闭开关,并且它刻意拒绝猜:没被测过的东西不给数字。它旁边的 Rules Auditor 对 CLAUDE.md 里的规则做同样的事,显示每一轮都会被重新载入的每个块的固定成本——并给出一个更精简的文件建议,而自己从不动手改它。两者都是 Pro;它们培养出来的测量习惯,比目录里任何单个工具都值钱。

工作台上摊开的一本小小的账簿,两栏用铅笔写了标题,左页上压着一把放大镜,旁边散着几颗黄铜螺丝。
一页是固定成本,另一页是可变成本。大多数清单只读右边那页。

通常能回本的类别

阻止重复读取的东西。 agent 会话里最贵的单个习惯,是把同样的内容读两遍。先给骨架再给正文、拒绝 agent 已经看过的片段、用稳定的摘要代替完整历史——这些都是把原本会被重发几十次的上下文买回来。Read Router 第一次读取时返回大上下文文件的索引,只有被问到时才给全文;Delta Read 跟踪 agent 已经看过的行;Hot Context 把旧历史切成可搜索而不常驻的片段。

给工具输出设上限的东西。 返回六百条匹配的 grep、打印九百行的测试套件、抓回来四万个字符导航内容的页面:全部进入上下文并留在那里。Head Limit 在每次调用里切掉巨大的 grep 结果,并教会 agent 怎么要剩下的部分;Smart Cut 交付大文件的第一页并带上总大小;Output Diet 和 Terminal Guide 保留开头、结尾和错误行,把完整输出留在磁盘上。

防止浪费一轮的东西。 一轮是系统里最贵的单位,而经典的浪费就是花一轮去发现编译器早就知道的事。First Pass 在编辑后构建,把错误推到下一轮。Conduction Write 拦住那次会让文件保持原样的写入。Way Out 在某个工具失败时,指向项目里解决过同一问题的示例——只在有证据的时候。

让回答变短的东西。 Response Diet 在开场白进入对话之前就把它切掉,这是最便宜的切割时机。No Comment 让 agent 不要给显而易见的东西加注释,并测量新代码里还有多少带着注释,同时不碰已经存在的注释。

通常回不了本的类别

把模型已经有的文档再说一遍的技能。人格和格式类技能,除非那个格式是硬性要求。三个互相重叠的 MCP 服务器,每一个都在启动时检查项目。还有更微妙的情况:一个确实有用的技能被装了两遍,两个版本、两段略有不同的描述——于是 agent 为两者都付钱,还得从中挑一个。

这些都不是罪过。它们都是合理的一次次购买,只是买的人从没见过那张小票。问题不在单个技能,而在于总额从来没有被定过价。

一次 20 分钟的审计

把你装的东西列出来。打开 Optimize Harness 看每项的实测成本,然后把这一周没用到的全部关掉。打开 Rules Auditor,读一读你上下文文件里那些块的固定成本——大多数人至少能找到一块在描述项目早已放弃的约定。跑三次正常会话。比较第一次会话的开场上下文和第四次。

一句吃过苦头才学会的警告:一次关一个,并记下你移除了什么。一个被你停用的技能,在质量上造成的损失可能超过它在 token 上省下的,而唯一知道的办法,是注意到它安静下来的那一周。

这篇文章不承诺什么

精简的上下文不自动就是好的上下文。有些技能靠每天阻止三次坏轮次来挣回它的固定成本,砍掉它们是最糟的那种节俭。测量告诉你价格,不告诉你价值。那个判断留给你——这也是为什么这里每个工具都能一键还原、测量层免费:你应该能在跳之前先看。

HarnessUp 本身不是技能、不是钩子、不是插件、不是 MCP 服务器,也不是代理。它是一个本地第二层,通过 Claude Code 和 Codex 的官方 hooks 起作用,从不读取你的 token 或密钥。这个区别对本文很重要:上面任何一个工具都不会像技能那样往你的开场上下文里加一条定义。它们作用在流量上,不在提示上。

给你装的东西定个价。免费安装 HarnessUp,看看你配置里每个技能、子 agent 和服务器的实测成本。

免费安装