DeepSeek Harness チュートリアル:インストールから headless まで
スクリーンショットで検証済みの 10 ステップ。真っ新しいインストールから Agent プリセット、Creator モードのプラグイン、headless 実行まで——DSH の完全ツアー。
最終更新: 2026-09-14
DeepSeek Harness(DSH)は DeepSeek がオープンソース化したエージェントハーネスで、公開 1 週間で GitHub スター 169,000 を記録しました。ワークスペース、プラグイン、ツール、サブエージェント、差し替え可能なモデル——そして UI まで作り直せる。このガイドは、現時点で最も完成度の高い動画ウォークスルーを、スクリーンショット検証済みの 10 ステップに整理したものです。クリーンインストールからプリセット、プラグイン、サンドボックス、headless 実行まで一気にたどります。
1 ページで読み切れる完全ツアーです。各ステップから元動画の該当シーンへディープリンク。プラグイン導入・モデル切り替え・Agent プリセットといった深掘りテーマは、ページ末尾の専用ガイドへどうぞ。
10 ステップで巡る DSH 全体像
- 1
ハーネスをインストールし、ダッシュボードを起動する
DeepSeek Harness(DSH)は、モデルに手を与えるオープンソースのハーネスです。ファイルツール、シェル、メモリ、権限。公式ドキュメントの導入方法は 2 つ——npx のワンライナーか、リポジトリの完全 clone(動画は clone を選択)。あとは 1 コマンドで Web UI が起動し、ローカル URL(動画では 127.0.0.1:3080)が表示されます。初回起動時には DeepSeek API キーを求めるダイアログが出ます。
$git clone https://github.com/deepseek-ai/deepseek-harness$pnpm dsh web
インストールは 2 択:npx ワンライナーか clone——動画は clone を選びました。1:15 に見る 
1 コマンドで Web UI が起動し、ローカル URL が表示されます。1:38 に見る - 2
任意のモデルプロバイダーを接続する——DeepSeek だけが選択肢じゃない
頭脳は DeepSeek である必要はありません。Settings → Models を開き、Add provider をクリック、リストから選択(ドロップダウンは amazon-bedrock から groq まで)、API キーを貼り付けて Apply。動画の作者は OpenRouter を接続し、どのモデルが最適かを試し、タスクごとに簡単に切り替えられるようにしています。プロバイダーが公開しているモデルは、すべてコンポーザーのモデルセレクターに現れます。

Add provider、選択、キーを貼り付け、Apply——設定はこれ一度きり。2:05 に見る 
プロバイダーをつなげば、そのモデルがすべてコンポーザーに現れます。2:13 に見る - 3
何かを頼む前にワークスペースを追加する
DSH で意味のあるアクションを取るには、フォルダを渡すことが前提です。サイドバーの Add workspace ボタン、またはコンポーザーのワークスペースドロップダウンから追加します。エージェントのセッションはそのフォルダにスコープされる——これは「1 つの仕事に集中する」のと「PC 全体を放し飼いにする」の分岐点です。セッションは永続的で、今日閉じて明日開けば、前の仕事がそのまま残っています。

まずフォルダを選ぶ——すべてのセッションはそこにスコープされます。2:30 に見る - 4
すべてはプラグイン——コアに見える部分さえも
DeepSeek が冒頭で掲げる言葉です。モデルと対話する部分、ツールリスト、何が起きたかのログ、さらにはエージェントの次の一手を駆動するループ——すべてプラグイン。保護されたコアは存在しないので、DSH には永続的なものがなく、何もあなたを縛れません。Settings → Plugins を開けば実感できます。ストレージも、セッションも、承認も、web サーバーさえも Enabled バッジ付きのプラグイン。エコシステムには既にコネクタが揃いつつありますが、DSH は開発者プレビューで、readme も破壊的変更がありうると明言しています。車輪の再発明の前にプラグインディレクトリを確認し、作ったものはプロトタイプとして扱いましょう。

