GeraikitaGeraikita AI
MenuIntegrazione degli strumenti

Integrazione degli strumenti

Guide per configurare gli strumenti più diffusi con Geraikita AI. Dopo la configurazione, imposta anche timeout e stream in Impostazioni degli strumenti agentici.

Claude Code CLI

Claude Code usa il formato Anthropic. Imposta la base URL sulla root (https://ai.geraikita.com — senza /v1), poi esegui claude. Usa i modelli claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# Base URL = ROOT senza /v1 (Claude Code aggiunge /v1/messages da sé)
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 e altri strumenti

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

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

Il tuo strumento rileva i modelli automaticamente? L'endpoint GET https://ai.geraikita.com/v1/models è disponibile. Se c'è un campo "Gateway base URL" che aggiunge automaticamente /v1/models, compilalo con https://ai.geraikita.com (root) così non diventa /v1/v1/models.

OpenCode

OpenCode legge i provider da un file di configurazione. Registra Geraikita come provider compatibile con OpenAI in ~/.config/opencode/opencode.json, oppure in un opencode.json di progetto.

~/.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" }
      }
    }
  }
}

Poi esporta la tua chiave e avvia OpenCode. Scegli il modello con /models: compare come geraikita/claude-sonnet-5.

bash
export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode
Importante: le chiavi sotto models vengono inviate all'API così come sono, quindi devono corrispondere esattamente agli id pubblici dei modelli Geraikita.
Ricorda: scrivi il nome del modello esattamente come nella pagina prezzi, senza prefisso.

9router

9router è un proxy locale che distribuisce le richieste su più provider e ascolta su http://localhost:20128. Non punti i tuoi strumenti direttamente a Geraikita: registri Geraikita come uno dei provider upstream di 9router.

  1. Apri la dashboard di 9router su http://localhost:20128/dashboard.
  2. Vai su Providers e aggiungi un endpoint custom OpenAI-compatible: Base URL https://ai.geraikita.com/v1, API key gk-xxxxxxxx.
  3. I tuoi strumenti continuano a puntare a 9router (http://localhost:20128/v1): basta selezionare un modello Geraikita e 9router inoltra quelle richieste a Geraikita.
Dashboard 9routerhttp://localhost:20128/dashboard
Base URL del providerhttps://ai.geraikita.com/v1
API keygk-xxxxxxxx
Base URL per i tuoi strumentihttp://localhost:20128/v1
bash
# il tuo strumento continua a puntare a 9router, non a Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

Così mantieni il routing e il fallback tra provider di 9router, mentre i token vengono pagati dai tuoi GeraiPoints Geraikita.

Ricorda: scrivi il nome del modello esattamente come nella pagina prezzi, senza prefisso.

Hermes

Hermes (l'Hermes Agent di NousResearch) funziona con qualsiasi endpoint compatibile con OpenAI. Puntalo a Geraikita in ~/.hermes/config.yaml.

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

Oppure esegui hermes model, scegli Custom OpenAI-compatible endpoint e inserisci base URL e chiave: Hermes rileva da sé i modelli disponibili con GET https://ai.geraikita.com/v1/models.

Ricorda: scrivi il nome del modello esattamente come nella pagina prezzi, senza prefisso.