# DeepSeek Harness в России: агент с локальным Web UI

> Агент запускается одной командой и открывает интерфейс в браузере на вашей машине. Polza подключается как custom provider — оплата картой РФ, без VPN.

- Запуск одной командой
- Интерфейс в браузере
- Работает из РФ напрямую
- Карта РФ и СБП

DeepSeek Harness — агент с открытым исходным кодом от DeepSeek AI. От терминальных инструментов он отличается тем, что поднимает локальный веб-интерфейс: чат и настройки открываются в браузере, а работает всё на вашей машине.

Задачи он выполняет в рабочей директории — читает файлы, вносит правки, запускает многошаговые инструкции. Модель берёт у стороннего провайдера, поэтому не привязан к моделям DeepSeek.

Проект находится в стадии developer preview: интерфейс и настройки могут меняться между версиями, и это стоит учитывать, прежде чем ставить его в рабочий процесс.

## Почему Harness не находит модели

Сам агент запускается одной командой npx и поднимает интерфейс локально. Упирается всё в провайдера, которого надо добавить в настройках.

- **Провайдер не отвечает.** Зарубежные API не обслуживают российские адреса: интерфейс открывается, но список моделей остаётся пустым. Решение: Custom provider на Polza отвечает из РФ.
- **Картой не оплатить.** Зарубежным провайдерам нужна иностранная карта, российская отклоняется на привязке. Решение: Карта РФ, СБП или счёт для юрлица.
- **Ключ в открытом файле.** Harness хранит ключ в .credentials.yaml на диске, и утечка файла означает утечку доступа. Решение: Отдельный ключ под инструмент, отозвать можно точечно.
- **Агент работает в директории сам.** Многошаговые задачи выполняются автономно и расходуют токены быстрее, чем обычный чат. Решение: Оплата за токены, лимиты не сгорают.
- **Юрлицу не провести оплату.** Оплату зарубежному сервису не примет бухгалтерия. Решение: Договор, счёт, УПД и НДС.
- **Расход не отслеживается.** Локальный интерфейс не показывает, во сколько обошлась сессия. Решение: Статистика по ключам и моделям в кабинете.

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

Запуск одной командой, настройка — в веб-интерфейсе. Нужны Node.js и npm.

Что нужно:

- **Node.js и npm.** Проверяются командами node --version и npm --version. Сам Harness ставить не нужно — он запускается через npx.
- **Ключ Polza.** Создаётся в кабинете за минуту. Лучше завести отдельный: Harness хранит ключ в файле на диске.
- **Браузер.** Интерфейс открывается на http://127.0.0.1:3080. На удалённом сервере понадобится проброс порта.

### 1. Запустите Harness

Отдельная установка не нужна — команда `npx` скачает и запустит агента. По умолчанию интерфейс поднимается на порту 3080 и открывается в браузере.

Терминал · запуск:

```
$ node --version   # проверяем Node.js
$ npx @deepseek-ai/dsh web

# на сервере без браузера:
$ npx @deepseek-ai/dsh web --no-open
```

### 2. Откройте интерфейс

Перейдите по адресу `http://127.0.0.1:3080`. Если Harness запущен на удалённом сервере, пробросьте порт любым привычным способом.

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

В интерфейсе откройте `Settings → Models` и нажмите `Add a custom provider`. Заполните пять полей — обратите внимание на слеш в адресе и на протокол:

Add a custom provider:

```
Provider ID  polza
Display name Polza.ai
Base URL     https://polza.ai/api/v1/
API protocol openai-completions
API key      ваш ключ из кабинета
```

### 4. Загрузите модели и работайте

Нажмите `Fetch available models` — список подтянется из каталога. Дальше выберите модель в верхней панели и отправьте первый запрос.

**Developer preview — учитывайте это.** Проект находится в стадии предварительной версии для разработчиков: интерфейс и параметры конфигурации меняются между выпусками. Поля, описанные здесь, соответствуют текущей версии, но перед обновлением Harness имеет смысл заглянуть в заметки о релизе. Для рабочих процессов, где важна стабильность, надёжнее взять инструмент из основного ряда.

## Что умеет DeepSeek Harness

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

- **Локальный Web UI.** Интерфейс для чата и настроек открывается в браузере, но работает на вашей машине — данные никуда не уходят.
- **Агентные задачи.** Выполняет многошаговые инструкции в рабочей директории, а не просто отвечает текстом.
- **Автозагрузка моделей.** Список подтягивается из каталога одной кнопкой — вручную идентификаторы вбивать не нужно.
- **Переключение моделей.** Модель меняется прямо в верхней панели интерфейса, без правки конфигов.
- **Открытый код.** Проект DeepSeek AI лежит на GitHub: видно, что агент делает с вашими файлами.
- **Работа на сервере.** С флагом --no-open запускается без браузера, поэтому подходит для удалённой машины с пробросом порта.

- **На своей машине.** Команда сама откроет браузер на порту 3080. Самый быстрый способ попробовать.
- **На удалённом сервере.** Запуск с флагом --no-open и проброс порта. Удобно, когда рабочая директория живёт не на ноутбуке.

## Чем Harness отличается от OpenCode и Cherry Studio

