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 | 完全なプログラミングアシスタント。タスクを理解し、コードを編集し、コマンドを実行して結果を確認 | 日常のコーディングと調査 |
| PTC | Standard の全機能に加えて programmatic tool calling:多数のステップを 1 つの自動化フローにまとめる小さな TypeScript プログラムをモデルが書く | 機械的ステップの多いタスク |
| Minimal | 永続ターミナルと基本的なテキスト置換ツールのみ | 単純な編集、ベンチマーク、ループの学習 |
| Creation | Standard の全機能に加えてランタイム検査、メモリ上でのプラグイン試行、創作タスク用プリセットの構築 | 自分のプリセットを設計するとき ―― シェルアクセスと同じ感覚で扱うこと |
セッションは内容が入った時点でプリセットがロックされるので、モードを変えるなら入力を始める前に。
最初のセッションの後
- セッションは再開できます。 タブを閉じても、イベントログから再開・分岐・検索・リプレイが可能です。
- プラグインの導入はコマンド 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 を開いてください。 - コマンドが拒否される ―― サンドボックスか承認ポリシーの仕事です。意図的にサンドボックスを広げるか(セーフティガイド 参照)、ワークスペース内で作業してください。
次に読む
- おすすめ人気プラグイン Top 10&スターターパック ―― 初回起動後にまず入れるべき定番セット
- 2026 年おすすめ必装プラグイン 12 選 ―― 最初に入れるべき定番プラグインの徹底解説
- 目的別コレクション一覧 ―― 開発ワークフロー別のおすすめセット
- DeepSeek Harness とは? ―― いま動かしたものの背後にある概念
- DeepSeek Harness チュートリアル:初心者から上級者まで ―― 1 ステップ 1 画面でたどる完全図解ツアー
- dsh プラグインとは? ―― インストールすると実際に何が得られるか
- プロファイル・パッチ・プリセット ―― ハーネスを自分のものにする
- 全プラグイン一覧を探索する ―― 「すべてがプラグイン」の意味を実感するいちばん速い方法
