ZuploZuplo
LoginStart for Free
  • Documentation
  • API Reference
Introduction
Getting Started
    Develop in the portal
      1 - Setup Your Gateway2 - Rate Limiting3 - API Key Auth4 - Deploy5 - Dynamic Rate LimitingDynamic MCP Server - Quickstart
    Develop locally with the CLI
      1 - Setup Your Gateway2 - Rate Limiting3 - API Key Auth4 - Deploy5 - Dynamic Rate LimitingDynamic MCP Server - Quickstart
Concepts
Development
Policies
Handlers
API Keys
Rate Limiting
Caching
MCP Server
MCP Gateway
AI Gateway
    IntroductionGetting StartedSource ControlUniversal API
    Providers
    Teams
    Apps
    Policies
    Cookbooks
    Integrations
      AI SDKClaude CodeCodexGooseLangChain SDKOpenAI SDK
Developer Portal
Monetization
GraphQL
Deploying & Source Control
Analytics
Observability
Networking & Infrastructure
Account Management
Programming API
Build with AI
Zuplo CLI
Migration Guides
Platform LimitsVersion Support PolicySecuritySupportTrust & ComplianceChangelog
powered by Zudoku
Integrations

Claude Code

The Zuplo AI Gateway supports the Anthropic /v1/messages API endpoint. This means that you can configure Claude Code to work seamlessly via the AI Gateway.

Claude Code Setup

  1. Create a new provider in the AI Gateway for Anthropic

  2. Set up a new team

  3. Create a new app to use with Claude Code and assign it to the team you created

  4. Copy the API URL and API Key shown at the top of the app page

  5. Add the API key and gateway URL to your environment, or Claude Code settings, using either approach below

Environment

Code
ANTHROPIC_AUTH_TOKEN=<your-ai-gateway-app-api-key> ANTHROPIC_BASE_URL=https://my-gateway-main-2e18f50.zuplo.app/config_fe0a04972d2848e0a94ae4b8bcd1497e

Using settings.json

Code
{ "env": { "ANTHROPIC_AUTH_TOKEN": "<your-ai-gateway-app-api-key>", "ANTHROPIC_BASE_URL": "https://my-gateway-main-2e18f50.zuplo.app/config_fe0a04972d2848e0a94ae4b8bcd1497e" } }

Claude Code appends /v1/messages to the base URL itself, so ANTHROPIC_BASE_URL is the app's URL without the /v1 suffix.

Restart Claude and it will switch to using your new AI Gateway configuration and all your Claude Code LLM requests will route through the AI Gateway.

Choosing a model

The gateway routes models named as providerName/model, where providerName is the provider name configured in your gateway. Claude Code's default model names don't carry that prefix, so set the model explicitly:

Code
ANTHROPIC_MODEL=anthropic/claude-sonnet-4-5-20250929 ANTHROPIC_SMALL_FAST_MODEL=anthropic/claude-haiku-4-5

The app's Model Filtering policy controls which models the app may use.

Edit this page
Last modified on August 18, 2026
AI SDKCodex
On this page
  • Claude Code Setup
    • Environment
    • Using settings.json
    • Choosing a model
JSON