GeraikitaGeraikita AI
MenuIntégration des outils

Intégration des outils

Guides pour configurer les outils populaires avec Geraikita AI. Une fois l’outil configuré, réglez aussi son timeout et son stream via Réglages des outils agentiques.

Claude Code CLI

Claude Code utilise le format Anthropic. Réglez l'URL de base sur la racine (https://ai.geraikita.com — sans /v1), puis lancez claude. Utilisez les modèles claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# URL de base = RACINE sans /v1 (Claude Code ajoute /v1/messages lui-même)
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 et autres outils

Cline / Roo (OpenAI Compatible) : fournisseur OpenAI Compatible, URL de base https://ai.geraikita.com/v1, clé API gk-..., ID de modèle claude-sonnet-5.

Cline (Anthropic) : fournisseur Anthropic, URL de base https://ai.geraikita.com, clé API gk-....

Votre outil détecte-t-il les modèles automatiquement ? L'endpoint GET https://ai.geraikita.com/v1/models est disponible. S'il existe un champ « Gateway base URL » qui ajoute automatiquement /v1/models, remplissez-le avec https://ai.geraikita.com (racine) pour éviter que cela devienne /v1/v1/models.

OpenCode

OpenCode lit ses providers dans un fichier de configuration. Déclarez Geraikita comme provider compatible OpenAI dans ~/.config/opencode/opencode.json, ou dans un opencode.json de projet.

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

Exportez ensuite votre clé et lancez OpenCode. Choisissez le modèle avec /models — il apparaît sous le nom geraikita/claude-sonnet-5.

bash
export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode
Important : les clés sous models sont envoyées telles quelles à l'API, elles doivent donc correspondre exactement aux ids publics des modèles Geraikita.
Rappel : écrivez le nom du modèle exactement comme sur la page des tarifs, sans préfixe.

9router

9router est un proxy local qui répartit les requêtes entre plusieurs providers et écoute sur http://localhost:20128. Vous ne pointez pas vos outils directement vers Geraikita : vous déclarez Geraikita comme l'un des providers upstream de 9router.

  1. Ouvrez le dashboard 9router sur http://localhost:20128/dashboard.
  2. Allez dans Providers et ajoutez un endpoint custom OpenAI-compatible : Base URL https://ai.geraikita.com/v1, clé API gk-xxxxxxxx.
  3. Vos outils restent pointés sur 9router (http://localhost:20128/v1) ; il suffit d'y choisir un modèle Geraikita — 9router transmet ces requêtes à Geraikita.
Dashboard 9routerhttp://localhost:20128/dashboard
Base URL du providerhttps://ai.geraikita.com/v1
Clé APIgk-xxxxxxxx
Base URL pour vos outilshttp://localhost:20128/v1
bash
# votre outil reste pointé sur 9router, pas sur Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

Vous gardez ainsi le routage et le fallback multi-providers de 9router, tandis que les tokens sont payés avec vos GeraiPoints Geraikita.

Rappel : écrivez le nom du modèle exactement comme sur la page des tarifs, sans préfixe.

Hermes

Hermes (le Hermes Agent de NousResearch) fonctionne avec n'importe quel endpoint compatible OpenAI. Pointez-le vers Geraikita dans ~/.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 placez-la dans ~/.hermes/.env

Ou lancez hermes model, choisissez Custom OpenAI-compatible endpoint et saisissez la base URL et la clé — Hermes détecte ensuite lui-même les modèles disponibles via GET https://ai.geraikita.com/v1/models.

Rappel : écrivez le nom du modèle exactement comme sur la page des tarifs, sans préfixe.