# OpenCode Source: https://provod.ai/ru/docs/opencode ## Выберите установщик или ручную настройку В OpenCode **поставщик** — это именованное подключение к API с моделями и параметрами соединения. Установщик настраивает уже установленный OpenCode, но не устанавливает сам OpenCode. Он авторизованно запрашивает `GET /v1/models`, добавляет или обновляет поставщика `provod` и переносит в локальный файл названия, лимиты, возможности, типы данных и публичные цены из ответа. Используйте установщик для настройки по актуальному каталогу. Ручное подключение подходит, когда нужно самостоятельно проверить и объединить каждое поле. ## Запустите установщик macOS и Linux Windows PowerShell ```bash export PROVOD_API_KEY="sk_..." curl -fsSL https://app.provod.ai/install/opencode.sh | \ PROVOD_API_KEY="$PROVOD_API_KEY" sh ``` ```powershell $env:PROVOD_API_KEY = "sk_..." irm https://app.provod.ai/install/opencode.ps1 | iex ``` Установщик сохраняет ключ отдельно в `~/.config/opencode/provod-api-key`, а в конфиг добавляет ссылку `{file:~/.config/opencode/provod-api-key}`. Не добавляйте файл ключа в репозитории или общие резервные копии. Чтобы использовать нестандартный файл, задайте `OPENCODE_CONFIG` до команды. Иначе установщик проверяет `~/.config/opencode/opencode.json`, затем `opencode.jsonc` и создаёт `opencode.json`, если файлов нет. Обе версии проверяют сформированный конфиг и делают резервную копию существующего файла перед заменой. Установщик не выбирает модель по умолчанию: после установки выберите нужную модель через `/models`. ## Настройте подключение вручную Сначала экспортируйте ключ и выберите доступный точный идентификатор через `GET /v1/models`. Затем замените каждую строку `model-id-from-GET-v1-models` ниже на этот идентификатор, а вместо указанной в примере переменной `PROVOD_API_KEY` вставьте текущее значение ключа. ```bash export PROVOD_API_KEY="sk_..." ``` **Ручная настройка сохраняет ключ открытым текстом** Значение `apiKey` записывается в локальный файл настроек OpenCode. Защищайте файл как секрет, не добавляйте его в репозитории и общие резервные копии, а для OpenCode создайте отдельный ключ с подходящим лимитом расходов. ```json { "$schema": "https://opencode.ai/config.json", "model": "provod/model-id-from-GET-v1-models", "provider": { "provod": { "npm": "@ai-sdk/openai-compatible", "name": "provod.ai", "options": { "baseURL": "https://api.provod.ai/v1", "apiKey": "paste-value-from-PROVOD_API_KEY" }, "models": { "model-id-from-GET-v1-models": { "name": "model-id-from-GET-v1-models" } } } } } ``` Сохраните пример как `~/.config/opencode/opencode.json`, затем ограничьте доступ к каталогу и файлу с ключом текущим пользователем. Если `OPENCODE_CONFIG` указывает другой путь, задайте этому файлу такие же права только для владельца: ```bash chmod 700 ~/.config/opencode chmod 600 ~/.config/opencode/opencode.json ``` Ручной пример задаёт только подключение. Установщик удобнее, если OpenCode должен получить из каталога актуальные лимиты контекста и ответа, поддержку рассуждений, инструментов и изображений, а также цены. ## Проверьте текущую конфигурацию Выведите модели, которые OpenCode загрузил для поставщика: ```bash opencode models provod ``` Выберите одну через `/models` или напрямую запустите текущий ID из каталога: ```bash export PROVOD_MODEL="model-id-from-GET-v1-models" opencode run --model "provod/$PROVOD_MODEL" "Reply with ok" ``` ## Восстановите или обновите конфигурацию В macOS/Linux установщик выводит путь к резервной копии с отметкой времени. Если объединённый файл перестал загружаться, остановите OpenCode, сохраните нерабочий файл для сравнения, восстановите указанную копию и перед повторным запуском проверьте `OPENCODE_CONFIG`. Если установщик не может безопасно объединить настройки или сохранить комментарии JSONC, он не заменяет исходный файл и записывает рядом отдельный фрагмент `provod-opencode-provider.jsonc` для проверки. PowerShell также выводит путь созданной резервной копии при успешном обновлении существующего файла. Повторный запуск обновляет каталог; копировать новые идентификаторы моделей с этой страницы не нужно. **Публичный код ошибки** — это предназначенное для клиента значение `error.code` из ответа API. Сохраните его вместе с HTTP-статусом, точным идентификатором модели, временем, версией OpenCode, путём к файлу настроек и маскированным префиксом ключа. Безопасная работа с ключом описана в [авторизации API](/ru/docs/authentication), а формат запроса — в [Chat Completions](/ru/docs/chat-completions). ## Решение проблем **OpenCode не показывает поставщика provod** Выполните `opencode models provod`, затем убедитесь, что активен файл `~/.config/opencode/opencode.json`, или явно задайте `OPENCODE_CONFIG`. После изменения файла перезапустите OpenCode. **Установщик не может загрузить модели** Проверьте тот же ключ через `GET /v1/models`, убедитесь, что в активном рабочем пространстве есть доступная модель, и проверьте доступность `PROVOD_API_KEY` процессу установщика, не выводя значение ключа. **После установки файл настроек перестал загружаться** Восстановите копию, путь к которой вывела версия для macOS/Linux, или ручную копию для Windows. Если создан отдельный фрагмент поставщика, проверьте и объедините его, не заменяя весь файл. **Настроенная модель исчезла или устарела** Повторно запустите установщик, чтобы обновить поставщика по текущему каталогу, либо замените все ручные значения одним точным доступным идентификатором. Не сохраняйте лимиты и возможности из старой записи модели. **Файл настроек или резервная копия раскрыли ключ API** Отзовите ключ в кабинете, создайте новый и обновите защищённые копии конфигурации. Простое удаление файла не отзывает раскрытый ключ. ## 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).