エージェントハーネスとは?モデルやフレームワークとの違い
エージェントハーネスは、モデルを動かすループ、ツール、権限、セッション状態を管理するプログラムです。モデルやフレームワークとの違いを、Claude CodeやDeepSeek Harnessの例で整理します。
エージェントハーネスとは
エージェントハーネスは、言語モデルの周囲で動作し、モデルをエージェントとして機能させるプログラムです。モデルを繰り返し呼び出すループ、モデルが呼び出せるツールの定義、呼び出しを実際に実行するかどうかを決める権限ルール、ターンをまたいで保持されるセッション状態、作業を行う作業ディレクトリを管理します。内部のモデルは交換できます。
最後の文が重要です。モデル単体では、質問に答えるとユーザーのことを忘れます。ハーネスはモデルに次に行うことを尋ね、モデルが要求したコマンドを実行し、結果を返して、再び尋ねます。この反復を指して「エージェント」と呼びます。周辺の用語がまだ曖昧であれば、AI エージェント、LLM、アシスタントの違いで用語を整理してからツールを選べます。
ハーネスはモデルではない
ベンダーが両者を同じブランド名で提供するため、混同されます。
dsh と DeepSeek は異なる製品です。github.com/deepseek-ai/deepseek-harness で 13 August 2026 に MIT licence の下で公開された DeepSeek Harness は、マシンにインストールする Node プログラムです。DeepSeek models は API(application programming interface)の背後で提供される重みです。dsh に別のベンダーのモデルを指定しても動作します。ハーネスが必要とするのは、メッセージを受け取り、tool calls を返すものだけだからです。
Claude Code と Claude も同じ関係です。Claude Code はハーネスです。ループ、権限システム、ファイルおよび shell ツールを備えた terminal プログラムです。Claude は、Claude Code がデフォルトで呼び出すモデルファミリーです。Codex と Gemini CLI も同じように分かれています。
毎回このテストで判断できます。ハーネスをインストールします。モデルを呼び出します。ディスク上にバージョンがあり、ホームディレクトリに設定ファイルがあるものはハーネスです。その設定ファイル内の deepseek-flash のような文字列はモデルです。
ハーネスのループが実際に行うこと
ハーネスのループが 1 回実行される流れは次のとおりです。ゆっくり読んでください。ハーネス間のほぼすべての違いは、この 5 つの手順の中にあります。
- ハーネスは、ここまでの会話とツール定義の一覧をモデルに送信します。
- モデルはテキストを返すか、いずれかのツールを呼び出すリクエストを返します。
- ハーネスは、そのリクエストを権限ルールに照らして確認し、実行するか、停止して確認を求めます。
- ハーネスはツールを実行し、出力と終了コードを取得します。出力が非常に長い場合は切り詰めます。
- ハーネスはその結果を会話に追加し、手順 1 に戻ります。
日常的な使い方でハーネス間の違いが最も大きく現れるのは手順 3 です。すべてのコマンドの前に確認を求めるハーネスは安全ですが、負担も大きくなります。まったく確認しないハーネスは、モデルがパスを誤ったときに、いずれ破壊的なコマンドを実行します。Claude Code は中間的な設定に対応しています。確認なしで実行するコマンドの allowlist と、それ以外のコマンドに対するプロンプトを設定できます。
その他の違いは、手順 1 にあります。ハーネスは、各リクエストに付随する system prompt も記述します。Claude Code では、その設定を直接変更できます。出力スタイルによって送信する system prompt が編集されるため、返されるすべての応答が変わります。会話は実行のたびに長くなりますが、モデルの context window には上限があります。そのため、ハーネスは何を削除し、何を要約し、何をファイルに書き出して後で読み戻すかを決める必要があります。この判断が、同じモデルを動かす 2 つのハーネスで作業品質が異なる主な理由です。これら 5 つの手順がまだ抽象的に感じられる場合は、自分で簡単なループを 1 回書いてみるのが有効です。AI エージェントを学ぶための段階的な道筋では、早い段階でまさにこれを構築します。
現在、ほとんどのハーネスは MCP (model context protocol) 経由で外部ツールを接続します。これは、MCP に対応する任意のハーネスにツールを公開する標準方式です。そのため、1 つの統合を複数のハーネスで利用できます。VPS 上で MCP サーバーを実行するでは、この部分を扱います。Web 検索は通常、最初に追加されるツールです。エージェントを独自の SearXNG インスタンスに接続すると、検索クエリを第三者に送信せずに済みます。また、エージェントがその後に読むすべてのページは、ループ内に到達する信頼できない入力であることも明確になります。
エージェントハーネスとエージェントフレームワーク
新しいハーネスが登場するたびにこの疑問が出ます。ベンダーごとに見解が異なるため、回答も一致しません。ここでは、実際に通用する整理を示します。
フレームワークは、import して使うライブラリです。フレームワークのループを使うか、自分でループを実装して、コード上でエージェントを組み立てます。代表例は LangChain です。構成要素が提供され、それらをコード上で組み合わせてエージェントを構築します。
ハーネスは、実行するプログラムです。ループはすでに実装され、ツールも用意され、権限モデルにも既定値があります。最初のコマンドで動作するエージェントを使い始め、そこから設定を行います。
通常は、インストール後に何をするかで判断できます。インストール後にコードを書くなら、それはフレームワークです。インストール後に話しかけるなら、それはハーネスです。
この境界には実際に議論があります。最も明確な根拠は、LangChain 自身のドキュメントです。2026 年 10 月時点で、LangChain は Deep Agents を「エージェントハーネス」と呼ぶ一方で、「LangChain のエージェント向けコア構成要素を基盤とするスタンドアロンライブラリ」とも説明しています。また、langchain-ai/deepagents リポジトリは自らを「バッテリー同梱のエージェントハーネス」と称しています。どちらの説明も妥当です。Deep Agents は import して使う Python SDK (software development kit) なので、インストールテストではライブラリに分類されます。一方で、十分な既定動作が組み込まれているため、ハーネスのように利用されています。Microsoft は 2026 年 7 月 9 日に Foundry Agent Service の Hosted Agents の一般提供を発表しました。また、2026 年 7 月 22 日の投稿では Microsoft Agent Framework Harness のリリースを発表しています。このことから、この語は単なる専門用語ではなく、製品カテゴリになったことが分かります。
代わりに、作業量を予測できる質問を考えてください。自分でループを書くなら、そのループを自分で管理します。再試行、コンテキストの削減、権限確認、実行内容の記録も管理対象です。ループが製品に組み込まれている場合は、それらすべてに対する他者の判断を引き継ぎます。そのため開始は大幅に速くなりますが、後から変更するのは難しくなります。
ハーネスとチャットウィンドウの違い
チャットウィンドウとハーネスは、どちらもモデルの出力を表示します。違いは、作業がどのコンピューター上で行われるかです。チャットウィンドウでは、モデルが実行するコードはベンダーのサンドボックス内で、アップロードしたファイルに対して実行されます。ハーネスは、起動したユーザーとして、ハーネスを起動したマシン上でツールを実行し、実際のファイルを対象にし、その環境には実際の認証情報が存在します。
これが利点のすべてであり、リスクのすべてでもあります。エージェントは、ようやく作業を実行できます。同時に、作業を削除することもできます。
実際に使われているハーネス
この一覧の日付を 19 August 2026 としているのには理由があります。この分野は毎週のように変化するため、まとめ記事はすぐに古くなります。
- Claude Code と Codex はベンダー製のハーネスです。ターミナルを中心に使い、デフォルトでは各ベンダー独自のモデルと連携します。権限管理も最も洗練されています。Claude Code、Cursor、Codex、Copilot の比較で詳しく説明しています。
- DeepSeek Harness (
dsh) は MIT ライセンスで提供され、「すべてがプラグイン」という考え方に基づいています。モデル、ツール、セッション、サンドボックス、ユーザーインターフェースをすべて交換可能な部品として扱います。インストールした各プラグインはエージェント自身の権限で実行されるため、固定されたツールセットを持つハーネスよりも、追加前に dsh プラグインがアクセスできる範囲を確認する方法が重要です。 - Hermes は Nous Research が開発した、コーディングツールではなく汎用自律エージェントです。2026 年 2 月に MIT ライセンスで公開されました。組み込みストレージはローカルで、メモリとスキルは
~/.hermes配下のファイルに、セッション履歴はローカルの SQLite データベースに保存されます。ただし、Mem0 や Hindsight などのオプションの外部メモリプロバイダーを有効にすると、これだけでは全体像を説明できません。2026 年 10 月時点で、Hermes のドキュメントには、有効なプロバイダーが各応答後にすべての会話ターンを受け取り、組み込みメモリへの書き込みもすべてミラーリングされると記載されています。そのため、データはそのプロバイダーにも保存されます。有効化する前に、Hindsight と Mem0 の比較を読む価値があります。残りの手順については、VPS で Hermes をセルフホストする方法で説明しています。 - Omnigent はメタハーネスです。Claude Code や Codex などの他のハーネスを、共有セッション、利用額の上限、オペレーティングシステムレベルのサンドボックスとともに、1 つの API の背後で動かします。マルチエージェントハーネスとしての Omnigentで、その利点を説明しています。
- OneCLI はチーム向けのサンドボックス化されたハーネスです。ゲートウェイがエージェントの送信リクエストに認証情報を注入する構成になっているため、エージェント自身が実際のキーを認識することはありません。
このうち 3 つは同じ候補リストに挙がることが多いため、モデルとの結合、ライセンス、成熟度、サーバーで動かすために必要なものについては、DeepSeek Harness、Claude Code、Omnigent を横並びで比較するを読む価値があります。
dsh のクイックスタートは 1 つのコマンドで実行できます。1 回実行するだけで、ハーネスとは何かを最も早く確認できます。マシンに Node.js が必要です。
npx @deepseek-ai/dsh webこれにより、http://127.0.0.1:3080 で Web UI(ユーザーインターフェース)が起動します。利用を前提にする前に README を読んでください。dsh は自らを開発者プレビューと説明し、互換性を損なう変更が行われると明記しています。最初のコマンドが直ちに失敗した場合や、想定していないビルドを取得した場合は、dsh の正確なバージョンを固定し、npx のキャッシュを削除する方法で通常は再び動かせます。サーバーへのインストールについては、VPS で DeepSeek Harness を実行する方法で説明しています。また、そのアドレスが 127.0.0.1 で始まる理由では、デフォルトのループバック設定を説明しています。
ハーネスの上位にルーターを置く
モデルルーターは、ハーネスとプロバイダー API の間に置くローカルプロキシです。一般的な例は Claude Code Router です。デフォルトでは 127.0.0.1:3456 にバインドし、Claude Code が本来ベンダーへ送信するリクエストを受け付け、設定したプロバイダーへ転送します。ハーネス側は何も変更されていないように動作します。
モデルを交換できるためルーターが存在しており、このことはこの記事の主張を示すよい例です。一方で、プロキシはすべてのプロンプトを参照し、すべてのプロバイダーキーを保持するため、リスクが集中します。単なる便利機能ではなく、インフラストラクチャとして扱ってください。ハーネスが API キーとモデル設定を保持する場所も、1 層下で発生する同じ問題です。
ハーネスを VPS で実行すると何が変わるか
ハーネスをラップトップから借りているサーバーへ移すと、4 つの点が変わります。
蓋を閉じても実行が続きます。 長時間のタスクは、通勤中もバッテリー切れの後も継続します。tmux 内で起動し、そこからデタッチします。
tmux new -s agent
# start the harness, then press Ctrl-b and then d to detach
tmux attach -t agent再起動後も復帰させる必要があるものには、ターミナルセッションより user service が適しています。
loginctl enable-linger $USER
systemctl --user status my-agent.serviceloginctl enable-linger は見落とされがちな部分です。これがない場合、systemd のデフォルト動作では、最後のセッションが閉じてから 10 秒後にユーザーの service manager が停止されるため、user service だけでは logout 後もエージェントを実行し続けられません。systemd で dsh をヘッドレス実行する に unit file があります。そのサーバー上で 1 つのセッションが動作するようになったら、2 つ目のセッションを起動できます。また、同じマシン上の 2 つの Claude Code セッションは相互にメッセージを送信できるため、今朝起動したセッションから、手動で中継せずにもう一方へジョブを渡せます。
鍵を保持します。 プロバイダーの鍵は、そのサーバー上の config file に保存されます。誰が読み取れるかを確認します。
ls -l ~/.configユーザーとして実行されているプロセスは、そのファイルを読み取れます。これにはエージェントと、エージェントが実行することを選択したあらゆるものが含まれます。
他のマシンへ接続できます。 他のマシンと同じプライベートネットワーク上にある VPS では、エージェントからそれらのマシンへの経路が確保されます。これがまさに目的ですが、同時に被害の波及範囲でもあります。
どこからでも接続できます。 ほとんどのハーネスは Web UI を公開しており、多くが理由あって loopback にバインドします。自分の設定を確認します。
ss -tlnp | grep 3080127.0.0.1:3080 は、サーバー自体だけが接続できることを意味します。0.0.0.0:3080 は、UI がすべてのインターフェースで待ち受けることを意味します。そのため、手前のファイアウォールがポートをブロックしない限り、サーバーの公開アドレスに到達できる誰でも接続できます。2026 年 10 月時点では、dsh は起動時にそのようなワイルドカードアドレスを拒否しますが、受け入れる他の Web UI も数多くあります。バインドアドレスを変更するのではなく、SSH トンネルを介して loopback UI に接続します。
ssh -N -L 3080:127.0.0.1:3080 you@your-server次に、ラップトップのブラウザーで http://127.0.0.1:3080 を開きます。通信は SSH セッション内を通過するため、インターネットに新たな接続口が公開されることはありません。
これらはすべて、そのままセキュリティ上の根拠にもなります
攻撃者の視点で、先ほどの4つの特性をもう一度確認してください。
自動実行されるため、モデルがパスを誤って解釈する瞬間を監視する人はいません。鍵を保持するため、読み取り可能な設定ファイルが1つあるだけで、provider アカウント全体が危険にさらされます。他のマシンへ接続できるため、プロンプトインジェクション、つまり agent が読み取る Web ページやファイルに埋め込まれた指示によって、データベースホストへの経路が生まれます。どこからでも到達できるため、公開アドレスで待ち受け、前段にファイアウォールがなく、独自の認証もない Web UI は、見つけた誰もが利用できる shell になります。dsh は起動時に表示する URL にプロセストークンを含めるため、一定の保護になります。ただし、その URL 自体が credential になるため、パスワードと同じように慎重に共有してください。
どの場合も対策は単純で、毎回同じです。自分のアカウントではなく、agent 専用の非特権ユーザーアカウントを作成します。
sudo adduser --disabled-password --gecos "" agentWeb UI は loopback で待ち受けさせ、SSH 経由でアクセスします。作業を完了できる範囲で、agent には最小限の credential だけを与えます。AI agent から秘密情報を分離するでは、この点を適切に扱っています。自分が監視していない状態で実行する処理には、慎重に管理したマシンよりも使い捨てのマシンが適しています。使い捨て VM で coding agent を実行するとVPS 上で Claude Code を安全に実行するでは、どちらもこの方法を採用しています。
エージェントハーネスは必要ですか?
作業が一度に 1 つの質問へ回答するだけなら、チャットウィンドウで十分です。ハーネスを使うと、監視が必要なループが増えるだけです。実ファイルに対して多くの手順を実行するタスクや、ユーザーが不在の間も処理を続ける必要があるタスクでは、ハーネスの導入効果が出ます。
この分野の大半は、まだ発展途上です。dsh は 2026 年 10 月時点で、自身の README に developer preview と記載しています。その他の製品も変化が速く、今日作成した設定ファイルを来月には編集する必要が生じる可能性があります。そのため、構成は小さく再現可能に保ち、変更内容を記録しておくことが重要です。この慎重さはループ内でも役立ちます。エージェントに動作する最小限の変更を促すスキルを使えば、無人実行の終了後にも実際に読みやすい差分が残ります。まずは 1 台のサーバーで 1 つのハーネスを使い、1 つのジョブと 1 つの限定的な key だけを与えてください。そのジョブが 1 週間問題なく動作してから、アクセス範囲を広げます。最初に選ぶハーネスを決めるには、現在実行する価値のある self-hosted agentsが適しています。
FAQ
エージェントハーネスとは、簡単に言うと何ですか?
モデルを取り囲むプログラムです。モデルはテキストとツール使用要求を生成します。ハーネスは、モデルへの要求を繰り返し、モデルが要求したツールを実行し、許可なしで実行できるツールに関するルールを適用し、ターン間のセッション状態とファイルを保持するループを実行します。モデルを入れ替えてもハーネスは動作します。これは、両者が別のものであることを示す最も明確な証拠です。
Claude Code はモデルですか、それともハーネスですか?
Claude Code はハーネスです。ループ、権限システム、組み込みのファイルおよびシェルツールを備えたターミナルプログラムです。Claude は、デフォルトで呼び出されるモデルファミリーです。同じ分離は DeepSeek Harness (dsh) にも当てはまります。これはインストールする Node プログラムであり、DeepSeek models は API 経由で提供されます。ハーネスはマシンにインストールします。モデルはネットワーク経由で呼び出します。
エージェントハーネスとエージェントフレームワークの違いは何ですか?
フレームワークは、インポートしてコードから利用するライブラリです。フレームワークのループを使うことも、自分でループを書くこともできます。ハーネスは実行するプログラムです。そのため、ループ、再試行、コンテキスト処理は自分で書くのではなく、設定可能なデフォルトとともに提供されます。実際には境界が曖昧です。2026 年 10 月時点で、LangChain's Deep Agents はインポート可能な SDK ですが、自身のリポジトリでは、必要な機能を備えたエージェントハーネスと説明しています。自分でループを書く必要があるかどうかを考えてください。その答えによって、状況に適した用語が決まります。
エージェントハーネスの実行に VPS は必要ですか?
いいえ。ここで挙げたハーネスはすべてラップトップで実行できます。サーバーを使うと、4 つの点が変わります。蓋を閉じてもエージェントが実行を続けられること、常時稼働するマシンに鍵を保管できること、他のサーバーへ接続できること、そしてどのデバイスからでも同じセッションに戻れることです。これらはすべてセキュリティ上の考慮事項でもあります。そのため、エージェント専用のユーザーアカウントを用意し、Web UI は 127.0.0.1 にバインドしたままにしてください。
同じハーネス内で別のモデルを使用できますか?
通常は使用できます。これがハーネスの定義上の特徴です。多くのハーネスでは、設定にモデル名と base URL を指定します。そのため、別のプロバイダーを指定する操作は、書き直しではなく設定の編集で済みます。ハーネスが対応しない場合は、Claude Code Router のようなローカルルーターをハーネスとプロバイダーの間に配置し、要求を変換できます。デフォルトでは 127.0.0.1:3456 にバインドします。このプロキシはすべてのプロンプトを参照し、すべての鍵を保持するため、注意して扱ってください。