GeraikitaGeraikita AI
MenúIntegración de herramientas

Integración de herramientas

Guías para configurar herramientas populares con Geraikita AI. Una vez configuradas, ajusta también su timeout y su stream en Configuración de herramientas agénticas.

Claude Code CLI

Claude Code usa el formato Anthropic. Configura la URL base como la raíz (https://ai.geraikita.com — sin /v1) y luego ejecuta claude. Usa los modelos claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# URL base = RAÍZ sin /v1 (Claude Code añade /v1/messages por sí mismo)
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 y otras herramientas

Cline / Roo (OpenAI Compatible): proveedor OpenAI Compatible, URL base https://ai.geraikita.com/v1, clave API gk-..., ID de modelo claude-sonnet-5.

Cline (Anthropic): proveedor Anthropic, URL base https://ai.geraikita.com, clave API gk-....

¿Tu herramienta detecta modelos automáticamente? El endpoint GET https://ai.geraikita.com/v1/models está disponible. Si hay un campo "Gateway base URL" que añade automáticamente /v1/models, rellénalo con https://ai.geraikita.com (raíz) para que no se convierta en /v1/v1/models.

OpenCode

OpenCode lee sus proveedores de un archivo de configuración. Registra Geraikita como proveedor compatible con OpenAI en ~/.config/opencode/opencode.json, o en un opencode.json del proyecto.

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

Luego exporta tu clave y abre OpenCode. Elige el modelo con /models: aparece como geraikita/claude-sonnet-5.

bash
export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode
Importante: las claves bajo models se envían tal cual a la API, así que deben coincidir exactamente con los ids públicos de los modelos de Geraikita.
Recuerda: escribe el nombre del modelo exactamente como aparece en la página de precios, sin prefijo.

9router

9router es un proxy local que reparte las peticiones entre varios proveedores y escucha en http://localhost:20128. No apuntas tus herramientas a Geraikita directamente: registras Geraikita como uno de los proveedores upstream de 9router.

  1. Abre el panel de 9router en http://localhost:20128/dashboard.
  2. Ve a Providers y añade un endpoint custom OpenAI-compatible: Base URL https://ai.geraikita.com/v1, clave API gk-xxxxxxxx.
  3. Tus herramientas siguen apuntando a 9router (http://localhost:20128/v1) y solo eliges un modelo de Geraikita: 9router reenvía esas peticiones a Geraikita.
Panel de 9routerhttp://localhost:20128/dashboard
Base URL del proveedorhttps://ai.geraikita.com/v1
Clave APIgk-xxxxxxxx
Base URL para tus herramientashttp://localhost:20128/v1
bash
# tu herramienta sigue apuntando a 9router, no a Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

Así mantienes el enrutamiento y el fallback entre proveedores de 9router mientras los tokens se pagan con tus GeraiPoints de Geraikita.

Recuerda: escribe el nombre del modelo exactamente como aparece en la página de precios, sin prefijo.

Hermes

Hermes (el Hermes Agent de NousResearch) funciona con cualquier endpoint compatible con OpenAI. Apúntalo a Geraikita en ~/.hermes/config.yaml.

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

O ejecuta hermes model, elige Custom OpenAI-compatible endpoint e introduce la base URL y la clave: Hermes detecta por sí mismo los modelos disponibles con GET https://ai.geraikita.com/v1/models.

Recuerda: escribe el nombre del modelo exactamente como aparece en la página de precios, sin prefijo.