GeraikitaGeraikita AI
MenuIntegração de ferramentas

Integração de ferramentas

Guias para configurar ferramentas populares com a Geraikita AI. Depois de configurar, ajuste também o timeout e o stream em Configurações de ferramentas agênticas.

Claude Code CLI

O Claude Code usa o formato Anthropic. Configure a base URL como a raiz (https://ai.geraikita.com — sem /v1) e depois execute claude. Use os modelos claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# Base URL = RAIZ sem /v1 (o Claude Code acrescenta /v1/messages sozinho)
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 outras ferramentas

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

Cline (Anthropic): provedor Anthropic, Base URL https://ai.geraikita.com, chave de API gk-....

Sua ferramenta descobre modelos automaticamente? O endpoint GET https://ai.geraikita.com/v1/models está disponível. Se houver um campo "Gateway base URL" que acrescenta /v1/models automaticamente, preencha com https://ai.geraikita.com (raiz) para não virar /v1/v1/models.

OpenCode

OpenCode lê os providers de um arquivo de configuração. Cadastre a Geraikita como provider compatível com OpenAI em ~/.config/opencode/opencode.json, ou em um opencode.json do projeto.

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

Depois exporte sua chave e abra o OpenCode. Escolha o modelo com /models — ele aparece como geraikita/claude-sonnet-5.

bash
export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode
Importante: as chaves em models são enviadas à API como estão, então precisam bater exatamente com os ids públicos dos modelos da Geraikita.
Lembre-se: escreva o nome do modelo exatamente como na página de preços — sem prefixo.

9router

9router é um proxy local que distribui as requisições entre vários providers e escuta em http://localhost:20128. Você não aponta suas ferramentas direto para a Geraikita — você cadastra a Geraikita como um dos providers upstream do 9router.

  1. Abra o dashboard do 9router em http://localhost:20128/dashboard.
  2. Vá em Providers e adicione um endpoint custom OpenAI-compatible: Base URL https://ai.geraikita.com/v1, chave API gk-xxxxxxxx.
  3. Suas ferramentas continuam apontando para o 9router (http://localhost:20128/v1); basta escolher um modelo da Geraikita — o 9router encaminha essas requisições para a Geraikita.
Dashboard do 9routerhttp://localhost:20128/dashboard
Base URL do providerhttps://ai.geraikita.com/v1
Chave de APIgk-xxxxxxxx
Base URL para suas ferramentashttp://localhost:20128/v1
bash
# sua ferramenta continua apontando para o 9router, não para a Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

Assim você mantém o roteamento e o fallback entre providers do 9router, enquanto os tokens são pagos com seus GeraiPoints da Geraikita.

Lembre-se: escreva o nome do modelo exatamente como na página de preços — sem prefixo.

Hermes

Hermes (o Hermes Agent da NousResearch) funciona com qualquer endpoint compatível com OpenAI. Aponte-o para a Geraikita em ~/.hermes/config.yaml.

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

Ou rode hermes model, escolha Custom OpenAI-compatible endpoint e informe a base URL e a chave — o Hermes descobre sozinho os modelos disponíveis via GET https://ai.geraikita.com/v1/models.

Lembre-se: escreva o nome do modelo exatamente como na página de preços — sem prefixo.