DeepSeek 自身の言葉:DSH に永続的なものは何もない。4:15 に見る 
ストレージも、承認も、web サーバーも——このリストではただのプラグインです。4:25 に見る - 5
仕事に合う実行モードを選ぶ
Settings → Agent presets には、組み込みの再構成が並びます。Standard モードはフルセット:ファイル編集、検索、シェル、Skills、計画、サブエージェント。Code モードは同じツールを公開しつつ、1 つずつ呼び出す代わりに、それらを連結する 1 本のプログラムをモデルに書かせます。Minimal モードはターミナルとファイルエディタの 2 ツールのみ。動画では同一タスク(200 ファイルのリネーム)をベンチマークし、Standard モードは 30 ラウンドトリップ、Code モードは 3 回でした。同じツールでもコストは 3 通り——仕事を終えられる最も安いモードを選びましょう。

組み込みプリセットは 4 種類——複製して改造するか、Creator モードに起草させます。5:22 に見る 
同じ 200 ファイルのリネーム:Standard は 30 回、Code モードは 3 回。5:32 に見る - 6
プラグインを説明すれば、Creator モードが作る
Creator モードは、自分の稼働環境を調べ、メモリ上で新しい部品を試し、あなたが普通の言葉で説明している間に能力を作り上げます。デモのプロンプトはこれだけ:エージェントの中に pong 風のミニゲームを作って。DSH は操作説明を整え、プラグインパッケージを定義し、ゲームはチャット上のフローティングウィンドウとして描画されます。ツール呼び出しの合間も動き続けます。人が書いたコードは 1 行もありません。DSH のカスタマイズは会話であり、プロジェクトではありません。

1 文で説明して、フローティングウィンドウで稼働——書いたコードはゼロ。6:05 に見る 
レシート完備:プラグイン定義済み、リクエスト計測済み、トークン集計済み。6:25 に見る - 7
Trajectory のレシートを読みながら進める
モデルが見たもの、やったことのすべては追記専用のログに書き込まれ、Trajectory タブがそれを読み返せる画面です。システムプロンプト、コンテキスト注入、推論、すべてのツール呼び出しと結果。問題を起こしたとき、何を伝えられていたかを正確に確認できます。この画面はツールの目録でもあります——bash、skill などが行動範囲のすべてで、リストにないことは起きません(Creator モードで追加は可能)。

システムプロンプト、コンテキスト注入、ツール呼び出し——レシートは追記専用のままで。9:28 に見る - 8
手綱を締める:サンドボックスレベルと承認
3 つのサンドボックス設定がすべてのセッションを制御します。Read-only は見るだけで触れず、Workspace write はプロジェクトフォルダ内のみ変更でき、Full access は文字通りの全権——OS が下層で強制します。動画では read-only セッションが index.md のコピーを承認まで拒否——作者は拒否ボタンを押しました。「常に許可」の選択肢はありません。Full access は確認ステップを減らす代わりに、警告ダイアログでリスクに同意してから意図的にオンにするものです。普段は workspace write、full access は慎重に。

read-only は見るだけ:コピーはそもそも実行されていません。8:06 に見る 
フルアクセスは慎重な決断:警告とチェックボックス、そして取り消しはできません。9:05 に見る - 9
何かに触る前に、計画を提示させる
Plan モードを使えば、DSH は何もする前にやることを言語化します。コンポーザーで /plan と入力し、タスクを説明、計画を読んでから解放する。計画を読むのは 1 分もかかりません。間違った 40 件のファイル編集の取り消しは数週間に及びかねません。2、3 ファイルを超える仕事には、まず計画を。

