Как подключить ключ kosareva.cloud к DeepSeek Harness

DeepSeek Harness: официальная страница и интерфейс десктопного приложения.

Кратко

DeepSeek Harness — открытый агент для работы с кодом, файлами, терминалом, документами и долгими фоновыми задачами. Чтобы запустить его с моделями через kosareva.cloud, добавьте в настройках Custom model API, укажите OpenAI-совместимый адрес https://api.kosareva.cloud/v1 и вставьте свой ключ. В стандартную карточку DeepSeek ключ kosareva.cloud вводить не нужно: там нельзя заменить адрес API.

DeepSeek выпустила Harness в публичное превью для macOS и Windows. Это не просто чат: агент получает рабочую папку, читает и меняет файлы, запускает команды, проверяет код и может продолжать задачу в фоне. Сам Harness открыт под лицензией MIT, а его возможности расширяются плагинами.

Ниже — настройка ключа kosareva.cloud без правки конфигурационных файлов.

Что такое DeepSeek Harness

DeepSeek Harness — это open-source-среда для автономных AI-агентов, построенная по принципу «всё является плагином».

На практике вы выбираете папку проекта и описываете задачу обычным текстом. Harness может изучить репозиторий, исправить ошибку, добавить функцию, запустить тесты и показать историю действий. Тем же способом он работает с таблицами, документами, исследованиями и пакетной обработкой файлов.

Плагины добавляют инструменты, навыки и элементы интерфейса. Их можно устанавливать готовыми или собирать в Creator mode через диалог с агентом. Есть экспериментальные плагины для команд агентов, задач по расписанию, голосового ввода и автоматического ревью.

Важно учитывать статус проекта: Harness пока находится в публичном превью. Разработчики прямо предупреждают, что между версиями возможны несовместимые изменения.

Зачем Harness нужен отдельный API-ключ

Сам Harness не генерирует ответы. Он отправляет запросы выбранной языковой модели, а API-ключ подтверждает доступ и связывает расход токенов с вашим балансом.

Ключ kosareva.cloud можно использовать в Harness через OpenAI-совместимый интерфейс. В таком подключении остаются постоянными два значения:

• адрес API — https://api.kosareva.cloud/v1;

• ключ — ваш токен из кабинета kosareva.cloud.

Модель выбирается отдельно. Это удобно, если для обычных правок вы используете одну модель, а для сложного рефакторинга — другую: новый ключ создавать не приходится.

Как вставить ключ kosareva.cloud в DeepSeek Harness

1. Установите Harness

Скачайте Desktop-версию с официальной страницы DeepSeek и установите приложение для macOS или Windows.

Если десктопная версия не подходит, Web UI запускается через Node.js одной командой:

npx @deepseek-ai/dsh web

После запуска интерфейс обычно открывается локально по адресу http://127.0.0.1:3080.

2. Создайте ключ в kosareva.cloud

Войдите в кабинет kosareva.cloud, откройте раздел API-ключей и создайте отдельный ключ для Harness. Отдельный ключ проще отключить или ограничить, не затрагивая другие проекты и сотрудников.

Скопируйте токен сразу после создания и не добавляйте его в репозиторий, .env.example, скриншоты или публичные логи.

3. Откройте настройки моделей

В Harness перейдите в Settings → Models и нажмите Add model provider.

Не используйте стандартную карточку DeepSeek для ключа kosareva.cloud. Она принимает только ключ и обращается к заранее заданному адресу. Для собственного адреса API нужна карточка Custom model API.

4. Заполните параметры провайдера

Укажите следующие значения:

• Provider ID: kosareva

• Display name: kosareva.cloud

• Base URL: https://api.kosareva.cloud/v1

• API protocol: OpenAI Chat Completions

• Credential / API key: ваш ключ kosareva.cloud

Provider ID лучше выбрать один раз и больше не менять. Harness использует его в сохранённых сессиях, настройках моделей и ссылках на учётные данные.

5. Добавьте модель

В блоке Model catalog нажмите Fetch available models. Harness запросит список моделей с указанного адреса, используя введённый ключ. Отметьте нужную модель и нажмите Add selected.

Если список не загрузился, добавьте идентификатор модели вручную. Берите точное значение из актуального каталога kosareva.cloud: регистр, дефисы и версия модели должны совпадать.

Сохраните провайдера, выберите добавленную модель для новой сессии и отправьте короткую тестовую задачу — например, попросите Harness прочитать README.md и пересказать структуру проекта, ничего не меняя.

Как проверить ключ до настройки Harness

