DeepSeek Harness: インストールと起動

Q: Docker で DSH を実行できますか？

はい。DSH は公式 Docker イメージを提供しています： docker run -p 3080:3080 -e DEEPSEEK_API_KEY=sk-xxx deepseek/dsh:latest 。

Q: DSH を最新版に更新するには？

npx 方式は自動的に最新版を取得します。グローバルインストールの場合は npm update -g @deepseek-ai/dsh 。ソースインストールの場合は git pull && pnpm install 。

Q: Windows ネイティブ環境での既知の問題は？

パス区切り文字の問題（ \ 対 / ）により、一部のツールが正常に動作しない場合があります。最高の体験のためには WSL2 での DSH 実行をお勧めします。

Q: DSH の詳細な起動ログを確認するには？

起動前に環境変数 DSH_LOG_LEVEL=debug を設定すると、完全な初期化プロセスとプラグイン読み込み情報を確認できます。

Q: pnpm install が失敗する場合は？

Node.js バージョン >= 18 を確認した上で、 pnpm store prune && pnpm install --force を試してください。ネットワーク問題の場合は、npm ミラーを設定： pnpm config set registry https://registry.npmmirror.com 。

最終更新：2026-08-31

DeepSeek Harness のインストールは非常にシンプル——1つのコマンドで始められ、複雑な環境設定は不要です。npx でワンクリック体験する場合でも、ソースから実行して深くカスタマイズする場合でも、DSH は5分で起動できます。

💡 ヒント：初回使用時は npx @deepseek-ai/dsh web でのワンクリック起動をお勧めします。手動での依存関係インストールは不要です。ソースコードからのアプローチは、フレームワーク自体を変更する必要がある開発者向けです。

📋 前提知識：基本的なコマンドライン知識、01-intro.md の完了

1. 学習内容

Node.js 18+ 環境のセットアップ
npx での DSH Web UI ワンクリック起動
ソースからの DSH 実行（pnpm install + pnpm dsh web）
Web UI のアクセスとインターフェース概要
環境変数設定の詳細

設定読み込み順序

2. 環境セットアップ

(1) Node.js のインストール

DSH は Node.js ランタイムベースで、Node.js 18+ が最低要件です。

BASH

# Node.js バージョンの確認
node --version
# v18.x.x 以上

# npm バージョンの確認
npm --version
# 9.x.x 以上

Node.js がまだインストールされていない場合：

BASH

# macOS (Homebrew)
brew install node

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Windows (winget)
winget install OpenJS.NodeJS.LTS

Node.js 20 LTS の使用をお勧めします——現在の最も安定した長期サポートバージョンであり、DSH はこのバージョンで最も徹底的にテストされています。

(2) OS 互換性

オペレーティングシステム	サポート状況	備考
macOS 12+	✅ 完全サポート	Intel と Apple Silicon の両方
Ubuntu 20.04+	✅ 完全サポート	LTS バージョン推奨
Windows 10+	✅ サポート	WSL2 環境推奨
Windows (ネイティブ)	⚠️ 基本サポート	一部のツールでパス問題が発生する可能性あり

(3) ネットワーク要件

DSH は LLM API にアクセスする必要があります。ネットワーク環境を確認してください：

BASH

# DeepSeek API 接続テスト（API Key 必要）
curl -s https://api.deepseek.com/v1/models \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" | head -20

# OpenAI 互換エンドポイント接続テスト
curl -s https://api.openai.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY" | head -20

3. ワンクリック起動：npx 方式

(1) Web UI の起動

最もシンプルな方法——インストール不要、実行するだけ：

BASH

npx @deepseek-ai/dsh web

初回実行時、npx は最新版の DSH パッケージを自動ダウンロードします：

TEXT 📖 参照専用

Need to install the following packages:
@deepseek-ai/dsh@latest
Ok to proceed? (y) y

🚀 DeepSeek Harness v0.x.x (developer preview)
📦 Starting Web UI...

  ➜  Local:   http://127.0.0.1:3080/
  ➜  Network: http://192.168.1.100:3080/

⚠️  Developer Preview: APIs may change before stable release.

(2) Web UI へのアクセス

ブラウザで http://127.0.0.1:3080/ を開きます：

ja DSH Web UI ホームページ

TEXT 📖 参照専用

http://127.0.0.1:3080/
├── 左：セッション一覧
├── 中央：チャットエリア
├── 右：ツールパネル
└── 上部：モード選択 + モデル選択

(3) npx 方式の特徴

利点	欠点
インストール不要、即座に実行	毎回新しいバージョンをダウンロードする可能性
常に最新版を取得	バージョンを制御できない
ちょっと試すのに最適	カスタマイズが制限される

