DeepSeek Harness штука интересная. Это не очередная обертка над API, а полноценный агентный каркас от самой DeepSeek. Он читает файлы в твоем проекте, пишет код, запускает его, показывает каждый шаг и умеет искать в вебе. Все крутится локально, прямо в браузере. Разбираемся, как поставить DeepSeek Harness на свою машину и не наступить на грабли.
Что такое DeepSeek Harness и почему о нем говорят
Если коротко, это агентный фреймворк для программирования. Сейчас он в статусе developer preview, но работает вполне бодро. Фишка в том, что внутри все устроено как конструктор: инструменты, модели, навыки и даже другие агенты подключаются как плагины. Хочешь поставить вместо стандартной модели что-то другое? Пожалуйста. Хочешь добавить Codex или Claude Code как внешнего агента? Тоже можно.
Основное окно взаимодействия - локальное веб-приложение. Запустил команду, открыл браузер, работаешь. Никаких облачных панелей, все данные остаются у тебя. Модель при этом ходит через DeepSeek API, так что за токены платишь как обычно, по факту использования.
Что понадобится для установки
Перед тем как ставить DeepSeek Harness, проверь, что у тебя есть две вещи:
- Node.js версии не слишком древней. Подойдет любая свежая, точная версия не критична
- Аккаунт на platform.deepseek.com, чтобы получить API-ключ
Еще понадобится pnpm, но его можно поставить через npm одной командой. Никаких дополнительных ключей для веб-поиска не нужно. Встроенный поиск использует тот же DEEPSEEK_API_KEY, что и основные модели. Приятная деталь.
Ставим Node.js и pnpm
Без Node.js никуда. Harness написан на JavaScript и запускается именно через него. Проверяем наличие:
node --version
Если команда не нашлась или версия старая, идем на официальный сайт Node.js и ставим LTS-версию. Дальше пакетный менеджер. Глобально ставим pnpm:
npm install -g pnpm
Это займет секунд двадцать. После этого можно переходить к самому интересному.
Установка DeepSeek Harness из исходников
Официальный quick start любит запускать через npx, но я предпочитаю глобальную установку. Так проще: один раз поставил, и команда dsh доступна отовсюду. Клонируем репозиторий и ставим из исходников. Этот путь, кстати, работает надежнее остальных способов установки.
npm install -g @deepseek-ai/dsh
После установки проверяем, что все встало корректно:
dsh --version
Если видишь номер версии, считай, полдела сделано.
Получаем API-ключ DeepSeek
Без ключа Harness не запустит ни одну агентскую задачу. Веб-поиск, работа с файлами, все это заблокировано, пока не добавишь ключ. Идем на platform.deepseek.com, заходим в раздел API keys и создаем новый. Обращайся с ключом как с паролем от банка. Не коммить его в репозиторий и тем более не показывай в скринкастах.
Ключ можно вставить сразу при первом запуске веб-интерфейса, а можно добавить позже через Settings → Models. Так что если пропустил, не страшно.
Запускаем веб-интерфейс
Все готово, пора запускать. В терминале выполняем:
dsh web
По умолчанию интерфейс поднимется на порту 3080. Открываешь браузер, переходишь на localhost:3080 и видишь рабочую панель. Порт можно поменять, если занят, но обычно дефолтный подходит. Первый запуск встретит тебя запросом API-ключа. Вставляешь, сохраняешь, продолжаешь.
Дальше нужно выбрать рабочую папку. Это каталог, с которым агент будет работать: читать файлы, создавать новые, запускать код. Отнесись к выбору серьезно. Не надо указывать корень системы, иначе Harness будет сканировать все подряд.
Почему стоит попробовать локальный запуск
Главное преимущество такого подхода в том, что ты не привязан к одной модели, одному набору инструментов или одному типу агента. Начинаешь с дефолтной конфигурации, потом потихоньку добавляешь компоненты. Захотел другую модель - поменял. Захотел подключить внешний агент - вставил плагин. Это гибко, и это реально работает. На Reddit такой подход особенно хвалят: Harness называют конструктором, а не очередной залоченной оберткой.
Еще момент: модель ходит через DeepSeek API, но рантайм и все инструменты живут локально. То есть код не уходит в чужое облако, файлы не загружаются на сторонние серверы. Для тех, кто работает с чувствительными данными, это весомый аргумент.
Если установка кажется сложной, есть лайфхак
Честно признаюсь: локальная установка Harness требует прямых рук и пары минут времени. Если хочется пользоваться агентами прямо сейчас, без возни с Node.js, ключами и портами, есть готовые решения.
К примеру, ИИ-роутер 3GPT от 3SELLER дает доступ ко всем флагманским нейросетям из России: Chat GPT 6 Astra, Claude Fable 5, Claude Fable 5.1, Claude Opus 5.5, Chat GPT 5.5, Chat GPT 6.1 Sol, Nano Banana для изображений и генерация видео. Иностранные карты не нужны. Не DeepSeek Harness, конечно, это другая экосистема. Но если твоя задача - просто получить рабочего агента и не собирать его из кирпичиков, то вариант рабочий. Пополнить баланс можно российской картой, через СБП или криптой. Получить доступ можно на официальном сайте 3GPT от 3SELLER.
Внутри есть и готовые ИИ-агенты под разные задачи: пишешь тексты, генерируешь картинки, делаешь видео. Модель агента можно менять прямо в чате. Это удобно, когда нет времени разбираться в плагинах. Подробности на странице агентов.
Первые шаги после запуска Harness
Когда интерфейс открылся и ключ введен, начинай с простого. Попроси агента посмотреть структуру проекта, объяснить, что делает конкретный файл, или напиши маленький скрипт. Например: «Посмотри файл src/index.ts и объясни, что он делает». Важно понять, как агент мыслит. Он показывает каждый шаг, так что ты видишь его логику и можешь поправить в любой момент.
Обязательно поиграй с веб-поиском. Он включается автоматически после добавления ключа и работает без отдельного API. Просто попроси агента найти свежую информацию по какой-нибудь теме, и он соберет ответ из веба, а не из застывшего training data.
Типичные грабли при установке
У людей чаще всего возникают три проблемы. Первая: старый Node.js. Если версия древняя, установка падает с непонятными ошибками. Лечится обновлением. Вторая: забыли ключ. Без ключа Harness работает в урезанном режиме, веб-поиск молчит. Третья: порт занят. Если 3080 уже используется, интерфейс не откроется. Решение простое - поменять порт в конфиге. На Reddit эти грабли всплывают в каждом втором треде, так что ты не один такой.
И не пугайся, если интерфейс выглядит спартански. Это нормально для developer preview. Все нужные функции на месте, просто без излишеств.
Кстати, если у тебя уже есть доступ к 3GPT, то можно обойтись без локальной установки как таковой. Все флагманские модели, включая свежие Chat GPT 6 и Claude Fable 5, доступны из браузера без танцев с Node.js. Иногда проще заплатить 149 рублей и работать, чем час настраивать окружение.
Что дальше
Понял, как работает базовый Harness, - углубляйся в плагины. Подключи внешние инструменты, создай собственные навыки, попробуй скомбинировать несколько агентов в одном проекте. Фреймворк позволяет менять все что угодно, и в этом его сила.
А если локальный запуск не твой путь, просто возьми готового агента в 3GPT. В любом случае, выбор за тобой. Главное, чтобы инструмент работал, а не пылился в углу.