> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DeepSeek Harness

> DeepSeek Harness を AIHubMix に接続する手順：npm 版のインストール、OpenAI 互換プロバイダー設定、auto または個別モデルの追加、Agent リクエストの検証。

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

<Info>
  このガイドは 2026 年 8 月 14 日に DeepSeek Harness `0.1.0-rc.6` で検証しました。Harness は開発者プレビューのため、今後のリリースで項目や UI が変更される場合があります。
</Info>

<h2 id="summary">
  要点
</h2>

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

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

<Frame>
  <img src="https://mintcdn.com/aihubmix/pPBGbuf_Qo9bMEMd/public/en/deepseek-harness/01-models-aihubmix-configured.png?fit=max&auto=format&n=pPBGbuf_Qo9bMEMd&q=85&s=9a11531222d056d05d6ee6030eddb595" alt="DeepSeek Harness の Models ページで設定済みの AIHubMix" width="1280" height="720" data-path="public/en/deepseek-harness/01-models-aihubmix-configured.png" />
</Frame>

<h2 id="requirements">
  何が必要ですか？
</h2>

* 有効な [AIHubMix API Key](https://console.aihubmix.com/token)
* Node.js `22.19.0` 以降、Node.js 24+ も利用可能
* npm Registry と `https://aihubmix.com` に接続できるネットワーク

```bash theme={null}
node --version
npm --version
```

<h2 id="install">
  DeepSeek Harness をインストールする方法
</h2>

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

```bash theme={null}
npm install -g @deepseek-ai/dsh
dsh --version
```

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

<h2 id="start-web-ui">
  Web UI を起動する方法
</h2>

ワークスペースとして使用するプロジェクトディレクトリで実行します。

```bash theme={null}
dsh web --port 3080
```

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

<h2 id="configure-provider">
  AIHubMix プロバイダーを設定する方法
</h2>

**Settings > Models > Add a custom provider** を開きます。

<Frame>
  <img src="https://mintcdn.com/aihubmix/pPBGbuf_Qo9bMEMd/public/en/deepseek-harness/03-add-custom-provider.png?fit=max&auto=format&n=pPBGbuf_Qo9bMEMd&q=85&s=e5f609447d3c979a65235ecc1b0382d0" alt="DeepSeek Harness のカスタムプロバイダー設定フォーム" width="1280" height="720" data-path="public/en/deepseek-harness/03-add-custom-provider.png" />
</Frame>

| 項目           | 推奨値                       | 説明                                  |
| ------------ | ------------------------- | ----------------------------------- |
| 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` です。

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

<h2 id="add-models">
  auto または他のモデルを追加する
</h2>

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

<Frame>
  <img src="https://mintcdn.com/aihubmix/pPBGbuf_Qo9bMEMd/public/en/deepseek-harness/07-discover-models.png?fit=max&auto=format&n=pPBGbuf_Qo9bMEMd&q=85&s=7fdeeb8c4ba8400910bcabe1e7b50a78" alt="DeepSeek Harness が取得した AIHubMix の利用可能モデル" width="1280" height="720" data-path="public/en/deepseek-harness/07-discover-models.png" />
</Frame>

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

<Frame>
  <img src="https://mintcdn.com/aihubmix/pPBGbuf_Qo9bMEMd/public/en/deepseek-harness/04-add-auto-model.png?fit=max&auto=format&n=pPBGbuf_Qo9bMEMd&q=85&s=0c1e93d53cf9840d5c5885dc192b0d80" alt="AIHubMix の auto モデルを手動で追加" width="1280" height="720" data-path="public/en/deepseek-harness/04-add-auto-model.png" />
</Frame>

**Create provider** を選択して保存します。

<h2 id="auto-vs-specific-models">
  auto と個別モデルの比較
</h2>

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

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

<h2 id="environment-variables">
  環境変数で API Key を保存する
</h2>

`$HOME/.dsh/settings.yaml` を編集します。

```yaml theme={null}
llm-pi-ai:
  providers:
    aihubmix:
      displayName: AIHubMix
      apiKeyEnv: AIHUBMIX_API_KEY
      api: openai-completions
      baseURL: https://aihubmix.com/v1
      models:
        - id: auto
          name: Auto
          contextWindow: 1000000
          maxTokens: 32768

agent-default-model:
  provider: aihubmix
  model: auto
```

```bash theme={null}
export AIHUBMIX_API_KEY='sk-***'
dsh web --port 3080
```

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

<Frame>
  <img src="https://mintcdn.com/aihubmix/pPBGbuf_Qo9bMEMd/public/en/deepseek-harness/02-aihubmix-provider-details.png?fit=max&auto=format&n=pPBGbuf_Qo9bMEMd&q=85&s=a18af7f6409268331dcb4ddfa7d78568" alt="DeepSeek Harness の AIHubMix プロバイダー詳細" width="1280" height="720" data-path="public/en/deepseek-harness/02-aihubmix-provider-details.png" />
</Frame>

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

<h2 id="verify-chat">
  モデルを選択して会話を検証する
</h2>

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

<Frame>
  <img src="https://mintcdn.com/aihubmix/pPBGbuf_Qo9bMEMd/public/en/deepseek-harness/05-select-auto-model.png?fit=max&auto=format&n=pPBGbuf_Qo9bMEMd&q=85&s=82577ac5295eebc0ef6e4945f75f5ffe" alt="DeepSeek Harness のモデルセレクターで Auto を選択" width="1280" height="720" data-path="public/en/deepseek-harness/05-select-auto-model.png" />
</Frame>

```text theme={null}
Reply with exactly: AIHubMix connection successful
```

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

<Frame>
  <img src="https://mintcdn.com/aihubmix/pPBGbuf_Qo9bMEMd/public/en/deepseek-harness/06-live-chat-success.png?fit=max&auto=format&n=pPBGbuf_Qo9bMEMd&q=85&s=f5fe3902c1c2f57b84b34b739b258394" alt="DeepSeek Harness で成功した AIHubMix 応答" width="1280" height="720" data-path="public/en/deepseek-harness/06-live-chat-success.png" />
</Frame>

<h2 id="headless-test">
  headless テストを実行する
</h2>

```bash theme={null}
export AIHUBMIX_API_KEY='sk-***'
dsh --profile headless \
  'Reply with exactly DSH_AIHUBMIX_OK and do not use tools.'
```

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

<h2 id="troubleshooting">
  よくある質問
</h2>

<h3 id="missing-credential">
  MISSING\_CREDENTIAL が表示される理由は？
</h3>

Harness が起動環境から `AIHUBMIX_API_KEY` を取得できていません。変数を設定し、同じターミナルから Harness を起動してください。

<h3 id="models-401">
  モデル取得が 401 を返す理由は？
</h3>

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

<h3 id="only-auto">
  モデルセレクターに Auto しか表示されない理由は？
</h3>

セレクターは現在の Provider カタログに登録済みのモデルだけを表示します。**Settings > Models > AIHubMix > Edit** で **Fetch available models** を使用するか、正確なモデル ID を手動で追加してください。

<h3 id="unknown-model">
  UNKNOWN\_MODEL が表示される理由は？
</h3>

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

<h3 id="connection-timeout">
  接続がタイムアウトする理由は？
</h3>

DNS、組織のネットワーク、ローカルプロキシを確認してください。ブラウザーのみがシステムプロキシを使用する場合は、`dsh` を起動するターミナルで `HTTP_PROXY`、`HTTPS_PROXY`、`NODE_USE_ENV_PROXY=1` を設定します。

<h2 id="security">
  セキュリティ上の注意
</h2>

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

***

最終更新日：2026-08-14