DeepSeek Harness: частые ошибки при настройке
DeepSeek Harness (dsh) остаётся предварительной версией для разработчиков, а подключение стороннего провайдера — самое частое место, где пользователи застревают. Собрали типичные симптомы, их причины и способы проверки.
Если вы ещё не знакомы с инструментом, начните со статьи «DeepSeek Harness: что это, установка и подключение API». Здесь — только разбор проблем.
Симптомы и решения
| Симптом | Причина | Что делать |
|---|---|---|
Ошибка неизвестной модели (UNKNOWN_MODEL) | Модели нет в списке пользовательского провайдера | Добавьте идентификатор в список Models провайдера или загрузите список кнопкой «Fetch available models» |
| Запросы по-прежнему идут в официальный DeepSeek | В чате выбрана модель из встроенной группы, а не из вашего провайдера | Выберите строку модели под именем своего провайдера |
| Не находите форму пользовательского провайдера | Открыта правка встроенного DeepSeek или каталога готовых провайдеров | Settings → Models → «Add a custom provider» |
| Список моделей не загружается | Некорректный Base URL или у сервиса не работает GET /models | Проверьте адрес (обычно оканчивается на /v1) командой curl вне harness |
| Не принимаются изображения | Для пользовательских моделей dsh по умолчанию считает, что они работают только с текстом | Явно укажите поддержку изображений в параметрах модели, если сервис её имеет |
| Сервис отвечает ошибкой на системные сообщения | Старые OpenAI-совместимые реализации не знают роль developer | Отключите её поддержку в параметрах провайдера и повторите |
| Порт занят | Уже запущен другой экземпляр или другая программа | Запустите с другим портом: npx @deepseek-ai/dsh web --port 8080 |
| Нет установщика для Linux | Настольное приложение выпускается для macOS и Windows | Используйте веб-режим: npx @deepseek-ai/dsh web |
Ошибка при --host 0.0.0.0 | Веб-профиль намеренно запрещает такой адрес | Это защита; для доступа извне используйте отдельные параметры доверенного адреса и осознанно оцените риск |
| Поведение изменилось после обновления | Developer preview: возможны несовместимые изменения | Закрепите конкретную версию и проверяйте обновления на тестовой задаче |
Как проверить провайдера вне harness
Прежде чем искать ошибку в настройках dsh, убедитесь, что сам сервис отвечает. Две команды закрывают большинство вопросов:
# 1. Список моделей (должен вернуться JSON)
curl -s https://api.aitunnel.ru/v1/models \
-H "Authorization: Bearer $AITUNNEL_API_KEY" | head -c 400
# 2. Простой запрос к chat/completions
curl -s https://api.aitunnel.ru/v1/chat/completions \
-H "Authorization: Bearer $AITUNNEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"ping"}]}'
Если оба запроса работают, проблема в настройках harness. Если нет — проверяйте ключ и идентификатор модели: таблица ошибок для AITUNNEL.
Нужен API-ключ сегодня
Регистрация по email или Telegram занимает пару минут, оплата идёт в рублях, VPN не нужен. Один ключ работает и с DeepSeek, и с другими моделями.
Приватность и безопасность
Это не ошибка, но частая причина неприятных сюрпризов. При работе с официальным API по умолчанию включена отправка журналов сессий, чтение файлов и сеть не изолированы, а в настольном приложении аналитика регулируется отдельно. Список настроек и способы их изменить: что проверить до запуска.
Если dsh не подходит
Для стабильной работы без ежедневных правок конфигурации рассмотрите другие оболочки: сравнение Harness, Claude Code и Codex, либо подключите DeepSeek к привычному редактору: Cursor, Cline, Continue.
Частые вопросы
Почему dsh пишет UNKNOWN_MODEL
Выбранной модели нет в списке пользовательского провайдера. Добавьте её идентификатор или загрузите список кнопкой Fetch available models.
Как понять, что запросы идут в мой провайдер
Выберите в чате строку модели, которая находится в группе вашего провайдера, и проверьте расход в кабинете сервиса.
Есть ли DeepSeek Harness для Linux
Настольного приложения для Linux нет, но веб-режим запускается командой npx на любой системе с Node.js.
Ещё по теме
- Подключение через AITUNNEL Один ключ, оплата в рублях, OpenAI- и Anthropic-совместимые адреса.
- DeepSeek Harness (dsh): что это и как подключить Открытый агентный рантайм DeepSeek.
- Harness, Claude Code и Codex: сравнение Что выбрать для агента.
- DeepSeek в Claude Code Настройка через Anthropic-совместимый адрес.