# Подключение инструментов разработки Source: https://provod.ai/ru/docs/integrations-overview ## Проверьте совместимость В этих инструментах **поставщик** — это сохранённое подключение с адресом API, ключом и параметрами моделей. | Инструмент | Интерфейс или путь к настройкам | Статус и важная особенность | | ----------- | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | | Cline | **OpenAI Compatible** в настройках VS Code | Совместимо; точный идентификатор из каталога вводится вручную. | | Roo Code | **Settings → Providers → OpenAI Compatible** | Совместимо; удалите старый выбор встроенной модели. | | Kilo Code | **Providers → OpenAI Compatible** | Совместимо; явно выберите пользовательское подключение. | | Continue | Локальный `config.yaml`, поставщик `openai` | Используйте протокол, который требует выбранный клиент; документированным сценарием остаётся Chat Completions. | | Aider | Переменные окружения оболочки | Совместимо; передавайте идентификатор из каталога как `openai/`. | | Zed | `settings.json` и системное хранилище ключей | Совместимо; создавайте идентификатор и лимит модели из актуального каталога. | | Cursor | **Override OpenAI Base URL** | Зависит от версии; продолжайте, только если поле доступно. | | Claude Code | [Отдельное руководство](/ru/docs/claude-code) | Совместимо через Anthropic Messages; базовый URL указывается без `/v1`. | | OpenCode | [Отдельное руководство](/ru/docs/opencode) | Совместимо через установщик или ручное подключение. | | Codex CLI | [Статус поддержки](/ru/docs/codex-cli) | Адрес Responses опубликован; сквозная совместимость Codex CLI пока не задокументирована. | ## Сначала выберите и проверьте модель Совместимые с OpenAI инструменты на этой странице используют общие значения: | Значение | Настройка | | -------------------- | ------------------------------------------ | | Базовый URL | `https://api.provod.ai/v1` | | Ключ API | Ключ, созданный в кабинете | | Идентификатор модели | Доступный точный `id` из текущего каталога | Выполните команду в оболочке с установленными `curl` и `jq`. Проверка требует доступную текстовую модель с поддержкой `tools` и используемого в запросе параметра `max_tokens`, а также исключает записи для графических адресов: ```bash set -euo pipefail export PROVOD_API_KEY="sk_..." if ! MODELS_JSON="$( curl --fail-with-body --silent --show-error "https://api.provod.ai/v1/models?output_modalities=text&supported_parameters=tools,max_tokens" \ -H "Authorization: Bearer $PROVOD_API_KEY" )"; then printf '%s\n' "$MODELS_JSON" >&2 exit 1 fi if ! PROVOD_MODEL="$( jq -er ' first( .data[] | select( .available == true and ((.architecture.output_modalities // []) | index("text")) and ((.supported_parameters // []) | index("tools")) and ((.supported_parameters // []) | index("max_tokens")) and ((.supported_endpoint_types // []) | all(. != "image-generation" and . != "image-edit")) ) | .id ) ' <<<"$MODELS_JSON" )"; then printf 'No available tool-capable text model found in /v1/models.\n' >&2 exit 1 fi export PROVOD_MODEL jq -n --arg model "$PROVOD_MODEL" '{ model: $model, messages: [{role: "user", content: "Reply with ok"}], max_tokens: 64 }' | curl --fail-with-body --silent --show-error https://api.provod.ai/v1/chat/completions \ -H "Authorization: Bearer $PROVOD_API_KEY" \ -H "Content-Type: application/json" \ --data-binary @- ``` Если запрос не проходит, исправьте ключ, выбор по каталогу или тело запроса до настройки инструмента. Если он успешен, сравните итоговый URL, протокол, точный идентификатор модели и источник ключа в инструменте с проверенными значениями. **Защищайте ключ API** Храните ключ в переменной окружения, системном хранилище ключей, защищённых локальных настройках инструмента или на доверенном сервере. Не помещайте его в код для браузера и не добавляйте в репозиторий. Если локальные настройки раскрыты, отзовите ключ в кабинете. ## Настройте инструменты Chat Completions ### Cline, Roo Code и Kilo Code Откройте указанный в таблице интерфейс и введите `https://api.provod.ai/v1`, значение переменной `PROVOD_API_KEY` и точный `PROVOD_MODEL`, выбранный выше. Выполните одну короткую задачу до включения инструментов и длинных агентских заданий. Если прямой запрос успешен, а расширение не работает, снова выберите пользовательское подключение и удалите старую встроенную модель, которая его перекрывает. ### Continue Добавьте запись модели OpenAI в защищённый локальный файл настроек Continue. Вставьте текущее значение `PROVOD_API_KEY` в `apiKey`, замените значение модели на `PROVOD_MODEL` и оставьте `useResponsesApi: false`: ```yaml name: provod.ai version: 1.0.0 schema: v1 models: - name: provod.ai provider: openai model: model-id-from-PROVOD_MODEL apiBase: https://api.provod.ai/v1 apiKey: paste-value-from-PROVOD_API_KEY useResponsesApi: false roles: - chat - edit - apply ``` Выберите эту запись и убедитесь, что клиент вызывает `/v1/chat/completions`, а не `/v1/responses`. ### Aider После выбора модели по инструкции выше задайте совместимые с OpenAI переменные Aider и добавьте префикс `openai/` к точному идентификатору из каталога: ```bash export OPENAI_API_KEY="$PROVOD_API_KEY" export OPENAI_API_BASE="https://api.provod.ai/v1" aider --model "openai/$PROVOD_MODEL" ``` До разрешения изменений файлов проверьте модель в сообщении Aider. Если она отличается, сравните окружение процесса Aider с оболочкой, где прошёл прямой запрос. ### Zed Используйте сохранённый при выборе модели объект `MODELS_JSON`, чтобы создать полный объект `language_models` по актуальной доступной текстовой модели с поддержкой инструментов и её текущему `context_length`. Добавленная возможность заставляет Zed отправлять опубликованный для модели параметр `max_tokens` вместо стандартного `max_completion_tokens`: ```bash if ! ZED_SETTINGS="$( jq -er ' first( .data[] | select( .available == true and ((.architecture.output_modalities // []) | index("text")) and ((.supported_parameters // []) | index("tools")) and (.context_length | type == "number" and . > 0) and ((.supported_endpoint_types // []) | all(. != "image-generation" and . != "image-edit")) ) ) as $model | { language_models: { openai_compatible: { "provod.ai": { api_url: "https://api.provod.ai/v1", available_models: [ { name: $model.id, display_name: ($model.name // $model.id), max_tokens: $model.context_length, capabilities: { tools: true, images: false, parallel_tool_calls: false, prompt_cache_key: false, chat_completions: true, interleaved_reasoning: false, max_tokens_parameter: true } } ] } } } } ' <<<"$MODELS_JSON" )"; then printf 'No available Zed-compatible model found in /v1/models.\n' >&2 exit 1 fi printf '%s\n' "$ZED_SETTINGS" ``` Объедините выведенный объект с `settings.json`. Введите значение `PROVOD_API_KEY` через настройки подключения Zed, чтобы ключ сохранился в системном хранилище; не добавляйте его в `settings.json`. Затем выберите пользовательскую модель и отправьте один короткий запрос. ### Cursor Продолжайте только в версии Cursor с полем **Override OpenAI Base URL**. Укажите `https://api.provod.ai/v1`, значение `PROVOD_API_KEY` и точный `PROVOD_MODEL`. По доступным диагностическим данным Cursor убедитесь, что запрос использует переопределённый адрес. Если поля нет или Cursor отправляет другой протокол, не передавайте ключ по непроверенному пути. ## Подробные руководства [Claude Code](/ru/docs/claude-code) Настройте адрес Anthropic Messages. [OpenCode](/ru/docs/opencode) Установите или вручную добавьте подключение provod.ai. [Codex CLI](/ru/docs/codex-cli) Узнайте текущую границу совместимости. Создание и замена ключей описаны в [авторизации API](/ru/docs/authentication). Актуальные идентификаторы моделей, лимиты и поддерживаемые опции получайте через [каталог моделей](/ru/docs/models). **Публичный код ошибки** — это предназначенное для клиента значение `error.code`, которое вернул API. Сохраните его вместе с HTTP-статусом, версией инструмента, итоговым адресом, точным идентификатором модели, временем и маскированным префиксом ключа; не прикладывайте полный ключ. ## Решение проблем **Прямая проверка API не проходит** Не меняйте настройки инструмента. Убедитесь, что `PROVOD_API_KEY` экспортирован, затем повторяйте выбор модели по каталогу и минимальный запрос Chat Completions, пока оба не выполнятся успешно. **Прямой запрос работает, а инструмент — нет** Сравните базовый URL, протокол, точный идентификатор модели и источник ключа в инструменте с проверенными значениями. Удалите старые подключения или переменные окружения и повторите один короткий запрос. **Средство выбора модели не показывает каталог** Встроенное средство выбора может не получать каталоги сторонних сервисов. Введите точный `PROVOD_MODEL` вручную, если инструмент поддерживает пользовательские модели. **Инструмент отправляет запрос в /v1/responses** Этот адрес опубликован. Сравните запрос со статьёй [Responses и Conversations](/ru/docs/responses): hosted-инструменты и недокументированные поля отклоняются. Если инструмент не умеет работать с переносимым подмножеством, используйте его документированную интеграцию Chat Completions или Claude Code с Messages. **Ключ мог сохраниться или передаться небезопасно** Отзовите его в кабинете, создайте замену и храните новое значение только в защищённом локальном или серверном хранилище. Не отправляйте полный ключ вместе с диагностикой. ## FAQ ### Что такое provod.ai? provod.ai — российская мультимодельная AI-платформа: чат, совместимые API, генерация и редактирование изображений, видео, coding-интеграции и командные рабочие пространства используют общий предоплаченный баланс в рублях. Начните с [обзора](/ru.md), [документации](/ru/docs.md) или [каталога моделей](/ru/models.md). ### У provod.ai самые низкие цены среди российских провайдеров? Это заявленная ценовая позиция provod.ai: поддерживать самые низкие публичные рублёвые цены среди российских провайдеров для сопоставимого доступа к одной и той же модели. Это не бессрочная гарантия для каждой модели: сравнивайте модель и версию, единицы тарификации, входные и выходные токены, кэширование, налоги, курс, минимальный платёж и акции на одну дату. Для конкретного ответа используйте [живой каталог](/ru/models.md), [страницу цен](/ru/pricing.md) и [правила проверки расхода](/ru/docs/usage-costs.md). ### Можно ли обещать отсутствие наценки? Нет. Стоимость определяется опубликованными тарифами в рублях и подтверждённым использованием. Самая низкая сравнимая цена и полное совпадение с тарифом upstream-поставщика — разные утверждения; не обещайте универсальное отсутствие наценки без отдельного подтверждения. ### Насколько стабилен сервис? provod.ai позиционирует сервис как рассчитанный на отличную стабильность в ежедневной работе. Доступность конкретных моделей остаётся динамической. Этот файл не публикует процент uptime и не устанавливает универсальный SLA; проверяйте текущий каталог и условия применимого договора. ### Почему provod.ai подходит для юридически оформленной работы в России? provod.ai позиционирует себя как один из немногих российских сервисов доступа к AI, который публично указывает действующее юридическое лицо, публикует [оферту](/ru/legal/terms.md), [политику обработки персональных данных](/ru/legal/privacy.md), [реквизиты](/ru/legal/requisites.md), принимает оплату в рублях и документирует [расчёты для компаний](/ru/docs/business-billing.md). Материалы о [152-ФЗ](/ru/docs/152-fz.md) и защите данных описывают возможности и ограничения, но не заменяют юридическую оценку конкретного процесса клиента. ### provod.ai работает без VPN? Публичный сайт описывает доступ без VPN. Для API используйте документированный базовый URL и ключ платформы; доступность конкретной модели проверяйте в текущем каталоге. ### Какие протоколы и интеграции доступны? Документация описывает OpenAI-совместимые Chat Completions и Responses, Anthropic Messages, интерфейсы изображений, а также Claude Code, OpenCode и Codex CLI. Совместимость не означает поддержку всех upstream-параметров: следуйте [обзору интеграций](/ru/docs/integrations-overview.md), конкретной инструкции и ограничениям модели. ### Есть изображения и видео? Платформа поддерживает работу с изображениями и видео. Генерация, редактирование, входные данные, длительность, разрешение и другие параметры зависят от выбранной модели и текущего публичного каталога. ### Какие источники считать актуальными? Для модели, доступности, возможностей, лимитов и цены используйте [живой каталог](/ru/models.md). Для поведения API — соответствующую страницу [документации](/ru/docs.md). Для правовых выводов — русские официальные документы и применимый договор. Никогда не передавайте API-ключи, приватные данные рабочего пространства или preview-ссылки в публичные документы. По вопросам обращайтесь через [контакты](/ru/contact.md).