DeepSeek Harness：公開された内容とインストール方法

DeepSeek Harness（DSH）は、V4-ProとV4-Flash向けのコーディングエージェント用ハーネスです。2026年8月13日にnpmパッケージ@deepseek-ai/dshとして公開され、これはV4-ProがGA（一般提供）に移行した日と同じです。通常のDeepSeek APIキーで動作し、4ステップで導入できます。プラグインシステムも備えています。

ただし、インストール前に必ず知っておきたい注意点があります。PyPIには5月から、まったく別のPythonパッケージdeepseek-harnessが公開されており、こちらもdshコマンドを提供しています。両者は名前が似ているだけで、同じツールではありません。

DeepSeek Harness（DSH）とは何か

コーディングエージェント用ハーネスは、モデルの周囲でコンテキストの選択、ツールエラーへの対応、再計画、タスク完了の判定などを担う仕組みです。同じモデルを使っていても、ハーネスの設定次第でベンチマーク結果は変わります。そのためDeepSeekは、単純なモデル性能ではなく、エージェント評価とともにハーネス設定も公開しています。

代表例を挙げると、Claude CodeはAnthropicのClaudeモデル向けハーネス、Cursorは複数のプロバイダーをIDEに統合するハーネス、GitHub CopilotはVS Code内でOpenAIモデルを利用するためのハーネスです。モデルとハーネスを組み合わせることで、単発の質問に答えるだけでなく、ファイル編集やコマンド実行、API呼び出しまで行える「エージェント」になります。DSHは、この役割をV4-ProとV4-Flash向けに担います。

DSHはDeepSeekが自社で提供する、V4-ProとV4-Flash向けのファーストパーティー・ハーネスです。Claude CodeがSonnetやOpus向けに作られているのと同じ位置づけと考えられます。初めて公に名前が登場したのは、7月31日のV4-Flashベータ版変更履歴でした。そこでは、エージェントベンチマークに「DeepSeek Harness minimal mode（近日公開予定）」を使い、effort=max、top_p=0.95、temperature=1.0で実行したと説明されています。

「Minimal mode」は、推論努力を最大にし、サンプリングパラメーターを固定した簡略構成です。ベンチマークごとに設定を調整するのではなく、結果を再現しやすくすることを目的としています。ベンチマークスコアを生み出したランナーよりも、プラグインシステムを含む製品版のほうが、機能面では広い範囲をカバーしています。

V4-ProとV4-Flashはいずれも100万トークンのコンテキストウィンドウに対応し、推論努力の設定としてlow、high、maxの3段階を利用できます。lowは単純なタスク、highは通常のエージェント作業、maxは複雑な作業向けです（公式変更履歴、8月13日付のエントリー）。

@deepseek-ai/dshをインストールする

Node.js 18以降が必要です。これはDeepSeekの公式Claude Code連携ガイドで指定されている環境要件と同じです。

1. Node.jsのバージョンを確認します：node --version（18以降が必要。macOSで未インストールの場合はbrew install node）。
2. グローバルにインストールします：npm install -g @deepseek-ai/dsh。
3. DeepSeekプラットフォームで取得したキーを設定します：export DEEPSEEK_API_KEY=<your key>。
4. 実行します：cd /path/to/my-project && dsh。

macOSでは、npmパッケージをグローバルインストールする際の権限エラーがよく起きます。npmが推奨しているのは、ユーザーが書き込めるグローバルプレフィックスを設定する方法です（npm config set prefix ~/.npm-global）。sudoでも動作しますが、今後パッケージを更新する際に所有者の不整合を招く可能性があります。

ハーネス本体について、別途設定された価格はありません。背後で使うモデルAPIの料金体系は、8月16日16:00 UTCに変更されます。V4ファミリーの料金はピーク時とオフピーク時に分かれ、オフピーク料金はピーク時の半額になります（公式変更履歴）。