▶ サンプル 4：

BASH

# バージョン番号を指定
npx @deepseek-ai/dsh@0.5.0 web

# ベータ版を指定
npx @deepseek-ai/dsh@beta web

4. ソースからの実行

(1) リポジトリのクローン

フレームワークのコードを変更したり、開発に貢献したりする必要があるユーザー向け：

BASH

# リポジトリのクローン
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness

# 利用可能なブランチの確認
git branch -r
# origin/main
# origin/dev
# origin/feature/...

(2) 依存関係のインストール

DSH は pnpm をパッケージマネージャーとして使用します：

BASH

# pnpm のインストール（未インストールの場合）
npm install -g pnpm

# プロジェクトの依存関係をインストール
pnpm install

pnpm install はすべてのワークスペースの依存関係をインストールします：

TEXT 📖 参照専用

packages/
├── core/          # Cordis カーネル
├── cli/           # CLI ツール
├── web/           # Web UI
├── sdk-python/    # Python SDK
├── plugins/       # 内蔵プラグイン
└── tools/         # 内蔵ツール

▶ サンプル 3：

BASH

# Web UI の起動（開発モード、ホットリロード付き）
pnpm dsh web --dev

# CLI モードの起動
pnpm dsh cli

# Headless モードの起動
pnpm dsh headless

開発モードとプロダクションモードの違い：

次元	開発モード `--dev`	プロダクションモード
ホットリロード	✅ コード変更で自動更新	❌
ソースマップ	✅ 完全なデバッグ情報	❌
パフォーマンス	より遅い（未最適化）	より速い（コンパイル最適化済み）
ログレベル	debug	info

▶ サンプル 4：

BASH

# すべてのパッケージをビルド
pnpm build

# Web UI のみビルド
pnpm --filter @deepseek-ai/dsh-web build

# ビルド後に実行
pnpm dsh web

5. 環境変数の設定

DSH は API Key、モデルエンドポイントなどの設定を環境変数で管理します。

(1) コア環境変数

BASH

# DeepSeek API Key（DeepSeek モデル使用時に必須）
export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxx"

# OpenAI 互換エンドポイント（オプション、DeepSeek 以外のモデル使用時）
export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"
export OPENAI_BASE_URL="https://api.openai.com/v1"

# カスタムエンドポイント（オプション、サードパーティ互換 API 使用時）
export DSH_LLM_BASE_URL="https://your-custom-endpoint.com/v1"
export DSH_LLM_API_KEY="your-api-key"

(2) ランタイム設定

BASH

# Web UI ポート（デフォルト 3080）
export DSH_PORT=3080

# ログレベル（debug / info / warn / error）
export DSH_LOG_LEVEL=info

# ワークスペース（Agent 操作のルートディレクトリ）
export DSH_WORKSPACE="/path/to/your/project"

# サンドボックスモード（strict / permissive / off）
export DSH_SANDBOX=permissive

(3) .env ファイルの使用

プロジェクトルートに .env ファイルを作成して環境変数を管理することをお勧めします：

BASH

# .env ファイルの例
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
DSH_PORT=3080
DSH_LOG_LEVEL=info
DSH_WORKSPACE=/home/alice/my-project
DSH_SANDBOX=permissive

セキュリティ上の注意：.env ファイルには機密情報が含まれます。必ず .gitignore に追加してください：

BASH

# .env がコミットされないようにする
echo ".env" >> .gitignore

(4) 環境変数の優先順位

graph LR
    A[コマンドライン引数] -->|最高| RES[最終値]
    B[.env ファイル] --> RES
    C[システム環境変数] --> RES
    D[デフォルト値] -->|最低| RES

6. CLI モードの起動

Web UI に加えて、DSH は純粋な CLI インタラクションもサポートしています：

BASH

# CLI モードの起動
npx @deepseek-ai/dsh cli

# ワークスペースを指定
npx @deepseek-ai/dsh cli --workspace /path/to/project

# モデルを指定
npx @deepseek-ai/dsh cli --model deepseek-chat

# 動作モードを指定
npx @deepseek-ai/dsh cli --mode ptc

CLI モードのインタラクション画面：

TEXT 📖 参照専用

$ npx @deepseek-ai/dsh cli

🚀 DeepSeek Harness v0.x.x
📂 Workspace: /home/alice/my-project
🤖 Model: deepseek-chat
🔧 Mode: standard

> Help me analyze this project's directory structure
🔍 Using tool: search...
📂 Reading directory structure...

Agent: This project is a typical Express.js application. The directory structure is as follows:
...

