Claude GatewayDocs

Documentação do produto

Conecte sua ferramenta em poucos minutos.

O Claude Gateway oferece endpoints compatíveis com Anthropic e OpenAI. Você usa uma única chave da sua conta, escolhe um modelo publicado e acompanha o consumo pela área do cliente.

01Ative seu plano

Entre na área do cliente e confirme que sua chave está ativa.

02Copie a configuração

Use a Base URL e a chave mostradas no painel.

03Teste a conexão

Envie uma mensagem curta antes de iniciar uma tarefa longa.

Base URL atualhttps://claude-ss.ia.br

Fundamentos

Autenticação

Use a chave kp_user_... da conta ativa. Nunca inclua essa chave em código público, commits, imagens ou logs.

Formato Anthropic

Envie a chave no cabeçalho x-api-key.

Formato OpenAI

Envie Authorization: Bearer SUA_CHAVE.

curl https://claude-ss.ia.br/v1/models \
  -H "Authorization: Bearer kp_user_SUA_CHAVE"

Catálogo

Modelos disponíveis

Consulte GET /v1/models para descobrir o catálogo publicado para sua integração. Os nomes abaixo são os identificadores principais.

claude-opus-5.5Máxima capacidade analítica e raciocínio profundo (Opus 5.5)
claude-opus-5-5Máxima capacidade analítica (alias compatível)
claude-opus-5Tarefas complexas, raciocínio profundo e agentes
claude-sonnet-5Código, escrita técnica e uso geral (contexto de 1M tokens)
claude-opus-4-8Alta capacidade
claude-opus-4-7Compatibilidade
claude-opus-4-6Compatibilidade
claude-sonnet-4-6Uso diário
claude-haiku-4-5Respostas rápidas e baixa latência
claude-fable-5-1Raciocínio avançado e código experimental (Disponível)
fable-5.1Raciocínio avançado e código experimental (Disponível)
gpt-6-lunaMultimodal (visão e texto) — Disponível
gpt-6-solRaciocínio rápido e baixa latência — Disponível
gpt-6-astraRaciocínio avançado e alta velocidade — Disponível

Integração

Claude Code

Defina as variáveis no mesmo terminal em que executará o Claude Code. Substitua o exemplo pela chave mostrada no seu painel.

export ANTHROPIC_BASE_URL="https://claude-ss.ia.br"
export ANTHROPIC_AUTH_TOKEN="kp_user_SUA_CHAVE"
export ANTHROPIC_MODEL="claude-opus-5.5"
claude
Linux: para manter as variáveis após reiniciar, adicione os comandos export ao arquivo ~/.bashrc ou ~/.zshrc.

Integração

Cline e extensões compatíveis

  1. 1

    Escolha o provedor Anthropic ou OpenAI Compatible.

  2. 2

    Informe a Base URL https://claude-ss.ia.br.

  3. 3

    Cole sua chave e selecione um modelo da lista publicada.

  4. 4

    Faça um teste curto e só então abra o projeto completo.

Se a ferramenta acrescentar /v1 automaticamente, informe apenas o domínio. Se ela pedir a URL completa do endpoint, use /v1/messages no modo Anthropic.

Código

SDK Anthropic

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: "kp_user_SUA_CHAVE",
  baseURL: "https://claude-ss.ia.br"
});

const response = await client.messages.create({
  model: "claude-opus-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Olá" }]
});

Código

API compatível com OpenAI

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "kp_user_SUA_CHAVE",
  baseURL: "https://claude-ss.ia.br/v1"
});

const response = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "Olá" }]
});

Referência

Endpoints

POST/v1/messagesAnthropic Messages API
POST/v1/chat/completionsChat Completions
POST/v1/responsesResponses API
GET/v1/modelsCatálogo publicado
GET/healthDisponibilidade HTTP

Diagnóstico

Erros comuns

401 Chave inválida ou ausente

Confirme se a chave pertence a uma conta ativa e se não há espaços antes ou depois. No Claude Code, reabra o terminal após usar setx.

403 Acesso não permitido

A conta pode estar suspensa, vencida ou sem acesso ao modelo solicitado. Verifique o plano na área do cliente.

429 Limite da conta

Consulte a janela de consumo no painel. Evite repetir automaticamente a mesma tarefa em vários clientes ao mesmo tempo.

503 Serviço temporariamente indisponível

Tente novamente após alguns segundos. Se persistir, use uma conversa nova ou reduza anexos muito grandes antes de contatar o suporte.

Modelo não carregou

Atualize o catálogo da ferramenta usando GET /v1/models e selecione exatamente um identificador publicado.

Operação segura

Boas práticas

  • Não compartilhe sua chave em repositórios, tickets ou capturas de tela.
  • Use uma conta vinculada por equipe ou operação quando precisar separar consumo.
  • Em conversas muito longas, permita a compactação do cliente ou inicie uma sessão nova com um resumo.
  • Envie somente os arquivos necessários para a tarefa atual.
  • Acompanhe atividade e limites na área do cliente.
Pronto para conectar?

Abra sua conta para copiar a chave e as configurações já preenchidas.

Ir para a área do cliente