← AIバイブコーディングTips 一覧へ Design / Agent = Model + Harness

同じモデルなのに、成績が22ポイント違う

最近よく見かける「ハーネス」という言葉。モデルの周りを囲む実行装置のことだが、単なる用語解説では終わらない。同じモデルをハーネスだけ替えて走らせると、コーディングベンチマークの成績が22ポイント以上動く——という実証データが出揃ってきた。バイブコーディングにとって何が恩恵なのかを、出典つきで整理する。

この記事で手に入るもの

Agent = Model + Harness という定式の出典と、「モデルを替えるよりハーネスを整える方が効く場面がある」ことを示す実測データ、そして自分の環境の何がハーネスに当たるのかの対応表。

01 — 定義

ハーネスとは、モデルを「エージェント」にする実行装置

出典としていちばん引きやすいのは、Hugging Faceが2026年5月に公開したエージェント用語集だ。そこでは Agent = Model + Harness という定式が明示されている。モデル(LLM本体)は、テキストを受け取ってテキストを返すだけの存在で、単独では記憶もループも持たず、ツールも実行できない。

その周りを囲んで、モデルを呼び出し、ツール呼び出しを実行し、結果を文脈に戻し、いつ止まるかを決める——この実行層がハーネスだ。Claude CodeもCodexもOpenCodeも、中のモデル以外の部分は全部ハーネスにあたる。システムプロンプトやツールの説明文といった「モデルに世界をどう見せるか」の層はスキャフォールド(足場)と呼び分けられることもあるが、日常的には合わせてハーネスと呼ばれることが多い。


02 — 実証データ

「モデルの差」より「ハーネスの差」の方が大きい

用語の整理だけなら記事にしない。効いているという実測が複数出ている。

01

同一モデルでハーネス差だけで22ポイント超

Particula Techの分析(2026年3月)によれば、最新モデル同士のSWE-Bench系スコア差は0.8ポイント幅に収束しつつある一方、同じモデルのままハーネス(スキャフォールド)を変えると22ポイント以上スコアが動く。「どのモデルか」より「どう走らせるか」の方が、いまや差がつく変数になっている。

02

編集ツールの形式を変えただけで6.7%→68.3%

同じ分析が引く極端な例では、あるモデルが編集ツールの形式(editツールのフォーマット)を修正しただけで、コーディングベンチマークの成績が6.7%から68.3%へ跳ね上がった。以前紹介した「モデルが賢くなるほどツール呼び出しは雑になる」の裏返しで、ツール定義の形はモデルの実力を出せるかどうかを直接左右する

03

「良いハーネスの中位モデル」が「標準の上位モデル」に勝つ

同分析には、より良いスキャフォールドに載せた中位モデル(52.7%)が、標準構成の上位モデル(52.0%)を上回った例も出てくる。モデルのグレードを上げる予算があるなら、その前にハーネス側の整備で同じ効果が出ないかを疑う価値がある。

ここが核心。この問題は研究側でも認識されていて、「ハーネスを開示せずにLLMエージェントを比較するな」という論文まで出ている。ベンダーが発表するスコアの差は、モデルの実力差ではなくハーネス差であることが珍しくない


03 — バイブコーディングへの翻訳

あなたが触っている設定は、ほぼ全部ハーネスの一部

「ハーネスなんて実装者の話でしょ」と思うかもしれないが、そうではない。個人の開発者が日々調整している設定の大半は、ハーネスのダイヤルそのものだ。

指示ファイル(CLAUDE.md / AGENTS.md)モデルに世界をどう見せるかを決める、スキャフォールドの中心部品。書きすぎれば固定費になり、足りなければ暴れる。
ツール構成・MCPサーバーどのツールをどんなスキーマで見せるか。編集ツールの形式だけで成績が10倍動いた例があるのはここ。
権限設定・確認モードどこまで自動で進ませ、どこで人間に戻すか。ループの停止条件はハーネスの仕事。
コンテキスト管理(要約・圧縮の設定)長いセッションで何を残し何を捨てるか。ここの品質が「確認済みのはずが未検証」のような事故を左右する。

つまりバイブコーディングにとっての恩恵はこう翻訳できる——結果が悪いとき、回せるダイヤルが「モデルを替える」の1つではなく2系統あると知っていること。モデルは自分では変えられないが、ハーネス側のダイヤルは今日から全部自分で回せる。しかも実証データ上、そちらの方が振れ幅が大きい。


04 — 自分で実証できるか

個人でも再現できる実験と、できない実験

SWE-Benchのような本格ベンチマークを個人で回すのは(実行環境・件数・コストの面で)現実的でない。ただし、縮小版の実証は個人環境でも設計できる

注意点はひとつ。試行回数が少ない個人実験では「たまたま」が混ざる。数回の試行で断定せず、「自分の環境ではこの傾向だった」に留めるのが誠実な書き方だ。


05 — 自分の運用に当てはめる

持ち帰れる3点

「ハーネス」という言葉を、明日から使える判断に変換する。

結果が悪いとき、モデルのせいにする前にハーネスを疑う指示ファイル・ツール構成・権限設定のどれかを1つ変えて再試行する方が、モデル変更より速くて安いことが多い。
ベンダー発表のスコア比較は「ハーネス込みか」を確認する同じモデルでもハーネス次第で22ポイント動く以上、条件が揃っていない比較は参考程度に読む。
ハーネスのダイヤルは記録しながら回す何を変えて何が良くなったかをメモに残す。再現できない改善は、次のモデル更新で消えても気づけない。