Windows 上の DeepSeek Harness: デスクトップアプリなし、問題なし — 公式の実行方法

There is no official DeepSeek Harness desktop app for Windows, and you do not need one. DeepSeek Harness (dsh) — the open-source agent runtime DeepSeek released under an MIT license on 2026-08-13 — is a Node.js tool that runs a local web server you open in your browser, with a headless CLI for the terminal as the alternative. On Windows the whole setup is two commands: install Node.js 22.19 or newer (Node 24 LTS is the safer pick), then run npx @deepseek-ai/dsh web and open http://127.0.0.1:3080. Every "DeepSeek Harness Desktop" repository on GitHub is an unofficial community wrapper around that same two-command setup — useful to some people, but not required. It is also the harness DeepSeek uses to produce the agentic coding results it reports for DeepSeek V4 Pro and DeepSeek V4 Flash, which is why the two models keep showing up in any conversation about it.

「deepseek harness windows」で検索したなら、おそらくラッパーリポジトリのページを眺めながら、どれをインストールすべきか迷っていることでしょう。この記事は、その検索の背後にある本当の疑問に答えます。DeepSeek Harnessが実際に何なのか、今日Windowsで実行する公式な方法、ターミナルでの代替手段、そしてプレビュー段階のツールを実行する際の率直な注意点についてです。これはハウツー記事であり、ローンチ記事ではありません。ローンチとリークの経緯については、別の記事で扱っています。

DeepSeek Harnessとは何か（そして何ではないか）

DeepSeek Harnessはモデルではなく、モデルのベンチマークを行うものでもありません。これはエージェントランタイムです。モデルをツール、ファイル、シェル、インターネットに接続するレイヤーであり、コードを読み、変更を計画し、コマンドを実行し、タスクが完了するまで反復します。そのアーキテクチャはタグラインに示されています："すべてはプラグイン。"モデル、ツール、スキル、セッション、サンドボックス、エージェントループ自体、さらにはWeb UIまでもが、起動時に組み合わされるプラグインであり、Cordisメタフレームワーク上に構築されています — Koishiチャットボットエコシステムの背後にあるのと同じカーネルです。デフォルトのデプロイメントには150以上のプラグインが同梱されています。

また、これは強調してプレビュー版である。dshはバージョン0.1.0-rc.6で、READMEは開発者プレビューと位置づけ、大文字で「THERE WILL BE COMPATIBILITY-BREAKING CHANGES」と警告している。それでも採用は衰えていない。プロジェクトは2026-08-13の公開から最初の12時間で約5万のGitHubスターを獲得し、2026-08-16時点で約12万6000に達した。これはDeepSeekがリリースしたオープンソースの中で最速の普及である。

簡単に言うと、Windowsの公式な方法は2つのコマンドです。

DeepSeekの公式READMEには、Windowsでの実行手順が1行で示されています。Node.jsをインストールして、次のコマンドを実行します：npx @deepseek-ai/dsh web。具体的には、手順は次のとおりです。

• Node.js 22.19+ または Node 24 をインストールしてください。現在の dsh リリースには Node 22.19 以上が必要です。Windows では Node 24 LTS を選ぶのが安全です。その理由は簡単で、新しい Node バージョンにはネイティブの zstd 解凍が組み込まれており、dsh は圧縮済みセッションログの読み取りにこれを使用します。インストールを確認するには、node --version を PowerShell または cmd で実行してください。

• Run the harness. Either run it on the spot with npx @deepseek-ai/dsh web, or install it once with npm install -g @deepseek-ai/dsh and then run dsh web from any folder afterwards. The first run prints the URL and starts the Web UI at http://127.0.0.1:3080.

• そのアドレスをブラウザで開いてください。Web UIはローカルWebアプリです。そのため、デスクトップアプリはありません。ブラウザがデスクトップアプリです。

• モデルキーを一度追加してください。を Web UI で開き設定 → モデル、DeepSeek APIキーを貼り付けて保存します。すぐに反映され、サーバーの再起動は不要です。dsh は、起動元のフォルダーを既定のファイルシステムの場所として使用し、UI の ワークスペースを選択 ステップで、任意のプロジェクトディレクトリを指定できます。

それが公式の手順全体です。マシンにすでにNode 22+がインストールされていれば、「何もない」状態から「エージェントが実行中」になるまで1分もかかりません。

