OpenCode

Подключите уже установленный OpenCode к GonkaGate. Начните с официального установщика, если хотите самый простой и поддерживаемый путь. К ручному custom-provider сценарию переходите только тогда, когда действительно хотите сами управлять OpenCode config.

Быстрая настройка через установщик GonkaGate

Запустите официальный установщик:

npx @gonkagate/opencode-setup

Этот инструмент настраивает уже установленный локально opencode. Сам OpenCode он не устанавливает.

Используйте этот путь, если хотите получить безопасную настройку без ручной правки конфига OpenCode:

• не кладет секрет в локальный opencode.json внутри репозитория
• записывает только минимально безопасный конфиг
• проверяет итоговый результат через opencode debug config --pure
• оставляет вас в обычном opencode

Перед началом

• OpenCode уже установлен локально и доступен в PATH.
• Для npx установщика доступен Node >=22.14.0.
• У вас уже есть API-ключ GonkaGate в формате gp-....
• Установщик сейчас стартует с моделью qwen/qwen3-235b-a22b-instruct-2507-fp8.

Установщик без интерактива

Используйте это для скриптов, автоматизации или если хотите привязать репозиторий к project scope:

GONKAGATE_API_KEY=gp-... npx @gonkagate/opencode-setup --scope project --yes

Если не хотите передавать ключ через переменную окружения, используйте stdin:

printf '%s' "$GONKAGATE_API_KEY" | npx @gonkagate/opencode-setup --api-key-stdin --scope project --yes --json

Как проверить результат установщика

Запустите:

opencode debug config --pure

Убедитесь, что в итоговом конфиге есть:

• provider.gonkagate
• https://api.gonkagate.com/v1
• qwen/qwen3-235b-a22b-instruct-2507-fp8 как стартовая модель GonkaGate

Затем откройте OpenCode и:

• выполните /models
• при необходимости выберите модель GonkaGate
• отправьте такой промпт:

Reply with exactly: OpenCode connected to GonkaGate

Так вы проверите провайдера, base URL и выбор модели до длинной сессии.

Ручной путь через custom provider

Используйте этот путь только если хотите сами управлять конфигом провайдера в OpenCode или сравнить результат установщика с официальным custom-provider сценарием из документации OpenCode.

1. Сохраните данные доступа внутри OpenCode

Запустите OpenCode, выполните /connect, выберите Other, затем укажите:

• Provider id: gonkagate
• API key: ваш ключ gp-...

OpenCode хранит данные, добавленные через /connect, в ~/.local/share/opencode/auth.json.

2. Добавьте конфиг провайдера

OpenCode читает глобальный конфиг из ~/.config/opencode/opencode.json и также может читать конфиг проекта ./opencode.json. Конфиг проекта имеет более высокий приоритет.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "gonkagate": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "GonkaGate",
      "options": {
        "baseURL": "https://api.gonkagate.com/v1"
      },
      "models": {
        "qwen/qwen3-235b-a22b-instruct-2507-fp8": {
          "name": "GonkaGate Qwen3 235B"
        }
      }
    }
  },
  "model": "gonkagate/qwen/qwen3-235b-a22b-instruct-2507-fp8",
  "small_model": "gonkagate/qwen/qwen3-235b-a22b-instruct-2507-fp8"
}

Проверьте четыре важных момента:

• Используйте @ai-sdk/openai-compatible, потому что текущий путь GonkaGate в OpenCode работает через OpenAI-compatible chat/completions.
• Сохраняйте /v1 в baseURL.
• ID провайдера в /connect и ключ провайдера в opencode.json должны совпадать строго.
• Начинайте с qwen/qwen3-235b-a22b-instruct-2507-fp8 и меняйте модель только после проверки другого актуального model ID в Get Models.

Если вы предпочитаете auth через переменную окружения вместо /connect, OpenCode также поддерживает options.apiKey, например "{env:GONKAGATE_API_KEY}". Не храните это значение в локальном конфиге репозитория.

3. Проверьте ручной путь

Запустите:

opencode auth list
opencode debug config --pure

Затем откройте OpenCode и выполните:

/models

Убедитесь, что gonkagate и выбранная модель видны до отправки реального запроса.

Частые первые ошибки

Текущие ограничения

• Этот гайд настраивает уже установленный OpenCode. Он не устанавливает сам OpenCode.
• Текущий проверенный путь GonkaGate в OpenCode использует OpenAI-compatible /chat/completions.
• Установщик стартует с моделью qwen/qwen3-235b-a22b-instruct-2507-fp8.
• opencode.json в проекте имеет более высокий приоритет, чем глобальный конфиг, поэтому локальные overrides могут скрыть корректную user-level настройку провайдера.

Официальные источники

• GonkaGate OpenCode installer
• Документация OpenCode по providers
• Документация OpenCode по config

См. также

• Claude Code для поддерживаемого Anthropic-compatible пути
• Настройка Cursor для OpenAI-настроек Cursor
• Kilo Code для пути через официальный установщик Kilo Code
• Настройка OpenClaw для другого custom-provider сценария
• Аутентификация и API-ключи для создания ключей, хранения и ротации
• Get Models для актуальных machine-readable model ID
• Быстрый старт GonkaGate, если вам все еще нужен один прямой запрос с нуля