OpenCode со своим API: custom provider go2llm
Чтобы использовать OpenCode со своим API, добавьте в opencode.json провайдера @ai-sdk/openai-compatible с baseURL: https://go2llm.tech/v1, передайте ключ go2llm и запустите модель как go2llm/claude-haiku-4-5. Связка OpenCode с go2llm проверена живым запросом через OpenAI Chat Completions.
Обновлено 27 сентября 2026 года. Если вы искали, как купить OpenCode Go, здесь другой способ оплачивать работу модели: go2llm списывает стоимость фактических API-запросов с общего баланса без обязательной ежемесячной подписки. Пополнить баланс можно рублями через СБП, а при регистрации на него зачисляется $1 — первый запуск пополнения не требует.
OpenCode Go и Zen: что это и как устроена оплата
OpenCode Go — месячная подписка на отобранные модели для задач кодинга. Её оформляют через аккаунт OpenCode Zen и получают отдельный API-ключ; для моделей заданы лимиты использования. Подробности — в официальной документации Go и в исходном описании OpenCode Go на GitHub.
OpenCode Zen — шлюз OpenCode к проверенным моделям. Для доступа добавляют платёжные данные и выпускают API-ключ; запросы оплачиваются по факту, баланс можно пополнять кредитами. Это описано в документации Zen и исходном описании Zen в репозитории.
Если оплатить Go или Zen не получается, подключите ключ go2llm как собственного провайдера OpenCode. Конфиг уже приведён в разделе «Как настроить custom provider в opencode.json».
В go2llm оплата списывается по факту за использованные токены, а модели выбираются по ID из каталога go2llm.
Что понадобится
Зарегистрируйтесь на go2llm и создайте ключ в кабинете: регистрация сама ключ не выпускает. Скопируйте его целиком, включая префикс gk_sk_. Для OpenCode используйте OpenAI-совместимый base URL https://go2llm.tech/v1 — у Anthropic SDK и Claude Code адрес другой.
Проверьте ID модели в открытом каталоге GET https://go2llm.tech/v1/models. OpenCode ходит через chat.completions, поэтому это значение должно быть в поле endpoints выбранной модели. Каталог меняется; скопированный из чужой инструкции ID может устареть.
Как настроить custom provider в opencode.json
Поместите файл opencode.json в проект или пользовательский конфиг ~/.config/opencode/opencode.json. Проверенный пример провайдера из документации инструментов:
{
"provider": {
"go2llm": {
"npm": "@ai-sdk/openai-compatible",
"name": "go2llm",
"options": { "baseURL": "https://go2llm.tech/v1" },
"models": { "claude-haiku-4-5": {}, "gpt-5.6-luna": {} }
}
}
}
go2llm здесь имя провайдера внутри OpenCode. Ключи объекта models — точные ID из каталога go2llm. Если выберете другую модель, замените ID в конфиге и в команде запуска; одного изменения недостаточно.
Передайте ключ командой opencode auth login. В инструкции по инструментам описан и локальный вариант с "apiKey": "YOUR_API_KEY" в options; проектный конфиг с настоящим ключом не кладите в репозиторий.
Как проверить запрос
Отправьте короткую задачу через модель, которая перечислена в конфиге:
opencode run "Ответь одним словом: работает" -m go2llm/claude-haiku-4-5
Если OpenCode не отвечает, отделите его настройку от работы ключа. Тот же шлюз можно проверить запросом к POST /v1/chat/completions из примера OpenAI-совместимого API. При успешном запросе go2llm возвращает фактическую стоимость в usage.cost_usd; баланс своего ключа показывает GET /v1/me.
| Ответ шлюза | Что проверить |
|---|---|
401 no-key | Ключ передан через opencode auth login и начинается с gk_sk_ |
404 model_not_found | ID точно совпадает с GET /v1/models |
400 model_protocol_mismatch | У модели в endpoints есть chat.completions |
402 insufficient_balance | На балансе хватает средств для резерва запроса |
429 rate_limit | Не исчерпан лимит запросов ключа; учтён Retry-After |
Когда оплата по факту не подойдёт
При интенсивной работе счёт зависит от числа токенов и выбранной модели, а не от времени в редакторе. Смотрите все три колонки прайса — вход, выход и чтение кэша — на странице цен или в /api/pricing. На ключ можно поставить квоту в долларах и список разрешённых моделей. По умолчанию лимит составляет 20 запросов в минуту на ключ суммарно по моделям и endpoint'ам.
Живой прогон OpenCode подтверждает связку клиента со шлюзом, но не каждую модель и не каждый ваш сценарий. Если нужен именно интерфейс Cursor, начните со страницы «Чем заменить Cursor»: подключение самого Cursor к go2llm ещё не проверено.
Что дальше
- Инструменты для кода — статусы Claude Code, OpenCode, Codex CLI и клиентов по документации.
- Документация API — авторизация и ошибки; таблица цен — модели и стоимость по типам токенов.
- Claude Code через API — другой проверенный клиент и другой протокол.
Получить ключ и сделать первый запрос за 3 минуты — go2llm.tech.