GeraikitaGeraikita AI
MenuIntegracja narzędzi

Integracja narzędzi

Przewodniki konfiguracji popularnych narzędzi z Geraikita AI. Po konfiguracji ustaw też timeout i stream zgodnie z Ustawieniami narzędzi agentowych.

Claude Code CLI

Claude Code używa formatu Anthropic. Ustaw base URL na root (https://ai.geraikita.com — bez /v1), a potem uruchom claude. Używaj modeli claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# Base URL = ROOT bez /v1 (Claude Code sam dokleja /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 i inne narzędzia

Cline / Roo (OpenAI Compatible): dostawca OpenAI Compatible, Base URL https://ai.geraikita.com/v1, klucz API gk-..., Model ID claude-sonnet-5.

Cline (Anthropic): dostawca Anthropic, Base URL https://ai.geraikita.com, klucz API gk-....

Twoje narzędzie samo wykrywa modele? Endpoint GET https://ai.geraikita.com/v1/models jest dostępny. Jeśli jest pole „Gateway base URL”, które automatycznie dokleja /v1/models, wpisz w nie https://ai.geraikita.com (root), aby nie powstało /v1/v1/models.

OpenCode

OpenCode czyta listę providerów z pliku konfiguracyjnego. Dodaj Geraikitę jako providera zgodnego z OpenAI w ~/.config/opencode/opencode.json albo w projektowym 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" }
      }
    }
  }
}

Następnie wyeksportuj klucz i uruchom OpenCode. Model wybierzesz przez /models — pojawia się jako geraikita/claude-sonnet-5.

bash
export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode
Ważne: klucze pod models lecą do API bez zmian, więc muszą dokładnie odpowiadać publicznym id modeli Geraikity.
Pamiętaj: wpisz nazwę modelu dokładnie tak, jak na stronie cen — bez prefiksu.

9router

9router to lokalny proxy, który rozdziela zapytania na wielu providerów i nasłuchuje na http://localhost:20128. Nie kierujesz narzędzi wprost do Geraikity — rejestrujesz Geraikitę jako jednego z providerów upstream 9routera.

  1. Otwórz dashboard 9routera pod http://localhost:20128/dashboard.
  2. Wejdź w Providers i dodaj endpoint custom OpenAI-compatible: Base URL https://ai.geraikita.com/v1, klucz API gk-xxxxxxxx.
  3. Twoje narzędzia dalej wskazują na 9router (http://localhost:20128/v1) — wystarczy wybrać model Geraikity, a 9router przekaże te zapytania do Geraikity.
Dashboard 9routerahttp://localhost:20128/dashboard
Base URL providerahttps://ai.geraikita.com/v1
Klucz APIgk-xxxxxxxx
Base URL dla twoich narzędzihttp://localhost:20128/v1
bash
# twoje narzędzie dalej wskazuje na 9router, nie na Geraikitę
export OPENAI_BASE_URL="http://localhost:20128/v1"

W ten sposób zachowujesz routing i fallback między providerami z 9routera, a tokeny opłacasz z GeraiPoints w Geraikicie.

Pamiętaj: wpisz nazwę modelu dokładnie tak, jak na stronie cen — bez prefiksu.

Hermes

Hermes (Hermes Agent od NousResearch) działa z każdym endpointem zgodnym z OpenAI. Skieruj go na Geraikitę w ~/.hermes/config.yaml.

~/.hermes/config.yaml
model:
  default: claude-sonnet-5
  provider: custom
  base_url: https://ai.geraikita.com/v1
  api_key: gk-xxxxxxxx   # albo umieść go w ~/.hermes/.env

Albo uruchom hermes model, wybierz Custom OpenAI-compatible endpoint i podaj base URL oraz klucz — Hermes sam wykryje dostępne modele przez GET https://ai.geraikita.com/v1/models.

Pamiętaj: wpisz nazwę modelu dokładnie tak, jak na stronie cen — bez prefiksu.