DeepSeek Harness в России без VPN

Проблема доступа из России

13 августа 2026 года DeepSeek открыла исходники DeepSeek Harness — собственного агентного фреймворка для разработки. За три недели репозиторий deepseek-ai/deepseek-harness собрал более 211 тысяч звёзд на GitHub. Лицензия MIT, слоган проекта — «everything is a plugin»: модельный адаптер, реестр инструментов и сам агентный цикл здесь взаимозаменяемые плагины, собранные на фреймворке Cordis.

DeepSeek Harness (dsh) — это локальный кодинг-агент с двумя режимами: браузерный Web UI и полностью безголовый (headless) прогон для скриптов и CI. Он модельно-независим: из коробки поддерживает DeepSeek, Anthropic, OpenAI и любой сторонний OpenAI-совместимый эндпоинт.

И вот тут для российского разработчика начинается проблема. Сам harness бесплатен, но ему нужны модели. Ключ DeepSeek с platform.deepseek.com требует пополнения с иностранной карты. Каталогные провайдеры из коробки — Anthropic и OpenAI — блокируют российские IP и не принимают карты российских банков. В итоге инструмент, который разрабатывает одна из самых открытых команд в индустрии, оказывается практически недоступен из России напрямую.

VPN формально решает вопрос доступа, но создаёт новые: длинные агентные сессии рвутся при деградации туннеля, корпоративные политики запрещают гонять рабочий код через чужие серверы, а оплата зарубежного API всё равно остаётся нерешённой. Для команды из трёх человек «каждому свой VPN» — это уже не разработка, а администрирование.

Решение: PlusVibe API

PlusVibe API — это OpenAI-совместимый шлюз, доступный по адресу https://plusvibeapi.ru/v1. Он реализует стандартный REST API OpenAI — включая GET /v1/models и чат-комплиты, — поэтому любой инструмент с поддержкой кастомного OpenAI-эндпоинта подключается к нему без правок кода. DeepSeek Harness поддерживает такие эндпоинты штатно: через форму «Add a custom provider» в Web UI или через settings.yaml.

Ключевые преимущества подхода:

Без VPN. Запросы идут напрямую на российский сервер — никаких туннелей и иностранных IP.
Оплата в рублях. Пополнение баланса привычными российскими способами: картой РФ или по счёту для юрлиц. Никаких иностранных карт и SWIFT.
Один ключ на все модели. Через шлюз доступны не только модели DeepSeek, но и GPT, Claude, Gemini, GLM и другие — полный каталог на странице Моделей.
Стабильность для длинных сессий. Агентные задачи живут минутами; прямое соединение без VPN-посредника не рвётся на середине шага.

Регистрация занимает пару минут на странице /register; после неё вы получаете ключ вида sk-pv-… — именно он понадобится в настройках ниже.

Если plusvibeapi.ru недоступен из вашей сети, у шлюза есть резервный адрес https://gw.plusvibeapi.ru/v1 — это тот же API с общими ключами и балансом, меняется только baseURL.

Установка и настройка DeepSeek Harness

Шаг 1. Требования и установка

Harness требует Node.js версии ^22.19.0 || &gt;=24.0.0. Проверить текущую версию: node --version. Актуальная версия пакета — 0.1.2-rc.1; проект находится в стадии developer preview и быстро итерируется — разработчики честно предупреждают о возможных несовместимых изменениях между версиями.

Самый быстрый способ запуска — через npm, без клонирования репозитория:

npx @deepseek-ai/dsh web

Команда поднимает Web UI на http://127.0.0.1:3080 и открывает его в браузере. Флаг --no-open запускает сервер без открытия браузера — удобно на сервере по SSH.

Если хотите запускать из исходников (например, чтобы собирать плагины), потребуется клон репозитория и закреплённая в проекте версия pnpm 11.7.0:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

Шаг 2. Ключ PlusVibe

Зарегистрируйтесь на plusvibeapi.ru, пополните баланс в рублях и создайте ключ в личном кабинете. Ключ выглядит как sk-pv-….

Шаг 3. Подключение через Web UI

В интерфейсе откройте Settings → Models и нажмите Add a custom provider. Заполните форму:

Provider ID — plusvibe (строчными буквами; идентификатор постоянный, его используют сессии и настройки);
Display name — например, PlusVibe;
Base URL — https://plusvibeapi.ru/v1;
API protocol — OpenAI-совместимый (chat completions);
Credential — ваш ключ sk-pv-….

Затем нажмите Fetch available models: harness опросит GET /v1/models по указанному адресу и сам подтянет список моделей каталога PlusVibe. Сохраните — провайдер готов, перезапуск сервера не нужен: изменения применяются со следующего запроса.

Шаг 4. Подключение через settings.yaml (headless и CI)

Для безголового режима и автоматизации удобнее прописать провайдера в файле настроек. Все пользовательские данные dsh хранит в ~/.dsh (переменная DSH_HOME меняет расположение). Создайте или отредактируйте ~/.dsh/settings.yaml:

llm-pi-ai:
  providers:
    plusvibe:
      displayName: PlusVibe
      apiKeyEnv: PLUSVIBE_API_KEY
      api: openai-completions
      baseURL: https://plusvibeapi.ru/v1
      models:
        - id: deepseek-v4-flash-0731
        - id: deepseek-v4-pro-0813

Поле apiKeyEnv — это имя переменной окружения, а не сам ключ: секреты в файл настроек не попадают. Задайте переменную:

