OpenCode

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

Быстрая настройка через GonkaGate installer

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

npx @gonkagate/opencode-setup

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

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

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

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

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

Non-interactive путь installer

Используйте это для скриптов, автоматизации или 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

Как проверить installer path

Запустите:

opencode debug config --pure

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

• 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

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

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

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

1. Сохраните credential внутри OpenCode

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

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

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

2. Добавьте provider config

OpenCode читает global config из ~/.config/opencode/opencode.json и также может читать project config ./opencode.json. Project config имеет более высокий приоритет.

{
  "$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.
• Provider id в /connect и ключ провайдера в opencode.json должны совпадать строго.
• Начинайте с qwen/qwen3-235b-a22b-instruct-2507-fp8 и меняйте модель только после проверки другого актуального model ID в Get Models.

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

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

Запустите:

opencode auth list
opencode debug config --pure

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

/models

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

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

Текущие границы

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

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

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

См. также

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