短期の試用なら、Mac上でNode.jsを用意し、公式のnpm起動方法を使うのが最短です。長時間の実行、遠隔アクセス、個人環境との分離が必要になった段階では、独立したクラウドMacへ移す判断が安全です。この記事では、インストール成功で終わらせず、モデル接続、作業領域、権限、再起動後の復旧までを時系列で確認します。
短期の試用なら、Mac上でNode.jsを用意し、公式のnpm起動方法を使うのが最短です。長時間の実行、遠隔アクセス、個人環境との分離が必要になった段階では、独立したクラウドMacへ移す判断が安全です。この記事では、インストール成功で終わらせず、モデル接続、作業領域、権限、再起動後の復旧までを時系列で確認します。
DeepSeek Harness Mac導入は、短期の試用なら手元のMacで進め、長時間の実行や遠隔利用、権限分離が必要なら独立したクラウドMacへ移すのが最短です。DeepSeek Harnessは主に外部モデルAPIを呼び出すため、GPU性能だけでなく、Node.jsの互換性、同時タスク数、保存領域、再起動後の復旧を基準に選びます。
初回導入、Agentにコード操作をさせたい開発者、個人用Macとチーム用の実行環境を分けたい責任者が対象です。画面が表示された時点を「成功」とせず、モデル接続、作業領域、承認操作、遠隔再接続まで確認します。
最終更新：2026年8月18日。公式リポジトリ、公式ユーザーガイド、開発ガイド、Node.js公式情報、Apple公式サポートを照合しています。
DeepSeek Harnessは、公式資料上では開発者プレビューとして提供されています。今後、互換性を壊す変更が入る可能性が明記されているため、本番リポジトリへいきなり接続する運用は避けます。(公式リポジトリ)
導入前に、次の成功条件を紙またはチケットに残します。
| 判断項目 | 手元のMac | 独立したクラウドMac |
|---|---|---|
| 主な用途 | 数時間の試用、プラグイン確認 | 長時間Agent、遠隔作業、チーム交付 |
| 起動のしやすさ | 最も簡単 | 初期のアカウント・SSH設定が必要 |
| スリープの影響 | 大きい | 常時稼働設計にしやすい |
| 個人ファイルとの分離 | 意識的な設定が必要 | 専用ユーザーと専用領域を作りやすい |
| 復旧確認 | 手動になりやすい | 起動スクリプトと監視を組み込みやすい |
| 推奨判断 | まずはこちら | 継続運用の条件を満たしたら移行 |
公式資料では、DeepSeek Harness用Macの最低メモリ容量やGPU性能は提示されていません。したがって、特定のMacモデルを一律に推奨するより、Node.jsプロセス、リポジトリのビルド、ログ保存、同時実行数を実際のタスクで確認する方が合理的です。
DeepSeek Harnessの開発ガイドでは、Node.js 22.19以上と24以上が対象で、CIでは22.19、24、26が確認対象です。また、リポジトリ開発にはpnpm 11.7.0、Git 2.26以上が示されています。通常の試用ではソース構築を行わないため、まずは公式npm起動を使い、開発用の依存関係を増やさない方が安全です。(公式開発ガイド)
| 用途 | 準備するもの | 判断結果 |
|---|---|---|
| Web UIの動作確認 | Node.jsの対応系統、DeepSeek APIキー、検証用作業領域 | 手元のMacで開始 |
| プラグイン開発 | Git、pnpm、ソースコード、ビルド時間を測れる環境 | ソース構築を選択 |
| 長時間Agent | 独立ユーザー、限定領域、ログ、再起動手順 | クラウドMacを優先 |
| チーム交付 | SSH管理、権限監査、設定の再現手順 | 個人Macから分離 |
ターミナルで次を実行し、Node.jsとnpmが利用できるかを確認します。
node --version
npm --version
バージョンが古い、または管理元が不明な場合は、Node.js公式のサポート対象リリースを利用します。EOLになったNode.jsはセキュリティ更新を受けられず、依存パッケージとの不整合も起きやすいため、長期運用の土台には向きません。(Node.js公式ダウンロードページ)
通常の試用では、次のコマンドだけを使います。
npx @deepseek-ai/dsh web
公式リポジトリでは、このコマンドがWeb UIを起動し、標準ではhttp://127.0.0.1:3080で提供されると説明されています。起動後にターミナルへ表示されたURLを開き、画面が表示されることを確認します。
成功信号は、Web UIが表示され、ターミナルのプロセスが終了していないことです。画面が開かない場合は、Node.jsのバージョン、ネットワーク接続、npmパッケージの取得状態を順番に確認し、ソース構築へ進む前に再実行します。
プラグイン開発やフレームワークの修正が必要な場合だけ、公式のソース手順を使います。
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
開発ガイドでは、依存関係の導入後にpnpm run typecheckを実行し、正常終了をセットアップ完了の目安にしています。一般的な試用でこの経路を選ぶと、ビルドや依存関係の問題が増えるため、npm起動と混在させないでください。
Web UIのSettingsからModelsを開き、DeepSeek APIキーを入力して保存します。公式ユーザーガイドでは、保存後はサーバーを再起動せずにモデル経路を利用できるとされています。(公式ユーザーガイド)
APIキーはリポジトリへ書き込まず、共有チャットやスクリーンショットにも残しません。ソース開発を行う場合も、環境変数またはGit管理対象外の.envを使います。実際のキーをコミットしないことが重要です。
次にChoose workspaceを開き、Agentに操作させるプロジェクトディレクトリを追加して選択します。公式ガイドでは、新しいWeb UIには選択済みの作業領域がなく、作業領域を指定するまでセッション入力欄を利用できない構成です。
初回は、次のような検証用ディレクトリを使います。
~/dsh-sandbox/
├── README.md
└── sample.txt
個人のホームディレクトリ全体、本番リポジトリ、クラウド認証情報を含むディレクトリは指定しません。作業領域を広く取りすぎると、Agentが意図しないファイルを読み取る範囲も広がります。
最初のタスクは、次のような読み取り中心の依頼にします。
この作業領域のファイル一覧を確認し、各ファイルの役割を要約してください。
ファイル変更とコマンド実行は行わないでください。
応答が確認できたら、読み取り、限定的な編集、コマンド実行の順に一つずつ試します。公式ガイドでは、Agentがファイルの読み取り・編集、コマンド実行などを行い、現在の権限ポリシーで承認が必要な操作には確認画面が出ると説明されています。
評価は「返答が自然か」だけでなく、次の4項目で行います。
| 確認項目 | 合格条件 | 不合格時の回退 |
|---|---|---|
| ファイル読み取り | 指定領域内だけを参照する | 作業領域をさらに狭める |
| 編集 | 変更内容を確認してから適用できる | 読み取り専用へ戻す |
| コマンド | 承認を求め、実行履歴を追える | コマンド実行を停止する |
| API接続 | エラー時に秘密情報を表示しない | APIキーを再発行する |
手元のMacで検証が終わり、数時間以上のAgent実行や遠隔操作が必要になったら、同じ環境をそのまま公開するのではなく、独立したMacとして組み直します。
Appleの公式手順では、System SettingsのGeneral、Sharing、Remote LoginからSSHまたはSFTPによる接続を有効化できます。接続ユーザーは「すべてのユーザー」ではなく、必要なアカウントだけに限定します。フルディスクアクセスも、必要性を確認してから付与します。(Apple公式のRemote Login手順)
最低限、次の境界を分けます。
Web UIを外部公開するだけでは、認証、通信経路、作業領域、コマンド承認の境界が十分に設計されません。まずSSHなどの管理経路を限定し、必要な場合だけ安全な中継やアクセス制御を追加します。個人Macのログイン画面を外部から操作できる状態にする設計は避けます。
クラウドMacを選ぶ場合は、先にMacクラウド環境の選び方を確認し、地域や利用時間よりも、常時接続、再起動手順、管理者権限の範囲を確認します。SSHとユーザー分離の設計は、遠隔Macの開発環境を安全に分離する方法とも組み合わせて考えます。
DeepSeek HarnessはmacOS上でNode.jsを使って起動できます。ただし、公式資料でMac向けの一律なGPU要件やメモリ最低値が確定しているわけではありません。実際の作業内容が軽いファイル操作なのか、ビルドや複数タスクを含むのかで必要な余裕は変わります。
遠隔運用へ移した後は、起動コマンドだけでなく、次の情報を記録します。
最初の運用日に、次の順番で復旧試験を行います。
互換性を壊す変更が予告されているため、更新前に現在の起動手順と設定を保存します。長期運用では、最新版へ即時更新するより、検証用環境で先に更新し、Web UI、モデル接続、作業領域、承認操作を再試験してから本番相当環境へ反映します。
個人の短い作業なら、モデル接続、作業領域、承認操作、基本的な再接続が確認できれば次へ進めます。一方、長時間Agent、複数人での利用、重要なリポジトリを扱う場合は、権限監査と復旧演習まで完了させます。
判定は次のように分けます。
手元のMacで動かす方法は導入が早い反面、スリープや再起動で処理が止まり、個人ファイルとの権限境界も曖昧になりやすく、チームへ同じ環境を渡す作業も手動になりがちです。DeepSeek Harnessを数日以上動かす、遠隔から確認する、検証用領域を分けるという条件が一つでも当てはまるなら、独立したMacをレンタルして実行環境を切り出す方が、復旧と権限管理を設計しやすくなります。
導入後に運用時間や遠隔アクセスの必要性が増えた場合は、VNCMacのMacクラウド環境で、必要な期間だけ検証用のMac環境を確保する方法も比較対象に入ります。継続的なAgent運用では、単に起動できることより、止まった後に戻せることを優先してください。