DeepSeek Harness

DeepSeek Harness（コマンド名 dsh）は、DeepSeek が公開するオープンソースのコーディング Agent Harness です。ワークスペース、ターミナル、ファイル編集、Skills、計画、Web UI を提供し、OpenAI Chat Completions 互換インターフェースで AIHubMix に接続できます。

このガイドは DeepSeek Harness 0.2.0-rc.2 に基づいています。このバージョンは 2026 年 10 月 18 日時点の最新版です。0.1.0-rc.6 から大きく変わっており、設定の場所と UI が更新されています。Harness は開発者プレビューのため、今後のリリースで項目や UI が変更される場合があります。

要点

設定する値は次の 4 つです。

設定	値
Provider ID	`aihubmix`
Base URL	`https://aihubmix.com/v1`
API protocol	`openai-completions`
API key environment variable	`AIHUBMIX_API_KEY`

DeepSeek Harness の Models ページで設定済みの AIHubMix

何が必要ですか？

有効な AIHubMix API Key
Node.js 22（22.19.0 以降）または Node.js 24 以降
npm Registry と https://aihubmix.com に接続できるネットワーク

node --version
npm --version

DeepSeek Harness をインストールする方法

ソースをクローンせず、公開済み npm パッケージをインストールします。

npm install -g @deepseek-ai/dsh
dsh --version

dsh: command not found と表示された場合は npm config get prefix を実行し、そのディレクトリの bin が PATH に含まれているか確認してください。

Web UI を起動する方法

ワークスペースとして使用するプロジェクトディレクトリで実行します。公式に推奨されている起動方法は npx です。

npx @deepseek-ai/dsh web --port 3080

グローバルにインストール済みの場合は、次のコマンドも使用できます。

dsh web --port 3080

http://127.0.0.1:3080 を開き、初回利用時にワークスペースを選択または追加します。

AIHubMix プロバイダーを設定する方法

Settings → Models → Add model provider を開き、カードを Custom model API に切り替えてから、次の内容を入力します。

項目	推奨値	説明
Provider ID	`aihubmix`	小文字の識別子。使用済みの場合は `aihubmix-gateway`
Display name	`AIHubMix`	モデルセレクターに表示する名前
Base URL	`https://aihubmix.com/v1`	`/v1` を含める
API protocol	`openai-completions`	OpenAI Chat Completions 互換プロトコル
API key	AIHubMix API Key	Harness が認証情報として保存し、平文は再表示しません

最終的なリクエスト先は https://aihubmix.com/v1/chat/completions です。

Base URL 欄に完全な /chat/completions パスを入力しないでください。

auto または他のモデルを追加する

Base URL と API Key を入力した後、Model catalog で Fetch available models を選択します。Harness は GET https://aihubmix.com/v1/models を呼び出し、利用可能なモデル ID を表示します。

DeepSeek Harness が取得した AIHubMix の利用可能モデル

最初の接続テストでは auto のみを追加し、表示名を Auto に設定できます。個別モデルを使う場合は取得した一覧から該当モデルを選択し、Add selected を選択します。UI のモデルセレクターには、現在の Provider カタログに登録済みのモデルだけが表示されます。

auto と個別モデルの比較

選択	使用する場面
`auto`	最初の接続テスト、または AIHubMix による自動モデル選択
個別モデル ID	固定したモデル能力、バージョン、再現可能な結果が必要な場合

どちらも同じ Provider、Base URL、API Key を使用します。モデルの切り替えに Provider の再作成は不要です。

環境変数で API Key を保存する

開発マシンや CI では、profile ファイルを通じて環境変数から Key を読み込むよう設定できます。Web UI は web profile、headless テストは headless profile を使用します。ファイルパスは次のとおりです。

$DSH_HOME/profiles/web/cordis.patch.yml
$DSH_HOME/profiles/headless/cordis.patch.yml

どちらのファイルにも次の内容を記述します。

- id: llm-pi-ai
  config:
    providers:
      aihubmix:
        apiKeyEnv: AIHUBMIX_API_KEY
        api: openai-completions
        baseURL: https://aihubmix.com/v1
        models:
          - id: auto
- id: agent-default-model
  config:
    provider: aihubmix
    model: auto

2 つのエントリは両方とも必要です。llm-pi-ai のみを記述し agent-default-model を記述しない場合、headless は既定の deepseek-official を使い続け、MISSING_CREDENTIAL が表示されます。

旧バージョンでは $HOME/.dsh/settings.yaml に設定を保存していましたが、0.2.0 ではこのファイルを使用しません。DSH 0.2.0 の初回起動時に、このファイルは profile 設定へ移行され、元のファイル名は settings.yaml.imported に変更されます。移行を行った実行では MISSING_CREDENTIAL が表示されることがあります。その場合は、もう一度実行してください。

