Use o Claude Code com qualquer modelo: configuração de endpoint personalizado

Claude Code é o agente de linha de comando da Anthropic para programação. Ele se comunica com um único endpoint, /v1/messages, no formato Anthropic Messages, e permite alterar a URL base. Aponte-o para o GetVibe API e a mesma CLI poderá executar Claude Opus 5.5, Claude Sonnet 5 ou um modelo que não seja da Claude do nosso catálogo, tudo com uma única chave pré-paga.

Etapa 1: settings.json

Instale o Claude Code (npm install -g @anthropic-ai/claude-code, Node.js 22+) e crie ou edite ~/.claude/settings.json. No Windows, o arquivo é %USERPROFILE%\.claude\settings.json.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-pv-...",
    "ANTHROPIC_BASE_URL": "https://getvibeapi.com",
    "ANTHROPIC_API_KEY": ""
  }
}

Dois detalhes são importantes:

• ANTHROPIC_API_KEY deve ser uma string vazia, e não estar ausente. Se ela não estiver presente, o Claude Code ignora a URL base e vai direto para a Anthropic.
• A URL base não inclui /v1. O Claude Code adiciona /v1/messages por conta própria, então https://getvibeapi.com/v1 duplicaria o caminho.

Execute claude e digite /status. A linha da URL base da Anthropic deve exibir https://getvibeapi.com.

Etapa 2: escolha os modelos

O Claude Code tem três slots de modelo: Opus, Sonnet e Haiku. Por padrão, ele usa o slot Sonnet para a maioria das tarefas e o slot Haiku para operações rápidas. Cada slot é uma variável de ambiente, e o valor pode ser qualquer ID de modelo do nosso catálogo que aceite o formato Messages:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-pv-...",
    "ANTHROPIC_BASE_URL": "https://getvibeapi.com",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_OPUS_MODEL":   "claude-opus-5.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL":  "claude-haiku-4.5"
  }
}

Para executar o agente com um modelo de menor custo, coloque o ID dele no slot Sonnet, por exemplo deepseek-v4.1-flash ou gemini-3.8-flash. Use os IDs exatos do catálogo: nomes de snapshot da Anthropic com data, como claude-haiku-4-5-20251001, não são resolvidos.

Quais modelos funcionam no Claude Code

Nem todos os modelos do catálogo aceitam o formato Anthropic Messages. O catálogo público em https://getvibeapi.com/api/catalog indica cada modelo com anthropicFormat. Quando o valor é true, o modelo funciona por meio de /v1/messages. No momento da publicação, isso inclui:

Os modelos GPT-6 (Luna, Sol, Astra) não aceitam o formato Messages e são recusados em /v1/messages. Para usá-los em um agente de terminal, use o Codex CLI, que usa a Responses API, ou qualquer ferramenta com uma URL base compatível com a OpenAI (consulte a lista de integrações).

Problemas comuns

• 401: verifique o valor de ANTHROPIC_AUTH_TOKEN e confirme que ANTHROPIC_API_KEY é "".
• As solicitações continuam indo para a Anthropic: ANTHROPIC_API_KEY não está definida como uma string vazia.
• As variáveis não são reconhecidas: settings.json é mais confiável do que perfis do shell, especialmente no Windows.
• Modelo indisponível: o ID está escrito incorretamente, foi descontinuado ou não está no formato Messages. Verifique-o na página Models.

Reduza os custos

Agentes de programação reenviam um prefixo longo e praticamente inalterado a cada turno. Os modelos Claude só armazenam em cache quando a solicitação inclui um ponto de interrupção cache_control. Se o Claude Code não enviar um, o gateway adicionará um para você. A entrada armazenada em cache é cobrada por uma fração da tarifa de entrada. O guia de caching e nosso artigo sobre caching de prompts explicam como manter o prefixo estável.

A referência completa está no guia do Claude Code e em Messages and Responses. Você paga por token usando um saldo pré-pago. Não há assinatura.