DeepSeek Harness: установка, настройка моделей и работа со своими файлами

DeepSeek Harness — открытая агентная среда от DeepSeek AI (лицензия MIT, исходники на GitHub), которая соединяет языковую модель с вашей рабочей папкой. Модель отвечает за рассуждения и план, а Harness берёт на себя инфраструктуру: доступ к файлам, выполнение команд в терминале, хранение сессий, права доступа и подключение инструментов.
Среда не привязана к одному провайдеру. Вы можете подключить несколько моделей по API-ключам и работать со своими проектами локально или на сервере без привязки к одной подписке.
Десктоп или сервер: что выбрать для старта
Большинство технических обзоров сразу предлагают ставить pnpm, клонировать репозиторий и собирать проект из исходников. Если вы работаете с текстами, документами или клиентскими проектами, начинать с этого не нужно.
Десктопное приложение подходит для повседневной работы на своём компьютере:
- Скачайте preview-установщик из раздела релизов на GitHub:
.exeдля Windows или.dmgдля macOS (Apple Silicon). - Запустите программу и выберите папку с вашими файлами.
- Дальнейшая настройка моделей и плагинов проходит в графическом интерфейсе без командной строки.
Веб-версия и сервер нужны, если рабочие папки лежат на удалённой машине или к агенту требуется постоянный доступ через браузер. При установленном Node.js 22+ интерфейс поднимается на http://127.0.0.1:3080 одной командой:
npx @deepseek-ai/dsh web
Для запуска на сервере или по SSH добавьте флаг, чтобы программа не пыталась открыть браузер на удалённой машине:
npx @deepseek-ai/dsh web --no-open
Адрес 127.0.0.1:3080 — локальный на самой удалённой машине, поэтому напрямую с вашего компьютера он не откроется. Для доступа из своего браузера нужен SSH-туннель (проброс порта 3080) или настроенный прокси.
Разработчикам также доступна глобальная установка CLI (npm install -g @deepseek-ai/dsh, далее команда dsh), сборка из исходников через pnpm и профили запуска headless, sdk и acp для скриптов и редакторов кода.
Независимость от одного аккаунта и перенос рабочей папки
Когда все инструкции, стиль текстов и детали проектов хранятся только внутри истории веб-чата, блокировка или потеря аккаунта забирает накопленную работу. Подробно мы разбирали эту ситуацию в статье что делать, если заблокировали Claude.
В агентной среде логика другая: правила, заметки и материалы лежат в обычных файлах у вас на диске, а модель выступает сменным исполнителем. Если вы уже собирали такую папку для другого инструмента, достаточно открыть её в DeepSeek Harness: агент прочитает AGENTS.md или CLAUDE.md в корне проекта, а нужный файл с правилами можно подключить вручную через @. Как устроена папка с правилами и ролями, разобрано в статье как создать агента.
Подключение моделей и разделение задач по стоимости
В DeepSeek Harness можно подключить сразу несколько провайдеров: официальный DeepSeek API, Anthropic (Claude), OpenAI-совместимые endpoint, OpenRouter или локальные модели через Ollama.
Стандартное подключение
API-ключ и баланс заводятся в кабинете разработчика выбранного провайдера (например, platform.deepseek.com), а не в обычном веб-чате.
- Откройте настройки и перейдите в раздел Settings → Models.
- В карточке DeepSeek вставьте API-ключ и нажмите Apply.
- Чтобы добавить ещё одного провайдера (например,
anthropicдля Claude), нажмите + Add model provider.

Подключение стороннего endpoint (Custom model API)
Если вы работаете через собственный шлюз, агрегатор вроде OpenRouter или локальный сервер, в окне добавления провайдера переключитесь на вкладку Custom model API:
- Заполните поля Provider ID и Display name.
- Укажите адрес подключения в поле Base URL и выберите нужный протокол в списке API protocol (например, Anthropic Messages для моделей Claude или OpenAI Chat Completions).
- Введите API-ключ и добавьте модели через Fetch available models или + Add model — после этого кнопка Create provider станет активной.

Как экономить на запросах
Держать дорогую модель основной на весь рабочий день невыгодно. Удобнее разделить задачи между двумя провайдерами:
- Рутина на недорогом API: первичный разбор документов, сортировка файлов, черновики и поиск по папке хорошо идут на DeepSeek.
- Сложные задачи точечно: архитектура, сложный код и финальная редактура переключаются на более сильную модель только на конкретный шаг.
Активную модель удобно переключать прямо в списке моделей в окне чата или через пресеты в настройках.
Управление в интерфейсе: @, / и плагины
Чтобы не копировать тексты и пути вручную, в строке ввода работают быстрые вызовы:
@— ссылка на конкретный файл, папку или прошлую сессию, чтобы сразу передать нужный контекст в запрос./— палитра встроенных команд, среди которых/planдля составления плана,/goalдля постановки цели и/compactдля сжатия длинной истории диалога.
Дополнительные инструменты, локализация интерфейса (например, русский язык) и переключатели ключей ставятся через маркетплейс dsh-market — в разделе Plugins в настройках или командой в терминале:
dsh plugin add dsh-market
Ограничения и безопасность до запуска
Перед переходом на DeepSeek Harness стоит учесть три практических ограничения:
- Статус developer preview. Проект активно развивается, поэтому между минорными обновлениями могут меняться формат конфигураций и внутренние API. Перед обновлением версии лучше сделать резервную копию: файл настроек можно открыть кнопкой Open configuration file в Settings и сохранить отдельно.
- Предоплата и ошибка
Insufficient Balance. Официальный DeepSeek API работает по предоплате баланса. Когда средства на счёте заканчиваются, агент останавливает выполнение задачи с ошибкойInsufficient Balance. - Доступ к файлам и терминалу. Агент получает реальные права на чтение, запись и запуск команд внутри открытой директории. Не подключайте корневые каталоги системы или папки с конфиденциальными данными — выделяйте под работу отдельную папку и осознанно ограничивайте права доступа.
Если у вас уже есть папка с правилами и материалами, достаточно поставить десктопную версию и проверить её на одной рабочей задаче. Если собирать структуру папок, правила и онбординг с нуля не хочется, в готовом решении «Агент под тебя» всё это уже настроено — папку можно открыть в DeepSeek Harness и сразу начать работу.
Частые вопросы
DeepSeek Harness — это бесплатно?
Сама среда с открытым исходным кодом под лицензией MIT бесплатная. Вы оплачиваете только запросы к моделям по своим API-ключам у выбранного провайдера.
Обязательно ли запускать DeepSeek Harness через терминал?
Нет. Для Windows (.exe) и macOS на Apple Silicon (.dmg) есть готовые установщики — настройка проходит в графическом окне. Терминал нужен для веб-версии на сервере или интеграции в скрипты.
Какие модели можно подключить?
Через Settings → Models и вкладку Custom model API подключаются DeepSeek, Anthropic (Claude), OpenAI-совместимые endpoint, OpenRouter и локальные модели через Ollama.
Почему появляется ошибка Insufficient Balance?
Официальный DeepSeek API работает по предоплате баланса. Когда деньги на счёте заканчиваются, агент останавливает выполнение и выдаёт эту ошибку.
Сохранятся ли правила при переходе из другого сервиса?
Да, если ваши инструкции, описания проектов и материалы лежат в обычной папке на компьютере. Достаточно открыть эту папку в DeepSeek Harness, и агент прочитает контекст из файлов.