7. インストールの確認

(1) DSH バージョンの確認

BASH

npx @deepseek-ai/dsh --version
# 0.x.x

(2) 環境設定の確認

BASH

npx @deepseek-ai/dsh doctor

dsh doctor が自動チェックする項目：

TEXT 📖 参照専用

✅ Node.js: v20.11.0
✅ pnpm: 8.15.0
✅ DEEPSEEK_API_KEY: configured (sk-...xxxx)
⚠️ OPENAI_API_KEY: not configured (optional)
✅ Network: api.deepseek.com reachable
✅ Workspace: /home/alice/my-project (exists)
⚠️ Sandbox: permissive mode (not recommended for production)

(3) クイック機能テスト

BASH

# Web UI を起動して curl で確認
npx @deepseek-ai/dsh web &
sleep 5
curl -s http://127.0.0.1:3080/api/health | head -5
# {"status":"ok","version":"0.x.x"}

8. よくあるインストール問題

(1) Node.js バージョンが低すぎる

TEXT 📖 参照専用

Error: DSH requires Node.js 18 or higher.
Current version: 16.x.x

解決策：

BASH

# nvm で複数の Node.js バージョンを管理
nvm install 20
nvm use 20

(2) ポートが既に使用中

TEXT 📖 参照専用

Error: Port 3080 is already in use.

解決策：

BASH

# 別のポートを指定
export DSH_PORT=3081
npx @deepseek-ai/dsh web

# またはポートを使用しているプロセスを見つける
lsof -i :3080    # macOS/Linux
netstat -ano | findstr :3080   # Windows

(3) API Key が無効

TEXT 📖 参照専用

Error: Invalid API key. Please check your DEEPSEEK_API_KEY.

解決策：環境変数が正しく設定されているか確認：

BASH

echo $DEEPSEEK_API_KEY
# sk-xxxxxxxxxxxxxxxx が出力されるはず

# 空の場合、再設定
export DEEPSEEK_API_KEY="sk-your-actual-key"

❓ よくある質問

Q npx は毎回ダウンロードしますか？

A 最初の npx 実行時に DSH パッケージをダウンロードしますが、以降の実行ではキャッシュを使用します。繰り返しダウンロードを避けたい場合は、グローバルインストール可能です：npm install -g @deepseek-ai/dsh、その後 dsh web で直接起動できます。

Q Docker で DSH を実行できますか？

A はい。DSH は公式 Docker イメージを提供しています：docker run -p 3080:3080 -e DEEPSEEK_API_KEY=sk-xxx deepseek/dsh:latest。

Q DSH を最新版に更新するには？

A npx 方式は自動的に最新版を取得します。グローバルインストールの場合は npm update -g @deepseek-ai/dsh。ソースインストールの場合は git pull && pnpm install。

Q Windows ネイティブ環境での既知の問題は？

A パス区切り文字の問題（\ 対 /）により、一部のツールが正常に動作しない場合があります。最高の体験のためには WSL2 での DSH 実行をお勧めします。

Q DSH の詳細な起動ログを確認するには？

A 起動前に環境変数 DSH_LOG_LEVEL=debug を設定すると、完全な初期化プロセスとプラグイン読み込み情報を確認できます。

Q pnpm install が失敗する場合は？

A Node.js バージョン >= 18 を確認した上で、pnpm store prune && pnpm install --force を試してください。ネットワーク問題の場合は、npm ミラーを設定：pnpm config set registry https://registry.npmmirror.com。

📖 まとめ

DSH は Node.js 18+ が最低要件；Node.js 20 LTS を推奨
npx @deepseek-ai/dsh web でワンクリック起動、http://127.0.0.1:3080 でアクセス
ソースコード実行：git clone + pnpm install + pnpm dsh web
環境変数は .env ファイルまたは export で設定；API Key の設定は必須
dsh doctor コマンドで環境設定を一括チェック
よくある問題：Node バージョン、ポート競合、API Key 設定

📝 練習問題

1. ⭐ 基礎：npx 方式で DSH Web UI を起動し、ホーム画面のインターフェース要素のスクリーンショット（または説明）を撮ってください。

2. ⭐⭐ 応用：DSH リポジトリをソースからクローンし、pnpm install を完了させて開発モードを起動してください。起動中に遭遇した問題とその解決方法を記録してください。

3. ⭐⭐⭐ チャレンジ：DSH を DeepSeek API と OpenAI 互換エンドポイント（例：Ollama）の両方に接続するよう設定してください。Web UI で2つのモデルを切り替え、それぞれでメッセージを送信して成功させること。

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

私たちについて