Como Configurar o Claude Code com WaveSpeed LLM (Endpoint Compatível com OpenAI)

Claude Code Sem uma Chave Anthropic

Claude Code é a CLI oficial da Anthropic para programar com Claude — mas você não precisa rotear solicitações pela API da Anthropic. Se você já tem uma conta WaveSpeed, pode apontar o Claude Code para o WaveSpeed LLM e ter acesso ao Claude Opus 4.6, GPT-5.2, Gemini 3, DeepSeek e mais de 290 outros modelos através de um único endpoint compatível com OpenAI.

Este guia cobre as variáveis de ambiente exatas, a URL base e o formato de ID de modelo que você precisa.

Por Que Rotear o Claude Code pelo WaveSpeed

• Uma cobrança, muitos modelos. Claude, GPT, Gemini, Llama, Qwen — tudo cobrado pela sua conta WaveSpeed.
• Compatível com OpenAI em todo lugar. Sem necessidade de gerenciar chaves Anthropic, OpenAI e Google separadamente.
• Sem cold starts. Latência consistente sob carga, igual à API nativa da Anthropic.
• Portabilidade de modelos. Mude do Claude Opus para o GPT-5.2 no meio de uma sessão alterando apenas uma variável de ambiente.

O Que Você Precisa

Campo	Valor
URL Base	https://llm.wavespeed.ai/v1
Chave de API	Sua chave de API WaveSpeed
Protocolo	OpenAI Chat Completions
Formato de ID de modelo	vendor/model (ex.: anthropic/claude-opus-4.6)

Passo 1: Instalar o Claude Code

Se você ainda não tem:

npm install -g @anthropic-ai/claude-code

Passo 2: Obter Sua Chave de API WaveSpeed

1. Faça login em wavespeed.ai.
2. Abra o painel → API Keys.
3. Crie uma nova chave e copie-a.

Passo 3: Configurar o Claude Code para Usar o WaveSpeed

O Claude Code suporta endpoints compatíveis com OpenAI personalizados via variáveis de ambiente. Defina-as antes de iniciar:

macOS / Linux

export ANTHROPIC_BASE_URL="https://llm.wavespeed.ai/v1"
export ANTHROPIC_API_KEY="YOUR_WAVESPEED_API_KEY"
export ANTHROPIC_MODEL="anthropic/claude-opus-4.6"

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL = "https://llm.wavespeed.ai/v1"
$env:ANTHROPIC_API_KEY = "YOUR_WAVESPEED_API_KEY"
$env:ANTHROPIC_MODEL = "anthropic/claude-opus-4.6"

Para torná-las persistentes, adicione-as ao seu ~/.zshrc, ~/.bashrc ou às variáveis de ambiente do Windows.

Passo 4: Iniciar o Claude Code

claude

O Claude Code roteará cada solicitação pelo WaveSpeed LLM usando o modelo que você definiu. Você verá respostas de streaming normais — sem diferença da API nativa da Anthropic.

Trocando Modelos no Meio do Projeto

Como todos os 290+ modelos compartilham um único endpoint, trocar é uma mudança de uma linha. Abra um novo shell com um modelo diferente:

export ANTHROPIC_MODEL="openai/gpt-5.2-pro"
claude

Ou experimente uma alternativa open-source:

export ANTHROPIC_MODEL="deepseek/deepseek-v4"
claude

Útil quando você quer comparar como diferentes modelos lidam com a mesma base de código.

Modelos Recomendados para o Claude Code

Nem todo modelo é ajustado para programação agêntica. Estes funcionam bem:

ID do Modelo	Melhor Para
anthropic/claude-opus-4.6	Padrão — programação em contexto longo e uso de ferramentas mais poderosos
anthropic/claude-sonnet-4.6	Claude mais rápido e barato para tarefas do dia a dia
openai/gpt-5.2-pro	Melhor desempenho de raciocínio alternativo
openai/gpt-5.2-chat	Equilíbrio entre velocidade e qualidade
deepseek/deepseek-v4	Programador open-source forte, menor custo

Solução de Problemas

“Chave de API inválida” / 401 Certifique-se de que ANTHROPIC_API_KEY está definida com sua chave WaveSpeed, não com uma chave Anthropic. O Claude Code envia isso como token bearer para qualquer endpoint que ANTHROPIC_BASE_URL aponte.

“Modelo não encontrado” Sempre inclua o prefixo do vendor. anthropic/claude-opus-4.6 funciona; claude-opus-4.6 não funciona.

Solicitações ainda indo para api.anthropic.com ANTHROPIC_BASE_URL deve estar definida no mesmo shell em que você inicia o claude. Verifique com:

echo $ANTHROPIC_BASE_URL

Se estiver vazia, reexporte-a ou recarregue a configuração do seu shell.

Uso de ferramentas / chamadas de função não funcionam Certifique-se de que o modelo escolhido suporta ferramentas. anthropic/claude-opus-4.6 e openai/gpt-5.2-pro suportam; alguns modelos menores não.

Preços

Você paga a taxa por token do WaveSpeed para o modelo que selecionar — sem taxa adicional do Claude Code. Compare os preços em wavespeed.ai/llm. O Claude Opus 4.6 custa $5/M de entrada, $25/M de saída. Modelos menores ficam abaixo de $1/M.

Por Que Esta Configuração Funciona

A substituição ANTHROPIC_BASE_URL do Claude Code foi projetada para que equipes pudessem rotear por proxies, gateways e camadas de autenticação empresarial. O WaveSpeed LLM é um gateway compatível com OpenAI, e o Claude Code aceita falar OpenAI Chat Completions quando apontado para um — então a substituição funciona perfeitamente.

Comece a Programar Hoje

Três variáveis de ambiente e você está rodando o Claude Code em 290+ modelos com uma única cobrança.

Obtenha sua chave de API WaveSpeed e aponte o Claude Code para https://llm.wavespeed.ai/v1 em minutos.