OpenCode и API-провайдер: как подключить модель и не оставить ключ в проекте
После установки OpenCode нужно выбрать, откуда агент будет получать модель. Это может быть встроенный провайдер, прямой API или совместимый сервис. Главная ошибка новичка не в названии модели, а в том, что ключ сохраняют рядом с кодом и случайно отправляют в Git.
Создайте отдельный ключ и лимит
Откройте кабинет выбранного провайдера, создайте ключ только для OpenCode и задайте минимальный бюджет. Не используйте production-ключ приложения: агенту он не нужен.
Условия бесплатного доступа, цены и названия моделей быстро меняются. Проверьте их в кабинете провайдера в день подключения.
Подключите провайдера штатной командой
В OpenCode откройте команду /connect, выберите провайдера и пройдите предложенную настройку. Затем используйте /models, чтобы выбрать доступную модель.
OpenCode может хранить учетные данные в своем хранилище или читать их из переменной окружения. Для пользовательского провайдера в конфигурации можно ссылаться на переменную, а не вставлять значение ключа напрямую.
Проверьте список авторизаций командой, указанной в текущей документации, например opencode auth list. Вывод должен подтверждать провайдера, но не должен раскрывать сам секрет.
Проверьте соединение без изменения кода
Откройте учебный репозиторий и попросите:
Прочитай README и назови команду тестов. Ничего не меняй и не запускай. Если информации недостаточно, так и скажи.
Если модель отвечает, соединение работает. Посмотрите Usage у провайдера и убедитесь, что запрос учтен в нужном проекте.
Сделайте одну локальную правку
Теперь дайте небольшую задачу:
В функции форматирования имени добавь удаление пробелов по краям. Не меняй регистр, зависимости и соседние функции. Добавь один тест. Сначала покажи план.
Просмотрите diff и запустите тесты сами. Для этой правки агенту не нужны сеть, установка пакетов и доступ к облачной инфраструктуре.
Проверьте Git до коммита
Выполните git status и поиск по названию переменной ключа. В репозиторий может попасть .env.example с пустым значением, но не реальный .env. Если ключ уже закоммичен, отзовите его: удалить строку новым коммитом недостаточно.
Работа с агентом, Git и секретами как с единым процессом разбирается в ИИ-лаборатории Глеба Кудрявцева.
Подключение завершено, когда модель отвечает, расход виден там, где ожидается, ключ не отслеживается Git, а первая правка проходит тест.