Гайды

DeepSeek Harness как установить: пошаговая инструкция

6 октября 2026 · 8 минут чтения

Проверка фактов

Юлия Найпак

Методист по автоматизации. Сверяет паспорт инструмента с документацией вендора.

Автор Р

Редакция

Коллектив авторов, редакторов и иллюстраторов статей на сайте блога онлайн-университета «Зерокодер». Пишем…

Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.

Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 6 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.

DeepSeek Harness как установить: поставить Node.js версии ^22.19.0 или >=24.0.0, выполнить npx @deepseek-ai/dsh web, открыть в браузере http://127.0.0.1:3080 и вставить API-ключ в Settings → Models. DeepSeek Harness (dsh) — открытый агентный рантайм DeepSeek под лицензией MIT: он связывает модели V4-Pro и V4-Flash с инструментами, файлами и терминалом. Для Windows x64 и macOS на Apple Silicon есть десктопное приложение.

Мы скачали топ-10 выдачи DuckDuckGo (ru-RU) по запросу «deepseek harness как установить»: текст отдали 10 из 10, медиана объёма читаемого текста топа — 1511 слов, метку 2026 года несут 9 из 10 прочитанных страниц.

Что такое DeepSeek Harness и зачем он нужен

DeepSeek Harness (dsh) — открытый агентный рантайм DeepSeek AI, выпущенный в статусе developer preview примерно 13 августа 2026 года под лицензией MIT, по данным обзора на CometAPI. В обзоре на AIReiter формула описана так: DSH — собственная оболочка DeepSeek, созданная специально для V4-Pro и V4-Flash, примерно так же, как Claude Code оптимизирован под Sonnet и Opus.

Как установить DeepSeek Harness: пошаговая инструкция

Порядок одинаков для Windows, macOS и Linux, если идти через npm. Шаг первый — проверить Node.js: команда node --version, целевой диапазон ^22.19.0 || >=24.0.0. По руководству на deepseek-harness-desktop.ru, v23 и v18, которая стоит по умолчанию в Ubuntu 24.04, вызовут синтаксические ошибки во время работы. Шаг второй — запустить npx @deepseek-ai/dsh web; пакет загрузится или возьмётся из кэша, запустит профиль Web UI и выведет адрес прослушивания — по умолчанию http://127.0.0.1:3080. Шаг третий — открыть этот адрес в браузере. Шаг четвёртый — в Settings → Models вставить API-ключ и выбрать модель, например deepseek-v4-flash или deepseek-v4-pro.

Где скачать DeepSeek Harness: репозиторий и источники

Официальные источники — репозиторий github.com/deepseek-ai/deepseek-harness, npm-пакет @deepseek-ai/dsh и сборки десктопа на download.deepseek.com/dsh-desk/. Русскоязычные материалы живут отдельно: на GitHub есть репозиторий Ragnoryok1/deepseek-harness-guide-ru с гайдом по установке, первому запуску и русскому интерфейсу, а также Leostrange/DeepSeek-Harness-Desktop-RU с русской локализацией десктопной сборки.

DeepSeek Harness Desktop: установка и настройка

Платформы ограничены: настольное приложение охватывает только Windows x64 и macOS на Apple Silicon; сборки для Intel Mac и целевой платформы Linux нет. Установщик тяжелее npm-пути — 288 МБ для .exe в Windows, образ диска 368 МБ в macOS, потому что он несёт среду выполнения внутри. Официальный клиент вышел 24 сентября 2026 года: установщик .exe или образ .dmg скачивается с download.deepseek.com/dsh-desk/, при первом запуске приложение проводит онбординг, а при закрытом окне продолжает работать в фоне.

DeepSeek Harness для Windows: требования и ошибки

Типичная ошибка на Windows — версия Node.js вне диапазона ^22.19.0 || >=24.0.0. Вторая — ожидание мгновенного старта: первая холодная установка тянет 61 прямую зависимость и около 1 ГБ в кэше npx. Пустой ключ в Windows проверяется командой echo $env:DEEPSEEK_API_KEY.

Как запустить DeepSeek Harness после установки

Успешный первый запуск печатает одну строку: dsh web: http://127.0.0.1:3080. Дальше работа идёт в браузере: локальное веб-приложение на 127.0.0.1:3080 с сессиями, рабочими областями и запросом разрешения перед привилегированными операциями.

Настройка DeepSeek Harness: ключ и параметры

Кастомный провайдер подключается через переменные окружения, не трогая конфигурацию:

export DEEPSEEK_API_KEY="your-gateway-key"
export DEEPSEEK_BASE_URL="https://api.ofox.ai/v1"
npx @deepseek-ai/dsh --profile headless "Reply with exactly this and nothing else: dsh-ofox-ok"

Поддерживаются официальные модели DeepSeek, пользовательские совместимые с OpenAI шлюзы и локальные модели через плагины/Ollama.

DeepSeek Harness API: подключение и использование

