DeepSeek Harness

DeepSeek Harness は、DeepSeek のフロンティアモデルのスコアを支えるエージェントランタイムです。モデルの上に載るツール、メモリ、サブエージェント調整、終了ロジックの層であり、モデルを実用的なエージェントに変えます。2026 年 7 月 31 日、DeepSeek が DeepSeek-V4-Flash のエージェントベンチマークを Harness ミニマルモードで実行した際に初めて公開され、8 月 13 日には「Everything is a Plugin」のモットーで MIT ライセンスのオープンソースとして公開されました。DeepSeek が公表したベンチマーク数値を再現したい方、DeepSeek ベースのコーディングエージェントを自作したい方にとって、これが公式リファレンス実装です。

主な機能

• プラグイン駆動アーキテクチャ：ツール、メモリ、サブエージェント調整、終了ロジックまですべてがプラグイン。「Everything is a Plugin」の通り、バージョン管理されたパッケージとして配布され、組み合わせ・差し替え・自作が自由。
• モデル + ハーネス = エージェント：エージェントはモデルとハーネスの組み合わせという設計思想。ターミナル、ファイル操作、Web アクセス、コード実行をハーネスが担い、モデルは推論に集中します。
• ミニマルモード：V4-Flash の評価に使われた制限付きツールセット（ターミナル、ファイル I/O、Web、コード実行）が先に公開され、フルランタイムの前にモデルのエージェント能力を証明しました。
• サブエージェント調整：子エージェントの生成・監視・結果回収の仕組みを内蔵し、暴走を止める終了ロジックも備えます。
• メモリとコンテキスト管理：DeepSeek のプレフィックスキャッシュ課金を活かすキャッシュフレンドリーなコンテキスト処理で、長時間セッションを安価に保ちます。
• TypeScript ネイティブ：TypeScript で書かれ、@deepseek-ai/dsh npm パッケージで配布。npx @deepseek-ai/dsh web で Web UI を起動できます。
• DeepSeek ネイティブな経済性：DeepSeek モデルの 1M トークンコンテキストとキャッシュヒット課金に最適化。他社モデルプロバイダーにも対応可能です。

使用シナリオ

このツールを使用すべき人は？

• エージェント開発者：Terminal Bench 2.1 で 82.7、DeepSWE で 54.4 を叩き出した公式ハーネスでエージェントを構築したい開発者。
• DeepSeek ヘビーユーザー：V4-Flash / V4-Pro でコーディングエージェントを運用し、サードパーティのラッパーではなくファーストパーティのハーネスを使いたいチーム。
• ベンチマーク再現者：DeepSeek のエージェントベンチマークの主張を独立検証したい研究者・エンジニア。
• オープンソース貢献者：勢いのある資金豊富なエージェントフレームワークに参加したい開発者。

解決する問題

1. プロプライエタリエージェントへの囲い込み：MIT ライセンスでフォーク・監査・セルフホストが可能。Claude Code や Codex とは異なります。
2. 「オープンモデルはツール呼び出しが苦手」という誤解：エージェントの不出来はモデルではなくハーネスの問題だ、という DeepSeek の主張のリファレンス実装。
3. 再現不能なベンチマーク：評価設定（ミニマルモード、max 努力レベル、top_p 0.95、temperature 1.0）が公開され、数値が実際に検証可能になりました。

料金プラン

基盤モデルの価格（USD / 100 万トークン、2026 年 8 月時点）：

優位性と独自の価値提案

競合他社と比較した優位性：

1. ファーストパーティのハーネス：フロンティア規模でテストされた DeepSeek 自前のランタイム。API にただ被せるサードパーティ製とは違います。
2. 圧倒的な低価格：V4-Flash は 100 万トークンあたり入力 $0.14 / 出力 $0.28。エージェントワークロードのコストは Claude Opus や GPT-5.5 の数分の一。
3. MIT オープンソース：Anthropic や OpenAI のプロプライエタリエージェントとは違い、完全な透明性とフォーク可能性。

際立つポイント：

