Все статьи

18 ноября 2026 г. · 5 мин чтения · Артём Гапоненко

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

Интерфейс DeepSeek Harness: подключение нескольких моделей по API, работа с локальной папкой и управление через команды

DeepSeek Harness — открытая агентная среда от DeepSeek AI (лицензия MIT, исходники на GitHub), которая соединяет языковую модель с вашей рабочей папкой. Модель отвечает за рассуждения и план, а Harness берёт на себя инфраструктуру: доступ к файлам, выполнение команд в терминале, хранение сессий, права доступа и подключение инструментов.

Среда не привязана к одному провайдеру. Вы можете подключить несколько моделей по API-ключам и работать со своими проектами локально или на сервере без привязки к одной подписке.

Десктоп или сервер: что выбрать для старта

Большинство технических обзоров сразу предлагают ставить pnpm, клонировать репозиторий и собирать проект из исходников. Если вы работаете с текстами, документами или клиентскими проектами, начинать с этого не нужно.

Десктопное приложение подходит для повседневной работы на своём компьютере:

  1. Скачайте preview-установщик из раздела релизов на GitHub: .exe для Windows или .dmg для macOS (Apple Silicon).
  2. Запустите программу и выберите папку с вашими файлами.
  3. Дальнейшая настройка моделей и плагинов проходит в графическом интерфейсе без командной строки.

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

  1. Откройте настройки и перейдите в раздел Settings → Models.
  2. В карточке DeepSeek вставьте API-ключ и нажмите Apply.
  3. Чтобы добавить ещё одного провайдера (например, anthropic для Claude), нажмите + Add model provider.

Настройка провайдеров и ввод API-ключа в разделе Settings → Models

Подключение стороннего endpoint (Custom model API)

Если вы работаете через собственный шлюз, агрегатор вроде OpenRouter или локальный сервер, в окне добавления провайдера переключитесь на вкладку Custom model API:

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

Подключение стороннего шлюза через вкладку Custom model API и Base URL

Как экономить на запросах

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

  • Рутина на недорогом API: первичный разбор документов, сортировка файлов, черновики и поиск по папке хорошо идут на DeepSeek.
  • Сложные задачи точечно: архитектура, сложный код и финальная редактура переключаются на более сильную модель только на конкретный шаг.

Активную модель удобно переключать прямо в списке моделей в окне чата или через пресеты в настройках.

Управление в интерфейсе: @, / и плагины

Чтобы не копировать тексты и пути вручную, в строке ввода работают быстрые вызовы:

  • @ — ссылка на конкретный файл, папку или прошлую сессию, чтобы сразу передать нужный контекст в запрос.
  • / — палитра встроенных команд, среди которых /plan для составления плана, /goal для постановки цели и /compact для сжатия длинной истории диалога.

Дополнительные инструменты, локализация интерфейса (например, русский язык) и переключатели ключей ставятся через маркетплейс dsh-market — в разделе Plugins в настройках или командой в терминале:

dsh plugin add dsh-market

Ограничения и безопасность до запуска

Перед переходом на DeepSeek Harness стоит учесть три практических ограничения:

  1. Статус developer preview. Проект активно развивается, поэтому между минорными обновлениями могут меняться формат конфигураций и внутренние API. Перед обновлением версии лучше сделать резервную копию: файл настроек можно открыть кнопкой Open configuration file в Settings и сохранить отдельно.
  2. Предоплата и ошибка Insufficient Balance. Официальный DeepSeek API работает по предоплате баланса. Когда средства на счёте заканчиваются, агент останавливает выполнение задачи с ошибкой Insufficient Balance.
  3. Доступ к файлам и терминалу. Агент получает реальные права на чтение, запись и запуск команд внутри открытой директории. Не подключайте корневые каталоги системы или папки с конфиденциальными данными — выделяйте под работу отдельную папку и осознанно ограничивайте права доступа.

Если у вас уже есть папка с правилами и материалами, достаточно поставить десктопную версию и проверить её на одной рабочей задаче. Если собирать структуру папок, правила и онбординг с нуля не хочется, в готовом решении «Агент под тебя» всё это уже настроено — папку можно открыть в 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, и агент прочитает контекст из файлов.