Программный доступ идёт через Python SDK, предназначенный для интеграции ИИ-агента dsh напрямую в Python-скрипты, автоматические конвейеры тестирования (CI/CD) или аналитические пайплайны. Ограничения платформ у SDK жёстче: официально поддерживается на Linux (x64, arm64) и macOS версии 14+ на чипах Apple Silicon; Python нужен версии 3.10+. При этом в таблице релизов на pimenov.ai у v0.1.2-rc.1 указан Windows x64 runtime для Python SDK.

DeepSeek Harness плагины: установка и расширения

Каждая возможность в harness — сменный плагин, по формулировке обзора на ofox.ai. В v0.1.6-alpha.2 от 17 сентября 2026 года появилась страница Plugins: установка, настройка, включение и отключение плагинов без перезапуска. В v0.1.7-rc.1 добавлен выбор официального, зеркального или собственного реестра плагинов.

Из расширений, описанных в руководстве на pimenov.ai: MCP — подключение MCP-серверов с обнаружением и чтением ресурсов и шаблонами URI, обновление до официального MCP SDK v2.

DeepSeek Harness Web: браузерная версия

Web-профиль — самый быстрый путь для интерактивной работы в браузере, не требующий глобальной установки пакетов. Отличия от десктопа практические: Web UI живёт, пока открыт терминальный процесс и вкладка браузера, а десктопное приложение работает в фоне при закрытом окне.

Первый запуск в браузере требует двух действий: закрыть уведомление первого запуска и ввести или пропустить ключ DeepSeek.

DeepSeek Harness DSH и DeepSeek Code Harness

DSH — сокращение от DeepSeek Harness, оно встречается в именах пакетов, профилей и релизов.

Code-линия живёт внутри того же рантайма. В обзоре на deepseek-harness.app описаны четыре режима рантайма: Standard, Code, Minimal и Creator. В релизах rc.7 и rc.8 Claude Code и Codex ставятся как субагентные Profile Bundle, режим Code становится PTC mode, а API получает минус 50% вне пика.

DeepSeek Harness бесплатно: лицензия и ограничения

Сам рантайм бесплатен: он опубликован под лицензией MIT 13 августа 2026 года. Платной остаётся модель за ним — harness обращается к V4-Pro и V4-Flash через DeepSeek API, поэтому использование оплачивается по числу токенов. Отдельная цена на сам harness пока не объявлена.

Локальный путь через Ollama исключает оплату токенов, но требует своего GPU.

DeepSeek Agent Harness: агентные сценарии

Agent harness — это слой, который превращает модель в агента. Продолжаемым субагентам доступны очередь сообщений, Steer и остановка; по умолчанию одновременно поддерживается до 8 субагентов с глубиной делегирования 1, по данным руководства на pimenov.ai. В v0.1.7-rc.1 появилась панель Agent Team.

Сценарии из практического руководства: запуск без терминала, локальный coding-агент, сравнение нескольких моделей, headless-анализ в CI, Python-пайплайн. Если нужен стабильный production API без частых миграций, Harness пока разумнее оценивать как экспериментальный runtime.

Решение типичных проблем при установке

Отдельная ловушка — пакеты. В обзоре на AIReiter разбирается разница между @deepseek-ai/dsh и pip install deepseek-harness: это разные пакеты, и путать их не стоит. Перед обновлением читайте примечания ко всем пропущенным версиям: формат журнала сессий менялся в v0.1.3-alpha.1, v0.1.5-alpha.1 и v0.1.7-rc.1.

Частые вопросы

DeepSeek Harness как установить одной командой?
Команда npx @deepseek-ai/dsh web скачивает пакет и поднимает веб-интерфейс на http://127.0.0.1:3080. Единственное жёсткое требование — Node.js в диапазоне ^22.19.0 || >=24.0.0. Холодная установка занимает около двух минут.

DeepSeek Harness скачать бесплатно можно?
Рантайм опубликован под лицензией MIT, платить за сам harness не нужно. Оплачивается модель за ним: harness обращается к V4-Pro и V4-Flash через DeepSeek API, поэтому расход считается по токенам.

DeepSeek Harness Windows чем отличается от остальных платформ?
Путь через npm одинаков для Windows, macOS и Linux. Десктопное приложение при этом охватывает только Windows x64 и macOS на Apple Silicon.

DeepSeek Harness плагины как подключить?
С v0.1.6-alpha.2 в интерфейсе есть страница Plugins: установка, настройка, включение и отключение плагинов без перезапуска. В v0.1.7-rc.1 добавлен выбор официального, зеркального или собственного реестра плагинов.

DeepSeek Harness API нужен ли ключ DeepSeek?
Ключ необходим для доступа к флагманским моделям deepseek-v4-pro и deepseek-v4-flash. Он вводится в Settings → Models либо задаётся переменными окружения DEEPSEEK_API_KEY и DEEPSEEK_BASE_URL. Второй путь позволяет направить dsh на совместимый с OpenAI шлюз, не трогая конфигурацию.

Если планируете сравнивать агентные оболочки, посмотрите разбор Cline в России и материал про Copilot в России. Для работы с генеративными сервисами пригодятся заметки про лимиты Шедеврума и разбор ситуации, когда Google AI Studio не работает.