Один ключ к DeepSeek, GPT, Claude и Gemini — оплата в рублях, доступ без VPN.

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

DeepSeek Harness (dsh): установка, настройка провайдера и первый запуск

DeepSeek Harness (команда dsh) — это открытый агентный рантайм, который позволяет запускать ИИ-агентов локально на своём компьютере. В этой инструкции — как установить harness, подключить к нему модель DeepSeek (или другую) и сделать первый запрос.

Для кого эта инструкция

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

Что такое DeepSeek Harness

DeepSeek Harness (dsh) — это программа-обёртка вокруг языковой модели, которая даёт ей инструменты: работу с файлами, запуск кода, поиск в интернете, доступ к терминалу. Агент сам решает, когда и какой инструмент применить, чтобы выполнить вашу задачу.

Ключевые особенности:

  • Открытый код — лицензия MIT, можно использовать бесплатно.
  • Локальный запуск — всё работает на вашем компьютере, ничего не уходит в облако (кроме самих запросов к API модели).
  • Любая модель — подключается к любому OpenAI-совместимому API.
  • Плагины — инструменты, адаптеры моделей и безопасность расширяются через плагины.

Установка DeepSeek Harness

Способ 1. Быстрый запуск через npx (рекомендуется)

Самый простой способ — запустить harness одной командой. Убедитесь, что у вас установлен Node.js (версия 18+).

bash
npx @deepseek-ai/dsh web

После выполнения команды откройте браузер и перейдите на http://127.0.0.1:3080. Если всё прошло успешно, вы увидите веб-интерфейс DeepSeek Harness.

Способ 2. Настольное приложение

Для Windows и macOS доступны десктопные сборки на GitHub проекта. Скачайте установщик для своей платформы и запустите.

Способ 3. Headless-режим (для серверов)

Если вы хотите запустить harness без веб-интерфейса (например, на сервере), используйте:

bash
npx @deepseek-ai/dsh --headless

Настройка провайдера и подключение API-ключа

После установки нужно подключить модель. Harness не включает модель «из коробки» — он подключается к API.

Шаг 1. Получите API-ключ

Вам нужен ключ от любого OpenAI-совместимого API:

  • Официальный DeepSeek API — ключ с platform.deepseek.com (нужна зарубежная карта).
  • AITUNNEL — ключ sk-aitunnel-... с оплатой в рублях. Один ключ для DeepSeek, GPT, Claude. Подробнее об AITUNNEL →

Получить ключ AITUNNEL для Harness

Оплата в рублях, без VPN, доступ к DeepSeek, GPT и Claude по одному ключу.

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

Шаг 2. Добавьте провайдера в веб-интерфейсе

Откройте веб-интерфейс dsh (http://127.0.0.1:3080). Перейдите в Settings → Models и нажмите Add Custom Provider. Заполните поля:

Настройка провайдера в DeepSeek Harness
Поле Значение для AITUNNEL Значение для DeepSeek
Base URL https://api.aitunnel.ru/v1 https://api.deepseek.com
API Key sk-aitunnel-... sk-...
Модели (через запятую) deepseek-v4.1-flash, gpt-6-luna, claude-haiku-5.5 deepseek-flash, deepseek-v4-pro

Сохраните настройки. Если всё указано верно, в выпадающем списке моделей появятся добавленные модели.

Шаг 3. Выберите модель и начните работу

В интерфейсе чата выберите одну из добавленных моделей, напишите задачу и отправьте. Harness сам решит, какие инструменты применить.

Типичные проблемы при установке

Частые ошибки DeepSeek Harness и их решение
Ошибка Причина Решение
UNKNOWN_MODEL Модель не добавлена в список провайдера Перейдите в Settings → Models и добавьте точное имя модели из каталога провайдера
Port 3080 already in use Порт занят другим процессом Закройте другой процесс или смените порт: npx @deepseek-ai/dsh web --port 3081
Unsupported model Модель не найдена у провайдера Проверьте имя модели в каталоге сервиса — у AITUNNEL идентификаторы отличаются от официальных
Request timeout Модель не отвечает в течение лимита Проверьте API-ключ и баланс. Для моделей с режимом рассуждений увеличьте max_tokens до 50 000+
No build for Linux Нативная сборка под Linux не найдена Используйте npx-версию — она работает на всех платформах

Первый запрос к агенту

После подключения модели попробуйте такой запрос:

text
Создай файл hello.txt с приветствием на трёх языках: русском, английском и китайском. Используй инструмент для работы с файлами.

Если агент работает корректно, он выполнит задачу: создаст файл, запишет в него текст и сообщит результат. Если агент запрашивает подтверждение на выполнение команд — подтвердите.

Советы по настройке

  • Начните с минимальной модели — для первых тестов используйте deepseek-flash или deepseek-v4.1-flash. Они быстрые и дешёвые.
  • Установите лимит бюджета — в AITUNNEL можно задать дневной лимит на ключ, чтобы случайно не потратить лишнего.
  • Для сложных задач используйте v4-pro — если агент не справляется с flash, переключитесь на deepseek-v4-pro. Он лучше рассуждает.
  • Не давайте агенту доступ к критичным файлам — песочница harness ограничивает доступ, но лучше перестраховаться.

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

DeepSeek Harness работает на Windows?

Да, npx-версия работает на Windows, macOS и Linux. Десктопное приложение доступно для Windows и macOS. Версия через npx универсальна.

Сколько стоит использование DeepSeek Harness

Сам harness бесплатный. Вы платите только за токены модели, которую используете. DeepSeek V4 Flash через AITUNNEL стоит от 13 ₽ за 1M токенов ввода. Одна сессия с агентом обычно обходится в копейки.

Можно ли использовать Harness без интернета

Нет, harness отправляет запросы к API модели через интернет. Сам код выполняется локально, но модель должна быть доступна через сеть. Локальные модели через Ollama или LM Studio тоже подходят, но это отдельная настройка.

Какой API-ключ нужен для DeepSeek Harness

Любой OpenAI-совместимый: официальный ключ DeepSeek, ключ AITUNNEL или другой агрегатор. В настройках провайдера указываете base_url, ключ и список моделей.

Для Harness нужен API-ключ

DeepSeek Harness подключается к любой OpenAI-совместимой модели. Через AITUNNEL вы получите ключ для DeepSeek, GPT и Claude — один ключ для всех агентов.

  • Один ключ на все модели
  • Оплата в рублях и счёт для юрлиц
  • Совместимо с OpenAI SDK