GeraikitaGeraikita AI
МенюИнтеграция инструментов

Интеграция инструментов

Руководства по подключению популярных инструментов к Geraikita AI. После установки также настройте timeout и stream по разделу Настройки агентных инструментов.

Claude Code CLI

Claude Code использует формат Anthropic. Установите base URL на корень (https://ai.geraikita.com — без /v1), затем запустите claude. Используйте модели claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# Base URL = корень без /v1 (Claude Code сам добавляет /v1/messages)
export ANTHROPIC_BASE_URL="https://ai.geraikita.com"
export ANTHROPIC_AUTH_TOKEN="gk-xxxxxxxx"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

claude

Cline и другие инструменты

Cline / Roo (OpenAI Compatible): провайдер OpenAI Compatible, Base URL https://ai.geraikita.com/v1, API-ключ gk-..., Model ID claude-sonnet-5.

Cline (Anthropic): провайдер Anthropic, Base URL https://ai.geraikita.com, API-ключ gk-....

Инструмент сам обнаруживает модели? Эндпоинт GET https://ai.geraikita.com/v1/models доступен. Если есть поле "Gateway base URL", автоматически добавляющее /v1/models, укажите https://ai.geraikita.com (корень), чтобы не получилось /v1/v1/models.

OpenCode

OpenCode берёт провайдеров из файла конфигурации. Добавьте Geraikita как OpenAI-совместимого провайдера в ~/.config/opencode/opencode.json или в opencode.json проекта.

~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "geraikita": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Geraikita AI",
      "options": {
        "baseURL": "https://ai.geraikita.com/v1",
        "apiKey": "{env:GERAIKITA_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": { "name": "Claude Sonnet 5" },
        "gpt-5.6-sol": { "name": "GPT 5.6 Sol" },
        "deepseek-v4-pro": { "name": "DeepSeek V4 Pro" }
      }
    }
  }
}

Затем экспортируйте ключ и запустите OpenCode. Модель выбирается через /models — она появится как geraikita/claude-sonnet-5.

bash
export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode
Важно: ключи внутри models уходят в API как есть, поэтому они должны в точности совпадать с публичными id моделей Geraikita.
Помните: имя модели пишется РОВНО так, как на странице тарифов — без префикса.

9router

9router — локальный прокси, который распределяет запросы по множеству провайдеров и слушает на http://localhost:20128. Инструменты направляются не прямо в Geraikita: Geraikita регистрируется как один из upstream-провайдеров 9router.

  1. Откройте дашборд 9router по адресу http://localhost:20128/dashboard.
  2. Перейдите в Providers и добавьте custom OpenAI-compatible эндпоинт: Base URL https://ai.geraikita.com/v1, API-ключ gk-xxxxxxxx.
  3. Ваши инструменты по-прежнему смотрят на 9router (http://localhost:20128/v1) — достаточно выбрать модель Geraikita, и 9router перенаправит эти запросы в Geraikita.
Дашборд 9routerhttp://localhost:20128/dashboard
Base URL провайдераhttps://ai.geraikita.com/v1
API-ключgk-xxxxxxxx
Base URL для ваших инструментовhttp://localhost:20128/v1
bash
# инструмент по-прежнему смотрит на 9router, а не на Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

Так вы сохраняете маршрутизацию и fallback между провайдерами от 9router, а токены оплачиваются вашими GeraiPoints в Geraikita.

Помните: имя модели пишется РОВНО так, как на странице тарифов — без префикса.

Hermes

Hermes (Hermes Agent от NousResearch) работает с любым OpenAI-совместимым эндпоинтом. Направьте его на Geraikita в ~/.hermes/config.yaml.

~/.hermes/config.yaml
model:
  default: claude-sonnet-5
  provider: custom
  base_url: https://ai.geraikita.com/v1
  api_key: gk-xxxxxxxx   # или положите его в ~/.hermes/.env

Либо запустите hermes model, выберите Custom OpenAI-compatible endpoint и введите base URL и ключ — Hermes сам определит доступные модели через GET https://ai.geraikita.com/v1/models.

Помните: имя модели пишется РОВНО так, как на странице тарифов — без префикса.