2026年8月13日、DeepSeekは異例のものを発表しました。それはモデルではなく、モデルを動かすための機械です。DeepSeek Harness (dsh) は、同社公式のオープンソースエージェントハーネスです。これは、セッションループ、ツール実行、権限チェック、ローカルWeb UIを備え、大規模言語モデルを動作するコーディングエージェントに変えるソフトウェア層です。DeepSeek V4-ProがAPIでリリースされたのと同じ日にローンチされ、VentureBeatはこれをClaude Codeのオープンソースのライバルとして位置づけました。
開発者コミュニティは迅速に反応しました。リリースから1週間後の8月20日現在、deepseek-harnessリポジトリは、約169,000のスターと18,100のフォークを獲得しています。7日間でこの規模の数字は、コードそのものよりも開発者の欲求を示しています。開発者は、検査、変更、そしてあらゆるモデルに適用できるエージェントハーネスを求めているのです。
DeepSeek Harnessとは何か
ハーネスとは、モデルを取り巻くすべてのものです。モデルはトークンを予測します。ハーネスは、モデルが何を見るか、どのツールを呼び出すことができるか、ファイルの編集やシェルコマンドがどのように承認されるか、そして多段階のセッションがどのようにまとまるかを決定します。Claude Code、Codex CLI、Gemini CLIはすべて、それぞれのベンダーのモデルを包むハーネスです。これら2つの比較の背景を知りたい場合は、Claude Code vs Codex CLIで説明しています。
DeepSeek Harnessは、DeepSeekがこのカテゴリに参入したもので、以下の3つの特徴がその枠組みを決定しています。
- 公式である。 これはDeepSeek AIによるファーストパーティプロジェクトであり、彼らのAPIをコミュニティがラップしたものではありません。
- オープンソースである。 MITライセンスで、サードパーティの依存関係はリポジトリのTHIRD_PARTY_NOTICESファイルに文書化されています。コードベースを任せるエージェントループを自分で読むことができます。
- 開発者プレビューである。 READMEには「互換性を破壊する変更が発生します」と明記されています。この言葉を額面通りに受け取ってください。それが実際に何を意味するかについては、以下で詳しく説明します。
リリースのタイミングも重要です。dshはDeepSeek V4-ProがAPIで提供されたのと同時に登場し、ハーネスとその主力デフォルトモデルがセットで登場しました。モデル側を評価している場合は、DeepSeek V4-Pro APIのガイドでエンドポイント、モデルID、リクエスト例について説明しています。
アーキテクチャ：すべてがプラグイン
ここに、dshが他の主流のコーディングエージェントと異なる点があります。ほとんどのハーネスはモノリシックです。エージェントループ、モデルクライアント、ツール定義、セッションストアが単一のアプリケーションとして提供されます。これらを設定したり、時には拡張したりすることはできますが、コア部分を入れ替えることはできません。
dshはそれを逆転させます。その設計原則は「すべてがプラグイン」であり、「時間的・空間的構成可能性のためのプログラミングパラダイム」と題された論文で設計が記述されているCordisというフレームワークに基づいて構築されています。学術的なタイトルを取り除けば、実用的な主張はこうです。通常は一体となっているエージェントの各コンポーネントが、dshでは交換可能なモジュールであるということです。これには以下が含まれます。
- モデルアダプター。 LLM APIと通信する層はプラグインです。これを交換すれば、dshは異なるバックエンドを駆動します。
- ツールレジストリ。 エージェントが呼び出すことができるツール（ファイル編集、シェル、検索）のセットは、ハードコードされるのではなく、プラグインによって登録されます。
- セッションログ。 セッションがどのように記録され、再生されるかはプラグイン可能です。
- エージェントループ自体。 コアとなる決定-行動-観察サイクルでさえ、交換可能なプラグインです。
なぜこれが重要なのでしょうか？2026年において、ハーネス層こそが本当の実験が行われている場所だからです。チームは、異なるコンテキスト管理戦略、異なる権限モデル、異なるリポジトリ向けの異なるツールセットを試したいと考えています。モノリシックなエージェントでは、ベンダーがあなたのアイデアを実装するのを待つことになります。しかしdshがあれば、プラグインを自分で書くことができます。
トレードオフも同様に現実的です。すべてが交換可能なシステムは、破損の表面積が大きくなり、互換性を破壊する変更を約束する開発者プレビューでは、途中でプラグインが壊れる可能性があります。それがdshがあなたに求める賭けです。つまり「今は柔軟性を、安定性は後から」ということです。
クイックスタート：ゼロから稼働中のエージェントへ
インストールパスは1つのコマンドです。
npx @deepseek-ai/dsh web
これにより、ローカルのWeb UIがhttp://127.0.0.1:3080で起動し、ブラウザで開かれます（自動で開きたくない場合は--no-openを渡します）。グローバルなインストールも、ゲートとなるアカウント作成もありません。
ソースからビルドしたい場合も、リポジトリパスで可能です。リポジトリをクローンし、`pnpm install`、`pnpm run build`、そして`pnpm dsh web`を実行します。
そこから、初回実行フローは3つのステップで構成されます。
- 設定でDeepSeek APIキーを設定します。キーは
$DSH_HOME/.credentials.yamlに保存され、それらへの参照のみを保持する主要な設定ファイルとは別に管理されます。 - ワークスペースを選択します。 「Choose workspace」をクリックし、dshを開始したプロジェクトディレクトリを追加して選択します。このステップは必須です。ワークスペースが選択されるまで、セッションコンポーザーは利用できません。dshは何かを実行する前に「どのファイルを考慮してよいか」について明確な回答を求めています。
- タスクを実行し、操作を承認します。 Web UIは「アクティブな権限ポリシーの下で承認が必要な」操作の前に確認を求めます。ファイルの書き込みやシェルコマンドは、サイレントに実行されるのではなく、プロンプトとして表示されます。
Web UIは単なる入り口の一つに過ぎません。内部では、dshはプロファイルを起動します。`dsh web`は`dsh --profile web`の略で、プロファイルは`$DSH_HOME/profiles/<name>`以下に保存されます。ヘッドレスモード（`dsh --profile headless "job"`）もあり、これは単一の新規セッションを実行し、結果を出力して終了します。これはスクリプトやCIに適した形式です。`dsh plugin`サブコマンドは、プロファイルディレクトリ内のpnpmに転送することでプロファイルのプラグインを管理し、`--dump-config`や`--dump-default-config`のようなランチャーフラグは、起動せずに構成ツリー全体を出力します。完全なリストはCLI READMEにあります。
どのようなモデルを実行できますか？
DeepSeekモデルがデフォルトであり、V4-Proが主要な組み合わせです。コスト面で知っておくべきことは、DeepSeekがオフピーク割引を恒久化したことで、一日中トークンを消費するエージェントの運用コストが変わる点です。詳細はDeepSeek V4-Proの値下げに関する記事、および公式リファレンスはapi-docs.deepseek.comにあります。
しかし、モデルアダプターはプラグインであり、dshはその特性を活かしています。デフォルト以外にも2つのパスが存在します。
- カタログプロバイダー。 Anthropic、OpenAI、Bedrock、Vertex、Azure用の組み込みプロバイダーエントリがあり、それぞれプロバイダー固有の認証情報処理を備えています。
- カスタムプロバイダー。 任意のOpenAI互換エンドポイントを
$DSH_HOME/settings.yamlに、ベースURL、キー用の環境変数、モデルリストと共に登録できます。これにより、クラウドAPIだけでなく、ローカルランタイムやゲートウェイもカバーされます。
モデルを選択すると、新しいセッションのデフォルトとなり、すべてのセッションはその開始モデルをログに記録するため、プロジェクト途中で切り替えても履歴が混乱することはありません。プロバイダーガイドは設定形式を文書化しています。このセクションを意図的に短くしたのは、カスタムエンドポイントの正確なYAMLを含む完全な手順はDeepSeek Harnessで任意のモデルを実行する方法に記載されているからです。
プラグインエコシステム、1週間後の状況
プラグインは`dsh-plugin` GitHubトピックを通じて発見され、コミュニティはGitHub DiscussionsとDiscordサーバーを通じて連携しています。ローンチから1週間後には、すでに需要の形が見えてきました。
- デスクトップラッパー。 deepseek-harness-desktop (Tauri) や dsh_desktop (Windows) のようなプロジェクトは、Web UIをネイティブアプリとしてパッケージ化しています。これらはコミュニティプロジェクトであり、DeepSeekの公式リリースではないため、APIキーに触れるあらゆるサードパーティラッパーと同様の精査を行ってください。
- 機能拡張プラグイン。 dsh-contextやdsh-vision-routerのようなコミュニティリポジトリは、セッションが見たりルーティングしたりできるものを拡張します。同様の注意点：コミュニティ製です。
- MCPサポート。 dshは、この記事の執筆時点では、コアでネイティブなモデルコンテキストプロトコル（MCP）サポートを提供していません。存在するものはコミュニティプラグインのdsh-mcp-managerで、これはMCP用の設定ページを追加します。リモートHTTPまたはローカルstdioサーバー、OAuthまたは静的トークン認証、`mcp__<name>__*`名で登録されたツール、そしてワークスペースの`.dsh`ディレクトリ内のプロジェクトごとのサーバー設定などです。
最後の点は、誤解されやすいため強調する価値があります。dshが「MCPをサポートしている」という投稿を読んだ場合、正確なバージョンは次のとおりです。コミュニティがMCPサポートをプラグインとして構築しており、これはまさに「すべてがプラグイン」というアーキテクチャの目的です。コアが後でそれを吸収する可能性はありますが、まだ行われていません。
あなたのAPIワークフローがどのように適合するか
エージェントハーネスとは、結局のところ、APIコールを実行するためのマシンです。それは駆動するモデルAPIであり、あなたが指定するプロジェクト内のAPIです。dshがあなたのバックエンドに対してコードを書くとき、それはコードベースからスクレイピングできるエンドポイントの理解に基づいて動作します。もしあなたのAPIの実際の動作がその仕様と一致しない場合、エージェントは自信を持って間違った契約に対してコーディングし、あなたは実行時にそれに気づくことになります。
その解決策は、退屈だが効果的です。エージェントが触れる前にAPIサーフェスを検証することです。Apidogはその層をカバーします。OpenAPI仕様を設計またはインポートし、実際のエン ドポイントをそれに対してテストし、モックサーバーを起動して、バックエンドが変更されている間でもエージェントが安定した仕様に正確なレスポンスに対して開発できるようにします。検証済みのモックに対して反復するエージェントは、古いコードから推測するエージェントよりもはるかに少ない「幻覚」的な統合を生成します。
直接的な統合パスもあります。Apidog MCP Serverは、MCPを介してあなたのAPI仕様をAIツールに公開します。dshでは、それは前述のコミュニティdsh-mcp-managerプラグインを介して行われます。プラグインをインストールし、Apidog MCP Serverを登録すれば、セッションは推測する代わりに実際の仕様をクエリできます。エージェント自身がトリガーできるCLIベースのテスト実行を含め、DeepSeek HarnessでApidog CLIを使用する方法で全体の手順を説明しています。実験の前にAPI側を準備したい場合は、まずApidogをダウンロードし、仕様をインポートしてください。これはエージェントエラーの最大の原因を取り除く、5分間のセットアップです。
今試すべきか、待つべきか？
正直な答えは、あなたがそれを何に使うかによります。
今すぐ試すべき場合：
- エージェントハーネスが内部でどのように機能するかを理解したい場合。dshは利用可能な主要ハーネスの中で最も検査しやすく、実際のAILoopを読むことは、どんなブログ記事よりも多くのことを教えてくれます。
- モデルの柔軟性が必要な場合。チームが異なるタスクに異なるモデルを使用している、または自己ホストしている場合、プラグイン可能なモデルアダプターはモノリシックエージェントでは得られない機能です。
- ツールを構築する場合。プラグインエコシステムはまだ1週間です。これほどの注目を集めるリポジトリで初期のプラグイン作者は、非常に大きな注目を浴びることができます。
- すでにDeepSeekのAPIを利用しており、V4-Pro向けにファーストパーティのエージェントエクスペリエンスを求めている場合。
待つべき場合：
- 安定した日常的なドライバーが必要な場合。「互換性を破壊する変更が発生します」はマーケティング上の謙虚さではなく、約束です。あなたの設定、プラグイン、そして体で覚えた操作のすべてが、バージョン間で壊れる可能性があります。
- 組織が審査済みでサポートされているツールを必要とする場合。コミュニティプラグインが認証情報を扱う開発者プレビューは、サポート契約付きのGA製品とは異なるリスクプロファイルです。
- 成熟したハーネスの洗練さを求める場合。Claude Codeはエルゴノミクスにおいて長いリードを持っており、1週間前のプレビューがまだあらゆる面でそれに匹敵することはありません。
ほとんどの現役開発者にとって、現実的な動きは両方です。本番作業には現在のエージェントを使い続け、サイドプロジェクトでdshを動かし、プレビューのラベルが外れる前に自分自身の意見を形成することです。もしあなたの主な疑問が、既存の製品と比べてどうかということであれば、DeepSeek Harness vs Claude Codeで並べて比較しました。
よくある質問
DeepSeek Harnessは無料ですか？
ハーネス自体はMITライセンスの下で無料のオープンソースです。費用がかかるのはその背後にあるモデルです。DeepSeekのプラットフォーム（または設定したプロバイダー）でのAPI使用は、そのプロバイダーによって通常通り請求されます。アダプター層はプラグイン可能であるため、dshをローカルでホストされたモデルに指定して、トークンごとに何も支払わないことも可能です。設定についてはDeepSeek Harnessで任意のモデルを実行する方法を参照してください。
dshはDeepSeekモデルとのみ動作しますか？
いいえ。DeepSeekモデルがデフォルトですが、モデルアダプターはプラグインです。カタログプロバイダーはAnthropic、OpenAI、Bedrock、Vertex、Azureをカバーしており、任意のOpenAI互換エンドポイントは`$DSH_HOME/settings.yaml`を通じて追加できます。
DeepSeek Harnessを自分のコードベースで実行しても安全ですか？
その安全性は、権限モデルとあなたの判断次第です。Web UIは、セッションを実行する前にワークスペースを選択するよう求め、アクティブな権限ポリシーの下で承認が必要な操作の前にプロンプトを表示します。とはいえ、これは開発者プレビューであり、コミュニティプラグイン（デスクトップラッパーを含む）は、あなたのAPIキーを扱う可能性のあるサードパーティコードです。インストールするものをよく確認し、誤った編集が損害を与える可能性のあるリポジトリからはプレビューを遠ざけてください。
「ハーネス」は「モデル」とどう違うのですか？
モデルは推論エンジンであり、ハーネスはモデルが動作するために必要なすべてです。セッション管理、ツール呼び出し、ファイルアクセス、権限プロンプト、コンテキストアセンブリのすべてがハーネス内に存在します。全く同じモデルを使用する2つのエージェントが、ハーネスが異なるために完全に異なる動作をすることがあり、これが現在、ほとんどのコーディングエージェントの競争がハーネス層で起こっている理由です。