DeepSeek Harness は、DeepSeek が提供するオープンソースの AI Agent フレームワークであり、Web UI と CLI の両方のモードをサポートしています。従量課金、Coding Plan、Token Plan Personal Edition、または Token Plan Team Edition を使用して、Alibaba Cloud Model Studio に接続できます。
DeepSeek Harness のインストール
- Node.js（v18.0 以降）をインストールします。
- 次のコマンドを実行して、DeepSeek Harness Web UI を起動します：
npx @deepseek-ai/dsh web
実行後、Web UI はデフォルトで http://127.0.0.1:3080 で実行されます。
認証情報の設定
設定ファイル ~/.dsh/settings.yaml を編集して、Model Studio プロバイダーとデフォルトモデルを追加します。または、Web UI を起動し、Settings → Models → Add a custom provider から設定することもできます。
Token Plan Personal Edition
YOUR_API_KEY を Token Plan Personal Edition の API Key に置き換えます。利用可能なモデルについては、Token Plan Personal Edition の サポートされているモデル を参照してください。
Provider ID |
|
Base URL |
|
API Protocol |
|
APIキー | Token Plan Personal Edition API キー |
モデル | モデル ID を入力します（例： |
~/.dsh/settings.yaml を直接編集することもできます：
agent-default-model:
provider: bailian-tpp
model: auto
llm-pi-ai:
providers:
bailian-tpp:
api: openai-completions
baseURL: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
apiKeyEnv: BAILIAN_API_KEY
models:
- id: auto
- id: qwen3.8-max
- id: qwen3.8-flash
- id: qwen3.7-max
- id: qwen3.7-plus
- id: qwen3.6-flash
環境変数 BAILIAN_API_KEY に Token Plan Personal Edition の API Key を設定します：
export BAILIAN_API_KEY="YOUR_API_KEY"
または、Web UI の Settings → Models で API Key を直接入力することもできます。
Token Plan Team Edition
YOUR_API_KEY を Token Plan Team Edition の API Key に置き換えます。利用可能なモデルについては、Token Plan Team Edition の サポートされているモデル を参照してください。
Provider ID |
|
Base URL |
|
API Protocol |
|
APIキー | Token Plan Team Edition API キー |
モデル | モデル ID を入力します（例： |
対応する ~/.dsh/settings.yaml の設定：
agent-default-model:
provider: bailian-tp
model: auto
llm-pi-ai:
providers:
bailian-tp:
api: openai-completions
baseURL: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
apiKeyEnv: BAILIAN_API_KEY
models:
- id: auto
- id: qwen3.8-max
- id: qwen3.8-flash
- id: qwen3.7-max
- id: qwen3.7-plus
- id: qwen3.6-flash
Coding Plan
YOUR_API_KEY を Coding Plan の API Key に置き換えます。利用可能なモデルについては、Coding Plan の サポートされているモデル を参照してください。
Provider ID |
|
Base URL | |
API Protocol |
|
APIキー | Coding Plan API キー |
モデル | モデル ID を入力します（例： |
対応する ~/.dsh/settings.yaml の設定：
agent-default-model:
provider: bailian-coding
model: qwen3.7-plus
llm-pi-ai:
providers:
bailian-coding:
api: openai-completions
baseURL: https://coding-intl.dashscope.aliyuncs.com/v1
apiKeyEnv: BAILIAN_API_KEY
models:
- id: qwen3.7-plus
- id: qwen3.6-plus
従量課金
YOUR_API_KEY をお使いの Model Studio API キー に置き換えます。利用可能なモデルについては、OpenAI 互換 - サポートされているモデル を参照してください。
リージョンに基づいて Base URL を設定します。URL 内の {WorkspaceId} を実際の Workspace ID に置き換えます：
- シンガポール：
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - 米国（バージニア）：
https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1
Provider ID |
|
Base URL | 上記のリージョンリストを参照 |
API Protocol |
|
APIキー | Model Studio API キー（ |
モデル | モデル ID を入力します（例： |
対応する ~/.dsh/settings.yaml の設定：
agent-default-model:
provider: bailian
model: qwen3.7-max
llm-pi-ai:
providers:
bailian:
api: openai-completions
baseURL: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
apiKeyEnv: BAILIAN_API_KEY
models:
- id: qwen3.7-max
- id: qwen3.7-plus
- id: qwen3.6-flash
設定の確認
設定を保存した後、Web UI のモデルセレクターで設定したモデルを選択し、メッセージを送信します。モデルが正常に応答すれば、設定は成功です。
FAQ
エラーコード
設定中にエラーが発生した場合は、対応する課金プランの FAQ を参照してください：
- 従量課金：エラーコード
- Coding Plan：Coding Plan FAQ
- Token Plan Personal Edition：Token Plan FAQ
- Token Plan Team Edition：Token Plan Team Edition FAQ
利用可能なモデルの取得が 401 を返す
Model StudioのOpenAI互換エンドポイントはGET /models APIを提供していません。Fetch available modelsをクリックすると、401または404が返されます。このボタンは無視して、モデルカタログにモデルIDを手動で入力できます。
MISSING_CREDENTIAL エラー
Web UIのSettings → ModelsでAPI Keyを再入力して保存するか、BAILIAN_API_KEY環境変数が設定されていることを確認してDeepSeek Harnessを再起動してください。