DeepSeek Harness: установка, модель и плагины по шагам

Вы решили попробовать DeepSeek Harness – бесплатный кодинг-агент вместо Claude Code. Но инструкции в сети расходятся: у одних команда работает, у других падает, а что и куда подключать, непонятно. Я решил разложить всё по шагам и с привязкой к версии: установка, подключение модели и сборка рабочего места плагинами. За вечер у вас будет работающий Harness с моделью DeepSeek или любого другого провайдера, 2–3 проверенными плагинами и скиллами, перенесёнными из Codex. А пробовать его стоит ради одной особенности: плагин здесь меняет само рабочее место (добавляет панели, темы и инструменты) без правки кода.

Что такое DeepSeek Harness и почему это не модель

Название сбивает с толку: Harness – это среда, в которой работает агент, а не новая нейросеть DeepSeek. Предварительную версию DeepSeek выпустила 13 августа 2026 года. В мае 2026 года DeepSeek использовала в описании вакансий формулу «модель + harness = агент». Модель думает и пишет код, а harness – это слой поверх неё: проекты, доступ к файлам, инструменты, интерфейс.

Отсюда главное практическое следствие: в отличие от Codex и Claude Code, Harness не привязан к моделям своего разработчика. Подключить можно модель DeepSeek по API-ключу, а можно любого другого провайдера, например через OpenRouter.

По базовым возможностям Harness похож на конкурентов: в нём есть проекты, доступ к файлам, поддержка скиллов и MCP. Обычный сценарий такой же, как в Claude Code: открываете папку проекта, ставите задачу в чате, даёте агенту доступ к файлам и смотрите на результат.

Отличие в архитектуре: плагины в Harness не висят сбоку, на них держится вся система. Они могут добавить кнопку, панель, тему оформления, инструмент для агента или новый способ работы с моделью. То есть из плагинов вы собираете своё рабочее место.

Как установить Harness: приложение или одна команда в терминале

Способов два.

Приложение. Зайдите на официальный сайт, выберите свою операционную систему и скачайте установщик. Подходит, если разбираться с терминалом достаточно лень.

Команда в терминале. Веб-версия запускается без отдельного инсталлятора:

npx @deepseek-ai/dsh web

Интерфейс при этом откроется в браузере, а для такого запуска нужен Node.js. На 10 октября 2026 года подходят версии 22.19.0 и новее в ветке 22 либо любая 24-я и новее. Двадцатая ветка не поддерживается, а npm об этом не предупредит: установка пройдёт, сбой случится позже и с разными ошибками. Поэтому при любой странной ошибке сначала смотрите node -v. Если выбирать, берите 24-ю: в ней npm 11, и npx не запускает старую закэшированную сборку.

Поэтому сценарии разделяем: для знакомства хватит npx (лучше с явной версией npx @deepseek-ai/dsh@0.2.0-rc.2 web). Для постоянной работы (например, если агент крутится на VPS и должен подниматься после перезагрузки) ставьте пакет глобально и тоже с зафиксированной версией: npm install -g @deepseek-ai/dsh@0.2.0-rc.2, затем dsh --version и dsh web. Если dsh не находится, каталог bin для npm не прописан в PATH – путь к нему покажет npm prefix -g. Интерфейс отвечает только на 127.0.0.1:3080, так что на VPS снаружи он сразу не откроется. Обновляйтесь осознанно, когда проверите новую сборку.

Подключение модели: ключ DeepSeek или любой провайдер

Без модели Harness – пустая оболочка, а настройка делается в интерфейсе за несколько минут.

Вариант 1. Модель DeepSeek

Откройте вкладку Models и вставьте API-ключ DeepSeek, дальше уже модели DeepSeek доступны для работы.

Вариант 2. Любой провайдер, например OpenRouter

1. Во вкладке Models нажмите Add Model Provider.
2. Выберите Custom Model API и укажите Base URL провайдера.
3. Вставьте API-ключ из кабинета провайдера.
4. Нажмите Add Model, вставьте ID нужной модели и задайте ей понятное имя.
5. Если модель принимает изображения, отметьте поддержку картинок (тогда в чат можно будет отправлять скриншоты – мелочь, а приятно).
6. Нажмите Create Provider, вернитесь на главную и выберите новую модель.

Проверка первой задачей

Откройте папку проекта, дайте агенту доступ к файлам и поставьте простую задачу. В одном тесте бесплатная на время стелс-модель с OpenRouter сделала страницу с заголовком и одной карточкой за 52 секунды – это проверка связки, а не замер скорости. Если агент прочитал файлы, создал страницу и вы видите результат, связка работает.

Плагины Harness: собираем рабочее место под себя

Сначала о терминах, их тут легко перепутать. Скилл – это инструкции и материалы агенту под конкретную задачу. Плагин меняет саму среду: добавляет панели, кнопки, инструменты и в том числе управляет скиллами.

Порядок сборки:

