GeraikitaGeraikita AI
MenüTool-Integrationen

Tool-Integrationen

Anleitungen zur Einrichtung beliebter Tools mit Geraikita AI. Stelle danach auch Timeout und Stream über die Agentic-Tool-Einstellungen ein.

Claude Code CLI

Claude Code nutzt das Anthropic-Format. Setze die Base-URL auf die Root (https://ai.geraikita.com — ohne /v1) und führe dann claude aus. Nutze die Modelle claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# Base-URL = ROOT ohne /v1 (Claude Code hängt /v1/messages selbst an)
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 & weitere Tools

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

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

Erkennt dein Tool Modelle automatisch? Der Endpunkt GET https://ai.geraikita.com/v1/models ist verfügbar. Gibt es ein Feld „Gateway Base URL“, das automatisch /v1/models anhängt, trage dort https://ai.geraikita.com (Root) ein, damit nicht /v1/v1/models daraus wird.

OpenCode

OpenCode liest seine Provider aus einer Konfigurationsdatei. Registriere Geraikita als OpenAI-kompatiblen Provider in ~/.config/opencode/opencode.json oder in einer projektweiten 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" }
      }
    }
  }
}

Exportiere dann deinen Key und starte OpenCode. Das Modell wählst du mit /models — es erscheint als geraikita/claude-sonnet-5.

bash
export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode
Wichtig: die Schlüssel unter models werden unverändert an die API gesendet und müssen daher exakt den öffentlichen Modell-IDs von Geraikita entsprechen.
Denk daran: schreibe den Modellnamen genau so wie auf der Preisseite — ohne Prefix.

9router

9router ist ein lokaler Proxy, der Anfragen auf viele Provider verteilt und unter http://localhost:20128 läuft. Du richtest deine Tools nicht direkt auf Geraikita — stattdessen registrierst du Geraikita als einen der Upstream-Provider von 9router.

  1. Öffne das 9router-Dashboard unter http://localhost:20128/dashboard.
  2. Gehe zu Providers und füge einen custom OpenAI-compatible Endpunkt hinzu: Base URL https://ai.geraikita.com/v1, API-Key gk-xxxxxxxx.
  3. Deine Coding-Tools zeigen weiterhin auf 9router (http://localhost:20128/v1); wähle dort einfach ein Geraikita-Modell — 9router leitet diese Anfragen an Geraikita weiter.
9router-Dashboardhttp://localhost:20128/dashboard
Provider-Base-URLhttps://ai.geraikita.com/v1
API-Keygk-xxxxxxxx
Base URL für deine Toolshttp://localhost:20128/v1
bash
# dein Tool zeigt weiter auf 9router, nicht direkt auf Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

So behältst du Routing und Fallback über mehrere Provider von 9router, während die Tokens von deinen Geraikita-GeraiPoints bezahlt werden.

Denk daran: schreibe den Modellnamen genau so wie auf der Preisseite — ohne Prefix.

Hermes

Hermes (der Hermes Agent von NousResearch) funktioniert mit jedem OpenAI-kompatiblen Endpunkt. Richte ihn in ~/.hermes/config.yaml auf Geraikita.

~/.hermes/config.yaml
model:
  default: claude-sonnet-5
  provider: custom
  base_url: https://ai.geraikita.com/v1
  api_key: gk-xxxxxxxx   # oder in ~/.hermes/.env ablegen

Oder führe hermes model aus, wähle Custom OpenAI-compatible endpoint und gib Base URL und Key ein — Hermes erkennt die verfügbaren Modelle dann selbst über GET https://ai.geraikita.com/v1/models.

Denk daran: schreibe den Modellnamen genau so wie auf der Preisseite — ohne Prefix.