計画を読んでから、エージェントを解放する。9:55 に見る - 10
教える、委任する、そして headless で走らせる
Skills は手順を書き留めた指示ファイルで、プロジェクトに入れることもグローバルにインストールすることもできます——動画では Claude Code のグローバルスキルが自動的に取り込まれました。ゴール(/goal)はセッションにフィニッシュラインを取り付け、結果にたどり着くまで走り続けさせます。ゴールは具体的に。組み込みのスケジューラはありませんが、Creator モードは定期タスクのプラグインを起草してくれます——セッションを閉じると停止しますが。長時間の仕事はサブエージェントに委任され、各自がクリーンなコンテキストを持ちます。あるいはエージェントが使い捨てのワークフロープログラムを書き、成果を追いかけます。最後に headless モード:1 コマンドで答えを表示して終了——ウィンドウもポートもなし。コマンドを実行できるものは、何でもエージェントを動かせます。
$pnpm dsh --profile headless "<one-off task>"
Skills は一度書けば繰り返し使える指示——プロジェクト単位でもグローバルでも。10:35 に見る 
ウィンドウもポートもなし:1 コマンド入れて、1 つの答えを受け取る。13:30 に見る
DeepSeek Harness チュートリアル:FAQ
このツアーによく寄せられる質問。
DeepSeek Harness を最も速くインストールする方法は?
公式ドキュメントには 2 つの方法があります。Web UI を直接起動する npx ワンライナーか、動画のように git リポジトリを clone する方法。どちらでも、1 コマンド(clone したリポジトリでは pnpm dsh web)でダッシュボードがローカル URL(ウォークスルーでは 127.0.0.1:3080)で起動し、初回起動時に API キーを求められます。
DSH を使うのに DeepSeek の API キーは必須ですか?
いいえ。初回起動のポップアップはキーを求めますが、Settings → Models → Add provider ではリスト上の任意のプロバイダーのキーを受け付けます。ウォークスルーでは OpenRouter を使用し、公開されているすべてのモデルをコンポーザーのモデルセレクターからタスクごとに試せます。
どの実行モードから始めるべきですか?
Standard モードです。ファイル編集、検索、シェル、Skills、計画、サブエージェントを備えたフルセットです。安価な繰り返し作業は Minimal モードへ、数十回のラウンドトリップが必要な作業は Code モードへ。動画の 200 ファイルリネームのベンチマークでは、Code モードは 3 回で完了し、Standard は 30 回でした。
DeepSeek Harness は、エージェントがファイルを壊すのをどう防ぎますか?
サンドボックス設定はプロンプトではなく OS が強制します。read-only は見るだけ、workspace write はプロジェクトフォルダ内のみ変更可能、full access は何でもできます。ウォークスルーでは read-only セッションが明示的な承認までファイルのコピーを拒否しました。「常に許可」のオプションはありません。full access は警告ダイアログ経由で意図的に有効化するものであり、既定にすべきではありません。
DSH は本当に自分自身のプラグインを作れるのですか?
はい、Creator モードの仕事です。欲しい能力を普通の言葉で説明すると、稼働環境を調べ、メモリ上で部品を試し、プラグインパッケージを定義します。動画では 1 文でチャット内で動く Pong ゲームを作り、後半では定期タスクのプラグインを起草させていました——セッションが生きている間だけ動く点に注意です。
Web UI なしで DeepSeek Harness を実行できますか?
headless モードは、タスクを渡す 1 コマンドで答えを表示して終了します。ウィンドウもポートもリスナーもなし。だからこそスクリプトやスケジュールタスク、他のエージェントツールがターミナルから DSH を呼べます。コマンドを実行できるものは、何でもエージェントを動かせます。
関連ガイド
このツアーの各ピースを、さらに深く。
DeepSeek Harness クイックスタート
5 分でインストールして最初の実行まで、最短手順を一つずつ。
ガイドを読むDeepSeek Harness プラグインのインストール
コミュニティプラグインを探し、npm や GitHub から追加し、読み込みを確認する。
ガイドを読むDeepSeek Harness Agent プリセット徹底解説
Standard・Code・Minimal・Creator の各モードを深掘りし、独自プリセットの起草まで。
ガイドを読むDeepSeek Harness のモデル切り替えガイド
プロバイダー接続、モデル比較、コンポーザーからのタスクごとの切り替え。
ガイドを読むDeepSeek Harness 必須プラグイン
最初に入れる価値のあるコミュニティプラグインと、それぞれで何が加わるか。
ガイドを読むDeepSeek Harness サブエージェントとマルチエージェント実践
5つのサブエージェントを並列実行:ヘッダーから各子を監視し、完了レポートを確認し、サブエージェントごとにモデルを指定。スクリーンショット付きの手順
ガイドを読むソースとクレジット
本ページのスクリーンショットはすべて、下記の公開画面録画から取得したもので、各画像から撮影された瞬間へディープリンクで戻れます。内容は公式ドキュメントと突き合わせて確認しています。
