Claude Code

One command →

curl -fsSL https://get.aireserve.com/install.sh | sh installs the aireserve CLI and configures Claude Code with the full gateway model catalog in its native /model picker — plus a session-cost status line and a one-command undo.

Or connect in one click →

The guided connect page creates a managed key for your account and writes the env block of ~/.claude/settings.json for you — no terminal work.

Everything below is the manual equivalent. Claude Code is configured entirely through environment variables — no code change, no plugin. Set the base URL to the host root (no /v1), pass your AI Reserve key as the auth token, and make sure ANTHROPIC_API_KEY is empty so the CLI doesn’t prefer it:

# Point Claude Code at the AI Reserve gateway
export ANTHROPIC_BASE_URL="https://api.aireserve.com"   # host root — NO /v1
export ANTHROPIC_AUTH_TOKEN="$AIRESERVE_API_KEY"                  # your aireserve_api_… key
export ANTHROPIC_API_KEY=""                                       # must be empty

# Recommended: pin the model in its [1m] form for the full 1M-token context
export ANTHROPIC_MODEL="claude-sonnet-4-6[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-20251001"

# Keep gateway credentials out of stdio MCP server subprocesses. Each server
# receives only Claude Code's safe baseline plus its explicitly configured env.
export CLAUDE_CODE_MCP_ALLOWLIST_ENV=1

# Recommended: the 1-hour prompt-cache TTL first-party sessions get.
# On API-key billing Claude Code defaults to a 5-minute TTL, so any pause
# longer than that forfeits the cache and the next turn re-writes the whole
# prompt. 1h cache writes bill 2x base input (vs 1.25x); reads stay 0.1x —
# one avoided cold rebuild pays for the premium.
export ENABLE_PROMPT_CACHING_1H=1

# Recommended: keep MCP tool search on. Claude Code disables it behind
# custom base URLs, which loads every MCP tool definition into the cached
# prompt prefix — any MCP server reconnect then invalidates the whole cache.
# The AI Reserve gateway forwards the tool-search protocol end to end.
export ENABLE_TOOL_SEARCH=true

claude   # every request is now metered and billed through your AI Reserve key

Add the exports to your shell profile (or the env block of ~/.claude/settings.json) to make the routing permanent. Requests hit /v1/messages — including count_tokens — so the full agent loop, tool use, and prompt caching work unchanged.

The one-click flow and aireserve configure claude-code set CLAUDE_CODE_MCP_ALLOWLIST_ENV=1 without changing .mcp.json or ~/.claude.json. Stdio MCP servers no longer inherit the session’s ANTHROPIC_AUTH_TOKEN; variables listed in each server’s own env remain available, matching Anthropic’s environment-variable reference. That reference does not list a separate minimum version for this setting; AI Reserve keeps its stricter Claude Code ≥ 2.1.118 requirement. We evaluated Claude Code’s apiKeyHelper, but it changes credential refresh and helper-process behavior without creating this MCP boundary, so AI Reserve continues to use the existing receipt-owned auth token.

Why the `[1m]` suffix?

When Claude Code talks to a gateway it can’t verify 1M support, so it budgets a 200K window by default — the context meter fills five times faster than first-party even though the gateway serves the full window. The [1m] id form tells Claude Code to budget the same 1M-token context it has first-party. It works on every extended-context model (claude-sonnet-4-6, claude-sonnet-5, claude-opus-5, fable-5, opus-4-8):

# The flagship at full context works the same way
export ANTHROPIC_MODEL="fable-5[1m]"

Claude Code strips the suffix before sending and adds the anthropic-beta: context-1m-2025-08-07 opt-in, which the gateway relays to Anthropic — and the gateway also accepts the [1m] id form directly, so either convention works. Selecting a 1M variant from the /model picker is known not to stick behind a custom base URL; pin it through the environment variable instead. Tokens are billed at the model’s normal rates.

Full model catalog in the `/model` picker

Claude Code (≥ 2.1.118) can populate its native /model picker straight from the gateway:

export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
export ANTHROPIC_CUSTOM_HEADERS="X-Gateway-Client: claude-code"

At startup Claude Code fetches /v1/models and lists every model your key can serve, with real display names. Models outside the Claude family appear under self-naming ids like claude-air-gpt-5.6-sol[1m] (Claude Code only lists claude/anthropic-prefixed ids) — the id always names the model that serves the request, and the response’s x-aireserve-served-model header records it. Add X-Gateway-Model-View: all on a second line of ANTHROPIC_CUSTOM_HEADERS to list the full catalog instead of the recommended compact set. The aireserve CLI sets all of this up (and undoes it) for you.

Limitations

claude.ai Connectors stop working behind the gateway. The moment ANTHROPIC_AUTH_TOKEN is set, Claude Code drops your claude.ai login for the session — and Connectors (Gmail, Google Drive, Google Calendar, Linear, …) ride on that login. This is a Claude Code limitation (anthropics/claude-code#48011, closed “not planned”); no gateway can work around it.

MCP source	Behind the gateway	What to do
claude.ai Connectors (added on claude.ai, pushed by your org)	❌ Disabled	Replace with the vendor’s native MCP server (below)
Your own MCP servers (`claude mcp add …`, `.mcp.json`)	✅ Work	Declare every credential the server needs in its own `env`; shell credentials are not inherited after AI Reserve setup

Most Connectors have a native MCP server you can add directly — same tools, one-time OAuth in your browser, and it keeps working whether the gateway is configured or not:

claude mcp add --transport http linear https://mcp.linear.app/mcp
claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

After switching between gateway and first-party auth, a native MCP server may ask you to re-authenticate once (/mcp → select → authenticate) — a known Claude Code token-refresh issue (#59460, #61214), not data loss. Your server registrations are never removed.

Claude Agent SDK

The embeddable agent runtime takes the same three variables via options.env:

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "hello",
  options: {
    model: "claude-haiku-4-5-20251001",
    env: {
      ...process.env, // options.env REPLACES the environment — keep PATH etc.
      ANTHROPIC_BASE_URL: "https://api.aireserve.com", // host root
      ANTHROPIC_AUTH_TOKEN: process.env.AIRESERVE_API_KEY!,
      ANTHROPIC_API_KEY: "",
    },
  },
})) {
  /* ... */
}

Getting started

Connect your tool

Models

Capabilities

Migrate

Data & privacy

One command →

Or connect in one click →

Why the `[1m]` suffix?

Full model catalog in the `/model` picker

Limitations

Claude Agent SDK

One command →

Or connect in one click →

​Why the [1m] suffix?

​Full model catalog in the /model picker

​Limitations

​Claude Agent SDK

Why the `[1m]` suffix?

Full model catalog in the `/model` picker

Limitations

Claude Agent SDK