V4-Pro GAのベンチマーク：ハーネスの効果が表れる部分

以下は、DeepSeekが8月13日付の変更履歴で公開した公式スコアです。いずれも、先ほど説明したハーネス設定で実行されています。

V4-Proは、これらのベンチマークでV4-Flashを0.5〜8.3ポイント上回りました。差が最も大きかったのはDeepSWE（+8.3）とNL2Repo（+7.3）です。なかでも87.9を記録したTerminal Bench 2.1が目玉となる数字でしょう。r/LocalLLaMAで公開された独立ハーネスによる再現テストでは、Flash 0731が445試行で82.7となり、設定によるばらつきを考慮すればDeepSeekの発表と一致しました。DSBench-FullStackとDSBench-Hardは内部評価セットのため、この2行はDeepSeek独自の測定結果です。

公開されたベンチマークはすべてmax設定で実行されています。プロダクション環境では、単純なタスクにlow、通常のエージェント作業にhigh、複雑な作業にmaxを使うようDeepSeekは案内しています。

@deepseek-ai/dshとpip install deepseek-harnessの違い

よく似た名前のパッケージが、数カ月違いで2つ公開されています。しかし、両者に関係はありません。

PyPI側のプロジェクトは、コーディングエージェントではなくプロトコルアダプターライブラリです。作者は270回以上の試行を通じてV4 APIの16の挙動を記録し、それらを10項目の契約としてまとめています。提供形態はPythonライブラリ、dsh CLI、MCPサーバー、Anthropic Skillの4種類です。V4を使う開発者が特に注意したいポイントは次の3つです。

• アシスタントのメッセージにreasoning_contentを保持しないと、マルチターンのツールループはHTTP 400を返します。両モデルで3回中3回再現されています。
• /betaエンドポイントは、v4-proを気づかないうちにdeepseek-reasonerへリマップします。
• キャッシュヒットは1,024トークンのプレフィックス以降、256トークン単位で現れます。5ターンのループでは平衡状態のヒット率が95%に達し、実効的な入力コストが約50分の1になりました。

どちらのパッケージもdshコマンドを提供していることが、混乱の主な原因です。pipでインストールしたならアダプターライブラリ、@deepseek-aiスコープでnpmから入れたならハーネスです。

DSHを使わずにDeepSeek V4をコーディングエージェントとして使う

DSHのドキュメントが整う前にDeepSeek対応のコーディングエージェントを使いたい場合は、DeepSeekの公式連携ガイドで、次の3つの方法が案内されています。

Claude Codeでは、環境変数によってDeepSeekのモデルをClaude Code側のスロットに割り当てます。

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

ここには1つ注意すべきマッピングがあります。claude-sonnetへのリクエストはProではなくFlashに解決されます。DeepSeekのドキュメントでは、ProをOpusスロット、FlashをHaikuスロットに割り当てています。なお、3つのツールはいずれもサードパーティー連携として説明されており、DeepSeekは有効性や安全性を保証していません。より広い比較については、コーディングエージェント向けLLM比較とV4-Pro GA APIガイドも参照してください。

FAQ

@deepseek-ai/dshは公式のDeepSeek Harnessですか？

npmの@deepseek-aiスコープはDeepSeekのGitHub組織と一致しており、リリース時期も7月31日の変更履歴で予告されていた期間と合っています。コミュニティの投稿から、インストールできることも確認されています。一方、DeepSeekの8月13日付変更履歴が公式に記載しているのはV4-Pro GAであり、ハーネスの名前までは明記していません。また、npmはパッケージページの自動検証をブロックしています。

DSHとPyPIのdeepseek-harnessは何が違いますか？

メンテナーも製品も異なります。@deepseek-ai/dshは8月13日にnpmで公開されたコーディングエージェント用ハーネスです。一方、pip install deepseek-harnessでインストールされるのは、Henry Zhangが開発した独立したPython製プロトコルアダプターライブラリです。MITライセンスで、5月9日に公開され、V4 APIの癖に対応します。両方がdshコマンドを提供しています。

