DeepSeek Harness (dsh): установка, настройка провайдера и первый запуск
DeepSeek Harness (команда dsh) — это открытый агентный рантайм, который позволяет запускать ИИ-агентов локально на своём компьютере. В этой инструкции — как установить harness, подключить к нему модель DeepSeek (или другую) и сделать первый запрос.
Для разработчиков, которые хотят запустить DeepSeek Harness локально: установить, настроить провайдера, вставить API-ключ и начать работать с агентами. Всё по шагам, без лишней теории.
Что такое DeepSeek Harness
DeepSeek Harness (dsh) — это программа-обёртка вокруг языковой модели, которая даёт ей инструменты: работу с файлами, запуск кода, поиск в интернете, доступ к терминалу. Агент сам решает, когда и какой инструмент применить, чтобы выполнить вашу задачу.
Ключевые особенности:
- Открытый код — лицензия MIT, можно использовать бесплатно.
- Локальный запуск — всё работает на вашем компьютере, ничего не уходит в облако (кроме самих запросов к API модели).
- Любая модель — подключается к любому OpenAI-совместимому API.
- Плагины — инструменты, адаптеры моделей и безопасность расширяются через плагины.
Установка DeepSeek Harness
Способ 1. Быстрый запуск через npx (рекомендуется)
Самый простой способ — запустить harness одной командой. Убедитесь, что у вас установлен Node.js (версия 18+).
npx @deepseek-ai/dsh web
После выполнения команды откройте браузер и перейдите на http://127.0.0.1:3080. Если всё прошло успешно, вы увидите веб-интерфейс DeepSeek Harness.
Способ 2. Настольное приложение
Для Windows и macOS доступны десктопные сборки на GitHub проекта. Скачайте установщик для своей платформы и запустите.
Способ 3. Headless-режим (для серверов)
Если вы хотите запустить harness без веб-интерфейса (например, на сервере), используйте:
npx @deepseek-ai/dsh --headless
Настройка провайдера и подключение API-ключа
После установки нужно подключить модель. Harness не включает модель «из коробки» — он подключается к API.
Шаг 1. Получите API-ключ
Вам нужен ключ от любого OpenAI-совместимого API:
- Официальный DeepSeek API — ключ с platform.deepseek.com (нужна зарубежная карта).
- AITUNNEL — ключ
sk-aitunnel-...с оплатой в рублях. Один ключ для DeepSeek, GPT, Claude. Подробнее об AITUNNEL →
Получить ключ AITUNNEL для Harness
Оплата в рублях, без VPN, доступ к DeepSeek, GPT и Claude по одному ключу.
Шаг 2. Добавьте провайдера в веб-интерфейсе
Откройте веб-интерфейс dsh (http://127.0.0.1:3080). Перейдите в Settings → Models и нажмите Add Custom Provider. Заполните поля:
| Поле | Значение для AITUNNEL | Значение для DeepSeek |
|---|---|---|
| Base URL | https://api.aitunnel.ru/v1 |
https://api.deepseek.com |
| API Key | sk-aitunnel-... |
sk-... |
| Модели (через запятую) | deepseek-v4.1-flash, gpt-6-luna, claude-haiku-5.5 |
deepseek-flash, deepseek-v4-pro |
Сохраните настройки. Если всё указано верно, в выпадающем списке моделей появятся добавленные модели.
Шаг 3. Выберите модель и начните работу
В интерфейсе чата выберите одну из добавленных моделей, напишите задачу и отправьте. Harness сам решит, какие инструменты применить.
Типичные проблемы при установке
| Ошибка | Причина | Решение |
|---|---|---|
| UNKNOWN_MODEL | Модель не добавлена в список провайдера | Перейдите в Settings → Models и добавьте точное имя модели из каталога провайдера |
| Port 3080 already in use | Порт занят другим процессом | Закройте другой процесс или смените порт: npx @deepseek-ai/dsh web --port 3081 |
| Unsupported model | Модель не найдена у провайдера | Проверьте имя модели в каталоге сервиса — у AITUNNEL идентификаторы отличаются от официальных |
| Request timeout | Модель не отвечает в течение лимита | Проверьте API-ключ и баланс. Для моделей с режимом рассуждений увеличьте max_tokens до 50 000+ |
| No build for Linux | Нативная сборка под Linux не найдена | Используйте npx-версию — она работает на всех платформах |
Первый запрос к агенту
После подключения модели попробуйте такой запрос:
Создай файл hello.txt с приветствием на трёх языках: русском, английском и китайском. Используй инструмент для работы с файлами.
Если агент работает корректно, он выполнит задачу: создаст файл, запишет в него текст и сообщит результат. Если агент запрашивает подтверждение на выполнение команд — подтвердите.
Советы по настройке
- Начните с минимальной модели — для первых тестов используйте
deepseek-flashилиdeepseek-v4.1-flash. Они быстрые и дешёвые. - Установите лимит бюджета — в AITUNNEL можно задать дневной лимит на ключ, чтобы случайно не потратить лишнего.
- Для сложных задач используйте v4-pro — если агент не справляется с flash, переключитесь на
deepseek-v4-pro. Он лучше рассуждает. - Не давайте агенту доступ к критичным файлам — песочница harness ограничивает доступ, но лучше перестраховаться.
Частые вопросы
DeepSeek Harness работает на Windows?
Да, npx-версия работает на Windows, macOS и Linux. Десктопное приложение доступно для Windows и macOS. Версия через npx универсальна.
Сколько стоит использование DeepSeek Harness
Сам harness бесплатный. Вы платите только за токены модели, которую используете. DeepSeek V4 Flash через AITUNNEL стоит от 13 ₽ за 1M токенов ввода. Одна сессия с агентом обычно обходится в копейки.
Можно ли использовать Harness без интернета
Нет, harness отправляет запросы к API модели через интернет. Сам код выполняется локально, но модель должна быть доступна через сеть. Локальные модели через Ollama или LM Studio тоже подходят, но это отдельная настройка.
Какой API-ключ нужен для DeepSeek Harness
Любой OpenAI-совместимый: официальный ключ DeepSeek, ключ AITUNNEL или другой агрегатор. В настройках провайдера указываете base_url, ключ и список моделей.
Ещё по теме
- Подключение через AITUNNEL Один ключ, оплата в рублях, OpenAI- и Anthropic-совместимые адреса.
- Дипсик Харнес (DeepSeek Harness) на русском Что такое Дипсик Харнес, как установить и настроить на русском языке.
- DeepSeek Harness (dsh): что это и как подключить Открытый агентный рантайм DeepSeek.
- Ошибки и настройка DeepSeek Harness UNKNOWN_MODEL, провайдер, порт, модели.