DeepSeek Harness — это открытая среда для запуска AI-агентов на компьютере. В отличие от обычного чата с нейросетью, Harness может работать с файлами проекта, запускать команды в терминале, изменять код, проверять результат, использовать инструменты и передавать отдельные задачи субагентам. При этом сам DeepSeek Harness не является языковой моделью: к нему нужно подключить DeepSeek, OpenAI или другого поддерживаемого провайдера.

Установка довольно простая: установить Node.js, выполнить одну команду в терминале, открыть локальный веб-интерфейс, подключить API-ключ и выбрать рабочую папку. Но есть важная оговорка: на 2 сентября 2026 года DeepSeek Harness официально имеет статус developer preview. Разработчики прямо предупреждают о возможных несовместимых изменениях и не называют продукт готовым для production.

Что такое DeepSeek Harness простыми словами

Термин agent harness можно перевести как «среда выполнения AI-агента». Языковая модель отвечает за рассуждение и принятие решений, а Harness даёт ей инструменты для выполнения этих решений.

Упрощённо процесс выглядит так:

Вы выбираете рабочую папку — Workspace.
Ставите задачу обычным текстом.
DeepSeek Harness передаёт её выбранной языковой модели.
Модель изучает файлы и решает, какие инструменты использовать.
Harness читает или изменяет файлы, запускает команды и получает результаты.
Модель анализирует результат и при необходимости продолжает работу.
Вы получаете не только текстовый совет, а фактически выполненную задачу.

Поэтому Harness ближе к Codex, Claude Code и другим агентным средам, чем к обычному веб-чату. Если интересна сама концепция таких систем, в блоге CenterAI есть отдельный раздел об AI-агентах и ассистентах.

Что умеет DeepSeek Harness

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

изучить структуру репозитория;
найти ошибки в коде;
изменить несколько файлов;
запустить тесты или сборку;
сравнить конфигурационные файлы;
проанализировать Markdown, JSON, CSV и другие текстовые данные;
составить план работ;
делегировать части большой задачи субагентам;
создавать собственные расширения и конфигурации Harness.

Архитектура DeepSeek Harness построена по принципу «everything is a plugin»: модельные адаптеры, инструменты, работа с сессиями и многие другие компоненты подключаются как плагины. Это делает Harness интересным не только как готового AI-агента, но и как платформу для создания собственных агентных систем.

Что нужно для установки DeepSeek Harness

Для обычного запуска из npm не требуется самостоятельно скачивать исходный код с GitHub. Нужны три вещи:

компьютер с Windows, macOS или Linux;
совместимая версия Node.js;
API-ключ хотя бы одного поставщика языковой модели.

Исходный репозиторий DeepSeek Harness указывает требование Node.js 22.19 или новее в ветке 22 либо Node.js 24+. На момент проверки актуальная LTS-версия Node.js — 24.20.0, поэтому для новой установки проще использовать именно Node.js 24 LTS.

Скачать Node.js можно с официального сайта: Node.js Download.

Отдельная видеокарта для работы Harness с облачными API не нужна: сама модель выполняется на серверах DeepSeek, OpenAI или другого провайдера. Но говорить, что продукт запустится «абсолютно на любом компьютере», было бы неправильно. Локально всё равно работают Node.js, терминал, инструменты агента, ваши тесты и приложения.

Как установить DeepSeek Harness

Шаг 1. Установите Node.js

Скачайте актуальную LTS-версию Node.js с официального сайта Node.js и выполните обычную установку для своей операционной системы.

После установки откройте PowerShell, Windows Terminal, Terminal на macOS или терминал Linux и проверьте версию:

node -v

Желательно использовать Node.js 24 LTS.

Шаг 2. Запустите DeepSeek Harness

Официальный способ запуска через npm состоит всего из одной команды:

npx @deepseek-ai/dsh web

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

http://127.0.0.1:3080

При локальном запуске браузер обычно открывается автоматически.

Официальный репозиторий проекта: DeepSeek Harness на GitHub.

Официальное руководство по Web UI: DeepSeek Harness — Use the Web UI.

Шаг 3. Выберите рабочую папку

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

Например, это может быть:

папка проекта сайта;
репозиторий Python-приложения;
папка Telegram-бота;
отдельная директория с документами и конфигурациями;
тестовая копия проекта.

В новом Web UI ввод сообщения недоступен, пока Workspace не выбран.

Как подключить DeepSeek

Если вы хотите использовать модели самого DeepSeek, откройте Settings → Models. В интерфейсе уже есть встроенный провайдер DeepSeek — достаточно вставить API-ключ и сохранить настройки.

API-ключ создаётся в официальном кабинете: DeepSeek Platform — API Keys.

Документация API: DeepSeek API Docs.

В стандартном каталоге Harness присутствуют, в частности:

DeepSeek V4 Flash — более дешёвый вариант для большого количества повседневных задач;
DeepSeek V4 Pro — более дорогая модель для задач, где требуется более сложное рассуждение.

