Quickstart — aponte seu cliente para o Load Balance

Você gera uma chave de acesso, monta a URL do proxy e recebe a primeira resposta 200 de POST /{orgSlug}/{customUrl}/v1/messages — com cURL ou com o Claude Code apontado para o Load Balance.

Pré-requisitos#

Antes do primeiro pedido, tenha em mãos:

A URL que o cliente chama tem o formato https:///{orgSlug}/{customUrl}, e cada parte vem de um lugar:

Faça a primeira requisição#

Três passos levam do zero à primeira resposta 200:

1. Guarde a URL base e a chave

   Copie o endereço da Config de URL e a sua chave. Exporte os dois valores no terminal, substituindo os placeholders pelos valores do seu painel:

   copiar

   bash

   export LB_BASE_URL="https://lb.exemplo.com/minha-empresa/ana"
   export LB_KEY="sk-lb-SUA-CHAVE"

2. Envie a primeira mensagem com cURL

   Chame POST /v1/messages na URL base. A chave vai no header x-api-key; o proxy aceita o mesmo valor em Authorization: Bearer.

   copiar

   bash200 OK

   curl -sS -X POST "$LB_BASE_URL/v1/messages" \
     -H "content-type: application/json" \
     -H "x-api-key: $LB_KEY" \
     -H "anthropic-version: 2023-06-01" \
     -d '{
          "model": "claude-sonnet-5-5",
          "max_tokens": 128,
          "messages": [
            { "role": "user", "content": "Em uma frase: o que é um gateway de chaves?" }
          ]
        }
   '

   json

   {
     "id": "msg_01Kw8Vq7Xp2Nz",
     "type": "message",
     "role": "assistant",
     "model": "claude-sonnet-5-5",
     "content": [
       {
         "type": "text",
         "text": "Um gateway que recebe uma chave de acesso e escolhe, a cada requisição, qual chave de provedor atende o pedido."
       }
     ],
     "stop_reason": "end_turn",
     "stop_sequence": null,
     "usage": {
       "input_tokens": 16,
       "output_tokens": 23
     }
   }
   

3. Aponte o Claude Code para a URL base

   O Claude Code lê ANTHROPIC_BASE_URL — a URL base, sem /v1, porque o cliente acrescenta o caminho — e ANTHROPIC_API_KEY, enviada como x-api-key.

   copiar

   bash

   export ANTHROPIC_BASE_URL="https://lb.exemplo.com/minha-empresa/ana"
   export ANTHROPIC_API_KEY="sk-lb-SUA-CHAVE"
   claude

   Antes da primeira requisição, o CLI dispara um HEAD contra a URL base para testar a conectividade. O proxy responde 200 com corpo vazio — não há configuração extra.

Se a resposta não for 200#

O corpo de erro segue o formato da API Messages, com um type que identifica a causa. O que você pode encontrar neste quickstart: