DeepSeek Harnessとは？MITライセンスのオープンソースAIエージェント基盤｜4つのモード・使い方・Claude Codeとの違い【2026年8月最新】

DeepSeek Harness（コマンド名 dsh）は、中国のDeepSeekが2026年8月13日にMITライセンスで公開した、オープンソースのAIエージェント実行基盤です。ソフトウェア自体は無料で、モデル・ツール・サンドボックス・UIまですべてを差し替えられる「すべてがプラグイン」という設計を採り、実際にかかる費用は接続するモデルAPIの従量課金だけです。

ただし現時点では v0.1 Developer Preview（開発者向けプレビュー） であり、公式READMEに「互換性を壊す変更が入る」と明記されています。本番システムへの組み込みは時期尚早で、当面は検証環境での評価が現実的な使い方になります。

この記事では、公式リポジトリ・公式ドキュメント・公式料金ページなどの一次情報をもとに、DeepSeek HarnessとClaude Codeの立ち位置の違い、4つの動作モードの使い分け、実際にかかるコスト、インストール手順と動作要件、公式が認めているサンドボックスの限界、そして今すぐ使うべき人と手を出さない方がよい人までを整理します。対象読者は、AIコーディングエージェントを自社環境で動かしたい開発者・技術選定担当者、そして「Claude Codeのオープンソース代替はあるのか」を調べている方です。

DeepSeek Harnessとは何か

出典: GitHub - deepseek-ai/deepseek-harness

DeepSeek Harnessは、AIモデルに「手足」を与えて実際の作業をさせるための土台（ハーネス）を、まるごとオープンソース化したプロジェクトです。ファイル編集・シェル実行・Web検索・サブエージェント・セッション管理といった、エージェントが動くために必要な仕組みを一式そろえたうえで、そのすべてをプラグインとして交換可能にしています。

公式サイトが掲げるコンセプトは「Agent = Model + Harness」。モデルが知性を担い、ハーネスが「環境を理解し、ツールを使い、現実の環境で作業を続ける仕組み」を担うという整理です。つまりDeepSeek Harnessは、モデルそのものではなく、モデルを実務で動かすためのインフラ層にあたります。

基本情報（2026年8月16日時点）

公開からわずか3日で10万スターを超えており、注目度の高さは数字にも表れています。プロジェクトの責任者は、2026年3月にJane StreetからDeepSeekへ参画したCui Tianyi氏とされ、harnessチームの組成が公表されたのが2026年5月ですから、約3〜5カ月でDeveloper Preview到達という異例の速度で開発されたことになります（この経緯はメディア報道ベースの情報で、公式な発表としては確認できていません）。

「Claude Cowork対抗」ではなく「Claude Code対抗」

検索では「Claude Cowork対抗」という表現も見かけますが、一次情報および主要メディア（VentureBeat、The New Stack、Crypto Briefing）はいずれも「Claude Codeの対抗」と位置づけています。Claude Coworkは非エンジニア向けのデスクトップ型エージェント機能であり、開発者向けのコーディングエージェント基盤であるDeepSeek Harnessとは対象ユーザーも用途も異なります。

両者の違いを整理しておきたい方は、Claude CoworkとはとClaude Codeとはをあわせて確認すると、この記事で扱う領域がはっきりします。

「すべてがプラグイン」というアーキテクチャ

出典: DeepSeek Harness 公式サイト

DeepSeek Harnessの最大の特徴は、モデル・ツール・スキル・セッション・サンドボックス・ストレージ・実行ループ・スケジューリング・UIのすべてがプラグインとして実装されている点です。エージェントは「モジュールのツリー」として構成され、必要なものだけをマウントし、不要なものは外せます。

この土台になっているのが Cordis というプラグインカーネルです。プラグインのマウント／アンマウント／依存関係の解決を担い、実行中の構成をツリーとして管理します。設計思想は論文『A Programming Paradigm for Spatiotemporal Composability』に基づくとされています。

実務的に重要なのは、モデル層もプラグインであるという点です。DeepSeek製ではありますが、DeepSeek専用のツールではありません。公式にAnthropic・OpenAIなどのプロバイダをカタログから追加でき、Bedrock・Vertex・Azure・Codexといったネイティブ認証を要する経路や、OpenAI互換の社内ゲートウェイも設定できます。

「DeepSeekが作ったから、DeepSeekのモデルにロックインされる」わけではない——ここがオープンソースで公開した意味であり、企業導入を検討する際の判断ポイントになります。

AIエージェントの実装基盤全体を見渡したい場合は、AIエージェントフレームワークおすすめで他の選択肢と並べて確認すると位置づけが掴みやすくなります。

4つの動作モードと使い分け

DeepSeek Harnessには、公式に4つの動作モード（プリセット）が用意されています。普段使いはStandard、開発者が触るならCreator、ベンチマークや検証はMinimalという整理が基本です。

どのモードを選ぶべきか

特筆すべきはMinimalモードです。複数メディアの報道によれば、DeepSeekがV4-Proの公開ベンチマークを取る際に使った構成そのものとされています。ベンダーが自社モデルの評価に使った実行環境を公開したという点で、計測手法が第三者から検証可能になった意味は小さくありません。ただし、Harness自体のベンチマークスコアは公式に公開されておらず、第三者による検証結果も現時点では確認できません。数値を扱う際はベンダー申告値である前提で読む必要があります。

接続するモデル側の実力については、DeepSeek V4-Proとはで別途整理しています。

DeepSeek Harnessでできること

出典: DeepSeek Harness 公式サイト

標準構成の時点で、商用のコーディングエージェントに期待する機能はひととおり揃っています。同梱プラグインを機能別に整理すると、実装範囲の広さがわかります。

セッションは追記専用のイベントログとして永続化され、再開（resume）・分岐（fork）・検索・リプレイができます。「エージェントが何をどの順番でやったか」を後から追える設計になっているため、監査や不具合調査との相性は良い部類です。ただし、どこまで記録されるかはプラグイン構成に依存します。

料金：本体は無料、かかるのはモデルAPI代だけ

DeepSeek HarnessはMITライセンスのOSSで、ソフトウェア自体に有料プランは存在しません。公式サイトにも料金の記載はなく、有料版・エンタープライズ版の提供予定も現時点では公表されていません。

実際にかかるコストは次の2つだけです。

1. 接続するモデルAPIの従量課金（DeepSeek APIを使うならDeepSeekへ、Anthropicを使うならAnthropicへ支払う）
2. 動かすマシンのコスト（ローカルPCなら実質ゼロ。サーバー常駐させるならそのインスタンス代）

DeepSeek API の料金（2026年8月16日時点）

両モデルとも、thinking mode・コンテキストキャッシュ・tool call・JSON出力に対応し、コンテキスト長は1Mトークン、最大出力は384Kトークンと公式ドキュメントに記載されています。

2026年8月16日16:00 UTCから時間帯別料金へ

公式ドキュメントによると、2026年8月16日16:00 UTC（日本時間8月17日1:00）を境に、ピーク／オフピークの時間帯別料金へ移行します。ピーク時間帯は 01:00〜04:00 UTC および 06:00〜10:00 UTC で、それ以外はオフピーク。オフピークはピークの半額という構成です。

改定後はオフピークでも移行前の水準より単価が上がるため、「安いから」という理由だけでDeepSeek APIを前提に設計するのは避けた方が無難です。ピーク時間帯は日本時間の午前10時〜13時と午後3時〜19時に相当するため、日本の業務時間はほぼピークに重なる点にも注意が必要です。なお料金は改定直後で変動しやすい局面のため、実際の見積もりは公式の料金ページで最新値を確認してください。料金改定の背景と影響はDeepSeek APIの料金改定で詳しく扱っています。

Harnessはモデルを差し替えられるため、「基盤は無料のまま、モデルだけコスト効率の良いものへ乗り換える」という運用ができます。Claude Codeのように月額サブスクリプションで使う場合との比較は、Claude Codeの料金と見比べると判断しやすくなります。

使い方：インストールから初回起動まで

出典: DeepSeek Harness 公式サイト

最短で試すなら npx @deepseek-ai/dsh web の1コマンドです。既定で http://127.0.0.1:3080 にWeb UIが立ち上がります。

動作要件

手順

# 方法1: npmから（ビルド不要・最短）
npx @deepseek-ai/dsh web
# → http://127.0.0.1:3080 でWeb UIが起動

# 方法2: ソースから
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build      # ← ここを飛ばすと動かない
pnpm dsh web

ソースから入れる場合、pnpm run build を実行しないと起動しません。SNSで拡散された手順にはこの行が抜けているものが少なくないため、「手順どおりにやったのに動かない」の多くはここが原因です。

CLIの主なコマンド

起動したディレクトリが既定のワークスペースルートになります。web と headless のプロファイルは初回利用時に自動で初期化されます。プロファイルは package.json（dsh.profile.bundles に順序付きのバンドル一覧）と cordis.patch.yml（ユーザー側のパッチ層）で構成され、@deepseek-ai/dsh-base / dsh-web-app / dsh-headless が同梱バンドルです。

モデルの設定でつまずきやすい点

• Web UIの Settings → Models でDeepSeekのAPIキーを入力して保存すれば、サーバー再起動なしで反映されます。
• Add provider でAnthropicやOpenAIなどカタログ搭載プロバイダを追加できます。
• Bedrock / Vertex / Azure / Codex はネイティブ認証が必要です（AWS認証情報＋リージョン、ADCプロジェクト、api-version、OAuth）。APIキー欄だけ埋めても設定は完了しません。
• Add a custom provider で社内ゲートウェイやセルフホストサーバーを追加できます。Fetch available models はOpenAI互換の GET /models を叩く実装です。
• Provider IDは変更できません。セッションや既定モデル、認証情報がこのIDを参照するためで、改名したい場合は「新規追加＋旧削除」になります。
• 画像入力は既定でオフです。手入力したモデルで画像を使うには $DSH_HOME/settings.yaml に input: [text, image] を明記する必要があります。なお、DeepSeek自身のチャット補完ルートはテキスト専用で、設定変更では画像対応にできません。
• Web UIは ワークスペースを選択するまで入力欄が使えません。Choose workspace で作業ディレクトリを追加してください。

Claude Code・OpenClaw・Codexとの違い

DeepSeek Harnessは「製品の置き換え」ではなく「インフラ層の代替」という理解が正確です。v0.1時点で「Claude Codeより良いコードを書く」という証拠はなく、価値は制御可能性とオープンさにあります。

選び分けの基準

• すぐに安定して開発を回したい → Claude Code。提供面の広さと運用実績で優位。詳細はClaude Codeとは。
• モデルと実行環境を自社で握りたい／将来のロックインを避けたい → DeepSeek Harness。ただし現時点では検証用途に限定するのが妥当。
• チャットツールから雑多な作業を任せたい → OpenClawなどの汎用エージェント。位置づけはOpenClawとはやOpenClawとOpenCodeの比較を参照。
• OpenAIモデル中心の開発フローに乗っている → Codexを軸に、必要に応じてHarnessから子エージェントとして呼ぶ構成も取れる。

Claude Codeの資産をそのまま活かせる互換機能

見落とされがちですが、DeepSeek HarnessにはClaude CodeやCodexと「共存」するための仕組みが最初から入っています。「乗り換えるか、留まるか」の二択ではありません。

• hooks-claude-code — Claude Codeの hooks.json や settings の hooks キーの対応サブセットを、そのまま実行できる互換ブリッジです。${CLAUDE_PLUGIN_ROOT} / ${CLAUDE_PROJECT_DIR} の変数置換にも対応しています。すでにhooksで整備した社内ルールがあるなら、書き直さずに持ち込める可能性があります（hooks自体の考え方はClaude Codeのhooksを参照）。
• subagent-claude-code — 公式のClaude Agent SDKを通じて claude CLIを子エージェントとして呼び出すプラグインです。ただしClaude Agent SDKと claude 実行ファイルが別途必要で、Anthropic側の課金も別途発生する構成になります（前提条件の公式な明示は確認できていないため、導入前に検証してください）。
• subagent-codex / hooks-codex — Codex側の資産に対しても同様の橋渡しがあります。
• mcp-client — 外部のMCPサーバのツールをそのままエージェントのツールとして登録できます。自動再接続にも対応済みで、メモリ系MCPを使うサンプル構成が examples/mcp-memory/ に同梱されています。既存のMCP資産をそのまま流用できるという意味では、Claude CodeのMCP連携で構築した環境と地続きです。

つまりDeepSeek Harnessは、「Claude Codeを捨てる話」ではなく「モデルと実行基盤の主導権を自分側に持つ話」と捉えるのが実態に近いと言えます。

セキュリティと運用上の注意点

DeepSeek Harnessはシェル実行とファイル操作をする以上、設定を誤ればホスト全体に影響が及びます。公式ドキュメントはこの点をかなり率直に書いており、そこを読まずに導入するのは危険です。

サンドボックスの3モード

公式の SandboxMode はファイルへの影響のみを規定します。ネットワークとプロセス可視性はこの語彙の対象外である点に注意してください。

バックエンドはOSごとに異なり、Linuxはbwrap／Landlock、macOSはSeatbelt、Windowsはアクセストークンの制限（ACL）という実装です。

「partial」を「full」と同一視しない

公式ドキュメントは、隔離の適用度を full / partial として事実として報告する設計を採っています。そして現状、古いLandlock ABIとWindowsのACLランナー（Everyone／ハードリンク境界）は partial と明記されています。絶対的な境界が必要な用途で partial を full と同じものとして扱ってはならない、と公式が釘を刺している点は重要です。Windowsでの常用は、現時点では慎重に判断すべきと言えます。

なお、使えるバックエンドが1つもない場合は SANDBOX_UNAVAILABLE エラーでフェイルクローズします。「黙って隔離なしで実行する」ことは仕様上禁止されており、この設計自体は信頼できます。

権限プリセット

権限は「サンドボックスモード」と「承認ポリシー」の2つのつまみを束ねた名前付きプリセットとして提供され、UIのPermissionsセレクタから切り替えます。既定のプリセットは次の2つです。

danger-full-access は隔離の解除と承認プロンプトの無効化がセットになっています。「とりあえず全部許可して動かす」は、実質的にホスト上で無確認のシェル実行を許すことと同義です。検証用の使い捨て環境以外では選ばないのが無難です。どちらのつまみにも一致しない状態は custom として表示されるだけで、切替先には選べません。

そのほか押さえておくべき論点

1. 認証情報の保存場所 — APIキーなどは $DSH_HOME/.credentials.yaml に保存されます。UIからは書き込み専用で、保存後は伏字のディスクリプタしか返りません。設定ファイル側は参照だけを保持する設計ですが、ホストOS自体のアクセス制御が前提である点は変わりません。
2. プラグインのサプライチェーンリスク — MITライセンスかつ全レイヤ差し替え可能ということは、サードパーティ製プラグイン（GitHubの dsh-plugin トピックで配布）がツールもモデルもサンドボックスまで置き換えられることを意味します。悪意あるプラグインは隔離そのものを無効化しうるため、導入するプラグインの出所は必ず確認してください。
3. データの送信先は接続先モデル次第 — ソフトウェア自体はローカル実行のOSSですが、既定構成ではDeepSeek APIに接続します。業務データがどこへ送られるかは接続するプロバイダによって決まります。金融・医療・自治体など規制の厳しい領域では、プロバイダをAnthropic／OpenAI／社内ゲートウェイに切り替える、あるいは組織のAIツール利用ポリシーを事前確認する必要があります。プラグイン設計の実利がここに効いてきます。
4. ログの範囲は構成依存 — セッションはJSONLまたはSQLiteに永続化され、監査証跡として使えます。ただし、何がどこまで記録されるかはプラグイン構成に依存します。
5. インシデント記録が公開されている — 公式は docs/postmortem/ に不具合の事後検証を公開しています（0002-js-expression-disabled-filesystem-tools、0004-landlock-partial-notice-misclassified-child-failures など）。透明性としては評価できますが、裏返せばプレビュー品質であることの証拠でもあります。

エージェントにシェル権限を渡す際の一般的な考え方は、AIエージェントのセキュリティやClaude Codeのセキュリティ対策で整理しています。

現時点での弱み・制約

公開されている制約を押さえておくと、期待値を外さずに評価できます。

• 本番運用向けではない。 READMEに「currently in developer preview and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.」と明記されています。互換性を壊す変更が来る前提の段階です。
• GitHub ReleasesもGitタグも存在しない。 2026年8月16日時点でどちらも0件で、バージョンは 0.1.0-rc.x のリリース候補段階です。「どの版で固定するか」を決めにくい状態にあります。
• ホスティングサービスがない。 自前でNode.jsプロセスを動かす前提で、SaaS版の提供予定は公表されていません。
• GitHub連携ワークフローが未提供。 Claude CodeのGitHub Actions統合に相当する公式機能はありません。PRレビュー自動化などは自作が必要です。
• 提供面が狭い。 Claude Codeがターミナル／IDE／デスクトップ／モバイル／Slackと多面展開しているのに対し、こちらはWeb UI・ヘッドレスCLI・Python SDKが中心です。
• DeepSeekのチャット補完ルートはテキスト専用。 画像入力を使うにはカスタムプロバイダ側で対応モデルを指定する必要があります。
• ドキュメントは英語と中国語の2言語構成。 日本語の公式ドキュメントは現時点で確認できていません。
• 第三者によるベンチマーク検証がない。 Minimalモードで手順は再現可能になりましたが、数値そのものはベンダー申告値です。
• Windowsでのサンドボックス適用は partial。 実運用での安定度に関する報告も、現時点では十分に蓄積されていません。

こんな人におすすめ

おすすめしない人

よくある質問

Q. 商用プロダクトに組み込んでも大丈夫ですか。

ライセンス上はMITなので、商用製品への組み込みや再配布まで許容されます。メディアが「MITは戦略的に重い選択」と評しているのはこの点です。ただしライセンスと実用性は別問題で、v0.1で互換性を壊す変更が予告されている以上、製品組み込みは版が安定してからが現実的です。

Q. DeepSeekのモデルを使わずに済みますか。

使えます。モデル層はプラグインで、Web UIのSettings→ModelsからAnthropicやOpenAIを追加でき、OpenAI互換の社内ゲートウェイも登録できます。ただしBedrock・Vertex・Azure・Codexはネイティブ認証が必要で、APIキー入力だけでは完了しません。

Q. 完全にオフラインで動きますか。

ソフトウェア自体はローカルで動きますが、モデル推論には接続先が必要です。ローカルLLMをOpenAI互換サーバーとして立て、カスタムプロバイダとして登録すれば外部通信を避ける構成は理論上取れますが、公式にオフライン運用の推奨構成が示されているわけではありません。

Q. Claude Codeから完全に乗り換えるべきですか。

現時点では推奨しません。v0.1でClaude Codeより良い出力が得られるという証拠はなく、提供面の広さや運用実績でも差があります。検証環境で並行して触り、モデル選択の自由度が自社にとってどれだけ価値があるかを測るのが現実的な進め方です。

Q. npx で試した後、何から触ればいいですか。

まずWeb UIで Choose workspace から作業ディレクトリを指定し、Settings→ModelsでAPIキーを登録します。次に権限プリセットを workspace-write（承認あり）のままにして、小さなリポジトリで挙動と実行軌跡ビューを確認するのが安全な入り方です。

Q. スター数が急増していますが、それだけで信頼できますか。

スター数は注目度の指標であって品質保証ではありません。公開3日で10万超は異例ですが、ReleasesもGitタグもまだ存在しない段階です。注目度と成熟度は分けて評価してください。

まとめ

DeepSeek Harnessは、「モデルは自由に選べて、実行基盤は自分で握れる」というAIエージェントの土台を、MITライセンスで開放したプロジェクトです。Claude Codeを機能面で上回るという話ではなく、これまでベンダーのクローズドな領域だった「ハーネス」を検査可能・交換可能にした点に価値があります。

• 本体は無料。かかるのは接続するモデルAPIの従量課金と、動かす環境のコストだけ
• Standard / Code / Minimal / Creator の4モードで、常用から評価・拡張開発までカバー
• Claude Codeのhooks互換、Claude Code・Codexのサブエージェント呼び出し、MCPクライアントを標準搭載
• サンドボックスは公式が partial の存在を明示。Windowsと旧Landlock ABIは要注意
• v0.1 Developer Preview。互換性を壊す変更が予告されており、本番投入は時期尚早

現時点での正しい向き合い方は、「検証環境で触りながら、将来の選択肢として押さえておく」です。エージェント基盤の全体像から整理したい方はAIエージェントとはを、開発元であるDeepSeekそのものの背景を知りたい方はDeepSeekとはをあわせてご覧ください。