DeepSeek Harness 接入 B.AI API 官方配置ガイド

DeepSeek Harness は、注目を集めているオープンソースのAIワークスペースアプリケーションで、現在開発者プレビュー段階にあります。ローカルワークスペースに深く入り込み、コードやファイルの分析を支援するだけでなく、オープンなカスタムProviderメカニズムを通じて、開発者に非常に高い柔軟性を提供します。一方、B.AI は先進的なAIインフラストラクチャとして、高可用性と低遅延を兼ね備えたフルスタックの大規模言語モデルサービスプラットフォームを構築し、開発者と企業のために、強力で安定性が高く、かつ非常に弾力性のあるインテリジェントな算力ネットワークの構築に取り組んでいます。

このガイドでは、Windows、macOS、Linux環境でDeepSeek Harnessをゼロから起動し、B.AI APIとの統合を成功させるまでの手順を詳しく説明します。このチュートリアルに従うことで、ローカルワークスペースから大規模言語モデルに至るまでの全チェーン呼び出しのループを構築し、AI駆動による生産性とイノベーションの可能性を最大限に引き出すことができます。

最終的に実現する呼び出しチェーン： DeepSeek Harness → B.AI API → B.AI が提供するモデル

1. 環境の準備

DeepSeek Harness は、Node.js に組み込まれている npx  を使用して起動します。お使いのシステムに、現在利用可能な Node.js LTS バージョンがインストールされていることを確認してください。

公式ダウンロードサイト： https://nodejs.org/en/download

• Windows

.msi インストーラーを直接ダウンロードするか、スタートメニューで PowerShell を検索して開き、WinGet インストールコマンドを実行します。

winget --version
winget install --id OpenJS.NodeJS.LTS -e --source winget

• macOS

Node.js 公式ダウンロードページで macOS Installer を選択し、.pkg ファイルをダウンロードして指示に従ってインストールを完了します。インストール完了後、Command + Space を押してスポットライト検索を開き、「Terminal」と入力してターミナルに入ります。

• Linux 

Node.js 公式ダウンロードページで、ご使用の Linux ディストリビューションとシステムアーキテクチャを選択し、ページに表示されるパッケージマネージャーのコマンドに従って LTS バージョンをインストールしてください。Ubuntu、Debian、Fedora などディストリビューションによってインストールコマンドは異なるため、公式ページで動的に生成されるコマンドを使用して、インストールプロセスが確実に成功するようにすることをお勧めします。

インストールが完了したら、開いているすべてのターミナルウィンドウを閉じ、新しいターミナルを開き直してください（Windows ユーザーは PowerShell、macOS ユーザーは Terminal、Linux ユーザーはシステムターミナルを使用）。

3つのシステムすべてで、以下の同じチェックコマンドを実行します：

node -v
npm -v
npx -v

3つのコマンドすべてがバージョン番号を返せば、環境の準備は完了です。

Node.js v24.19.0
npm 11.17.0
npx 11.17.0

GitHub のソースコードからプロジェクトをビルドして実行する予定がある場合は、Git 環境が必要です。まずターミナルで git --version を実行して、インストールされているか確認してください。インストールされていない場合は、お使いのオペレーティングシステムに応じて以下のコマンドを実行してください：

Windows 

winget install --id Git.Git -e --source winget

macOS 

xcode-select --install

Ubuntu または Debian 

sudo apt update
sudo apt install git

注：npx 方式でクイックに体験し、B.AI を設定する予定のみの場合は、Git はスキップして問題ありません。

2.  npx を使用した DeepSeek Harness の起動 (推奨)

通常の使用および B.AI API の設定を行う開発者には、npx を使用した起動を直接お勧めします。

ターミナルで以下のコマンドを実行します（3つのOSで共通）：

npx @deepseek-ai/dsh web

初回実行時のプロンプト： 必要なパッケージをダウンロードするかどうか尋ねられます。y と入力して Enter キーを押し、確認します。

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

起動中に依存関係の非推奨警告が表示される場合がありますが、これは正常な現象であり、対応は不要です。

npm warn deprecated node-domexception@1.0.0

ターミナルにローカルアドレスが出力されたら、DeepSeek Harness の Web サービスが正常に起動したことを意味します。

dsh web: http://127.0.0.1:3080

ターミナルウィンドウを開いたままにして、ブラウザのアドレスバーに次のように入力します：

http://127.0.0.1:3080

このアドレスは、このマシンからのみアクセス可能です。ターミナルウィンドウを閉じるか、ウィンドウ内で Ctrl+C を押すと、ローカルサービスは停止します。ブラウザで 127.0.0.1:3080 を開けない場合は、まずターミナルがまだ実行中であるかどうか、またターミナル内に上記の  dsh web アドレスが出力されているかどうかを確認してください。必要に応じて、起動コマンドを再実行してください。

npx @deepseek-ai/dsh web

3. ソースコードからのビルド方法（上級者向け）

プラグインの開発、ソースコードの変更、またはプロジェクト開発への参加を計画している場合は、公式 GitHub リポジトリからソースコードを取得することもできます。

公式リポジトリ： https://github.com/deepseek-ai/deepseek-harness