Если Harness возвращает ошибку авторизации, сначала проверьте ключ отдельно. Так проще понять, проблема в доступе к API или в настройках агента.

Проверка через cURL

export KOSAREVA_API_KEY="ваш_ключ"

curl https://api.kosareva.cloud/v1/models \
  -H "Authorization: Bearer $KOSAREVA_API_KEY"

В ответ должен прийти список доступных моделей. Не вставляйте настоящий ключ прямо в команду, если терминал сохраняет историю.

Проверка через Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KOSAREVA_API_KEY"],
    base_url="https://api.kosareva.cloud/v1",
)

model_id = os.environ["KOSAREVA_MODEL"]

response = client.chat.completions.create(
    model=model_id,
    messages=[
        {"role": "user", "content": "Ответь одним словом: работает"}
    ],
)

print(response.choices[0].message.content)

Перед запуском задайте две переменные окружения: KOSAREVA_API_KEY и KOSAREVA_MODEL. Во второй укажите точный идентификатор из каталога.

Если Harness не принимает ключ

Ошибка 401

Проверьте, что ключ скопирован целиком, без пробела в начале или конце. Затем повторите запрос к /v1/models. Если cURL тоже получает 401, проблема не в Harness.

Модель не найдена

Проверьте поле Model ID. Название, которое человек видит в каталоге, и технический идентификатор могут отличаться. Безопаснее загрузить список кнопкой Fetch available models, чем печатать значение по памяти.

Harness отправляет запрос не туда

Обычно это случается, если ключ вставили в стандартную карточку DeepSeek. Создайте Custom model API и ещё раз проверьте Base URL: https://api.kosareva.cloud/v1.

Настройки изменились, но старая сессия ведёт себя по-прежнему

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

Что стоит ограничить заранее

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

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

Чего здесь нет

Подключение ключа не превращает Harness в полностью изолированную локальную систему: запросы к модели уходят через API. Оно также не отменяет стоимость токенов и не гарантирует совместимость любого плагина с каждой будущей версией приложения.

Ещё одно ограничение — протоколы нельзя смешивать внутри одной карточки провайдера. Для описанной настройки выбирайте именно OpenAI Chat Completions. Если отдельному инструменту понадобится другой протокол, для него создаётся отдельная конфигурация.

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

У Harness нет отдельной платы за исходный код: проект опубликован под лицензией MIT. При работе через kosareva.cloud списание идёт за фактически использованные токены выбранной модели, без абонентской платы. Актуальная цена зависит от модели и указана в каталоге kosareva.cloud.

Для агента важна не только цена одного запроса, но и длина всей цепочки. Задача с чтением репозитория, несколькими исправлениями и повторными тестами расходует больше токенов, чем одиночный вопрос. Отдельный ключ и лимит дают более понятный контроль такого расхода.

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

Можно ли вставить ключ kosareva.cloud в стандартное поле DeepSeek API Key?

Нет. Для ключа kosareva.cloud создайте Custom model API, чтобы вместе с ключом указать адрес https://api.kosareva.cloud/v1.

Какой протокол выбрать в DeepSeek Harness?

Для описанной настройки выберите OpenAI Chat Completions. В конфигурации Harness этот протокол хранится как openai-completions.

Где Harness хранит API-ключ?

По документации Harness сохраняет ключ в файле $DSH_HOME/.credentials.yaml. Интерфейс после сохранения получает только скрытое описание ключа, а не его полный текст.

Нужно ли перезапускать Harness после смены модели?

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

Можно ли использовать один ключ для нескольких моделей?

Да. Ключ и Base URL остаются прежними, а нужная модель выбирается по её идентификатору. Для разных проектов удобнее выпускать отдельные ключи и задавать им собственные лимиты.

Итог

DeepSeek Harness отделяет оболочку агента от модели: интерфейс, файлы, терминал и плагины живут в Harness, а доступ к нейросети задаётся провайдером. Для kosareva.cloud этот провайдер настраивается как Custom model API с адресом https://api.kosareva.cloud/v1 и протоколом OpenAI Chat Completions.

Главная деталь — не вставлять ключ в стандартную карточку DeepSeek. Если указать и ключ, и правильный Base URL, Harness сможет получать список моделей и запускать агентные задачи через один OpenAI-совместимый доступ.

Источники

• DeepSeek Harness — официальная страница
• DeepSeek Harness — репозиторий на GitHub
• Документация DeepSeek Harness: настройка моделей
• kosareva.cloud — AI API и каталог моделей