Gate.AI Documentation

Prerequisites

• Cursor is installed
• You have a Gate.AI API Key

Step 1: Open Cursor Settings

Open the top-right menu → Settings.

Step 2: Open Models Settings

In the left sidebar:

1. Find and open Models
2. Click View All Models
3. Scroll to the bottom and click Add Custom Model

Step 3: Add Configuration

Fill in the integration information:

Step 4: Save and Close Settings

After finishing the configuration, save it and close Settings.

Step 5: Use Gate.AI in Cursor

In Chat, Composer, Agent, and other conversation surfaces, search for or choose the model you just added from the model selector.

FAQ

If you already have Claude Code (Anthropic's terminal / IDE coding assistant) installed, follow these steps to connect Gate.AI.

1. Create a Gate.AI API key

1. Go to Dashboard → Settings → API Keys and create a key.
2. Copy the key that starts with sk-or-v1- and use it to replace the placeholders below.
3. For auto routing: go to Dashboard → Settings → Routing and enable Auto routing. When it is off, specify a model ID explicitly in each request.

2. Configure Anthropic Base URL and API key

Claude Code reads environment variables. We recommend following the official LLM gateway documentation and setting:

Option A: Current terminal session (temporary)

export ANTHROPIC_BASE_URL="https://api.gaterouter.ai/anthropic"
export ANTHROPIC_API_KEY="sk-or-v1-xxxxxxxxxxxxxxxx"
claude

Option B: Shell profile

Append the following to ~/.zshrc or ~/.bashrc:

export ANTHROPIC_BASE_URL="https://api.gaterouter.ai/anthropic"
export ANTHROPIC_API_KEY="sk-or-v1-xxxxxxxxxxxxxxxx"

After running source ~/.zshrc (or opening a new terminal), run claude.

Option C: Claude Code settings.json (recommended)

In user-level or project-level configuration, add an env block (see Claude Code settings for paths), for example in your project directory .claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.gaterouter.ai/anthropic",
    "ANTHROPIC_API_KEY": "sk-or-v1-xxxxxxxxxxxxxxxx"
  }
}

Security note: Do not commit real keys to a public repository; use your OS secret store or CI secret injection, and keep local secrets in environment variables only.

Bypass the gateway and use Anthropic directly

To temporarily skip the gateway:

env -u ANTHROPIC_BASE_URL -u ANTHROPIC_API_KEY claude

(You must already have Anthropic official credentials or another default provider configured.)

3. Configure models (Gate.AI model IDs)

In Gate.AI docs, model IDs look like provider/model-name (for example anthropic/claude-sonnet-4.6). They are not identical to Claude Code built-in aliases such as sonnet. Pick one approach:

3.1 Default model via environment variable

export ANTHROPIC_MODEL="anthropic/claude-sonnet-4.6"

Or add the same key under env in settings.json.

3.2 Alias mapping

Map aliases to Gate.AI model IDs (Sonnet example):

export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.6"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4.6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5"

Use the Gate.AI docs — Models list as the source of truth for IDs.

3.3 Custom entry in /model

To pick a gateway-backed model in the UI, use Claude Code's custom model option (see the official Model configuration - ANTHROPIC_CUSTOM_MODEL_OPTION):

export ANTHROPIC_CUSTOM_MODEL_OPTION="anthropic/claude-sonnet-4.6"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Sonnet (Gate.AI)"

3.4 Auto-routing model auto

If auto routing is enabled in the dashboard, you can try setting ANTHROPIC_MODEL to auto (same meaning as auto on the OpenAI setup page). If you see errors, switch back to an explicit model ID such as anthropic/claude-sonnet-4.6.

4. Verify the setup

1. In a terminal with the environment configured, run:

claude

2. After the session starts, send a simple prompt, for example: In one sentence, introduce yourself.

3. If you get a normal reply with no auth or routing errors, requests are reaching Gate.AI and the selected model is responding.

5. FAQ

Prerequisites

• Claude Desktop is installed
• Gate.AI API Key

Step 1: Enable Developer Mode

1. Launch Claude Desktop. You do not need to sign in with an Anthropic account.
2. From the menu bar, choose Help → Troubleshooting → Enable Developer Mode.

After enabling it, the Developer menu appears in the menu bar.

Step 2: Open Third-Party Inference Settings

From the menu bar, choose Developer → Configure Third-Party Inference…

Step 3: Enter Gate.AI Credentials and Models

1. Choose Gateway and Static API key, then enter your Gate.AI credentials.
   After filling them in, click Test connection to test the connection.

2. Turn on Model discovery.
   After enabling it, you can click Test connection again.

3. Click Apply Changes to save.

Step 4: Restart and Launch

1. Fully quit Claude Desktop, including the app process, then reopen it.
2. On the launch page, choose Continue with Gateway. No Anthropic account is required.

Step 5: Verify

The connection is successful when the model picker shows available models.

FAQ

Authentication Errors

Routing and Model Errors

Request Parameter Errors

Quota and Rate Limit Errors

Billing and Balance Errors

Upstream Service Errors

Server Internal Errors

Common Quick Checks

Incorrect Base URL

# ❌ Incorrect
https://api.gate.ai/v1/chat/completions

# ✅ Correct
https://api.gate.ai/openai/v1/chat/completions  # OpenAI protocol
https://api.gate.ai/anthropic/v1/messages  # Anthropic protocol

Incompatible max_tokens Parameter

// ❌ Some models do not support this
{ "model": "gpt-4o", "max_tokens": 100 }

// ✅ Use max_completion_tokens
{ "model": "openai/gpt-5.5", "max_completion_tokens": 100 }

API Key Format

# ✅ Correct request headers
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx # OpenAI protocol
X-api-key: sk-xxxxxxxxxxxxxxxxxxxx # Anthropic protocol