CCG API Docs / OpenCode
OpenCode · интеграция

OpenCode с нашим API

OpenCode — открытый терминальный агент. Подключается через файл конфигурации: GPT-ключи через OpenAI-совместимый SDK, Claude-ключи через Anthropic SDK.

Начать настройку Открыть статистику

Поддерживаемые ключи

Тип ключа определяет npm-пакет провайдера в opencode.json.

Ваш ключКак подключаетсяBase URLМодель (пример)
GPT (gpt-*)@ai-sdk/openai-compatiblehttps://bridge.gptclaudegemini.xyz/v1gpt-5.6-terra
Claude (claude-*)@ai-sdk/anthropichttps://bridge.gptclaudegemini.xyz/v1claude-sonnet-5
Один ключ — один тип моделей

Ключ видит только модели своего тарифа. Проверить список: GET https://bridge.gptclaudegemini.xyz/v1/models с вашим ключом.

Установка и настройка

  1. Установите OpenCode

    Terminal
    curl -fsSL https://opencode.ai/install | bash
opencode --version

  2. Добавьте ключ в auth.json

    Файл ~/.local/share/opencode/auth.json (создайте при отсутствии, не удаляйте чужие записи):

    ~/.local/share/opencode/auth.json
    {
  "ccg": {
    "type": "api",
    "key": "sk-xxxxxxxxxx"
  }
}

  3. Опишите провайдер в opencode.json

    Файл ~/.config/opencode/opencode.json. Для GPT-ключа:

    ~/.config/opencode/opencode.json
    {
  "model": "ccg/gpt-5.6-terra",
  "provider": {
    "ccg": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CCG API",
      "options": { "baseURL": "https://bridge.gptclaudegemini.xyz/v1" },
      "models": {
        "gpt-5.6-terra": { "name": "GPT 5.6 Terra" },
        "gpt-5.5": { "name": "GPT 5.5" }
      }
    }
  }
}

    Для Claude-ключа замените провайдер на Anthropic SDK:

    ~/.config/opencode/opencode.json
    {
  "model": "ccg/claude-sonnet-5",
  "provider": {
    "ccg": {
      "npm": "@ai-sdk/anthropic",
      "name": "CCG API",
      "options": { "baseURL": "https://bridge.gptclaudegemini.xyz/v1" },
      "models": {
        "claude-sonnet-5": { "name": "Claude Sonnet 5" },
        "claude-opus-4-8": { "name": "Claude Opus 4.8" }
      }
    }
  }
}

  4. Запустите

    Откройте новый терминал, выполните opencode в папке проекта и выберите модель ccg/….

Выбор модели

Доступные model ID зависят от вашего ключа:

Terminal
curl https://bridge.gptclaudegemini.xyz/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

Решение проблем

Invalid API Key / 401
Проверьте, что ключ скопирован целиком и без пробелов, а Base URL указан точно как в таблице выше.
Model Not Found
Запросите список моделей вашего ключа через /v1/models и используйте точный ID из ответа.
Первый запрос упал с 5xx, повтор прошел
При недоступности одного upstream шлюз переключается на резервный, но первая попытка может вернуть ошибку. Повторите запрос.
OpenCode не видит провайдер
Проверьте JSON-валидность обоих файлов и совпадение имени провайдера (ccg) в auth.json и opencode.json. Затем перезапустите OpenCode.

Статистика и ключ

Статистика открывается на отдельном сервисе. Для поиска используйте полный токен; в интерфейсе отображается только маскированная часть ключа.

Открыть статистику