GeraikitaGeraikita AI
MenuTool integrations

Tool integrations

Guides for setting up popular tools with Geraikita AI. Once installed, also configure their timeout and stream via Agentic tool settings.

Claude Code CLI

Claude Code uses the Anthropic format. Set the base URL to the root (https://ai.geraikita.com — without /v1), then run claude. Use the models claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# Base URL = ROOT without /v1 (Claude Code appends /v1/messages itself)
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 & other tools

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

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

Does your tool auto-discover models? The GET https://ai.geraikita.com/v1/models endpoint is available. If there is a "Gateway base URL" field that automatically appends /v1/models, fill it with https://ai.geraikita.com (root) so it doesn't become /v1/v1/models.

OpenCode

OpenCode reads its providers from a config file. Register Geraikita as an OpenAI-compatible provider in ~/.config/opencode/opencode.json, or in a project-level 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" }
      }
    }
  }
}

Then export your key and start OpenCode. Pick the model with /models — it shows up as geraikita/claude-sonnet-5.

bash
export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode
Important: the keys under models are sent to the API as-is, so they must match Geraikita's public model ids exactly.
Reminder: write the model name exactly as it appears on the pricing page — no prefix.

9router

9router is a local proxy that fans out to many providers and listens on http://localhost:20128. You don't point your tools at Geraikita directly — you register Geraikita as one of 9router's upstream providers.

  1. Open the 9router dashboard at http://localhost:20128/dashboard.
  2. Go to Providers and add a custom OpenAI-compatible endpoint: Base URL https://ai.geraikita.com/v1, API key gk-xxxxxxxx.
  3. Leave your coding tools pointing at 9router (http://localhost:20128/v1) and just select a Geraikita model — 9router forwards those requests to Geraikita.
9router dashboardhttp://localhost:20128/dashboard
Provider Base URLhttps://ai.geraikita.com/v1
API keygk-xxxxxxxx
Base URL for your toolshttp://localhost:20128/v1
bash
# your tool keeps pointing at 9router, not at Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

That way you keep 9router's routing and fallback across providers, while the tokens are paid from your Geraikita GeraiPoints.

Reminder: write the model name exactly as it appears on the pricing page — no prefix.

Hermes

Hermes (NousResearch's Hermes Agent) works with any OpenAI-compatible endpoint. Point it at 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   # or put it in ~/.hermes/.env

Or run hermes model, choose Custom OpenAI-compatible endpoint, and enter the base URL plus your key — Hermes then discovers the available models itself via GET https://ai.geraikita.com/v1/models.

Reminder: write the model name exactly as it appears on the pricing page — no prefix.