DeepSeek Harness のセットアップ

このガイドでは、DeepSeek Harness（dsh）を、カスタムの OpenAI 互換プロバイダとして Aiberm で動かす方法を説明します。設定後は、1 つの Aiberm API キーで Claude、GPT、Gemini、DeepSeek、Kimi、MiniMax、GLM、Grok、および Aiberm 上のその他のモデルにアクセスできます。

DeepSeek Harness とは

DeepSeek Harness は DeepSeek AI のオープンソースエージェントハーネスです。すべてはプラグインであり、Cordis によって構成されます。通常の入り口はブラウザ UI（dsh web）で、同じホームディレクトリがワンショットのヘッドレスジョブにも使われます。

公式プロジェクト:

• ホームページ: deepseek.com/harness
• ソース: github.com/deepseek-ai/deepseek-harness
• ディスカッション: GitHub Discussions

前提条件

• Aiberm アカウント（登録）
• Aiberm API キー（キーを取得）
• Node.js がインストール済みであること（npx に必要）
• macOS、Linux、または Windows のターミナル

インストールと起動

公式のインストール方法は、ワンショットの npx 起動です。エージェントに作業させたいプロジェクトディレクトリから実行します。

npx @deepseek-ai/dsh web

Web UI はデフォルトで http://127.0.0.1:3080 で待ち受けます。現在の作業ディレクトリがワークスペースのルートになります。

便利なバリエーション:

# Another port
npx @deepseek-ai/dsh web --port 8080

# One-shot headless job (same models and credentials as the Web UI)
npx @deepseek-ai/dsh --profile headless "summarize the README"

すでに CLI をインストールしている場合:

dsh web
dsh --help
dsh web --help

Aiberm を設定する（Web UI、推奨）

Aiberm は 組み込みの DeepSeek カードではなく、カタログ上の OpenAI / Anthropic プロバイダでも ありません。それらのエントリは公式エンドポイントを維持します。Aiberm は OpenAI 互換ゲートウェイなので、カスタムプロバイダとして追加します。

公式リファレンス: Configure models。

ステップ 1: Settings → Models を開く

Web UI で Settings → Models を開きます。

ステップ 2: カスタムプロバイダを追加する

Add a custom provider を選び、次を入力します。

ステップ 3: モデルを読み込む、または入力する

Model catalog の下で Fetch available models を選びます。Harness は、今入力したキーで Aiberm の OpenAI 互換 GET /v1/models を呼び出します。使いたいモデルを選んで保存します。

検出に失敗した場合は、モデル ID を手入力します。モデル一覧 または Aiberm Pricing の ID を使います。例:

• claude-sonnet-4-6
• claude-opus-4-6
• gpt-5.4
• google/gemini-3-flash
• deepseek/deepseek-v4-pro
• grok-4.6

ステップ 4: モデルを選ぶ

保存後、コンポーザー下部のモデルピッカーに Aiberm が表示されます。モデルを選ぶと、その選択が 新しい セッションのデフォルトにもなります。すでにリクエストを送ったセッションは、自身のログに記録されたモデルを維持します。

ピッカーは、組み込みの DeepSeek モデルと Aiberm カスタムプロバイダを分けて表示します。Claude、GPT、Gemini、その他のカタログには Aiberm グループを使います。

Aiberm を設定する（settings.yaml）

同じプロバイダを、$DSH_HOME/settings.yaml（通常は ~/.dsh/settings.yaml）を編集して宣言することもできます。このファイルに API キーを 入れないでください。

llm-pi-ai:
  providers:
    aiberm:
      displayName: Aiberm
      apiKeyEnv: AIBERM_API_KEY
      api: openai-completions
      baseURL: https://aiberm.com/v1
      models:
        - id: claude-sonnet-4-6
        - id: claude-opus-4-6
        - id: claude-opus-4-6-thinking
        - id: gpt-5.4
        - id: google/gemini-3-flash
        - id: deepseek/deepseek-v4-pro
        - id: grok-4.6
        - id: kimi-k2.6
        - id: minimax-m2.7

agent-default-model:
  provider: aiberm
  model: claude-sonnet-4-6

その後、キーを次のいずれかに保存します（リクエスト時は最初に一致したものが使われます）。

1. 起動環境: AIBERM_API_KEY=sk-... npx @deepseek-ai/dsh web
2. $DSH_HOME/.credentials.yaml（Models ページが書き込む場所）:

AIBERM_API_KEY: sk-your-aiberm-api-key

3. 起動ディレクトリのプロジェクト .env、または $DSH_HOME/.env

公式の認証情報の優先順: プロセス環境 → $DSH_HOME/.credentials.yaml → プロジェクト .env → $DSH_HOME/.env。Models ページに書き込んだ値は、古い .env のキーより優先されます。

POSIX では、.credentials.yaml のモードを 600 にしてください。

Harness の同梱カタログにないカスタムルートでは、api、baseURL、空でない models 一覧を 必ず 設定します。models はそのルートのカタログを 置き換えます — ピッカーに出したいモデルはすべてそこに含める必要があります。id だけのエントリで十分です。

Vision モデル

手入力したモデルは、明示するまでテキスト専用として扱われます。そのようなモデルに画像を添付すると、Harness は送信前にリクエストを拒否します。

Aiberm の Vision モデルでは、settings.yaml に input を追加します。

llm-pi-ai:
  providers:
    aiberm:
      apiKeyEnv: AIBERM_API_KEY
      api: openai-completions
      baseURL: https://aiberm.com/v1
      models:
        - id: claude-sonnet-4-6
        - id: gemini-3-pro-image-preview
          input: [text, image]
        - id: gpt-image-2
          input: [text, image]

一覧のすべてのモデルが画像を受け付ける場合は、ルートのフォールバックを一度設定します。

defaultInput: [text, image]

defaultInput は上書きではなくフォールバックです。デフォルトは [text] です。

設定の確認

1. http://127.0.0.1:3080 を開きます。
2. モデルピッカーに Aiberm とモデルが一覧されていることを確認します。

3. Hi のような短いプロンプトを送ります。
4. 任意: Aiberm 経由でモデルを直接一覧します。

curl -H "Authorization: Bearer sk-your-aiberm-api-key" \
     https://aiberm.com/v1/models

ピッカーにない追加 ID は、プロバイダの models 一覧に追加するか、Fetch available models を再実行します。

ヘッドレスと CLI の注意

Web UI と dsh --profile headless は $DSH_HOME を共有します。Aiberm を一度設定したら、次を実行します。

npx @deepseek-ai/dsh --profile headless "list the files in this directory"

ランチャーフラグが先で、そのあとはプロファイルに属します。

dsh --profile web --port 8080
dsh --profile web --help
dsh --help

トラブルシューティング

MISSING_CREDENTIAL

ルートは AIBERM_API_KEY（または別の apiKeyEnv）を指定していますが、値が保存されていません。Settings → Models でキーを保存するか、dsh を起動するシェルで同じ変数をエクスポートしてください。

UNKNOWN_MODEL

選択したモデルが、このプロバイダの models 一覧にありません。モデルを再取得するか、ID を手入力してください。Aiberm の ID は時間とともに変わるため、モデル一覧 で確認してください。

モデル取得時またはチャット時の 401

• Aiberm Console でキーを確認します。
• Base URL は https://aiberm.com/v1 である必要があります（/v1 を含めます）。
• キーを settings.yaml に貼り付けないでください。認証情報または環境に置きます。

リクエストがまだ DeepSeek または OpenAI に行く

組み込みの DeepSeek カード、またはカタログの openai / anthropic プロバイダを設定しています。それらは公式エンドポイントを維持します。誤設定の行を削除し、ID aiberm と base URL https://aiberm.com/v1 の カスタム プロバイダを追加してください。

送信前に画像が拒否される

そのモデルに画像モダリティがありません。そのモデルに input: [text, image] を追加し（Vision モデル を参照）、新しい セッションを開始してください。添付済みの画像は古いセッションログに残ります。

設定の編集が反映されない

プロバイダとキーの変更は 次の リクエストで適用されます。サーバーの再起動は不要です。既存セッションは、すでにログに書かれたモデルを維持します。デフォルトを変えたあとは新しいチャットを開始してください。

ファイルの場所

注意事項

• キーは Models ページで設定することを推奨します。settings.yaml には apiKeyEnv の参照だけを置いてください。
• エージェントに読ませたくないシークレットがすでに入っているディレクトリでは実行しないでください。
• このガイド以外のフィールド（タイムアウト、リトライ、reasoning 互換）は、公式の dsh-llm-pi-ai README を参照してください。

リンク

• DeepSeek Harness on GitHub
• Official configure-models guide
• Aiberm Console
• Aiberm Models List
• Aiberm Pricing