なぜ「DeepSeek Harness Desktop」のリポジトリはすべてラッパーなのか

このクエリの1ページ目の結果は、すべてコミュニティ製のデスクトップラッパーです。Electron、Tauri、WebView2のシェルで、Nodeランタイムを同梱し、フレーム付きウィンドウ内で公式Web UIを起動します。これらはDeepSeekの製品ではなく、活用能力を追加するものでもなく、ランチャーを追加するものです。それらに共通する点は次のとおりです。

それらはダブルクリックで起動でき、コマンドラインを完全に避けられる——それが本当の売りどころだ。

• これらは署名されていないため、インストール時にWindows SmartScreenの警告が表示されます。「詳細情報 → 実行」はフローの一部です。

• 彼らは公式プロジェクトを異なるペースで追跡しています。0.1.0-rc.5 に固定する人もいれば、0.1.0-rc.6 に固定する人も、master に追従する人もいます。そのため、ラッパーとハーネスのバージョンは時間とともに乖離していきます。

これらは、dshが常に使用するのと同じローカルデータを~/.dshの下に保存するため、ラッパーと公式CLIを切り替えてもセッションはリセットされません。

ラッパーが価値があるのはいつか？「アイコンをダブルクリックして、トレイが見えて、ターミナルに一切触れない」ことが決め手となる場合だ。その場合、プレビュー段階のツールの前面に、サードパーティがアップデートとセキュリティのレイヤーとして存在することを受け入れることになる。では、価値がないのはいつか？公式の手順はコマンド2つとブラウザのタブだけだ。すでにNodeを持っているなら、ラッパーは必要ないかもしれないランチャーを手に入れるだけで、その代わりに独自のメンテナンスの表面が追加される。

ターミナルルート：ヘッドレスCLIとTUIプラグイン

ブラウザが作業場所でない場合、dshにはターミナル向けの機能もあり、2つのモードに分かれています。

ヘッドレスは非対話型プロファイルです：dsh --profile headless "summarize this repository"は、UIなしで1つのタスクを実行し、結果を出力して終了します。これはCI向けのモードです。Windowsでは、スクリプトやスケジュールされたタスクもこのモードを使用すべきです。ディスプレイやログインセッションを必要としないためです。

TUIは、Claude Codeスタイルの対話型ターミナルフロントドアであり、コアパッケージではなくコミュニティ製のプラグインバンドルとして提供されています。dsh-tuiのようなパッケージは、dsh plugin --profile tui add <package>でプロファイルにインストールし、dsh --profile tuiで実行します。少なくとも1つはWindows用の.cmdランチャーを同梱しています。試す前に知っておくべき注意点：TUIは入力と出力の両方に実際のターミナルが必要です。パイプやリダイレクトを使用する設定の場合、dshは拒否し、代わりにヘッドレスモードを使用するよう指示します。

4つのプリセット：どの作業にどれを使うか

dshには4つの組み込みエージェントプリセットが同梱されていますが、これらは難易度の階段ではなく、4つの異なるツールサーフェスです。デフォルトは ~/.dsh/settings.yaml の agent-presets.default で設定します。

• 標準はデフォルトです。ファイル編集、シェル、ファイル検索とウェブ検索、スキル、サブエージェント、プランニングといった日常のあらゆる作業に対応するフル機能のエージェントです。ほとんどのWindowsユーザーは、まずこれを使い始めるのがよいでしょう。

• PTC（コードモードとも呼ばれる）は、Standardが備えるすべての機能を維持しつつ、ツールの公開方法を変更します。長く連続した独立したツール呼び出しではなく、モデルがTypeScriptプログラムを作成して、ループ、フィルタ、条件分岐といった複数ステップの操作を組み合わせます。複雑なワークフロー、繰り返しの多いワークフロー、または複数ステップのワークフローに適しています。

• Minimalは、エージェントを意図的に2つのツール（永続シェルとファイルエディタ）に絞り込んでおり、日常の作業ではなく評価とベンチマークを目的としています。これはDeepSeek自身のエージェントスコアが実行されるプリセットです。

• Creation (Cordis) はカスタムプリセットを作成するためのものです。ランタイム検査、インメモリでのプラグイン実験、プリセット作成のガイダンスが含まれます。ハーネス自体を試すためのものです。

MCPと軌道再生：これを実行する価値がある理由

