GeraikitaGeraikita AI
菜单工具集成

工具集成

在 Geraikita AI 上配置常用工具的指南。配置完成后，请再通过Agentic 工具设置调整 timeout 和 stream。

Claude Code CLI

Claude Code 使用 Anthropic 格式。把 base URL 设为根地址（https://ai.geraikita.com——不含 /v1），然后运行 claude。使用模型 claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5。

# Base URL = 根地址，不含 /v1（Claude Code 会自行追加 /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 与其他工具

Cline / Roo（OpenAI Compatible）：provider 选 OpenAI Compatible，Base URL https://ai.geraikita.com/v1，API 密钥 gk-...，Model ID claude-sonnet-5。

Cline（Anthropic）：provider 选 Anthropic，Base URL https://ai.geraikita.com，API 密钥 gk-...。

工具支持自动发现模型？GET https://ai.geraikita.com/v1/models 端点可用。如果有会自动追加 /v1/models 的「Gateway base URL」输入框，请填 https://ai.geraikita.com（根地址），以免变成 /v1/v1/models。

OpenCode

OpenCode 从配置文件读取 provider。在 ~/.config/opencode/opencode.json（或项目里的 opencode.json）中把 Geraikita 注册为 OpenAI 兼容 provider。

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

然后导出你的 key 并启动 OpenCode，用 /models 选择模型——它会显示为 geraikita/claude-sonnet-5。

bash
export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode
重要：models 下面的键会原样发给 API，因此必须与 Geraikita 的公开模型 id 完全一致。
提醒：模型名称要与价格页上完全一致——不要加任何前缀。

9router

9router 是一个本地代理，把请求分发给多家 provider，监听在 http://localhost:20128。你不用让工具直接指向 Geraikita——而是把 Geraikita 注册为 9router 的上游 provider 之一。

  1. 打开 9router 控制台 http://localhost:20128/dashboard。
  2. 进入 Providers，添加一个 custom OpenAI-compatible 端点：Base URL https://ai.geraikita.com/v1，API key gk-xxxxxxxx。
  3. 你的编码工具依旧指向 9router（http://localhost:20128/v1），只要选一个 Geraikita 的模型，9router 就会把这些请求转发到 Geraikita。
9router 控制台http://localhost:20128/dashboard
Provider Base URLhttps://ai.geraikita.com/v1
API keygk-xxxxxxxx
工具用的 Base URLhttp://localhost:20128/v1
bash
# 工具仍然指向 9router，而不是直连 Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

这样你既保留 9router 跨 provider 的路由与兜底，token 又是从 Geraikita 的 GeraiPoints 里扣。

提醒：模型名称要与价格页上完全一致——不要加任何前缀。

Hermes

Hermes（NousResearch 的 Hermes Agent）可以对接任何 OpenAI 兼容端点。在 ~/.hermes/config.yaml 里把它指向 Geraikita。

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

或者运行 hermes model，选择 Custom OpenAI-compatible endpoint，然后填入 base URL 和 key——Hermes 会通过 GET https://ai.geraikita.com/v1/models 自动发现可用模型。

提醒：模型名称要与价格页上完全一致——不要加任何前缀。