Один ключ к DeepSeek, GPT, Claude и Gemini — оплата в рублях, доступ без VPN.

Получить ключ

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, а также панель траектории — таймлайн всех шагов агента с вызовами инструментов и временем выполнения. Последняя особенно полезна для отладки: видно, где именно агент свернул не туда.

Способы запуска

Режимы работы DeepSeek Harness
РежимКак запуститьДля чего
Настольное приложениеУстановщик для macOS и Windows x64Веб-интерфейс в оболочке Electron со встроенным окружением. Сборки для Linux нет
Веб-интерфейсnpx @deepseek-ai/dsh webЛокальное приложение на 127.0.0.1:3080, подходит для повседневной работы
Headlessdsh --profile headless "запусти тесты"Разовая задача без интерфейса: удобно для CI и скриптов
SDKdsh --profile sdkJSON-RPC через stdio; есть обёртка на Python — пакет deepseek-harness-sdk
ACPdsh --profile acpПодключение к редакторам и внешним клиентам по Agent Client Protocol

Состав режимов описан по документации проекта и обзорам на момент ноября 2026 года; в developer preview он может меняться. Устанавливайте именно @deepseek-ai/dsh из npm и проверяйте издателя пакета: названия вроде «deepseek-harness» бывают у посторонних проектов.

Установка за пять минут

Нужен только Node.js. Никаких клонирований репозитория для обычного использования не требуется:

bash
# локальный веб-интерфейс на 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-совместимого клиента:

Пример настройки пользовательского провайдера (AITUNNEL)
ПолеЗначение
Provider IDлюбое постоянное имя, например aitunnel
Base URLhttps://api.aitunnel.ru/v1/
API protocolopenai-completions
API keyключ из личного кабинета сервиса (sk-aitunnel-...)
Modelsидентификатор из каталога сервиса, например deepseek-v4.1-flash
  1. Создайте ключ

    Зарегистрируйтесь в сервисе и создайте API-ключ. Для отдельного ключа под агента можно задать лимит бюджета: агент в цикле тратит токены быстрее обычного чата.

  2. Добавьте провайдера

    В Settings → Models выберите именно «Add a custom provider», а не правку встроенного провайдера DeepSeek, и заполните поля из таблицы.

  3. Загрузите список моделей

    Кнопка «Fetch available models» обращается к маршруту GET /models и заполняет список сама. Если модель не добавлена в список провайдера, выбрать её не получится: интерфейс вернёт ошибку неизвестной модели.

  4. Выберите модель в чате

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

Что здесь проверено, а что нет

Схема собрана из документации dsh о пользовательских провайдерах и из описания OpenAI-совместимого адреса AITUNNEL (разбор подключения). Мы не гоняли длинные агентные сессии через эту связку (разбор частых ошибок — в статье «DeepSeek Harness: ошибки и настройка»), поэтому перед серьёзной работой выполните короткую задачу и убедитесь, что вызов инструментов работает. Для моделей из сторонних каталогов dsh по умолчанию считает, что они принимают только текст, а некоторые старые OpenAI-совместимые реализации не понимают роль developer — это настраивается в параметрах провайдера.

Сколько это стоит

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

Официальный прайс DeepSeek, вне пика, за 1M токенов
МодельВвод, кэш-хитВвод, кэш-миссВывод
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 HarnessClaude CodeCodex
РазработчикDeepSeekAnthropicOpenAI
Исходный кодОткрыт, MITЗакрытCLI открыт
МоделиЛюбые через плагин-адаптерМодели ClaudeМодели OpenAI
ИнтерфейсыНастольное приложение, веб, headless, SDK, ACPТерминал, IDE, десктоп, SDKТерминал, IDE, облако
РасширяемостьЛюбая часть заменяема плагиномПлагины, хуки, MCP, субагентыMCP, конфигурация
ЗрелостьDeveloper previewСтабильный продуктСтабильный продукт

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

Интересная особенность: 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, незащищённое чтение файлов и сетевой доступ, телеметрию. Это раздел «Что проверить до запуска» выше. Для чувствительных проектов используйте отдельную рабочую папку и отдельный ключ с лимитом бюджета.

Один ключ вместо пяти аккаунтов

DeepSeek, GPT, Claude и Gemini через один OpenAI-совместимый адрес: api.aitunnel.ru/v1. Регистрация занимает пару минут, оплата в рублях, доступ без VPN.

  • Один ключ на все модели
  • Оплата в рублях и счёт для юрлиц
  • Совместимо с OpenAI SDK