DeepSeek Harness (dsh): что это, как установить и подключить API
DeepSeek Harness — это открытый рантайм для ИИ-агентов от DeepSeek: программа, которая даёт языковой модели цикл работы, инструменты, песочницу и интерфейс, чтобы она могла выполнять задачи на вашем компьютере. Запускается командой dsh, распространяется по лицензии MIT и подключается не только к моделям DeepSeek, но и к любому OpenAI-совместимому API.
- Что это: агентный «обвес» вокруг модели, а не новая модель. Ближайшие аналоги — Claude Code и Codex, но у DeepSeek Harness открытый код.
- Статус: developer preview с 13 августа 2026 года, возможны несовместимые изменения между релизами.
- Запуск:
npx @deepseek-ai/dsh web— локальный веб-интерфейс за минуту. - Цена: harness бесплатный, платите за токены модели.
- Проверьте до запуска: журналы сессий при работе с официальным API по умолчанию отправляются в DeepSeek.
Что такое DeepSeek Harness
DeepSeek сама описывает идею формулой «агент = модель + harness». Модель отвечает за рассуждение и генерацию текста. Harness — это всё остальное: цикл, в котором модель получает задачу, вызывает инструмент, читает результат и решает, что делать дальше; песочница и права доступа; история сессии; интерфейс, в котором вы всё это видите.
Проект вышел 13 августа 2026 года вместе с моделью DeepSeek V4 Pro. Это Node.js-приложение на плагинном фреймворке Cordis, репозиторий лежит на GitHub, пакет в npm называется @deepseek-ai/dsh. За первые дни репозиторий собрал десятки тысяч звёзд, но стоит помнить: звёзды показывают интерес, а не зрелость. Авторы сами называют релиз ранней версией для разработчиков и предупреждают о возможных несовместимых изменениях.
Важно не путать два уровня. API DeepSeek — это HTTP-интерфейс к моделям: вы шлёте запрос и получаете текст. DeepSeek Harness — программа, которая сама ходит в этот API в цикле и превращает ответы модели в действия: правит файлы, запускает команды, ищет в вебе.
Как устроено: «всё — плагин»
Главное отличие DeepSeek Harness от большинства агентов — отсутствие «неприкосновенного ядра». Адаптер модели, реестр инструментов, журнал сессии и даже сам цикл агента — отдельные плагины, которые можно заменить через настройки, не форкая проект. Плагины собираются в пакеты (bundles), пакеты — в профили, а итоговая конфигурация складывается из нескольких слоёв, где более поздний слой перекрывает предыдущий.
Есть и обратная сторона, о которой пишут пользователи: заменить базовый плагин — не то же самое, что подправить его поведение. Если нужна небольшая правка существующей логики, вам придётся поддерживать собственную версию этого плагина.
Из готового «из коробки» и через официальные плагины: субагенты (включая запуск Claude Code и Codex как субагентов), командный режим с общей доской задач, расписание задач, работа с Office-файлами в настольной версии, MCP-клиент, поддержка файлов AGENTS.md и CLAUDE.md, а также панель траектории — таймлайн всех шагов агента с вызовами инструментов и временем выполнения. Последняя особенно полезна для отладки: видно, где именно агент свернул не туда.
Способы запуска
| Режим | Как запустить | Для чего |
|---|---|---|
| Настольное приложение | Установщик для macOS и Windows x64 | Веб-интерфейс в оболочке Electron со встроенным окружением. Сборки для Linux нет |
| Веб-интерфейс | npx @deepseek-ai/dsh web | Локальное приложение на 127.0.0.1:3080, подходит для повседневной работы |
| Headless | dsh --profile headless "запусти тесты" | Разовая задача без интерфейса: удобно для CI и скриптов |
| SDK | dsh --profile sdk | JSON-RPC через stdio; есть обёртка на Python — пакет deepseek-harness-sdk |
| ACP | dsh --profile acp | Подключение к редакторам и внешним клиентам по Agent Client Protocol |
Установка за пять минут
Нужен только Node.js. Никаких клонирований репозитория для обычного использования не требуется:
# локальный веб-интерфейс на http://127.0.0.1:3080
npx @deepseek-ai/dsh web
# другой порт
npx @deepseek-ai/dsh web --port 8080
# разовая задача без интерфейса
dsh --profile headless "прогони тесты и кратко опиши падения"
При первом запуске откройте Settings → Models и добавьте провайдера с API-ключом. Веб-профиль намеренно не принимает адрес 0.0.0.0: открыть агента с доступом к командной строке для всей сети можно только осознанно, через отдельные параметры. Это правильное поведение по умолчанию, не отключайте его без необходимости.
Ключ для dsh без зарубежной карты
Агрегатор с OpenAI-совместимым адресом подходит как пользовательский провайдер: оплата в рублях, один ключ к DeepSeek и другим моделям.
Как подключить модель через OpenAI-совместимый API
Адаптер модели в dsh — плагин, поэтому harness не привязан к DeepSeek. Для сторонних сервисов используется пункт Add a custom provider в разделе Settings → Models. Поля те же, что и у любого OpenAI-совместимого клиента:
| Поле | Значение |
|---|---|
| Provider ID | любое постоянное имя, например aitunnel |
| Base URL | https://api.aitunnel.ru/v1/ |
| API protocol | openai-completions |
| API key | ключ из личного кабинета сервиса (sk-aitunnel-...) |
| Models | идентификатор из каталога сервиса, например deepseek-v4.1-flash |
-
Создайте ключ
Зарегистрируйтесь в сервисе и создайте API-ключ. Для отдельного ключа под агента можно задать лимит бюджета: агент в цикле тратит токены быстрее обычного чата.
-
Добавьте провайдера
В Settings → Models выберите именно «Add a custom provider», а не правку встроенного провайдера DeepSeek, и заполните поля из таблицы.
-
Загрузите список моделей
Кнопка «Fetch available models» обращается к маршруту
GET /modelsи заполняет список сама. Если модель не добавлена в список провайдера, выбрать её не получится: интерфейс вернёт ошибку неизвестной модели. -
Выберите модель в чате
В выпадающем списке выберите строку под вашим провайдером, иначе запросы продолжат уходить в официальный DeepSeek.
Схема собрана из документации dsh о пользовательских провайдерах и из описания OpenAI-совместимого адреса AITUNNEL (разбор подключения). Мы не гоняли длинные агентные сессии через эту связку (разбор частых ошибок — в статье «DeepSeek Harness: ошибки и настройка»), поэтому перед серьёзной работой выполните короткую задачу и убедитесь, что вызов инструментов работает. Для моделей из сторонних каталогов dsh по умолчанию считает, что они принимают только текст, а некоторые старые OpenAI-совместимые реализации не понимают роль developer — это настраивается в параметрах провайдера.
Сколько это стоит
Harness не стоит ничего: лицензия MIT, платных тарифов у проекта нет. Расходы — это токены модели. Агентные циклы многократно пересылают одно и то же начало контекста, поэтому здесь особенно заметен контекстный кэш: попадание в него удешевляет ввод в десятки раз.
| Модель | Ввод, кэш-хит | Ввод, кэш-мисс | Вывод |
|---|---|---|---|
deepseek-flash | $0.003 | $0.15 | $0.60 |
deepseek-v4-pro | $0.022 | $0.66 | $1.98 |
В часы пик цены вдвое выше. Пример: сессия, в которой агент отправил 5 млн входных токенов без кэша и получил 0,5 млн выходных, на deepseek-flash вне пика обойдётся примерно в $1,05 (5 × $0,15 + 0,5 × $0,60). На практике заметная часть ввода попадёт в кэш, и счёт получится ниже.
Через агрегатор цена считается в рублях и по другому прайсу. По таблице на странице AITUNNEL (данные на 9 октября 2026, сверяйте актуальные) V4.1 Flash стоит 30 ₽ за 1M на вводе и 120 ₽ на выводе, то есть та же сессия выйдет примерно в 210 ₽. Какая из схем выгоднее, зависит от того, есть ли у вас доступ к оплате официального аккаунта. Подробнее: как оплатить DeepSeek API из России.
Как снизить счёт, описано в статье «Как сэкономить на токенах». Какую модель ставить по умолчанию, разобрано в статье deepseek-flash или deepseek-v4-pro: для агентных задач разумно начинать с Flash и переходить на старшую модель только там, где Flash заметно ошибается. Отдельно учтите, что в документации сторонних сервисов встречается упоминание версии deepseek-v4-pro-0813 как модели по умолчанию в harness; её статус описан в той же статье.
Что проверить до запуска
Эти настройки не скрыты, они описаны в документации проекта, но легко пропустить, когда установка — одна команда.
- Журналы сессий. При работе с официальным API DeepSeek включён плагин, который отправляет журналы сессий вместе с последующими запросами. Отключается в Settings → General (пункт про загрузку журнала сессии при использовании официального API) или параметром
enabled: falseу плагина. Если вы подключили локальную модель или стороннего провайдера, этот путь не используется, но встроенный веб-поиск по-прежнему ходит в API DeepSeek. - Песочница. Новые сессии работают в режиме
workspace-write: запись ограничена рабочей папкой, но чтение файлов и доступ в сеть не изолированы. Агент может прочитать вашу домашнюю директорию. Профильsdk-minimalи вовсе запускается с полным доступом и без подтверждений. - MCP. Ни один MCP-сервер не включён заранее: каждый такой сервер — исполняемый код вне песочницы, и подключать его нужно осознанно.
- Телеметрия. В веб-сборке по умолчанию режим «только обратная связь», в настольном приложении аналитика регулируется отдельным переключателем. Проверьте его в настройках.
Ничего исключительного тут нет: большинство облачных ИИ-агентов отправляют код и запросы вендору. Но открытый исходный код и локальный запуск создают ложное ощущение, что ничего не уходит из компьютера. С официальным API это не так, пока вы не поменяете настройку. Не храните ключи в репозитории, с которым работает агент: правила описаны в статье как получить API-ключ DeepSeek.
Сравнение с Claude Code и Codex
Развёрнутое сравнение по сценариям — в отдельной статье: Harness, Claude Code и Codex.
Все три инструмента — агентные оболочки, и функционально они сближаются. Различия сегодня — в открытости, привязке к моделям и зрелости.
| Параметр | DeepSeek Harness | Claude Code | Codex |
|---|---|---|---|
| Разработчик | DeepSeek | Anthropic | OpenAI |
| Исходный код | Открыт, MIT | Закрыт | CLI открыт |
| Модели | Любые через плагин-адаптер | Модели Claude | Модели OpenAI |
| Интерфейсы | Настольное приложение, веб, headless, SDK, ACP | Терминал, IDE, десктоп, SDK | Терминал, IDE, облако |
| Расширяемость | Любая часть заменяема плагином | Плагины, хуки, MCP, субагенты | MCP, конфигурация |
| Зрелость | Developer preview | Стабильный продукт | Стабильный продукт |
Интересная особенность: dsh умеет вызывать Claude Code и Codex как субагентов, а Claude Code, в свою очередь, можно направить на OpenAI/Anthropic-совместимый адрес агрегатора. Если вы уже используете такую связку, настройки собраны в статьях DeepSeek в Claude Code и DeepSeek в Cursor.
Кому подойдёт, а кому нет
Подойдёт, если вы хотите недорого запускать агента на моделях DeepSeek, любите настраивать инструмент под себя, пишете собственные плагины или нужен headless-режим для CI. Режим Creator позволяет описать плагин словами, а агент сам напишет и установит его.
Не подойдёт, если вам нужен инструмент, который будет работать без правок следующий квартал: в preview-версии совместимость между релизами не гарантируется, и для рабочих процессов версию стоит закреплять и проверять на тестах. Не подходит он и как готовый чат-бот для клиентов: harness даёт цикл и инструменты, а подключение к CRM, база знаний и правила эскалации остаются вашей задачей.
Нужен API-ключ сегодня
Регистрация по email или Telegram занимает пару минут, оплата идёт в рублях, VPN не нужен. Один ключ работает и с DeepSeek, и с другими моделями.
Частые вопросы
Что такое DeepSeek Harness
Открытый агент-рантайм от DeepSeek (команда dsh, лицензия MIT), который оборачивает модель циклом агента, инструментами, песочницей и интерфейсом. Каждая часть — заменяемый плагин. Вышел 13 августа 2026 года в статусе developer preview.
DeepSeek Harness бесплатный
Сам harness — да. Платить нужно за токены подключённой модели: напрямую в DeepSeek или через агрегатор.
Как установить DeepSeek Harness
Установите Node.js и выполните npx @deepseek-ai/dsh web. Откроется локальный интерфейс на 127.0.0.1:3080, в котором в разделе Settings → Models добавляется ключ. Есть также настольное приложение для macOS и Windows.
Работает ли он только с моделями DeepSeek
Нет. Через пункт «Add a custom provider» можно подключить любой OpenAI-совместимый адрес, в том числе локальные модели и агрегаторы.
Можно ли пользоваться им из России без зарубежной карты
Harness ставится локально, регион ему не важен. Если пополнить официальный аккаунт DeepSeek нечем, подключите OpenAI-совместимого провайдера с оплатой в рублях, например AITUNNEL, как описано выше.
Безопасно ли запускать его на рабочем коде
Сначала проверьте настройки по умолчанию: отправку журналов сессий при работе с официальным API, незащищённое чтение файлов и сетевой доступ, телеметрию. Это раздел «Что проверить до запуска» выше. Для чувствительных проектов используйте отдельную рабочую папку и отдельный ключ с лимитом бюджета.
Ещё по теме
- Подключение через AITUNNEL Один ключ, оплата в рублях, OpenAI- и Anthropic-совместимые адреса.
- Ошибки и настройка DeepSeek Harness UNKNOWN_MODEL, провайдер, порт, модели.
- Harness, Claude Code и Codex: сравнение Что выбрать для агента.
- DeepSeek в Claude Code Настройка через Anthropic-совместимый адрес.