DeepSeek Harness (dsh) 使い方入門:5 分で動かすクイックスタート

DeepSeek Harness(dsh)の最短の使い方。Node.js 24.9 以上で npx @deepseek-ai/dsh web を実行し、Web UI は http://127.0.0.1:3080。Settings → Models に API キーを貼れば 5 分で最初のタスクまで辿り着けます。

最終更新: 2026-11-12

ひと言でいうと

DeepSeek Harness(dsh)は、DeepSeek が公開しているオープンソースの「すべてがプラグイン」なエージェントランタイムです。現在も 開発者プレビュー で、リリース間で互換性を壊す変更が入ります。まず Node.js 24.9 以上(公式 README と @deepseek-ai/dsh npm パッケージが宣言している下限)を入れて、次を実行します。

npx @deepseek-ai/dsh web

Web UI は既定で http://127.0.0.1:3080 に立ち上がり、通常はブラウザが自動で開きます。Settings → Models に API キーを貼り、ワークスペースを選んで、小さなタスクを 1 つエージェントに頼めば完了です。UI ではなくターミナルで単発のジョブを流すなら:

npx @deepseek-ai/dsh --profile headless "このプロジェクトを要約し、主要ファイルの役割を教えて"

npm install -g @deepseek-ai/dsh してから dsh web でも動きますが、それは任意の経路です。公式のゼロインストール入口は npx です。本ページの内容は 2026-11-12 に公式 README と公開中の npm パッケージで確認済みです。第三者チュートリアルと食い違う場合は README が優先です。

インストール:コマンド 1 本

npx @deepseek-ai/dsh web

初回はパッケージをダウンロードします(“Ok to proceed?” と聞かれたら y)。web プロファイル で起動し、ブラウザで Web UI を開きます。

常駐の CLI が欲しい場合は 1 回だけ入れておけば、起動のたびにダウンロードせずに済みます。

npm install -g @deepseek-ai/dsh
dsh web          # dsh --profile web と同じ

途中で何か壊れたら github.com/deepseek-ai/deepseek-harness を確認してください。README と issues はそこにあり、対応 Node.js バージョンの正確な情報源は README です。

API キー、あるいは不要な場合

Web UI で Settings → Models を開き、DeepSeek の API キーを貼って保存すれば、再起動なしでそのモデル経路が使えるようになります。マシンの環境変数にすでにキーがある場合は dsh が自動で拾うので、この手順はまるごと不要です。

ハーネスが体で、モデルが脳です。別のモデルを使いたければ OpenAI 互換エンドポイントなら何でも使えます。UI の設定で変更してください(DeepSeek Harness とは? 参照)。

最初のタスクの前に

先に決めておくとよいことが 1 つあります。エージェントに作業させたいフォルダで dsh を起動すること。 デフォルトのサンドボックスはそのワークスペースにしか触れさせないので、起動ディレクトリはそのまま安全境界になります。

最初のタスク

Web UI はチャット画面で開きます。キー操作ではなく、欲しい結果を説明してください。手順はエージェントが自分で計画します。最初のタスクの例:

  • 「このリポジトリの TODO を要約して、完了までの計画を提案して」
  • 「このプロジェクトの失敗しているテストを直して、実行して確認して」
  • 「このコードベースの構造を短いドキュメントとして説明して」

動きを観察してみてください。エージェントは確認の質問をしたり、計画を提案して承認を待ったり、その後ツール呼び出しを始めたりします。セッションログはモデルが見るものすべてを記録するので、後からセッションを再開したり分岐したりできます。

リスクのある操作(ワークスペース外への書き込み、ネットワーク呼び出し、見慣れないコマンドの実行)が来たら、ハーネスは実行前に確認します。バグではなく、承認システムが仕事をしている状態です。

モードの選び方

UI 上部のモードセレクターはセッションの Agent Preset を選ぶものです。初回は Standard のままで問題ありません。4 つのモードは以下の通りです。

モード内容使いどき
Standard完全なプログラミングアシスタント。タスクを理解し、コードを編集し、コマンドを実行して結果を確認日常のコーディングと調査
PTCStandard の全機能に加えて programmatic tool calling:多数のステップを 1 つの自動化フローにまとめる小さな TypeScript プログラムをモデルが書く機械的ステップの多いタスク
Minimal永続ターミナルと基本的なテキスト置換ツールのみ単純な編集、ベンチマーク、ループの学習
CreationStandard の全機能に加えてランタイム検査、メモリ上でのプラグイン試行、創作タスク用プリセットの構築自分のプリセットを設計するとき ―― シェルアクセスと同じ感覚で扱うこと

セッションは内容が入った時点でプリセットがロックされるので、モードを変えるなら入力を始める前に。

最初のセッションの後

  • セッションは再開できます。 タブを閉じても、イベントログから再開・分岐・検索・リプレイが可能です。
  • プラグインの導入はコマンド 1 本: dsh plugin --profile web add <パッケージ名 または github:owner/repo> を実行し、dsh web を再起動します。プロファイルディレクトリ内の pnpm に引数をそのまま転送します。最初の 1 個を入れる前に プラグインの安全なインストール方法 を読んでください。
  • プロファイル・パッチ・プリセット が、ハーネスをあなた仕様に組み立てる仕組みです。設定ガイド で積層順序を解説しています。パッチレイヤーこそ、dsh が他のエージェントと本質的に分かれる場所です。サブエージェント、条件付きルール、権限、UI 交換 ―― すべて設定です。

動かないとき

  • Node.js のバージョン ―― 初回起動失敗の最大原因です。dsh には Node.js 24.9 以上が必要なので、まず node --version を確認してください。下限が動いた場合は公式 README が優先です。
  • モデルが応答しない ―― Settings → Models の API キーを確認し、マシンからプロバイダーのエンドポイントへ到達できるかも確認してください。
  • ポート 3080 が使用中 ―― npx @deepseek-ai/dsh web --port 8080 で起動し、ターミナルが表示した URL を開いてください。
  • コマンドが拒否される ―― サンドボックスか承認ポリシーの仕事です。意図的にサンドボックスを広げるか(セーフティガイド 参照)、ワークスペース内で作業してください。

次に読む

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。