echo 'export PLUSVIBE_API_KEY=sk-pv-ВАШ_КЛЮЧ' &gt;&gt; ~/.bashrc
source ~/.bashrc

Ключ также можно положить в файл ~/.dsh/.env или в .env в директории проекта — harness читает оба слоя при запуске.

Если какой-то шлюз отказывается принимать запросы в формате новых OpenAI-полей, официальная документация dsh рекомендует добавить в маршрут секцию compat — например, supportsDeveloperRole: false и maxTokensField: max_tokens. Это штатный механизм совместимости, а не костыль.

Пример работы

После настройки выберите рабочую директорию: в Web UI нажмите Choose workspace и укажите папку проекта, в которой запущен dsh. Отправьте первую задачу:

Суммируй, что делает этот репозиторий, и перечисли его основные модули

Агент читает и редактирует файлы проекта, выполняет команды и ведёт план работы; действия, требующие подтверждения по активной политике прав, он предлагает подтвердить — политика настраивается, поэтому один и тот же harness подходит и для осторожного ревью, и для автономных прогонов. Модель выбирается в пикере моделей — выбранный вариант становится умолчанием для новых сессий, уже начатая сессия сохраняет модель из своего журнала.

Внешние инструменты подключаются через MCP: клиентский плагин идёт в комплекте, конкретные MCP-серверы добавляются опциональными оверлеями и по умолчанию выключены — каждый сервер это доверенный исполняемый код вне песочницы агента, и проект это явно подчёркивает.

Второй режим — безголовый прогон. Одна команда выполняет задачу в свежей сессии, печатает итог и завершается — то, что нужно для скриптов и CI:

dsh --profile headless "Прогони тесты и почини те, что упадут"

Есть и режимы для интеграций: dsh --profile acp обслуживает клиентов по протоколу ACP через stdio, dsh --profile sdk — по JSON-RPC. Архитектура «всё есть плагин» означает, что реестр инструментов и сам цикл агента можно заменить своими — через плагины на Cordis или готовые бандлы: внешние пакеты ставятся командой dsh plugin --profile web add &lt;пакет&gt;, а плагины сообщества публикуются на GitHub с темой dsh-plugin.

Для команды сценарий тот же, что у любого API-инструмента: каждый разработчик получает свой ключ sk-pv-… в кабинете PlusVibe, а расход по каждому ключу виден отдельно — удобно контролировать бюджет на эксперименты.

Частые проблемы

MISSING_CREDENTIAL — переменная из apiKeyEnv не задана в окружении, а ключ не сохранён через страницу Models. Проверьте echo $PLUSVIBE_API_KEY в той же сессии, где запускаете dsh.

UNKNOWN_MODEL — в сессии выбрана модель, которой нет в списке провайдера. Добавьте её в models маршрута или выберите настроенную модель в пикере.

«Fetch available models» возвращает 401 — неверный ключ: обнаружение моделей ходит в стандартный GET /v1/models с тем же ключом. Для эндпоинтов без этого метода модели можно вписать вручную.

Шлюз отклоняет запросы при верных ключе и адресе — его формат запроса отличается от OpenAI. Официальный рецепт — секция compat на маршруте в ~/.dsh/settings.yaml: начните с supportsDeveloperRole: false и maxTokensField: max_tokens.

Цены и модели

PlusVibe API работает по модели pay-as-you-go: вы платите только за фактически использованные токены, отдельно за входящие и исходящие, как в оригинальных API. Для DeepSeek Harness мы рекомендуем две модели DeepSeek, которые продаём напрямую:

МодельДля чегоВход, ₽/1MВыход, ₽/1Mdeepseek-v4-flash-0731Повседневный кодинг, быстрые правки, массовые прогоны2,056,14deepseek-v4-pro-0813Сложный рефакторинг, архитектурные решения, разбор легаси19,8057,60

У обеих моделей контекст 164 тысячи токенов и поддержка кэширования входа: повторное чтение того же контекста стоит 0,21 ₽ и 2 ₽ за миллион токенов соответственно. Для агентных циклов, где каждый шаг пересылает всю историю, кэш существенно снижает счёт. Цены актуальны на 4 сентября 2026 года.

Этим выбор не ограничен: через тот же провайдер plusvibe в harness работают все модели нашего каталога — 41 модель на 4 сентября 2026 года, от недорогих до флагманских. Актуальный список с ценами — на странице /models; подробнее о том, как подключать модели DeepSeek через API, — в статье «DeepSeek API в России».

Итог

DeepSeek Harness — один из самых интересных агентских фреймворков 2026 года: открытый, модульный, с браузерным и безголовым режимами. Единственное препятствие для разработчика из России — оплата моделей и заблокированные каталогные провайдеры.

PlusVibe API снимает оба ограничения: штатная форма кастомного провайдера в dsh принимает наш эндпоинт https://plusvibeapi.ru/v1 за пару кликов, ключ sk-pv-… — через settings.yaml, оплата — в рублях. Настройка занимает пять минут и не требует ни VPN, ни иностранных карт.

Попробуйте связку в деле: зарегистрируйтесь на /register, подключите провайдера и запустите первый прогон. А если сравниваете агентов между собой, почитайте наш опыт работы с DeepSeek и Claude в кодинге и обзор DeepSeek V4 Pro.

Запустите DeepSeek Harness из России

Модели DeepSeek, GPT и Claude через один ключ. Оплата картой РФ или по счёту для юрлиц.

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