DeepSeek Harness とは？ インストール方法と他ツールとの比較

DeepSeek Harness の概要

DeepSeek Harness のインストールと使い方

1. デスクトップ版か Web 版を選ぶ

   deepseek.com/en/harness から macOS（Apple シリコン）または Windows（64ビット）向けのデスクトップアプリをダウンロードします。macOS では dsh コマンドもインストールできます。Node.js が入っているマシンなら、npx で Web UI を起動するか、ソースからビルドできます。

   # Node.js で Web UI を起動
   npx @deepseek-ai/dsh web
   # その後 http://127.0.0.1:3080 を開く
   
   # またはソースからビルド
   git clone https://github.com/deepseek-ai/deepseek-harness.git
   cd deepseek-harness && pnpm install && pnpm run build && pnpm dsh web

2. サインインするか API キーを追加する

   初回起動時に、ブラウザで DeepSeek アカウントにサインインするか、Settings → Models（設定 → モデル）で platform.deepseek.com の API キーを貼り付けます。キーは ~/.dsh/.credentials.yaml（$DSH_HOME）に保存されます。

3. プロジェクトの指示を渡す

   DeepSeek Harness は、プロジェクト内の AGENTS.md または CLAUDE.md（と .local.md の派生ファイル）、そしてグローバルな ~/.dsh/AGENTS.md を読み込みます。Claude Code や Codex 向けに書いた既存の指示はそのまま使えます。CLAUDE.md ガイドと Codex AGENTS.md ガイドも参考にしてください。

4. どこまで任せるかを決める

   サンドボックスモード（read-only、workspace-write、danger-full-access）と承認ポリシー（ask または never）を選びます。DeepSeek の安全面の注意書きによると、このハーネスは実験的で、セキュリティ監査を受けておらず、サンドボックスも隔離を保証しません。大事なコードではまず read-only から始めましょう。

5. ヘッドレスでタスクを実行し、プラグインを追加する

   スクリプトから単発のタスクを実行するには dsh headless、セッションを続けるには --resume か --session-id、スケジュールタスク、サブエージェント、エージェントチームなどのプラグインを追加するには dsh plugin を使います。

   # UI なしで1つのタスクを、権限モードを指定して実行
   dsh headless "Add tests for src/auth" --permission-mode workspace-write
   
   # イベントを JSON でストリーミング（スクリプト用など）
   dsh headless "Summarize open TODOs" --json
   
   # プロファイルにプラグインを追加
   dsh plugin --profile default add <package>

出典：DeepSeek Harness のリポジトリとドキュメント

DeepSeek Harness の料金：動かすのにかかる費用

ハーネス自体は無料のオープンソースです。利用料は DeepSeek API が以下の料金で請求します。単位は100万トークンあたりの米ドルです（api-docs.deepseek.com、2026年11月6日）。オフピーク料金はピーク料金の半額で、ピーク時間帯は平日の UTC 01:00–04:00 と 06:00–10:00（中国の祝日を除く）です。DeepSeek は無料枠を公開していないため、「無料で使う」とは実質的に、無料のソフトウェアと手持ちの API クレジットで使うことを意味します。

主な機能

• すべてがプラグイン：ツール、モデル、インターフェース、振る舞いはすべてプラグインです。プロファイルごとにインストールでき、チャットで頼んで作ってもらうこともできます（「Creator mode」）。コミュニティのプラグインには GitHub トピック dsh-plugin が付いています。
• DeepSeek が挙げる公式・実験的プラグインには、エージェントチーム、自動承認レビュー、スケジュールタスク、音声入力、ターミナル、エージェントループ、サブエージェントがあります。
• Skills（SKILL.md フォルダ）、MCP サーバー、hooks。既存の Claude Code hooks を動かす実験的なブリッジもあります。
• サブエージェントはプロセス内で動かすほか、ACP、Codex、Claude Code、別の Harness をバックエンドにすることもできます。
• 再開できるセッション、コンパクション、JSON イベントを出力するヘッドレスモード、その上に構築するための SDK。
• Super-agent：別の MIT バンドル dsh-superagent を使うと、ハーネスが GitHub リポジトリ上で自律的に動きます。DeepSeek は研究用プロトタイプと位置づけています。DeepSeek Super-Agent の解説をご覧ください。
• よく一緒に紹介される論文「A Programming Paradigm for Spatiotemporal Composability」（arXiv、2026年8月）は、ハーネスそのものではなく、土台となる Cordis フレームワークについての論文です。

DeepSeek Harness vs Claude Code vs Codex vs OpenCode

DeepSeek は比較を公開していません。これは2026年11月6日時点の各ツールのドキュメントをもとにした私たちの整理です。DeepSeek は Claude Code、Codex、OpenCode の中で自社モデルを使う方法も案内しているので、組み合わせて使うこともできます。

よく検索される疑問

• Linux：Linux 向けのデスクトップ版はまだありません。Linux では npx @deepseek-ai/dsh web で Web UI を起動するか、ソースからビルドします。
• VS Code：DeepSeek は VS Code 拡張機能を提供していません。エディタと並べてデスクトップ版か Web UI を使うか、DeepSeek が手順を公開している Claude Code や Codex などのエディタ向けエージェントで DeepSeek のモデルを使います。
• Ollama とローカルモデル：ドキュメントはありません。ハーネスはセルフホストのサーバー向けに OpenAI／Anthropic 互換のカスタムエンドポイントを受け付けており、これが自前のモデルを使う公式の方法です。
• TUI：ターミナル UI は標準では付属しません。カスタムプロファイルか、実験的なターミナルプラグインが公式に案内されている選択肢です。
• 論文：上記の Cordis の論文を参照してください。DeepSeek は、ハーネス自体を引用する場合は「DeepSeek Harness: Everything is a Plugin」とするよう求めています。

DeepSeek Harness に、タスクではなく仕事を任せよう

Crewmark は Claude Code、Codex、OpenCode に加えて DeepSeek Harness にも対応しています。セッションを職種・目標・勤務時間を持つ AI 社員に変え、ハートビートで起こして共有ボードから次の issue を取らせます。

1. エージェントに DeepSeek Harness を選ぶ

   プロジェクトでセットアップコマンドを実行します。社員はあなたのマシン上の DeepSeek Harness セッションで動き、費用はあなたの DeepSeek API アカウントに請求されます。

2. 職種と目標を与える

   ソフトウェアエンジニア、SEO スペシャリスト、グロースマーケター。それぞれに動かすべき数字があります。AI 社員とはをご覧ください。

3. ハートビートで仕事を始めさせる

   勤務時間中は15分、30分、60分ごとに起きて次の issue を取り、判断が必要なときはメッセージを送ってきます。他のアプローチとの比較はスーパーエージェントとはで。

DeepSeek Harness のよくある質問