• 2026 年 7 月 31 日の V4-Flash エージェントスコア（Terminal Bench 2.1: 82.7、NL2Repo: 54.2、Cybergym: 76.7、DeepSWE: 54.4、Toolathlon verified: 70.3）の背後にあるエンジン。
• オープンソース公開から数時間で GitHub 24,000+ stars を達成。
• 2026 年 3 月に結成された専任チームが開発。本格製品は「DeepSeek Code」——Claude Code への DeepSeek の回答——へと発展する見込み。

ユーザーレビュー

「『オープンモデルはツール呼び出しが苦手』はほぼ常にハーネスの問題であり、モデルの問題ではない——この洞察はまったく正しい。待ち望んでいたリファレンス実装だ。」 — Hacker News の議論より

「フロンティアのクローズドエージェントより 10〜12 倍安く、エージェントベンチマークでは Claude Opus に迫る。経済性こそがストーリーだ。」 — Reddit r/LocalLLaMA のコメント

「ついに DeepSeek の数値を再現できる公式ハーネスが登場。ベンダー公称スコアが検証可能になった。」 — Hacker News のコメント

はじめに

クイックスタートガイド

1. クローン：git clone https://github.com/deepseek-ai/deepseek-harness
2. インストール：リポジトリの README に従い依存関係を導入（TypeScript、npm エコシステム）。
3. 構成：DeepSeek API キー（または任意プロバイダー）を設定し、プラグインを選択。
4. 実行：npx @deepseek-ai/dsh web で Web UI を起動、またはプロジェクトディレクトリでヘッドレス実行。

統合

シームレスに統合：

• DeepSeek API（V4-Flash、V4-Pro）と Responses API
• Codex ワークフロー互換
• dsh-plugin プラグインエコシステム
• プラグインインターフェース経由の MCP 風ツール

よくある質問

DeepSeek Harness は無料ですか？

はい。ハーネス自体は MIT ライセンスのオープンソースで無料です。DeepSeek プラットフォームのモデル API 利用料のみ支払います。

どのモデルに対応していますか？

主に DeepSeek の V4-Flash / V4-Pro（1M トークンコンテキスト）向け。プラグインアーキテクチャにより他プロバイダーも追加可能です。

DeepSeek のベンチマークスコアを再現できますか？

公開評価設定（Harness ミニマルモード、max 努力レベル、top_p 0.95、temperature 1.0）が文書化されました。2026 年 8 月時点で独立再現が進行中です。

Claude Code との比較は？

Claude Code はプロプライエタリ。DeepSeek Harness は MIT ライセンスでセルフホスト可能、しかも使用モデルのトークン単価は約 10 分の 1。フル版「DeepSeek Code」の機能面の追従はまだ発展途上です。

代替案

DeepSeek Harness が合わない場合、以下の代替案を検討してください：

• Claude Code：Anthropic のプロプライエタリコーディングエージェント。DeepSeek が狙う UX のベンチマーク。
• Reasonix：プレフィックスキャッシュ経済性に最適化されたサードパーティ製 DeepSeek ネイティブターミナルエージェント。
• OpenAI Agents SDK：異なるオーケストレーションモデルを持つ OpenAI のオープンソースエージェントフレームワーク。

ヒントとベストプラクティス

1. キャッシュフレンドリーなプロンプトを使う：DeepSeek のキャッシュヒット価格（入力 100 万トークンあたり $0.0028 vs $0.14）は安定した追記型コンテキストを優遇します。ハーネスセッションは長時間稼働させましょう。
2. ミニマルモードから始める：公式ベンチマークと同じ構成を先に使い、重いプラグインは後から追加。
3. ピーク価格に注意：2026 年 8 月 16 日から DeepSeek はピーク/オフピーク料金を導入（UTC 01:00–04:00 と 06:00–10:00 がピーク）。バッチエージェント実行はオフピークに。

まとめ

DeepSeek Harness は、DeepSeek のフロンティアエージェントスコアを生み出したオープンソースランタイムです。プラグイン駆動、MIT ライセンス、そしてクローズドエージェントの数分の一のコスト。DeepSeek モデルでエージェントを構築するなら、V4-Flash の数字を再現し、超えるための出発点はこの公式ハーネスです。