OpenCode Desktop

С Polza.ai вы можете использовать модели Claude, GPT, DeepSeek и другие через единый API-ключ — без отдельных аккаунтов у каждого провайдера. В этой инструкции покажем, как подключить Polza.ai к настольному приложению OpenCode на macOS и Windows.

Совместимость: Windows 10/11 и macOS, OpenCode Desktop 2.x. Инструкция проверена на версии 2.2.0.

Это инструкция для настольного приложения OpenCode. Терминальный вариант (CLI) — отдельная страница: OpenCode.

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

Установленное приложение OpenCode.
Аккаунт Polza.ai с положительным балансом.
API-ключ Polza.ai.
Терминал на macOS или PowerShell на Windows — стандартные инструменты обеих систем.

Получите API-ключ Polza.ai

Войдите в личный кабинет Polza.ai.

Перейдите в раздел «API-ключи».
Создайте новый ключ или используйте существующий.

Сохраните ключ — он понадобится для подключения OpenCode.

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

Создайте файл конфигурации OpenCode

macOS
Windows

Откройте приложение «Терминал» на macOS и выполните команду:

mkdir -p ~/.config/opencode
touch ~/.config/opencode/opencode.json
open -e ~/.config/opencode/opencode.json

Команды создадут папку конфигурации, если её ещё нет, и откроют файл opencode.json в TextEdit.

Нажмите Win + X и выберите «Терминал» или «Windows PowerShell». Права администратора не требуются.Выполните следующую команду:

New-Item -ItemType Directory -Force "$HOME\.config\opencode" | Out-Null

Она создаст папку конфигурации OpenCode, если её ещё нет.Теперь создайте файл opencode.json, если он отсутствует, и откройте его в Блокноте:

$file = "$HOME\.config\opencode\opencode.json"
if (!(Test-Path $file)) {
    New-Item -ItemType File -Path $file | Out-Null
}
notepad $file

Файл конфигурации будет находиться по адресу:

macOS
Windows

~/.config/opencode/opencode.json

%USERPROFILE%\.config\opencode\opencode.json

Например:

C:\Users\Username\.config\opencode\opencode.json

Обратите внимание: OpenCode использует файл opencode.json или opencode.jsonc. Файл service.json для этой настройки не подходит. Если файл opencode.json уже существует, не удаляйте его содержимое. Провайдера Polza.ai нужно добавить к текущим настройкам.

Добавьте провайдера Polza.ai

Если файл opencode.json пустой, вставьте в него следующую конфигурацию:

{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "polza": {
      "name": "Polza.ai",
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://polza.ai/api/v1",
        "apiKey": "{file:~/.config/opencode/provider-key}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5",
          "modelID": "anthropic/claude-sonnet-5"
        },
        "deepseek-v4-flash": {
          "name": "DeepSeek V4 Flash",
          "modelID": "deepseek/deepseek-v4-flash"
        }
      }
    }
  }
}

Сохраните файл — Cmd + S на macOS или Ctrl + S на Windows.В конфигурации указаны две модели для примера. Вы сможете добавить другие модели из каталога Polza.ai.

Если у вас уже настроены другие провайдеры, добавьте объект polza внутрь существующего раздела providers, не заменяя остальные настройки.

Подключите API-ключ Polza.ai

Для безопасности сохраним API-ключ отдельно от основного файла конфигурации.

macOS
Windows

Вернитесь в Терминал и выполните:

touch ~/.config/opencode/provider-key
open -e ~/.config/opencode/provider-key

В открывшийся файл вставьте API-ключ Polza.ai.В файле должен находиться только ключ — без кавычек и дополнительных символов.Сохраните файл и закройте TextEdit.Теперь ограничьте доступ к файлу с ключом:

chmod 600 ~/.config/opencode/provider-key

Готово! OpenCode будет автоматически считывать API-ключ из этого файла.

Вернитесь в PowerShell и выполните:

notepad "$HOME\.config\opencode\provider-key"

Если Windows сообщит, что файл не найден, согласитесь создать новый.В открывшийся Блокнот вставьте API-ключ Polza.ai.В файле должен находиться только ключ — без кавычек, пробелов и дополнительного текста.Нажмите Ctrl + S и закройте Блокнот.Храните файл в личной папке пользователя и не предоставляйте к нему общий доступ.

Теперь API-ключ хранится в отдельном файле:

macOS
Windows

~/.config/opencode/provider-key

%USERPROFILE%\.config\opencode\provider-key

OpenCode будет автоматически считывать его благодаря настройке:

{
  "apiKey": "{file:~/.config/opencode/provider-key}"
}

Важно: не переименовывайте файл в provider-key.txt. Убедитесь, что его название — именно provider-key, без расширения.

Перезапустите OpenCode

После перезапуска проверьте подключение:

Полностью закройте приложение OpenCode.
Запустите его повторно.
Откройте меню выбора AI-моделей.
Найдите провайдера Polza.ai.
Выберите Claude Sonnet 5 или DeepSeek V4 Flash.

На macOS закройте приложение через Cmd + Q.Отправьте тестовый запрос, например:

«Привет! Расскажи, как ты можешь помочь мне с разработкой».

Если модель отвечает, подключение работает.

Как добавить другие модели

Вы можете использовать дополнительные модели из каталога Polza.ai.

macOS
Windows

Для этого откройте opencode.json и добавьте нужную модель в раздел models провайдера polza.

Для этого откройте конфигурацию через PowerShell:

notepad "$HOME\.config\opencode\opencode.json"

Внутри раздела models добавьте новую запись:

{
  "providers": {
    "polza": {
      "models": {
        "my-model": {
          "name": "Название модели",
          "modelID": "provider/model-id"
        }
      }
    }
  }
}

Замените provider/model-id на точный идентификатор модели из каталога Polza.ai. Поле my-model определяет локальный идентификатор модели в OpenCode, а name — её отображаемое название.

При добавлении записей соблюдайте синтаксис JSON: соседние объекты должны разделяться запятыми.

После сохранения файла перезапустите приложение.

Если подключение не работает

Polza.ai не появляется в списке моделей

Убедитесь, что:

Файл называется opencode.json, а не opencode.json.txt.
Он находится в %USERPROFILE%\.config\opencode\ на Windows или ~/.config/opencode/ на macOS.
Конфигурация содержит раздел providers.
В JSON нет синтаксических ошибок.
Используется OpenCode Desktop 2.x.

Ошибка авторизации

Проверьте правильность API-ключа в файле provider-key. Убедитесь, что он действителен и не содержит лишних символов.

Модель отображается, но не отвечает

Проверьте баланс Polza.ai, доступность выбранной модели и правильность её идентификатора modelID.

Пропали ранее настроенные провайдеры

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

Готово!

Теперь вы можете работать с моделями Polza.ai прямо в OpenCode. Запросы оплачиваются по фактическому использованию токенов, без отдельной подписки на каждую модель. Расходы можно отслеживать в личном кабинете Polza.ai.

Следующие шаги

Настольное приложение OpenCode — подключение к Polza.ai по шагам

Выбор провайдера

Как выбирать и переключаться между провайдерами моделей

Если при подключении возникнут вопросы, напишите в поддержку Polza.ai — поможем разобраться.

Начало работы

Продвинутое

Классификация и оценка