Skip to content
NEWNano Banana 2.1 が登場 — Google の最新画像生成モデル、1 枚 $0.0336 から、ネイティブ 4K、前世代の約半額モデルを見る
HopBase
← ブログに戻る

DeepSeek Harness（dsh）ゲートウェイ設定ガイド（2026）

HopBase 2026年8月25日 7 分で読めます

結論から言うと、DeepSeek Harness（dsh）を HopBase 経由で動かすには、$DSH_HOME/settings.yaml にカスタムプロバイダーを 1 つ追加し、api: openai-completions、baseURL: https://api.hop-base.com/v1、apiKeyEnv: HOPBASE_API_KEY を指定して使いたいモデル ID を列挙し、起動前に export HOPBASE_API_KEY=sk-your-key を実行するだけです。dsh の Web UI でも「設定 → モデル → カスタムプロバイダーを追加」から同じ 3 つの値を入力できます。dsh はモデル非依存なので、ゲートウェイを 1 つ挟めば同じインストールで DeepSeek、GLM、Kimi、Grok、GPT、Claude を並行して動かせ、クォータ・呼び出し監査・コスト配賦も 1 つのコンソールで管理できます。注意すべきプロトコルの例外は 2 つです。grok-4.20-multi-agent は openai-responses が必要で、Claude モデルはベース URL https://api.hop-base.com（/v1 なし）で anthropic-messages を使う必要があります。そうしないと 404 になります。モデルが見つからない場合は、GET /v1/models からキーで使える正確な ID を取得してください。Function Calling とストリーミングの usage 報告は、本番ゲートウェイに対してエンドツーエンドで検証済みです。

DeepSeek Harness（dsh）は DeepSeek 公式のオープンソース エージェントランタイムで、2026 年 8 月 13 日に V4-Pro と同時にリリースされ、2 日で GitHub スター 10 万を突破しました。設計思想はひと言で表せます。すべてがプラグイン——エージェントループそのものも含めてです。そのため dsh は、固定機能のコーディングアシスタントというより、コーディングエージェントを組み立てるためのモジュール型ランタイムといえます。

dsh の背後にゲートウェイを置く理由

dsh はモデル非依存で、カスタムプロバイダーに必要なのはベース URL、プロトコル、モデル ID だけです。各ベンダーに直接つなぐと、キー・請求書・ネットワーク経路をそれぞれ管理しなければなりません。HopBase のゲートウェイ 1 つを経由すれば、同じ dsh インストールで DeepSeek、GLM、Kimi、Grok、GPT、Claude を並行して動かせ、クォータ・呼び出し監査・コスト配賦も 1 つのコンソールにまとまります。

3 分でできる設定

$DSH_HOME/settings.yaml にプロバイダーを追加します。

providers:
  hopbase:
    api: openai-completions
    baseURL: https://api.hop-base.com/v1
    apiKeyEnv: HOPBASE_API_KEY
    models:
      - id: deepseek-v4-flash-202605
      - id: glm-5.3
      - id: grok-4.6

起動前にキーを export します：export HOPBASE_API_KEY=sk-your-key。UI で設定したい場合は、dsh Web UI の「設定 → モデル → カスタムプロバイダーを追加」で同じ 3 つの値を入力してください。モデル ID は GET /v1/models から取得します。

プロトコル早見表

モデルファミリーapibaseURL
DeepSeek / GLM / Kimi / Grok / GPT チャットopenai-completionshttps://api.hop-base.com/v1
grok-4.20-multi-agent（Responses 専用）openai-responseshttps://api.hop-base.com/v1
Claude モデルanthropic-messageshttps://api.hop-base.com（/v1 なし）

検証済みの項目

エージェントが依存する 2 つの機能を、HopBase の本番ゲートウェイに対してエンドツーエンドで検証しています。Function Calling（dsh 形式のツールリクエストに対して正しい tool_calls が返る）と、ストリーミングの usage 報告（最終チャンクに完全な usage が含まれ、課金はプロバイダーが報告した usage と 1 行ずつ突き合わせて一致）です。

トラブルシューティング早見表

エラー原因対処
404 "platform does not support this API path"Claude モデルを OpenAI プロトコルで呼び出しているanthropic-messages を使い、ベース URL は /v1 なしにする
model not found / 503キーのどのグループにもそのモデルが含まれていないGET /v1/models の正確な ID を使う
401 invalid api keyキーが途中で切れている、または余分な空白が入っているコンソールからキーをコピーし直す

全パラメータとその他のクライアントについては DeepSeek Harness 連携ガイドをご覧ください。新規登録してキーを作成すれば、すぐに始められます。

チュートリアルDeepSeek