DeepSeek Harness вышел не так давно, а уже собрал вокруг себя толпу разработчиков, которые хотят держать ИИ-агента под рукой. Интерфейс приятный, модели сильные, но установка... Тут многие спотыкаются. Я прошёл через три способа установки, наступил на грабли с Node.js и понял, как объяснить это человеческим языком. Ниже - рабочие варианты для Windows, macOS и Linux.
Десктопная версия для Windows и macOS: проще некуда
Если у вас Windows x64 или Mac на Apple silicon, терминал не понадобится. Официальный сайт deepseek.com/harness предлагает готовые установщики: .exe на 289,3 МБ для Windows и .dmg на 369,8 МБ для macOS. Скачивайте только оттуда, в GitHub releases установщиков нет.
В десктопной сборке уже встроен свой Node.js. Ставить его отдельно не нужно, а команда dsh добавляется в систему через пункт меню Manage dsh Command. Установка сводится к скачиванию, запуску и паре кликов.
Есть подводный камень: у установщика для Windows бывает отказ распаковки с ошибкой Access denied. Лечится просто: запустите установщик от имени администратора. У меня на чистой Windows 11 всё сработало с первого раза, а знакомый на Windows 10 наступил на эти грабли. Учтите это заранее.
Установка через npx: основной путь для Linux и Web UI
На Linux десктопной версии нет. Поэтому официальный способ запуска - Web UI через npx. Потребуется Node.js не ниже 22.19, лучше 24+. Если у вас установлен Node.js, команда выглядит так:
npx @deepseek-ai/dsh web
После запуска интерфейс поднимется на 127.0.0.1:3080 и сам откроется в браузере. Пакет не устанавливается, npx подтягивает всё на лету. На Reddit этот вариант хвалят за то, что он не трогает систему и не требует прав администратора.
Глобальная установка через npm для тех, кто любит стабильность
Мне не нравится вводить длинную команду каждый раз, поэтому предпочитаю глобальную установку. После неё в терминале доступна короткая команда dsh. Делается это так:
npm install -g @deepseek-ai/dsh
Затем проверяем версию:
dsh --version
Перед установкой обновите Node.js хотя бы до 22.19. На более старых версиях пакет может ругаться или работать нестабильно. Версии проверяются так:
node -v
npm -v
У меня, например, стоит v24.19.0 и npm 11.17.0 - все летает.
Сборка из исходников для тех, кто правит среду
Если хотите модифицировать сам Harness или просто фанат ручного управления, исходники лежат на GitHub в репозитории deepseek-ai. Сборка занимает около пяти команд, но тут потребуются Git, Node.js и понимание того, что вы делаете. Обычным пользователям этот путь не нужен, но такая возможность есть.
Настройка API ключа и первый запуск
Установить и запустить - полдела. При первом старте среда попросит ключ DeepSeek API с platform.deepseek.com или вход через аккаунт DeepSeek. Ключ вводится на вкладке Models в Settings. Если входите через аккаунт, в настройках виден баланс, бонусные кредиты, а также кнопки Usage и Top up.
Важный момент для пользователей из России: бесплатного лимита при входе нет. При нулевом балансе сразу выскакивает окно Top up. Оплатить напрямую с российской карты не получится: DeepSeek с нами не дружит в этом плане. Тут многие застревают.
Здесь выручает 3GPT от 3SELLER. Это ИИ-роутер с доступом из России к последним флагманским моделям: Chat GPT 6 Astra, Claude Fable 5, Claude Opus 5.5, Nano Banana для изображений, генерация видео и многим другим. Всё это от 149 ₽, оплата российской картой, через СБП или крипту. Подключаете API-ключ от 3GPT в Harness - и работаете без иностранных карт.
Дальше всё просто. После ввода ключа DeepSeek Harness готов к работе. В Web UI схема та же, что и в десктопе. Можно отправлять первые запросы.
Частые проблемы при установке и их решение
Собрал типичные грабли, на которые наступают почти все:
Ошибка Access denied при установке на Windows - запустите установщик от имени администратора. Лечится за секунду, но сбивает с толку.
Команда dsh не найдена после установки - проверьте, добавился ли путь в PATH. На macOS и Windows десктопная версия делает это сама, на Linux через npx проблема не возникает, но при глобальной установке может быть.
Node.js слишком старый - просто обновите. Минимальная версия 22.19, рекомендую последнюю LTS.
Интерфейс не открывается после npx - проверьте, что порт 3080 не занят. Если занят, убейте процесс или смените порт через флаги.
Самый частый затык - нулевой баланс и отсутствие возможности оплатить API из России. С этим справляется 3GPT: регистрируетесь, пополняете баланс российской картой или через СБП, получаете ключ и вставляете его в Harness. Всё работает так же, как с официальным ключом.
Установка DeepSeek Harness занимает не больше 10 минут, если идти правильным путём. Десктоп для Windows и macOS, npx для Linux, глобальная установка для тех, кто ценит удобство. Главное - решите вопрос с API заранее, иначе упрётесь в стену при первом запуске. Если вы в России, сразу идите на 3GPT, чтобы не терять время. Дальше останется только запустить Harness и отправить первый запрос.