Yaha AI Gateway
Integrations

Claude Code

Integrate Claude Code with Yaha Gateway.

Claude Code uses the Anthropic Messages API. Yaha proxies /v1/messages natively to Anthropic upstream keys.

Configuration

Set environment variables (shell or ~/.claude/settings.jsonenv):

export ANTHROPIC_BASE_URL="https://gateway.yahagateway.io"
export ANTHROPIC_AUTH_TOKEN="yaha.<your-project-key>"
export ANTHROPIC_API_KEY=""

Important: set ANTHROPIC_API_KEY to empty so Claude Code uses ANTHROPIC_AUTH_TOKEN (Bearer) with your yaha.* key.

Model discovery

To populate the /model picker from gateway allowlist:

export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

Requires Claude Code v2.1.129+. Yaha proxies GET /v1/models; only models whose IDs start with claude or anthropic appear.

settings.json example

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gateway.yahagateway.io",
    "ANTHROPIC_AUTH_TOKEN": "yaha.<your-project-key>",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

Upstream requirements

Route Claude models to an Anthropic provider key on the project. Yaha forwards:

  • anthropic-beta, anthropic-version from the client
  • X-Claude-Code-Session-Id, X-Claude-Code-Agent-Id (logged for attribution)

Endpoints used

EndpointPurpose
POST /v1/messagesChat + tools
POST /v1/messages/count_tokensToken counting
GET /v1/modelsModel discovery (optional)

See also

On this page