DeepSeek Harness 転送API接続ガイド：モデルProviderの設定

1. DeepSeek Harnessとは

DeepSeek Harness（コマンド dsh）は、DeepSeekがオープンソース化したエージェントフレームワークであり、「すべてはプラグイン（everything-is-a-plugin）」アーキテクチャを採用しています。Web UIを内蔵しているほか、コマンドラインやSDK経由での実行にも対応しており、AIにワークスペース内のファイルの読み込み、コードの修正、タスクの実行を行わせるのに最適です。

2. Web UIの起動

Node.jsをインストールした状態で、以下のコマンドを実行してください：

npx @deepseek-ai/dsh web

このコマンドはデフォルトで http://127.0.0.1:3080 にてWeb UIを起動し、自動的にブラウザを開きます。自動起動を無効にする場合は --no-open を追加してください。ソースコードから実行する場合は以下のようにします：

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

3. モデルを当サイトのゲートウェイに向ける

Web UIを開き、Settings → Models → Add a custom provider の順にクリックし、以下を入力します：

Provider ID : jizhi
Base URL    : https://www.relay-api.com
API 协议    : OpenAI Compatible（openai-completions）
API Key     : sk-あなたのキー
模型        : claude-sonnet-5

（OpenAIエンドポイントには https://www.relay-api.com/v1 を、Geminiエンドポイントには https://www.relay-api.com/v1beta を使用してください。必要に応じて複数のProviderを追加可能です。）

settings.yamlでの設定も可能

llm-pi-ai:
  providers:
    jizhi:
      apiKeyEnv: JIZHI_API_KEY
      api: openai-completions
      baseURL: "https://www.relay-api.com"
      models:
        - id: claude-sonnet-5

保存後、モデルセレクターから該当のモデルを選択すればセッションを開始できます。

4. ワークスペースの選択とタスクの実行

起動後、Choose workspace をクリックし、dsh を実行したプロジェクトディレクトリを選択します。ワークスペースを選択すると新しいセッションを作成でき、例えば「このリポジトリを要約して主要なパッケージをリストアップして」といった指示を送ることができます。フレームワークは権限が必要な際に承認を求めます。

5. よくある質問とトラブルシューティング

現象	対策
401	キーが無効です。API Keyを確認するか、Modelsページで再入力し、適切な環境変数が公開されているか確認してください。
UNKNOWN_MODEL	モデルが設定されていないか、不一致です。カスタムProviderのモデルリストに正確なslugを追加してください。
ゲートウェイ拒否	リクエスト構造がOpenAIと完全に一致しない場合、route設定にて compat.supportsDeveloperRole: false と compat.maxTokensField: max_tokens を設定してください。

セキュリティのヒント：sk- キーは公開リポジトリに記述しないでください。環境変数経由での参照を推奨します。エージェントのタスクはリソースを消費するため、残高や利用量に注意してください。

Base URLについての補足：当サイトは /v1beta/models/... と /v1beta/v1beta/models/...（および /v1/... と /v1/v1/...）の両方を受け付けます。そのため、クライアント側で自動的に /v1 や /v1beta が補完されるかどうかに関わらず動作します。Base URLはドメインのルート、または /v1beta を含めたアドレスのどちらでも利用可能です。モデルIDはコンソールの「トークン」ページ右上にある「モデルID」からコピーしてご確認ください。