1. Каталог. Откройте Settings→Plugin Market, установите DSH Market, который там предлагается первым, и перезапустите приложение. Это каталог, через который ищутся и ставятся остальные плагины.
2. Управление скиллами. Найдите в поиске DSH Skill Explorer. Перед установкой прочитайте описание и проверьте автора, и только после этого ставьте.
3. Перенос скиллов. Поставьте Skills Management: появится раздел со скиллами, которые уже лежат у других агентов на компьютере, например у Codex или Claude Code. Внешний скилл импортируется в Harness, дальше вы управляете своей копией. Для Codex: откройте скилл и нажмите Install from Codex.
4. Правая панель. Плагин правой панели добавляет просмотр изменений, которые внёс агент, список задач для него и дополнительный чат. С ним удобнее контролировать, что агент сделал с файлами. После установки снова перезапустите приложение.

На этом шаге Harness и начинает отличаться от конкурентов: вместо готового интерфейса у вас среда, где нужные панели добавлены под ваш способ работы.

DeepSeek Harness против Claude Code: где выигрывает и где уступает

Честно о главном: серьёзных сравнений качества работы Harness и Claude Code на одинаковых задачах мало. В единичном тесте в августе 2026 года обе среды с моделью Claude Sonnet 5 исправили одну и ту же ошибку в небольшой библиотеке на TypeScript: патчи вышли одинаковыми, все 10 тестов прошли, но Claude Code уложился в 55 секунд, а Harness – в 125,4, и замер был один. О Harness с моделями DeepSeek этот тест ничего не говорит. Поэтому сравнивать стоит прежде всего устройство.

Где Harness выигрывает. Свобода выбора модели и рабочее место, которое собирается плагинами. Если вы хотите платить за дешёвую модель или переключаться между провайдерами, а интерфейс настроить под себя, это его сильная сторона.

Где уступает. Нестабильность preview: Harness вышел 13 августа 2026 года, и только с 19 августа по 9 октября появилось ещё 24 версии, так что без фиксации версии инструкция из прошлой недели может не сработать. Плюс каждый плагин – это код с правами агента, и проверять его приходится самому.

Есть и обратный путь: если вам нужна в первую очередь дешёвая модель, а не новая среда, DeepSeek V4 можно подключить прямо к Claude Code через Anthropic-совместимый API, и тогда переходить никуда не обязательно. Экономию даёт модель, а не среда: на май 2026 года DeepSeek V4 Flash стоила $0,14 за миллион входных токенов, Claude Opus 4.7 – $15; нынешние цены уточните у провайдеров.

В итоге Harness подойдёт тем, кому важны выбор модели и настраиваемое рабочее место и кто готов следить за версиями. Если же нужна предсказуемая среда без экспериментов, разумнее остаться на Claude Code.

Ключевые термины

• Harness (агентская среда) – Программа поверх модели, которая управляет циклом агента, инструментами, правами доступа и состоянием сессии.
• Плагин – Подключаемый модуль, который добавляет в Harness кнопку, панель, тему, инструмент для агента или способ работы с моделью.
• Скилл – Набор инструкций и материалов, который объясняет агенту, как выполнять конкретную задачу.
• MCP – Способ дать агенту инструменты внешнего сервиса, например доступ к Notion.
• Developer preview – Предварительная стадия проекта, в которой возможны изменения, ломающие совместимость между сборками.
• npx – Средство запуска пакетов из npm, которое загружает пакет по требованию без постоянной установки.

Итог: как начать без лишнего риска

Чтобы первая неделя с Harness прошла без сюрпризов, пройдите короткий список:

• Node.js 22.19.0+ или 24+ (двадцатая ветка не подойдёт).
• Версия Harness зафиксирована в команде установки или запуска.
• Модель подключена (ключ DeepSeek или провайдер через Custom Model API) и проверена на простой задаче.
• Установлены 2–3 плагина с проверенными автором и доступами.
• Нужные скиллы перенесены из Codex или Claude Code через Skills Management.

Проверьте себя

1. Вы хотите работать в Harness с моделью не от DeepSeek. Это возможно?

• А. Да, но только через отдельную платную подписку DeepSeek
• Б. Нет, Harness работает только с моделями DeepSeek
• В. Да, через Add Model Provider и Custom Model API с Base URL и ключом провайдера

2. Команда установки из инструкции месяц назад сегодня ведёт себя иначе. Что лучше сделать?

• А. Выполнить npm cache clean --force и повторить
• Б. Указать диапазон версий вроде ^0.1.0
• В. Указать точную версию пакета в команде или глобальной установке

3. На сервере стоит Node 20. Чего ожидать при запуске Harness?

• А. Всё заработает, Node 20 поддерживается
• Б. npm заблокирует установку с понятной ошибкой
• В. Установка может пройти, но работа сломается позже; нужен Node 22.19+ или 24+

4. Чем плагин в Harness отличается от скилла?

• А. Плагин – это доступ к внешнему сервису, например Notion
• Б. Скилл – инструкции агенту под задачу, а плагин меняет саму среду: панели, темы, инструменты
• В. Ничем, это два названия одного и того же

5. Вы нашли в каталоге полезный плагин от неизвестного автора. Что важно учесть?

• А. Плагины изолированы и ни на что не влияют
• Б. Можно ставить всё подряд и удалить лишнее потом
• В. Плагин работает с правами агента, поэтому до установки стоит проверить описание, автора и доступы