GetCheapAI

Como usar um revendedor de API no Claude Code

Aponte o Claude Code para um endereço de API personalizado por variáveis de ambiente ou pelo settings.json.

2 min de leitura

O Claude Code permite enviar as requisições para um endereço de API personalizado; basta definir as variáveis de ambiente correspondentes ou gravá-las em um arquivo de configuração. Este artigo mostra como apontar o Claude Code para um revendedor de API compatível com a interface da Anthropic.

Informações necessárias

Antes de começar, obtenha as seguintes informações na plataforma de API que você usa:

  • Endereço da API (URL base): o endereço raiz da interface fornecido pela plataforma
  • Chave de API (Key): a credencial usada para autenticação
  • Nome do modelo: o identificador do modelo que a plataforma oferece e que você pretende usar

Método 1: variáveis de ambiente

Defina as seguintes variáveis de ambiente no terminal (você pode gravá-las em ~/.zshrc ou ~/.bashrc para que valham permanentemente):

export ANTHROPIC_BASE_URL="https://example.com"   # substitua pelo endereço da API fornecido pela plataforma
export ANTHROPIC_AUTH_TOKEN="your-key"            # substitua pela sua chave de API
export ANTHROPIC_MODEL="your-model-name"          # substitua pelo nome de modelo aceito pela plataforma

Depois de defini-las, abra o terminal novamente e execute claude para que tenham efeito.

Método 2: settings.json

Também é possível gravá-las no arquivo de configuração do Claude Code ~/.claude/settings.json (global) ou no .claude/settings.json do projeto:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://example.com",
    "ANTHROPIC_AUTH_TOKEN": "your-key",
    "ANTHROPIC_MODEL": "your-model-name"
  }
}

Quando a configuração contiver a chave de API, convém usar o .claude/settings.local.json, que fica fora do controle de versão.

Perguntas frequentes

  • Aparece um 404: alguns serviços são sensíveis à barra no final; tente adicionar ou remover a / no fim do endereço da API.
  • O nome do modelo não corresponde: o Claude Code não converte nomes de modelo automaticamente; defina o nome que a plataforma reconhece.
  • Não funciona na interface gráfica: aplicativos de interface gráfica abertos pelo Dock ou por um atalho não leem as variáveis de ambiente definidas no terminal.
  • Conflito com a assinatura: se você também estiver conectado a uma conta com assinatura do Claude, o endereço personalizado se sobrepõe à assinatura; para voltar ao serviço oficial, basta remover as configurações acima.

Saiba mais