Обе модели поддерживают tool calling и предназначены в том числе для агентных сценариев. Актуальные характеристики и стоимость лучше проверять непосредственно на странице Models & Pricing, поскольку тарифы могут меняться.

Как подключить OpenAI к DeepSeek Harness

Использовать именно модели DeepSeek необязательно. В Harness есть каталог других провайдеров, включая OpenAI.

Чтобы подключить OpenAI:

Откройте Settings → Models.
Нажмите Add provider.
Выберите OpenAI.
Введите API-ключ OpenAI.
Сохраните настройки.
Выберите нужную модель в переключателе моделей новой сессии.

Для обычного OpenAI не нужно вручную прописывать Base URL: Harness использует встроенный каталог провайдера, где уже определены endpoint, протокол и модели.

Создать API-ключ можно в OpenAI Platform.

Важно: подписка ChatGPT и OpenAI API оплачиваются отдельно. Наличие ChatGPT Plus или Pro само по себе не предоставляет оплаченный API-баланс.

В актуальной линейке OpenAI для агентных и программных задач можно ориентироваться на GPT-5.6 Luna как экономичный вариант, GPT-5.6 Terra как промежуточный и GPT-5.6 Sol для более сложного программирования и рассуждений. Конкретный список в Harness зависит от установленного каталога и доступности моделей для вашего API-аккаунта.

Можно ли подключить другой API

Да. В разделе моделей есть отдельный пункт Add a custom provider. Он предназначен для корпоративных шлюзов, self-hosted моделей и других OpenAI-совместимых сервисов.

Для такого подключения задаются:

Provider ID;
отображаемое название;
Base URL;
API-протокол;
API-ключ;
одна или несколько моделей.

Это более продвинутый сценарий. OpenAI и другие провайдеры, уже присутствующие в каталоге Harness, лучше добавлять через обычный Add provider, а не через Custom Provider.

Какой режим доступа выбрать

Это одна из самых важных настроек DeepSeek Harness. AI-агент способен выполнять реальные команды и изменять реальные файлы.

На уровне sandbox Harness поддерживает три режима работы с файловой системой:

read-only — запрет изменения файлов;
workspace-write — разрешение записи внутри Workspace;
danger-full-access — снятие файлового ограничения.

При этом стандартная конфигурация Web UI по умолчанию использует preset Workspace Write. Именно его стоит оставлять для большинства обычных задач.

Workspace Write

Агент может изменять файлы внутри выбранного Workspace. Для действий, требующих более широких разрешений, применяется механизм подтверждения.

Это разумный вариант для разработки и повседневной работы.

Danger Full Access

В этом режиме файловая изоляция отключается. В стандартном preset Harness он также связан с политикой выполнения без постоянного запроса подтверждения.

Не включайте Full Access просто ради удобства. Для экспериментов с таким режимом лучше использовать отдельную виртуальную машину, контейнер или другой изолированный компьютер.

Есть ещё один важный нюанс: sandbox-mode Harness в первую очередь регулирует изменения файловой системы. Видимость сети и процессов не входит в эту конкретную модель ограничений. Подробнее о принципах минимальных прав для AI-агентов мы писали в материале «Безопасность AI-агентов: как ограничить доступ к почте, CRM и данным».

Standard и Creator: чем отличаются режимы агента

Помимо разрешений на файлы, DeepSeek Harness использует agent presets — наборы инструментов и настроек конкретного агента.

Standard

Это основной режим для обычной работы с проектом. Агент получает инструменты для работы с файлами, терминалом, планированием и делегированием задач.

Начинать знакомство с Harness имеет смысл именно со Standard.

Creator

Creator предназначен для изменения и расширения самого агентного окружения. Архитектура Harness позволяет собирать собственные agent presets и плагины, а Creator предоставляет агенту инструменты для работы с этой системой.

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

Если вам интересна похожая концепция расширения AI-инструментов, можно сравнить её с подходом OpenAI Codex в руководстве «Skills и Plugins в Codex: как выбрать, установить и применять в работе».

Как работать с DeepSeek Harness на практике

После подключения модели и выбора Workspace можно давать агенту обычные задания на русском языке.

Например:

Изучи весь проект. Ничего пока не изменяй. Найди архитектурные проблемы, потенциальные ошибки и дублирование кода. Создай список задач по приоритету.

После анализа можно продолжить:

Исправь первую задачу. Не трогай остальные части проекта. После изменений запусти существующие тесты и проверь результат.

Такой подход обычно безопаснее, чем команда «исправь всё», потому что результат проще контролировать и откатывать.

Что такое субагенты в DeepSeek Harness

Harness поддерживает делегирование работы дочерним агентам. Главный агент может передать отдельную задачу субагенту и затем использовать полученный результат.

Например, большую проверку приложения можно разделить на:

