Инструкция

ИИ-агент на своём компьютере

Пошагово ставим DeepSeek Harness — открытую программу-оболочку для ИИ-агента — и подключаем к ней ключ Китай-API. Сама программа бесплатная, платите только за запросы к модели. Понадобится компьютер с Windows или macOS, интернет и минут пятнадцать. Если что-то пойдёт не так, в конце разобраны частые ошибки.

Сначала честно о том, что это такое DeepSeek Harness — не чат для разговоров. Это агент: он умеет читать файлы на вашем компьютере, выполнять команды и работать с папками по вашей задаче. Если нужен просто собеседник вроде того, что у внука в телефоне, хватит обычного чата — агент для этого не нужен. Программа в статусе developer preview: пункты меню и команды могут меняться от версии к версии, а серьёзные задачи на ней пока лучше не строить.

Что понадобится

До начала установки

Компьютер: Windows 10 или 11, либо macOS. Подойдёт обычный ноутбук, ничего докупать не нужно. Ставить лучше на свой личный компьютер, а не на рабочий с чужими документами.
Аккаунт Китай-API: Регистрация в кабинете, затем пополнение баланса. На пробу хватит 300–500 ₽: запросы к дешёвым моделям стоят копейки.
API-ключ: Создаётся в кабинете в разделе с ключами. Выглядит как строка sk-kitai-…. Это пароль от вашего баланса: никому его не показывайте и не вставляйте в переписку.
Интернет: Первый запуск скачивает программу из сети. Если интернет медленный, это займёт несколько минут — так и должно быть.

Установка по шагам

Каждый шаг с проверкой

01

Поставить Node.js

Откройте nodejs.org и скачайте версию с пометкой LTS. Запустите установщик и жмите «Далее», ничего не меняя. Нужна версия 22.19 или новее — на странице загрузки она и предлагается.

Зачем: DeepSeek Harness написан на JavaScript и работает в среде Node.js. Без неё команда из следующего шага просто не найдётся.

02

Проверить, что установилось

Windows: нажмите «Пуск», наберите cmd и откройте «Командная строка». macOS: откройте «Терминал» через Spotlight (лупа справа сверху), набрав Терминал.

В чёрном окне наберите node -v и нажмите Enter. Должно ответить что-то вроде v22.19.0. Если вместо этого написано «не является внутренней или внешней командой» — Node не установился или окно открыто старое: перезапустите терминал.

03

Запустить DeepSeek Harness

В том же окне наберите одну строку и нажмите Enter:

npx @deepseek-ai/dsh web

Первый запуск скачает программу — минуту или две будет видно, как идут строки загрузки. Когда всё готово, откроется браузер с адресом http://127.0.0.1:3080. Если браузер не открылся, введите этот адрес вручную. Окно терминала не закрывайте: программа работает, пока оно открыто.

04

Получить ключ в кабинете

Зайдите в кабинет, пополните баланс и создайте API-ключ. Скопируйте его целиком, вместе с началом sk-kitai-. Держите под рукой до следующего шага.

05

Подключить Китай-API

В открывшемся окне программы откройте настройки (Settings) и раздел с моделями (Models). Добавьте нового поставщика как OpenAI-совместимый и заполните три поля:

Адрес API (Base URL): https://api.kitai-api.ru/v1
Ключ (API Key): ваш sk-kitai-…
Модель (Model): deepseek-v4-flash — дешёвая и быстрая; deepseek-v4-pro — умнее и дороже

Названия пунктов меню зависят от версии программы. Если отдельного поля для своего адреса нет, закройте программу и запустите её с переменными окружения: они подменяют адрес и ключ по умолчанию.

Windows, по одной строке в командной строке:

set DEEPSEEK_BASE_URL=https://api.kitai-api.ru/v1
set DEEPSEEK_API_KEY=sk-kitai-ваш-ключ
npx @deepseek-ai/dsh web

macOS, по одной строке в терминале:

export DEEPSEEK_BASE_URL=https://api.kitai-api.ru/v1
export DEEPSEEK_API_KEY=sk-kitai-ваш-ключ
npx @deepseek-ai/dsh web

После закрытия терминала эти строки сбрасываются, и при следующем запуске их нужно повторить. Настройки, сохранённые внутри самой программы, остаются.

06

Проверить, что модель отвечает

Создайте на рабочем столе папку без важных файлов, например «проба», выберите её как рабочую папку и напишите в поле задачи: «Объясни в двух предложениях, что такое API, и подпишись названием модели, которая ответила». Ответ придёт за несколько секунд. Если вместо него ошибка — смотрите разбор ниже.

07

Ограничить права агента

В настройках безопасности выберите режим без полного доступа — чтение или работа только внутри выбранной папки. Агент, которому разрешено всё, может изменить или удалить файлы на компьютере. Пока вы не поняли, как он себя ведёт, полный доступ не включайте.

Сколько это стоит

Платите только за запросы

Подписки нет. Деньги списываются с баланса за токены — куски текста, которые модель прочитала и написала. У DeepSeek V4-Flash это 30 ₽ за миллион входных токенов и 120 ₽ за миллион выходных, вне часов пика. Простыми словами: обычный вопрос и ответ на абзац — около 10 копеек, в пиковое окно вдвое дороже. По будням с 04:00 до 07:00 и с 09:00 до 13:00 по Москве DeepSeek берёт двойной тариф; это условие провайдера, на другие модели оно не распространяется. Стоимость каждого запроса видна в кабинете, а потратить агент может только то, что лежит на балансе.

Цены на модели — в таблице на главной. Точный расход по вашим задачам покажет калькулятор.

Если что-то не работает

Частые ошибки и что делать

«node не является внутренней или внешней командой»: Node.js не установлен или терминал открыт до установки. Закройте окно, откройте заново и повторите node -v. Если снова не находит — переустановите Node.js и перезагрузите компьютер.
Программа пишет «Invalid token» или «неверный ключ»: Ключ скопирован не полностью или взят из другого сервиса. Он должен начинаться с sk-kitai- и не содержать пробелов. Создайте новый ключ в кабинете и вставьте заново.
«Insufficient balance» или «недостаточно средств»: Закончился баланс. Пополните счёт в кабинете. Даже при нулевом балансе ключ остаётся рабочим — запросы пойдут сразу после пополнения.
Браузер с программой не открылся: Откройте адрес http://127.0.0.1:3080 вручную. Если страница не грузится — закройте терминал и запустите команду заново, дождавшись конца загрузки.
Ответ идёт слишком долго: У DeepSeek бывают пиковые окна, когда запросы обрабатываются медленнее. Проверить текущее состояние и время ответа по каждой модели можно на странице статуса.
Агент просит разрешение на команду: Так и должно быть. Читайте, что он собирается сделать, прежде чем разрешать. Всё, что связано с удалением файлов, сменой настроек системы и доступом к паролям, — повод остановиться.

О безопасности

Коротко и без обещаний

Агент работает на вашем компьютере и видит то, что вы ему показали: выбранную папку, файлы в ней, введённые задачи. Ключ Китай-API остаётся в настройках программы на вашем компьютере, а запросы уходят на наш шлюз. Мы не пишем содержимое запросов в журналы; что именно передаётся поставщику модели — разобрано на странице «Безопасность и данные».

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

Застряли на каком-то шаге

Позвоните или напишите — разберём вместе. Это бесплатно, помощь по установке не входит в стоимость запросов.

8 909 805-96-31 Написать в Telegram