DSHを使うにはDeepSeek APIキーが必要ですか？

はい。ハーネスはDeepSeek API経由でV4-ProとV4-Flashを利用するため、料金はトークン単位で発生します。npmパッケージ自体は無料でインストールできますが、費用がかかるのはAPI利用分です。V4ファミリーの料金は8月16日16:00 UTCにピーク時・オフピーク時の料金へ移行し、オフピーク時はピーク時の半額になります。

DSHはClaude Codeと比べてどうですか？

Claude Codeは、Anthropic互換エンドポイントを通じてすでにDeepSeek上で動作する、成熟したドキュメント付きのターミナルコーディングエージェントです。DSHの強みは、V4向けに特化した最適化にあります。V4のプロトコル挙動に合わせて作られたハーネスであり、既存の仕組みに適応させたものではありません。ベンチマーク設定が公開されていることから、その優位性は十分に考えられますが、DSHのドキュメントとコミュニティによる検証が進むまでは、独立した利用環境で実証されたとはいえません。

AIハーネスとAIエージェントは何が違いますか？

ハーネスは、コンテキスト管理、ツールの振り分け、タスクのオーケストレーションを担う基盤レイヤーです。エージェントは、ハーネス上でモデルを動かし、複数ステップのアクションを実行できるようにした統合システムを指します。エージェントには必ずハーネスが必要ですが、同じハーネスで複数のモデルを動かすこともできます。Claude Code、Cursor、Copilot、DSHはいずれもハーネスであり、そこにモデルを組み合わせることで「エージェント」になります。

リリース状況：公式確認済みの情報とコミュニティ報告

この記事の情報は、2段階の根拠に分けられます。

公式に確認できる情報（DeepSeek APIの変更履歴に記載された情報）：

• deepseek-v4-proは8月13日にGAへ移行し、OpenAI Responses APIをネイティブサポート。推論努力のレベルは3段階です（変更履歴）。
• V4-Flashは7月31日にパブリックベータへ移行し、ベンチマークは「DeepSeek Harness minimal mode（近日公開予定）」で作成されました。
• V4-Pro GAとV4-Flashベータのベンチマーク数値は、いずれもこれらの変更履歴に記載されたものです。
• V4ファミリーの料金は、8月16日16:00 UTCにピーク時・オフピーク時の料金へ変更されます。
• Claude Code、OpenCode、OpenClawの連携ガイドは公式ドキュメントです。

コミュニティから報告された情報（Reddit投稿、再現されたスクリーンショット）：

• @deepseek-ai/dshはインストール可能で、動作も確認されています。u/Testx01が8月13日12:56 UTCにパッケージのリンクを投稿し、数分以内にu/Available_Yam_6267も続きました。npmの@deepseek-aiスコープはDeepSeekのGitHub組織と一致します。
• npmのパッケージページは自動取得をブロックしているため、バージョン、ライセンス、メンテナーのメタデータはレジストリ経由では確認できていません。

「Deepseek harness is out on npm :)」— u/Testx01、r/DeepSeek、8月13日

• 再現された内部ベータのメッセージでは、369人が参加するベータグループが8月11日に最終内部ビルドをプッシュし、8月13日のパブリックベータに向けてプラグイン開発者にリポジトリへ#dshタグを付けるよう伝えたとされています。公開後は、プラグインを個人アカウントへ移行できるようになるという説明もありました。
• コミュニティの報道では、中国のテックメディアを引用し、DeepSeekが5月の時点で専任ハーネスチームを立ち上げ、Agent Harnessのプロダクト担当職を採用していたと伝えています。

DeepSeekが自社サイトで正式なドキュメントを公開するまでは、DSHの機能、CLI、プラグインに関する情報は、コミュニティによる確認済みの報告として扱うのがよいでしょう。