аудит backend;
аудит frontend;
поиск проблем безопасности;
проверку тестов;
анализ документации.

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

Если несколько агентов должны одновременно редактировать один репозиторий, безопаснее сознательно разделять им рабочие каталоги, Git worktree, контейнеры или другой механизм изоляции.

Что такое Trajectory

Trajectory — подробное представление событий сессии. Оно показывает не только итоговый ответ модели, но и действия агента: обращения к инструментам, результаты вызовов, шаги и границы отдельных turn.

В интерфейсе можно изучать, например:

какой инструмент был вызван;
его входные и выходные данные;
сколько времени заняло действие;
информацию об использовании токенов;
последовательность действий агента.

Для отладки агентных систем это значительно полезнее обычной истории чата: можно увидеть не только неправильный итог, но и место, где агент начал двигаться по неправильной траектории.

Как работает ветвление сессии

DeepSeek Harness поддерживает fork сессии. Новая ветка получает историю исходной сессии до выбранной завершённой точки, после чего её можно продолжить независимо.

Это удобно, если первая половина сложной задачи выполнена правильно, а затем агент выбрал неудачное решение. Вместо повторного запуска всего процесса можно создать ветку от успешной точки и дать другое указание.

Но fork сессии — это прежде всего ветвление истории агента. Его не следует автоматически считать созданием отдельной копии файлов проекта.

Можно ли устанавливать плагины

Да. DeepSeek Harness позволяет подключать дополнительные plugin bundles. В официальной документации для этого используется команда вида:

dsh plugin —profile web add ИМЯ_ПАКЕТА

Плагины могут добавлять новые инструменты, интерфейсные компоненты и поведение агента.

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

Поэтому перед установкой стороннего плагина желательно:

проверить исходный код;
проверить автора и репозиторий;
посмотреть актуальные issues;
не запускать непроверенный код на машине с рабочими секретами;
для экспериментов использовать отдельное окружение.

Насколько DeepSeek Harness безопасен

Сам DeepSeek формулирует это достаточно однозначно: Harness является экспериментальным developer-preview продуктом, не проходил security audit и не должен считаться production-ready.

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

Минимальные правила:

оставлять Workspace Write вместо Full Access;
делать резервные копии;
не давать агенту лишние секреты;
не открывать ему домашний каталог целиком без необходимости;
не ставить неизвестные плагины;
для рискованных экспериментов использовать VM или контейнер.

Кому стоит попробовать DeepSeek Harness

В нынешнем виде Harness особенно интересен разработчикам и техническим специалистам, которые хотят не просто разговаривать с моделью, а дать ей контролируемый набор реальных инструментов.

Типичные сценарии:

разработка и рефакторинг кода;
диагностика существующих проектов;
автоматизация повторяющихся технических операций;
эксперименты с мультиагентными системами;
создание собственных инструментов для AI-агента;
исследование архитектуры agent harness.

Для критичных production-процессов продукт пока разумнее рассматривать как экспериментальную платформу, а не как готовый автономный исполнитель.

Кратко: установка DeepSeek Harness с нуля

Установить Node.js 24 LTS.
Открыть терминал.
Выполнить npx @deepseek-ai/dsh web.
Открыть Web UI, если браузер не открылся автоматически.
В Settings → Models добавить DeepSeek или, например, OpenAI.
Выбрать Workspace.
Оставить Workspace Write для обычной работы.
Выбрать модель.
Начать новую сессию и поставить первую задачу.

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

Если задача состоит не в эксперименте с Harness, а в создании рабочего AI-агента под конкретный бизнес-процесс, можно обсудить архитектуру и MVP с CenterAI.

FAQ

DeepSeek Harness бесплатный?

Сам проект опубликован как open-source под лицензией MIT. Но обращения к DeepSeek, OpenAI и большинству облачных моделей оплачиваются по тарифам соответствующего API.

Обязательно ли использовать DeepSeek?

Нет. Harness поддерживает других провайдеров. В официальной документации прямо приведены OpenAI и Anthropic, а также предусмотрено подключение custom provider.

Нужна ли мощная видеокарта?

Для работы с облачным API — нет. Модель выполняется на сервере провайдера. Однако команды, тесты, сборка проекта и другие локальные процессы выполняются на вашем компьютере.

Можно ли установить DeepSeek Harness на Windows?

Да. Архитектура Harness предусматривает локальные sandbox-механизмы для Linux, macOS и Windows. При этом разработчики отмечают различия в уровне изоляции между платформами, поэтому sandbox нельзя считать абсолютной защитой.

Можно ли подключить OpenAI?

Да. Откройте Settings → Models → Add provider → OpenAI и добавьте API-ключ. Создавать Custom Provider для стандартного OpenAI не требуется.

Заменяет ли Harness разработчика?

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

Источники и проверка

Дата последней проверки: 02.09.2026

DeepSeek Harness: что это такое и как установить AI-агента