Три способа работать с моделями вне редактора — разница в интерфейсе и в том, насколько инструмент зрелый.

- **DeepSeek Harness.** Агент с веб-интерфейсом и работой в директории. Developer preview, поэтому подойдёт скорее посмотреть, чем поставить в рабочий процесс.
- **OpenCode.** Терминальный агент того же жанра, но зрелый и с настройкой одной командой. Под него есть отдельная страница.
- **Cherry Studio.** Десктопный клиент для диалога с моделями и работы с документами. Не про выполнение задач в репозитории.

## Напрямую или через Polza

| Из России | Зарубежный провайдер | Harness через Polza |
| --- | --- | --- |
| Оплата | Зарубежная карта, в валюте | Карта РФ, СБП, счёт для юрлиц |
| Доступ к API | Закрыт, нужны обходные пути | Работает из РФ напрямую |
| Список моделей | Зависит от вендора | Подтягивается кнопкой из каталога |
| Выбор моделей | Один вендор | DeepSeek, Kimi, Qwen и ещё 400 |
| Модель оплаты | Квоты и лимиты | За токены, лимиты не сгорают |
| Документы | Нет | Договор, счёт, УПД, НДС |
| Расходы | В кабинете провайдера | Статистика по ключам и моделям |

## Сколько стоит DeepSeek Harness

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

- **Сложная разработка.** DeepSeek V4 Pro — рассуждение и многошаговые задачи, самый дешёвый Pro-класс в каталоге.
- **Быстрые повседневные задачи.** DeepSeek V4 Flash — короткие запросы и рутина, где важнее скорость и цена.
- **Код и агентные задачи.** Kimi K3 для работы с кодом и Qwen 3.8 Max для универсальных агентных сценариев.

- [deepseek/deepseek-v4-pro](https://polza.ai/models/deepseek/deepseek-v4-pro.md) — сложная разработка и рассуждение
- [deepseek/deepseek-v4-flash](https://polza.ai/models/deepseek/deepseek-v4-flash.md) — быстрые повседневные задачи
- [moonshotai/kimi-k3](https://polza.ai/models/moonshotai/kimi-k3.md) — работа с кодом
- [qwen/qwen3.8-max](https://polza.ai/models/qwen/qwen3.8-max.md) — универсальные агентные задачи

## Если модели не загрузились

Четыре причины, на которые приходится почти вся переписка с поддержкой.

- **Fetch available models возвращает 401.** Ключ вставлен с кавычками, пробелами или переносом строки. Скопируйте заново и повторите загрузку.
- **Список моделей пустой.** Проверьте Base URL — он должен заканчиваться на /v1/ со слешем, а в API protocol должен стоять openai-completions.
- **Кнопка Create provider неактивна.** Заполнены не все обязательные поля: нужны Provider ID, Display name, Base URL, API protocol, API key и минимум одна модель.
- **Интерфейс не открылся.** Команда могла запуститься с флагом --no-open или на другом порту. Откройте http://127.0.0.1:3080 вручную, а на сервере пробросьте порт.

## Частые вопросы

### Что такое DeepSeek Harness?

Агент с открытым кодом от DeepSeek AI с локальным веб-интерфейсом. Запускается на вашей машине, выполняет многошаговые задачи в рабочей директории и подключается к любому OpenAI-совместимому провайдеру.

### Как запустить Harness?

Одной командой npx @deepseek-ai/dsh web. Отдельная установка не нужна, достаточно Node.js и npm. Интерфейс откроется на http://127.0.0.1:3080.

### Какой Base URL указывать?

https://polza.ai/api/v1/ — со слешем на конце. В поле API protocol выберите openai-completions.

### Fetch available models возвращает 401

Ключ вставлен с кавычками, пробелами или переносом строки. Скопируйте его заново и повторите загрузку моделей.

### Список моделей пустой

Чаще всего дело в адресе или протоколе: проверьте слеш в конце Base URL и выбранный openai-completions. Модели можно добавить и вручную.

### Кнопка Create provider не нажимается

Не заполнены обязательные поля. Нужны Provider ID, Display name, Base URL, API protocol, API key и хотя бы одна модель.

### Где хранится ключ?

В файле .credentials.yaml в домашнем каталоге Harness; в настройках сохраняется только ссылка на него. Файл не стоит публиковать и коммитить.

### Можно ли запустить на сервере?

Да, с флагом --no-open. Браузер на сервере не откроется, интерфейс будет доступен после проброса порта 3080.

## Читать дальше

- [API нейросетей: единый ключ для ChatGPT, Claude и 400+ моделей](https://polza.ai/blog/api-neyrosetei.md)
- [Российский API нейросетей без VPN](https://polza.ai/blog/rossiyskiy-api-dlya-neyrosetey-bez-vpn-polnyy-gayd-2026.md)
- [Агрегатор нейросетей: что это и лучшие сервисы 2026](https://polza.ai/blog/agregator-nejrosetej.md)

## Ссылки

- Документация: https://polza.ai/docs/integracii/deepseek-harness
- Страница: https://polza.ai/integrations/deepseek-harness
- Обновлено: 2026-09-26