← 記事一覧

設定

トークンで元を取る Claude Code のスキルとフック

インストールするスキルはどれも、コンテキストで支払う小さなサブスクリプションだ。毎セッション、発火するかどうかに関係なく。フックはまったく別の買い物であり、その違いにお金の大半が隠れている。

本記事は、ここで紹介するツールを開発している HarnessUp のプロダクトマネージャー、Ted Mavera が執筆しました。このブログの文章は人工知能の助けを借りて書かれ、公開前にチームがレビューしています。

クリーム色の陶器の機械に 5 つのスキルカートリッジが並び、それぞれがオレンジ色のコイン盤を専用のガラス管へ送り出している。横には真鍮の砂時計、手前には外れたカートリッジが一つ。

この記事の目的

Claude Code のスキル一覧は、いまやどこにでもある。トップ 10、フロントエンドに最適なもの、ワークフローを変えるもの。どれも教えてくれないのは、その一覧のどの項目も買い物であり、仕事そのものと同じ通貨で支払い、その日に使おうと使うまいと課金されるということだ。一覧は役に立つ順に並べている。コストを並べた人はいない。

この記事はその後半をやる。スキルが悪い取引だからではない——なかにはハーネス全体で最高の取引もある——が、元を取るスキルと静かに毎セッションに課税するスキルの違いは測定できる違いであり、ほとんど誰も測っていないからだ。

スキルを追加するときの 2 つの出費

スキルには定義があり、その一部はセッションが始まった瞬間からモデルのコンテキストに入る。エージェントがスキルの存在と、いつそれを使うべきかを知るためだ。その部分が固定費であり、毎セッション、毎会話で、スキルが実際に走るかどうかとは無関係に支払う。スキルが走るときは本体が読み込まれ、その指示が続くターンを形づくる。それが変動費だ。

無視されるのは固定の側で、それはいちばん面白くない形で積み上がる。セッションの末尾では小さく見える 10 個のスキルが、毎会話の毎ターンに読み直されるブロックに合算される。他のあらゆるコンテキストと同じ算術だ。会話の先頭にあるものは、一度ではなく、何度も課金される。

フックは違うふうに働き、ここを一覧は最もよく間違える。フックはハーネスがイベントで実行するコマンドだ。ツール呼び出しの前、編集の後、セッションが止まるとき。ほとんどのフックはトークンをまったく増やさない。増えるのはレイテンシで、その後の出来事が変わる。無駄な書き込みを止め、繰り返しの読み込みを拒否し、編集後にプロジェクトをコンパイルするフックは、ミリ秒のコストで 1 ターン分を取り戻せる。トークンの観点では、良いフックはほぼ無料だ。悪いフックが高いのは、コンテキストを読むからではなく、失敗するか、再試行するか、あらゆるものに発火するからだ。

手元に残す前にスキルへ値段をつける方法

4 つの問いを、この順で。冒頭のコンテキストに何を加えるか。走るときにターンをいくつ足すか、いくつ減らすか。どれだけの出力を生むか。そして普通の 1 週間に何回実際に発火するか。

4 つ目の問いがほとんどのケースを決める。月に 2 回しか発火しないのに毎セッションでコンテキストに乗るスキルは、めったに使わないものへのサブスクリプションだ。同じスキルでも、うまく書かれていれば、発火する 2 回で節約する分の一部のコストで済む。ただしその 2 回が本当にある場合に限る。

私たちのパネルには、まさにこのための画面がある。Optimize Harness は各スキル、サブエージェント、プラグイン、サーバーの実測コストを表示し、オフにするスイッチを添える。そして推測することを意図的に拒む。測っていないものに数字は与えない。隣の Rules Auditor は CLAUDE.md のルールについて同じことをし、毎ラウンド再読み込みされる各ブロックの固定費を表示する。そして自分で編集することなく、より簡潔なファイルを提案する。どちらも Pro だが、それらが可能にする測定の習慣は、カタログのどの単一ツールよりも価値がある。

作業台の上に開かれた小さな帳簿。鉛筆で見出しをつけた 2 つの列があり、左のページには虫めがねが置かれ、そばに真鍮のねじがいくつか散らばっている。
固定費が片方のページ、変動費がもう片方。ほとんどの一覧は右のページしか読まない。

たいてい元を取るカテゴリ