プレーンなチャットクライアントではなくdshを使う価値がある理由は2つある。第一に、Model Context Protocol (MCP) クライアントが組み込まれている — /mcpコマンドとSettings MCPタブで外部MCPサーバーをハーネスに接続できるので、他のエージェントが使っているのと同じツールをdshにプラグインできる。第二に、すべての実行は追記専用のセッションログに記録され、Trajectoryビューでは実行をソースごとに調べたり、再開、フォーク、検索、リプレイしたりできる。これが、エージェントの最終的な答えをただ眺めてデバッグすることと、各呼び出しを行った理由をステップごとに追跡することの違いである。

公式の道が誤った答えであるとき

• 必要なのは、ワンクリックでターミナル不要なことだ。公式インストーラーは存在しない。ダブルクリックが絶対条件なら、コミュニティ製ラッパーに頼ることになる。それらは未署名なので、利便性と、サードパーティによるメンテナンスの手間を天秤にかけること。

• お使いのWindowsマシンは古いか、ロックダウンされています。 dshはNode 22.19+（またはNode 24）を必要とします。管理されたマシンでは、それはランタイムのインストールと、あなたが持っていない可能性のある承認を意味します。

• これはプレビュー版であり、壊れます。 0.1.0-rc.6 には、今後破壊的変更が行われるという警告が含まれています。rc ビルド間では、プラグインやプロファイルが動作しなくなることがあります。スクリプトを組む場合は、バージョンを固定してください。

• モデル使用料はお客様の負担です。 dshは無料です。各タスクは設定したキーでトークンを消費します。エージェントループはファイルを読み直してリトライするため、難易度の高いタスクで冗長なモデルを使うと、午後だけで驚くほどの予算を使うことがあります。ここでコストを左右するのは、ハーネスの選択ではなく、モデルの選択です。

• 定額サブスクリプションは、トークン単位のルーティングを上回ることがあります。特定のラボのプラン内で上限に収まるなら、定額サブスクリプションはどのトークン単位のルーティングよりも安価なことが多いです。モデルを混ぜるかフェイルオーバーが必要な場合はルーティングが勝りますが、デフォルトではそうではありません。

モデルをハーネスの背後にルーティングする。

ネイティブパスはDeepSeek独自のAPIです。Settings → Models にキーを貼り付ければそのまま使えます。しかしdshはOpenAI互換のベースURLも受け付けます — 環境変数にDEEPSEEK_BASE_URLを設定するか、settings.yamlでLLMプロバイダーを設定します — つまり、ハーネスに触れることなく、ハーネスの背後にあるモデルを差し替えられます。同じローカルdshインストール上で、難しいリファクタリングにはDeepSeek V4 Proを、安価な機械的編集にはDeepSeek V4 Flashを使用できます。

それがOrcaRouterが占める層です。OpenAI互換のベースURL1つ、200以上のモデル、マークアップなし——プロバイダーのリスト価格をそのまま転送——そしてプロバイダーがレート制限や性能低下を起こした際の自動フェイルオーバー。dshをそれに向ければ、ハーネスはあなたのマシン上に留まり、モデルカタログは購入ではなくルーティングの判断になります。正直な注意点が2つ：私たちはdshをホストしていません——それはあなたのWindowsマシン上でローカルに動作します——そして、DeepSeek自身のAPIを超えるモデルが必要な場合、私たちはモデルアクセス層にすぎません。また、プランの上限内で単一のヘビーモデルを使う場合、ルーターに関係なく定額サブスクリプションの方が安いことがよくあります。

短いバージョン

Windows 上の DeepSeek Harness は、アプリストアからのインストールではなく、2 つのコマンドでセットアップできます。Node 22.19 以降(または Node 24)を用意し、npx @deepseek-ai/dsh web を実行したら、ブラウザで http://127.0.0.1:3080 にアクセスします。GitHub の「デスクトップ」リポジトリは、同じローカルサーバーをラップした非公式のものです。ターミナル向けには、ヘッドレスモードが CI 用のワンショットタスクを実行し、TUI プラグインが Claude Code スタイルのインターフェースを提供します。Standard・PTC・Minimal・Creation の 4 つのプリセットでツールの範囲を選択でき、MCP と軌跡リプレイによって真に実用的です。無料・オープンソースのプレビュー段階であり、バージョンの固定、モデル料金の監視、そしてハーネスとは別にモデルをルーティングすることをお勧めします。