Documentation

Connect your coding workflow.

Use Gaionix AI Gateway with Claude Code, or connect a compatible application to one managed endpoint.

Create an access key

Create an account, choose a package, then create a dedicated gnx_... API key from the dashboard. Keep the full key private; it is only shown when it is created.

Create an account

Use Claude Code

Claude Code Compatible

Claude Code is the recommended connection. It uses the gateway's Anthropic-compatible endpoint and supports streaming, tool use, and multi-turn coding tasks.

Claude Code Terminal

  1. Install Claude Code, then open a terminal in your project.
  2. Set your gateway URL and access key.
  3. Start Claude Code with your preferred tier.
export ANTHROPIC_BASE_URL="https://semeru.gaionix.com/api/gateway/anthropic"
export ANTHROPIC_AUTH_TOKEN="gnx_your_api_key"

cd /path/to/your-project
claude --model sonnet

Choose haiku, sonnet, or opus to select a gateway tier. Add the two export lines to your shell profile if you want the setup to persist between terminals.

Claude Code Panel

For Claude Code Panel on VS Code, set the gateway environment in Claude's local settings file.

  1. Open C:\Users\{USERNAME PC}\.claude\settings.json with VS Code or Notepad.
  2. If the file already has another configuration, keep it and only add the env section.
  3. Reload VS Code after saving the file.
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://semeru.gaionix.com/api/gateway/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "gnx_your_api_key"
  }
}

Example path: C:\Users\Budi\.claude\settings.json. If your file already contains settings, merge the env block instead of replacing the whole file.

{
  "enabledPlugins": {
    "figma@claude-plugins-official": true,
    "frontend-design@claude-plugins-official": true
  },
  "model": "sonnet",
  "env": {
    "ANTHROPIC_BASE_URL": "https://semeru.gaionix.com/api/gateway/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "gnx_your_api_key"
  }
}

Connect a compatible application

Choose the endpoint format supported by your application. Both accept your dedicated gnx_... API key.

Anthropic Compatible

Messages API

Best for Claude Code, Cline's Anthropic provider, and applications that use Anthropic's Messages API.

POST https://semeru.gaionix.com/api/gateway/anthropic/v1/messages
x-api-key: gnx_your_api_key
OpenAI Compatible

Chat Completions API

For LibreChat, Chatbox, and applications built for OpenAI's Chat Completions API.

POST https://semeru.gaionix.com/api/gateway/openai/v1/chat/completions
Authorization: Bearer gnx_your_api_key

Model and Pricing

Compare estimated usage costs in Gaionix credits before connecting your application.

Cline

Anthropic CompatibleOpenAI Compatible

Cline supports both formats. We recommend selecting Anthropic, enabling Use custom base URL, then setting the Base URL to https://semeru.gaionix.com/api/gateway/anthropic. Enter your gnx_... API key and choose claude-sonnet-4-6 as the model.

Anthropic Compatible — recommended

Base URL
https://semeru.gaionix.com/api/gateway/anthropic/v1
API Key
gnx_your_api_key
Model
claude-sonnet-4-6

Ready for agent workflows

Cline uses Gaionix's native Anthropic-compatible streaming and tool protocol. The selected Claude model name is mapped to the matching Gaionix tier.

OpenAI Compatible alternative

In Cline Settings, select OpenAI Compatible, then enter:

Base URL
https://semeru.gaionix.com/api/gateway/openai/v1
API Key
gnx_your_api_key
Model ID
sonnet

Cursor IDE

OpenAI Compatible

Use Cursor's OpenAI base URL override to direct compatible chat requests through Gaionix.

  1. 01

    Open Cursor settings

    Open Settings, then find the Models or API Keys section.

  2. 02

    Enable the override

    Enable "Override OpenAI Base URL".

  3. 03

    Enter Gaionix credentials

    Set the Base URL to https://semeru.gaionix.com/api/gateway/openai/v1 and enter your gnx_ API key.

  4. 04

    Select a public model

    Choose a model listed in the OpenAI-compatible table, then save.

Choose one of the models shown in the OpenAI-compatible table above.

OpenClaw

OpenAI Compatible

OpenClaw runs autonomous AI agents continuously, commonly on a VPS or Docker. It follows standard OpenAI environment variables, so all requests can go through Gaionix without changing your agent workflow.

Environment variables

Create or update the .env file used by OpenClaw. Replace YOUR_PUBLIC_MODEL_ID with the exact model ID from the OpenAI-compatible model table.

# Gaionix OpenAI-compatible gateway
OPENAI_API_BASE=https://semeru.gaionix.com/api/gateway/openai/v1
OPENAI_API_KEY=gnx_your_api_key
OPENAI_MODEL=YOUR_PUBLIC_MODEL_ID

Docker Compose

For a Docker deployment, add the same values under the OpenClaw service environment, then recreate or restart the container.

services:
  openclaw:
    environment:
      OPENAI_API_BASE: "https://semeru.gaionix.com/api/gateway/openai/v1"
      OPENAI_API_KEY: "gnx_your_api_key"
      OPENAI_MODEL: "YOUR_PUBLIC_MODEL_ID"
Model ID: use the model ID exactly as shown in the table below, without a provider prefix. For example: xiaomi/mimo-v2.5.
docker compose up -d
docker compose logs -f openclaw

Choose one of the models shown in the OpenAI-compatible table above.

LibreChat & Chatbox

Both apps connect through Gaionix's OpenAI-compatible endpoint. Use a dedicated API key for the app or workspace so its usage stays easy to review.

LibreChat

OpenAI Compatible

Add the API key to LibreChat's .env, then register Gaionix as a custom endpoint in librechat.yaml.

# .env
GAIONIX_API_KEY=gnx_your_api_key

# librechat.yaml
endpoints:
  custom:
    - name: "Gaionix"
      apiKey: "${GAIONIX_API_KEY}"
      baseURL: "https://semeru.gaionix.com/api/gateway/openai/v1"
      models:
        default: []
        fetch: true
      titleConvo: true

Restart LibreChat after saving. With fetch: true, it can load the available public OpenAI-compatible models from the gateway.

Chatbox

OpenAI Compatible

Create a custom provider in Chatbox and select the OpenAI-compatible provider type.

  1. 01

    Open settings

    Go to Settings → Model, then add a custom provider.

  2. 02

    Choose provider type

    Select OpenAI API Compatible.

  3. 03

    Enter endpoint and key

    Set API Host to https://semeru.gaionix.com/api/gateway/openai and enter your gnx_ API key.

  4. 04

    Choose a model

    Select a model shown in the OpenAI-compatible model table, then save.

Choose one of the models shown in the OpenAI-compatible table above.

API Host: enter https://semeru.gaionix.com/api/gateway/openai without the final /v1, because Chatbox adds that path itself.

Credit usage

Credit usage depends on the selected tier and the size of each request and response. Your dashboard shows your remaining credits and request history.

Create a dedicated key for each project
Use the tier that fits the task
Review usage in your dashboard