GitHub が提供するのはプロジェクトのソースコードであり、ダウンロード後はターミナルで依存関係のインストールとプロジェクトのビルドを実行する必要があります。ファイルをダブルクリックして直接実行することはできません。以下の2つの方法でソースコードを取得して実行できます：

方法1：ZIP ソースコードパッケージをダウンロード リポジトリページで緑色の Code ボタンをクリックし、Download ZIP を選択します。ダウンロードして解凍した後、ターミナルを開き、cd コマンドで解凍したプロジェクトディレクトリに入り、以下のコマンドを順に実行します：

npm install -g pnpm
pnpm install
pnpm run build
pnpm dsh web

方法2：Git クローンを使用 まず git --version を実行して、Git 環境が存在するか確認することをお勧めします。インストールされていない場合は、前述の「環境の準備」セクションを参照して、ご使用のシステムに合わせた Git のインストールを完了してください。環境が問題ないことを確認したら、ターミナルを開き直して、以下のコマンドを実行します：

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
npm install -g pnpm
pnpm install
pnpm run build
pnpm dsh web

ZIP と Git のどちらの方法を使用しても、ビルドと起動が成功した後のアクセスアドレスは同じく http://127.0.0.1:3080 です。

4. B.AI カスタム Provider 設定

ステップ1、公式デフォルト設定をスキップ

DeepSeek Harness に初めて入ると、公式モデルの API Key 入力ウィンドウが表示されます。必ず「後で設定」をクリックしてください。ここに B.AI の Key を入力すると、システムが正しく認識できなくなります。

ステップ2、カスタム設定ページに入る

ページ左下の「設定」をクリックし、左側のメニューで「モデル」を選択し、右側の「カスタムプロバイダーを追加」をクリックします。注：この時点で公式 Provider に赤い点が表示されるのは正常な状態であり、その後の操作には影響しません。

ステップ3、B.AI インターフェース情報を入力

カスタムプロバイダーを開いたら、以下の内容を入力します。

Provider ID bai
表示名 B.AI
API アドレス https://api.b.ai/v1
API プロトコル openai-completions
API キー B.AI 管理画面で作成した有効な API Key

ステップ4、モデルディレクトリを取得し、Provider の作成を完了

基本情報の入力が完了したら、「モデルディレクトリ」領域まで下にスクロールします。システムは2つの追加方法を提供します：「モデルを追加」をクリックしてモデル ID を手動で入力するか、右上の「利用可能なモデルを取得」をクリックします。

推奨操作： まず「利用可能なモデルを取得」をクリックします。 DeepSeek Harness に、B.AI へ直接リクエストさせ、現在のアカウントで利用可能なモデルディレクトリを取得させます。モデルリストが正常に返ってくれば、B.AI API Key、https://api.b.ai/v1、openai-completions プロトコル、およびモデルディレクトリインターフェースなどの設定が正常に接続されたことの証明となります。

モデルの選択と追加に関する注意：

• 返されたリストで、B.AI が現在利用可能な DeepSeek モデルをチェックします（例として deepseek-v4-flash や deepseek-v4-pro が見られます。具体的に利用可能なモデルはアカウントの権限や時期によって動的に変化するため、実際に返された結果を基準としてください）。
• モデル ID を変更しないでください： モデル ID は B.AI が実際に返すディレクトリと完全に一致している必要があります。大文字小文字、ハイフン、バージョン番号を勝手に変更しないでください。そうしないと、その後の呼び出しで model not found エラーが発生しやすくなります。

モデルの追加が正しいことを確認したら、フォームの最下部までスクロールし、「プロバイダーを作成」をクリックします。

作成に成功すると、設定ページに B.AI という名前のカスタム Provider が新たに追加され、その横に緑色の点が表示されます。これは、B.AI カスタム Provider が正常に保存され、利用可能な状態にあることを意味します。 注：この時点で DeepSeek 公式 Provider がまだ赤い点を表示している場合、それは DeepSeek 公式 API Key を入力していないためであり、緑の点に対応する B.AI インターフェースの通常の使用には影響しません。

ステップ5、 チェーン接続性の検証

設定ウィンドウを閉じ、メインインターフェースに戻って新しいセッションを作成します。モデルセレクターで B.AI Provider を選択し、次に追加したばかりの DeepSeek モデルを選択して、以下のテストを実行します：

基本対話テスト： モデルセレクターで B.AI と対応するモデルを選択し、コマンドを送信します：

自己紹介をしてください。また、現在使用しているモデルについても説明してください。

コンテンツが正常に返されるか、ストリーミング出力があるかを確認し、現在の Provider が B.AI であり、モデル ID が選択したものと一致していることを確認します。

ツール呼び出しテスト： 読み取り専用コマンドを送信してツールチェーンを検証します：

現在のワークスペースのファイルを確認し、ディレクトリ構造を要約してください。ファイルを変更または削除しないでください。

コマンドで特に「ファイルを変更または削除しないでください」と強調するのは、現在のワークスペースを変更せずに、Harness のツール呼び出しチェーンが機能しているかを安全かつ迅速に検証するためです。

上記の2つのテストを実行している間、DeepSeek Harness を実行しているターミナルウィンドウを振り返って確認し、コンソールに 401、404、model not found、またはその他のリクエストエラーメッセージが表示されていないことを確認してください。ターミナルの動作が安定していれば、これですべての接続と検証作業が正常