export AIHUBMIX_API_KEY='sk-***'
dsh web --port 3080

起動環境からキーを取得した場合、設定画面には読み取り専用の案内が表示され、実際の値は表示されません。

環境変数を変更した後は Harness を再起動してください。

モデルを選択して会話を検証する

Settings を閉じ、入力欄の右下にあるモデルセレクターから Auto または追加済みの個別モデルを選択します。

Reply with exactly: AIHubMix connection successful

期待する応答を受信できれば、Harness、OpenAI Chat Completions 互換エンドポイント、AIHubMix の接続は正常です。

headless テストを実行する

Web UI を使わずにテストする場合は、次のコマンドを実行します。このコマンドは headless profile を使用するため、$DSH_HOME/profiles/headless/cordis.patch.yml に上記 2 つのエントリが記述されている必要があります。

export AIHUBMIX_API_KEY='sk-***'
dsh --profile headless \
  'Reply with exactly DSH_AIHUBMIX_OK and do not use tools.'

成功すると DSH_AIHUBMIX_OK が出力されます。

よくある質問

MISSING_CREDENTIAL が表示される理由は？

Harness が使用できる設定を読み込めていません。profile に 2 つのエントリが記述されていること、環境変数 AIHUBMIX_API_KEY が設定されていることを確認し、同じターミナルから Harness を起動してください。

test -n "$AIHUBMIX_API_KEY" && echo configured

モデル取得が 401 を返す理由は？

API Key が有効で、余分な空白や改行が含まれていないか確認してください。モデル取得リクエストは Bearer 認証を使用します。

モデルセレクターに Auto しか表示されない理由は？

セレクターは現在の Provider カタログに登録済みのモデルだけを表示します。Settings → Models → AIHubMix → Edit を開き、Model catalog で Fetch available models を選択して必要なモデルを選んだ後、Add selected を選択してください。

UNKNOWN_MODEL が表示される理由は？

現在の Provider カタログにそのモデル ID がありません。モデル ID は大文字と小文字を区別するため、モデル取得で返された値を使用してください。

接続がタイムアウトする理由は？

DNS、組織のネットワーク、ローカルプロキシを確認してください。DSH は HTTP_PROXY と HTTPS_PROXY の環境変数を自動的に読み取ります。特定のアドレスをプロキシ経由にしない場合は NO_PROXY を設定できます。ブラウザーのみがシステムプロキシを使用する場合は、dsh を起動するターミナルで HTTP_PROXY と HTTPS_PROXY を設定してください。

セキュリティ上の注意

API Key を Git、スクリーンショット、共有スクリプトに含めない
Harness の認証情報ストレージまたは AIHUBMIX_API_KEY を使用する
トラブルシューティング時に完全な API Key を出力しない
CI の Secret 管理機能で環境変数を設定する

最終更新日：2026-10-18

コーディングアシスタント

IDE 統合

エージェント / ワークフロー

SDK とフレームワーク

要点

何が必要ですか？

DeepSeek Harness をインストールする方法

Web UI を起動する方法

AIHubMix プロバイダーを設定する方法

auto または他のモデルを追加する

auto と個別モデルの比較

環境変数で API Key を保存する

モデルを選択して会話を検証する

headless テストを実行する

よくある質問

MISSING_CREDENTIAL が表示される理由は？

モデル取得が 401 を返す理由は？

モデルセレクターに Auto しか表示されない理由は？

UNKNOWN_MODEL が表示される理由は？

接続がタイムアウトする理由は？

セキュリティ上の注意

​要点

​何が必要ですか？

​DeepSeek Harness をインストールする方法

​Web UI を起動する方法

​AIHubMix プロバイダーを設定する方法

​auto または他のモデルを追加する

​auto と個別モデルの比較

​環境変数で API Key を保存する

​モデルを選択して会話を検証する

​headless テストを実行する

​よくある質問

​MISSING_CREDENTIAL が表示される理由は？

​モデル取得が 401 を返す理由は？

​モデルセレクターに Auto しか表示されない理由は？

​UNKNOWN_MODEL が表示される理由は？

​接続がタイムアウトする理由は？

​セキュリティ上の注意

要点

何が必要ですか？

DeepSeek Harness をインストールする方法

Web UI を起動する方法

AIHubMix プロバイダーを設定する方法

auto または他のモデルを追加する

auto と個別モデルの比較

環境変数で API Key を保存する

モデルを選択して会話を検証する

headless テストを実行する

よくある質問

MISSING_CREDENTIAL が表示される理由は？

モデル取得が 401 を返す理由は？

モデルセレクターに Auto しか表示されない理由は？

UNKNOWN_MODEL が表示される理由は？

接続がタイムアウトする理由は？

セキュリティ上の注意