GeraikitaGeraikita AI
MenuTích hợp công cụ

Tích hợp công cụ

Hướng dẫn cài đặt các công cụ phổ biến với Geraikita AI. Sau khi cài xong, hãy chỉnh cả timeout và stream qua Cài đặt công cụ agentic.

Claude Code CLI

Claude Code dùng định dạng Anthropic. Đặt base URL là root (https://ai.geraikita.com — không có /v1), rồi chạy claude. Dùng model claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# Base URL = ROOT không có /v1 (Claude Code tự thêm /v1/messages)
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 & công cụ khác

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-....

Công cụ tự khám phá model? Endpoint GET https://ai.geraikita.com/v1/models có sẵn. Nếu có ô "Gateway base URL" tự thêm /v1/models, hãy điền https://ai.geraikita.com (root) để không thành /v1/v1/models.

OpenCode

OpenCode đọc danh sách provider từ file cấu hình. Khai báo Geraikita như một provider OpenAI-compatible trong ~/.config/opencode/opencode.json, hoặc trong opencode.json của project.

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

Sau đó export key và mở OpenCode. Chọn model bằng /models — nó hiện ra là geraikita/claude-sonnet-5.

bash
export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode
Quan trọng: các key bên dưới models được gửi thẳng tới API, nên phải trùng khớp tuyệt đối với id model công khai của Geraikita.
Nhớ nhé: viết tên model ĐÚNG như trên trang giá — không thêm prefix.

9router

9router là proxy chạy cục bộ, phân phối request tới nhiều provider và lắng nghe ở http://localhost:20128. Bạn không trỏ tool trực tiếp vào Geraikita — bạn đăng ký Geraikita như một provider upstream của 9router.

  1. Mở dashboard 9router tại http://localhost:20128/dashboard.
  2. Vào Providers và thêm endpoint custom OpenAI-compatible: Base URL https://ai.geraikita.com/v1, API key gk-xxxxxxxx.
  3. Các tool coding vẫn trỏ vào 9router (http://localhost:20128/v1), chỉ cần chọn model Geraikita — 9router sẽ chuyển tiếp request sang Geraikita.
Dashboard 9routerhttp://localhost:20128/dashboard
Base URL providerhttps://ai.geraikita.com/v1
API keygk-xxxxxxxx
Base URL cho tool của bạnhttp://localhost:20128/v1
bash
# tool của bạn vẫn trỏ vào 9router, không trỏ thẳng vào Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

Nhờ vậy bạn vẫn có routing và fallback giữa nhiều provider của 9router, còn token thì trả bằng GeraiPoints Geraikita của bạn.

Nhớ nhé: viết tên model ĐÚNG như trên trang giá — không thêm prefix.

Hermes

Hermes (Hermes Agent của NousResearch) dùng được với mọi endpoint OpenAI-compatible. Trỏ nó về Geraikita trong ~/.hermes/config.yaml.

~/.hermes/config.yaml
model:
  default: claude-sonnet-5
  provider: custom
  base_url: https://ai.geraikita.com/v1
  api_key: gk-xxxxxxxx   # hoặc đặt trong ~/.hermes/.env

Hoặc chạy hermes model, chọn Custom OpenAI-compatible endpoint, rồi nhập base URL và key — Hermes tự dò các model khả dụng qua GET https://ai.geraikita.com/v1/models.

Nhớ nhé: viết tên model ĐÚNG như trên trang giá — không thêm prefix.