再読み込みを止めるもの。 エージェントのセッションで最も高くつく習慣は、同じ内容を 2 回読むことだ。本体の前に骨組みを渡すもの、エージェントがすでに見た範囲を拒否するもの、完全な履歴の代わりに安定した要約を保つものは、そうしなければ何十回も再送されるコンテキストを買い戻している。Read Router は大きなコンテキストファイルの索引を最初の読み込みで返し、全文は求められたときだけ返す。Delta Read はエージェントがすでに見た行を追跡する。Hot Context は古い履歴を、常駐ではなく検索可能な断片に切り分ける。

ツール出力に上限をかけるもの。 600 件の一致を返す grep、900 行を出力するテストスイート、4 万文字のナビゲーションとして届く取得ページ。すべてコンテキストに入り、残る。Head Limit は呼び出しごとに巨大な grep 結果を切り、残りをどう求めればよいかをエージェントに教える。Smart Cut は大きなファイルの最初のページを総サイズとともに渡す。Output Diet と Terminal Guide は先頭、末尾、エラー行を残し、完全な出力はディスクに置いておく。

無駄なターンを防ぐもの。 ターンはシステムで最も高い単位であり、典型的な無駄は、コンパイラがすでに知っていたことを発見するために使うターンだ。First Pass は編集後にビルドし、エラーを次のターンへ押し込む。Conduction Write はファイルが同一のままになる書き込みを止める。Way Out はツールが失敗したとき、同じ問題を解決したプロジェクト内の例を指し示す——証拠があるときだけ。

回答を短くするもの。 Response Diet はウォームアップの文章が会話に入る前に削る。削るのに最も安い瞬間だ。No Comment は自明なことにコメントしないようエージェントに求め、新しいコードのうちどれだけがコメント付きで届くかを測る。既存のコメントには触れない。

たいてい元を取らないカテゴリ

モデルがすでに持っているドキュメントを繰り返すスキル。ペルソナや整形のスキル——形式が厳格な要件でない限り。重複する 3 つの MCP サーバーで、それぞれが起動時にプロジェクトを検査するもの。そしてより微妙なケース:本当に役に立つのに 2 回、2 つのバージョンで、少しずつ違う説明とともにインストールされているスキル。エージェントは両方に払い、選ばなければならない。

どれも罪ではない。どれも、レシートを見せられていない人が、1 つずつ行った合理的な買い物だ。問題は個々のスキルではなく、合計に値段がつけられたことがないことだ。

20 分の監査

インストールしたものを列挙する。Optimize Harness を開いて項目ごとの実測コストを見て、今週使わなかったものをすべてオフにする。Rules Auditor を開いてコンテキストファイルの各ブロックの固定費を読む——ほとんどの人は、プロジェクトがすでに捨てた慣習を説明しているブロックを少なくとも 1 つ見つける。普通のセッションを 3 回走らせる。1 回目のセッションの冒頭コンテキストと 4 回目を比べる。

身をもって学んだ警告を 1 つ。オフにするのは 1 つずつ、そして何を外したかを記録しておくこと。無効にしたスキルが、トークンで節約した以上に品質で損をさせることがある。それを知る唯一の方法は、静かになった週に気づくことだ。

これが約束しないこと

簡潔なコンテキストが自動的に良いコンテキストになるわけではない。なかには 1 日 3 回の悪いターンを防ぐことで固定費を回収するスキルもあり、それを削るのは最悪の節約だ。測定は値段を教えるが、価値は教えない。その判断はあなたに残る。ここにあるどのツールも 1 クリックで元に戻せ、計測レイヤーが無料なのもそのためだ。跳ぶ前に見られるべきだから。

HarnessUp 自体はスキルでも、フックでも、プラグインでも、MCP サーバーでも、プロキシでもない。Claude Code と Codex の公式フックを通じて動作するローカルの第 2 レイヤーで、あなたのトークンやキーを読むことは決してない。この区別はこの記事にとって重要だ。上のツールはどれも、スキルのように冒頭のコンテキストに定義を加えない。彼らはプロンプトではなく、トラフィックに働く。

インストールしたものに値段をつけよう。HarnessUp を無料でインストールし、あなたの構成にある各スキル、サブエージェント、サーバーの実測コストを見よう。

無料でインストール