Настройка Grok в OpenCode
Обновлено:
Нейросеть Grok в OpenCode: настройка через Grok API Dev занимает менее 5 минут.
Что такое OpenCode
OpenCode описывает себя как опенсорсный AI-агент для написания кода: он помогает писать код в терминале, в редакторе или в десктопном приложении. К одному вендору он принципиально не привязан — через Models.dev доступно больше 75 провайдеров, включая локальные модели, а любой OpenAI-совместимый endpoint можно объявить своим собственным провайдером. Именно так сюда и попадает Grok 4.5.
Терминал, десктоп или редактор
Один и тот же агент существует как терминальный интерфейс, десктопное приложение и расширение для IDE — конфиг провайдера у них общий.
Любая модель и любой провайдер
75+ провайдеров из коробки плюс ваш собственный OpenAI-совместимый endpoint в конфиге, так что ключ и адрес остаются вашими.
Что понадобится
- Аккаунт Grok API Dev — новому начисляется $0.25 тестового баланса, а API-ключ выпускается прямо в личном кабинете.
Настройка OpenCode
Установите OpenCode
Быстрее всего — официальный скрипт установки. Он также есть в npm, Homebrew, Scoop и Chocolatey. Запустите его один раз, чтобы он создал свою папку с настройками.
curl -fsSL https://opencode.ai/install | bashПропишите провайдера в конфиге
Все настройки OpenCode лежат в одном файле. Откройте его в любом редакторе и добавьте блок провайдера.
~/.config/opencode/opencode.json
Если файла ещё нет, создайте его вместе с родительскими папками.
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"llm-gate": {
"npm": "@ai-sdk/openai-compatible",
"name": "LLM Gate",
"options": {
"baseURL": "https://api.llm-gate.tech/v1",
"apiKey": "YOUR_API_KEY"
},
"models": {
"grok-4.5": {
"name": "Grok 4.5"
}
}
}
}
}- Вместо YOUR_API_KEY подставьте ключ из личного кабинета и не храните файл в репозитории.
Запустите и проверьте
Сохраните файл и запустите OpenCode в папке проекта. Что полезно знать до того, как что-то чинить: OpenCode не заменяет конфиги, а сливает их, и файл opencode.json в корне проекта приоритетнее глобального. Поэтому если модель не появилась, сначала проверьте, нет ли в репозитории своего конфига, который перекрывает вашего провайдера, и только потом правьте глобальный.
opencodeopencode
Ask anything... "Fix broken tests"
Build · Grok 4.5 LLM Gate
tab agentsctrl+p commands
Tip Press ctrl+p to see all available actions and commands
Частые вопросы
Почему провайдер называется llm-gate, а не grok?
Ключ внутри provider — это идентификатор, который вы выбираете сами, и именно его OpenCode показывает как имя провайдера. К модели он отношения не имеет: модель — grok-4.5, она объявлена ниже в блоке models.
OpenCode не видит модель, в чём дело?
Три обычные причины: в baseURL потерян суффикс /v1, адрес должен быть ровно https://api.llm-gate.tech/v1; конфиг лежит не по пути ~/.config/opencode/opencode.json; либо JSON стал невалидным после слияния — достаточно лишней запятой, и OpenCode пропустит весь файл.
Зачем нужно поле npm?
Оно указывает, какой адаптер OpenCode должен загрузить для этого провайдера. @ai-sdk/openai-compatible — универсальный OpenAI-совместимый адаптер, именно он нужен для endpoint GrokAPI. Без него OpenCode не поймёт, как обращаться к провайдеру.
Можно ли оставить других провайдеров рядом?
Да. provider — это объект, в нём спокойно живут несколько провайдеров сразу: добавьте нашего рядом с существующими ключами, а не вместо них. Переключаться между моделями можно уже внутри OpenCode.
Безопасно ли хранить ключ в конфиге?
Файл лежит в домашней директории, а не в проекте, поэтому по умолчанию он не попадает в репозиторий. Главное — не копировать его в папку проекта, которая коммитится, а при утечке перевыпустить ключ в личном кабинете.