Conecte o Claude Code com o HiAPI: guia completo de configuração para economizar US$ 100/mês em assinatura

O Claude Code é a ferramenta de programação em terminal da Anthropic, com capacidade de compreensão e refatoração de código entre as melhores da categoria. Mas ele tem um obstáculo que faz muita gente hesitar: para usar o Claude Code, você precisa pagar a assinatura Max de US$ 200/mês ou US$ 100/mês com uso limitado. Para quem não passa o dia inteiro escrevendo código, essa mensalidade fixa é difícil de justificar.

A boa notícia é que o Claude Code oferece suporte a BYOK (Bring Your Own Key): basta configurar duas variáveis de ambiente para conectar a uma API de terceiros. Este artigo explica como usar os modelos Claude do HiAPI para alimentar o Claude Code, transformando a mensalidade fixa em cobrança por uso.

Por que os usuários do Claude Code estão procurando API Key de terceiros

A estrutura de mensalidade da assinatura Max não é amigável para dois tipos de pessoa:

Usuários de intensidade leve a moderada. Usar o Claude Code apenas uma ou duas horas por dia consome tokens muito longe de justificar o valor do Max. Pagar US$ 100/mês equivale a gastar US$ 3 por dia por uma cota que talvez você use só US$ 0,5.

Usuários que já têm o hábito de usar APIs. Muitas pessoas já têm um fluxo de trabalho de gerenciamento de API Keys; o modelo de assinatura acaba sendo um fardo extra de gerenciamento. Elas preferem "uma Key para todas as ferramentas" a comprar uma assinatura separada só para o Claude Code.

A vantagem do pagamento por uso é óbvia: você paga pelo que consome e não gasta nada se não usar. A parte economizada da mensalidade pode ser investida em outros modelos ou ferramentas.

Como funciona o mecanismo BYOK do Claude Code

O Claude Code lê duas variáveis de ambiente na inicialização (o endpoint Anthropic Messages do HiAPI já implementa chamada de ferramentas, resposta em streaming e raciocínio estendido, mas a combinação Claude Code + HiAPI ainda não foi testada de ponta a ponta; recomenda-se validar com uma tarefa simples após a configuração):

• ANTHROPIC_BASE_URL: endereço do endpoint da API. Por padrão aponta para o oficial da Anthropic; altere para o endereço de um provedor terceiro para usar um endpoint personalizado.
• ANTHROPIC_API_KEY: Key de autenticação. API Key gerada pelo provedor terceiro, normalmente no formato começando com sk-.

O princípio não é complicado: todas as requisições do Claude Code seguem o protocolo Anthropic Messages API. Desde que o endpoint personalizado implemente esse protocolo, o Claude Code funciona normalmente. O endpoint /v1/messages do HiAPI oferece suporte completo à Anthropic Messages API, incluindo chamada de ferramentas, resposta em streaming e raciocínio estendido.

O método de configuração é simplesmente gravar essas duas variáveis no ambiente do terminal e depois iniciar o comando claude normalmente. Os passos completos de configuração estão abaixo.

Por que escolher o HiAPI para conectar o Claude Code

O HiAPI oferece atualmente 4 modelos Claude (preços com data de referência 2026-10), cobrindo diferentes cenários e orçamentos:

Modelo	Entrada $/M	Saída $/M	Contexto
claude-opus-5-5	$2.02	$10.08	1M
claude-opus-4-8	$2.29	$11.47	200K
claude-sonnet-4-6	$3.00	$15.00	200K
claude-opus-4-8@aws	$5.74	$28.70	1M

Os destaques:

O Opus 5.5 é o maior atrativo. Entrada $2.02/M e saída $10.08/M, cerca de 87% mais barato que o preço típico de modelos da classe Opus ($15/$75). Usar capacidade de nível Opus para tarefas complexas de refatoração custa muito menos do que o esperado.

O preço do Sonnet 4.6 é equivalente ao oficial. O preço de $3/$15 não gera sobrepreço em cenários de programação do dia a dia; você continua usando o que já usava.

Os 4 modelos têm funções distintas. Não é "usar o mais barato", mas escolher o modelo conforme a complexidade da tarefa — a próxima seção explica como escolher.

Além disso, esses modelos Claude do HiAPI oferecem suporte simultâneo aos protocolos Anthropic Messages e OpenAI Chat. O Claude Code usa o protocolo Messages; outras ferramentas compatíveis com interface OpenAI (como Cursor e Codex CLI) também podem ser conectadas, com uma única Key cobrindo vários ambientes de programação.

Passos de configuração (5 minutos)

1. Obter a API Key do HiAPI

Acesse HiAPI, entre na página "API Key" do console e crie uma nova Key. O formato da Key começa com sk-; copie e salve imediatamente após criar.

Se não tiver conta, registre-se primeiro e conclua a configuração básica.

2. Definir as variáveis de ambiente

No terminal, execute:

export ANTHROPIC_BASE_URL=https://api.hiapi.ai
export ANTHROPIC_API_KEY=sk-<sua HiAPI Key>

Substitua <sua HiAPI Key> pela Key obtida no passo anterior.

Recomenda-se gravar essas duas linhas no arquivo de configuração do shell (~/.zshrc ou ~/.bashrc) para não precisar digitá-las a cada novo terminal:

echo 'export ANTHROPIC_BASE_URL=https://api.hiapi.ai' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY=sk-<sua HiAPI Key>' >> ~/.zshrc
source ~/.zshrc

3. Iniciar o Claude Code

claude

Ao iniciar, o Claude Code lê automaticamente essas duas variáveis de ambiente e envia as requisições ao HiAPI. Se tudo estiver certo, você pode usar o Claude Code como de costume; a única diferença é que o backend passa a ser o HiAPI.

4. Verificação

Após iniciar, insira uma tarefa simples para testar, como "liste os arquivos do diretório atual", e confirme que a resposta está normal e a saída em streaming está fluida. Se houver problemas, verifique se as variáveis de ambiente foram definidas corretamente:

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

Como escolher o modelo: Sonnet vs Opus

O erro mais comum dos iniciantes é "se tem Opus, use Opus". Na verdade, escolher o modelo pela tarefa é mais importante do que escolher pelo preço. A seguir, recomendações por cenário:

Programação do dia a dia → claude-sonnet-4-6. Escrever código, corrigir bugs, adicionar funcionalidades, entender a estrutura do projeto. A velocidade de resposta do Sonnet é suficientemente rápida e a capacidade cobre a grande maioria das necessidades diárias de programação. O preço é equivalente ao oficial, mas como não há a barreira da mensalidade de US$ 100, o custo real é muito menor.

Refatoração complexa / alterações em vários arquivos → claude-opus-5-5. Ajustes de arquitetura envolvendo vários arquivos e tarefas que exigem compreensão profunda da lógica do código. O Opus 5.5 tem a maior capacidade, custa apenas $2.02/$10.08 e é atualmente a opção Opus com melhor custo-benefício. O contexto de 1M também basta para projetos grandes.

Tarefas complexas em geral → claude-opus-4-8. Fica entre o Sonnet e o Opus 5.5. O preço de $2.29/$11.47 também é amigável. É a "versão reforçada padrão" para quem não quer ficar em dúvida na escolha do modelo.

Precisa de contexto de 1M mas não pode usar o Opus 5.5 → claude-opus-4-8@aws. É a versão de contexto grande do Opus 4.8, com preço mais alto ($5.74/$28.70), adequada para análise global de bases de código muito grandes. Em cenários comuns, priorize o Opus 5.5.

Resumo em uma frase: use Sonnet no dia a dia e mude para Opus 5.5 em tarefas complexas. Calculando o custo por dia, o uso moderado fica em torno de $1-3/dia, muito mais flexível que a assinatura de US$ 100/mês.

Sobre custo: a quantidade de tokens consumida pelo Claude Code em cada conversa varia muito. Perguntas e respostas simples usam algumas centenas de tokens; refatorações complexas podem passar de dezenas de milhares. Recomenda-se avaliar com o uso real de uma semana se compensa em relação à assinatura, em vez de olhar apenas a tabela de preços. O console do HiAPI oferece estatísticas de uso para acompanhar o consumo real.

FAQ

O Claude Code realmente pode usar API Key de terceiros?

Sim. A Anthropic oferece oficialmente no Claude Code a variável de ambiente ANTHROPIC_BASE_URL, justamente para dar suporte a endpoints personalizados. Não é破解 nem uso não oficial.

Há funcionalidades ausentes no Claude Code após a configuração?

As funcionalidades principais (leitura e escrita de código, execução no terminal, chamada de ferramentas, conversa) usam o protocolo Anthropic Messages API e não são afetadas. O endpoint do HiAPI implementa completamente esse protocolo. Se encontrar comportamentos anormais, verifique primeiro se a API Key é válida e se as variáveis de ambiente estão corretas.

O que fazer se o Claude Code der erro após a configuração?

O problema mais comum é que as variáveis de ambiente não entraram em vigor. Confirme que echo $ANTHROPIC_BASE_URL produz saída na sessão atual do terminal. Se estiver usando o aplicativo desktop do Claude Code em vez da versão de terminal, a forma de aplicar as variáveis de ambiente é diferente; consulte o método de configuração de variáveis de ambiente da plataforma correspondente do Claude Code.

Quanto é possível economizar por mês?

Supondo 2-3 horas de programação com o Claude Code por dia, com o preço do Sonnet 4.6, o consumo diário de tokens fica em torno de $1-3 e o custo mensal em cerca de $30-90. Em comparação com a assinatura Max de US$ 100/mês, usuários de intensidade leve a moderada economizam de 40% a 70%.

Para usuários intensivos (programação o dia todo, muitas refatorações), é preciso medir na prática: US$ 100/mês é a linha divisória; se o custo real da API passar desse valor, a assinatura Max passa a valer mais a pena. Recomenda-se rodar uma semana com a Key de terceiros e comparar o custo real de tokens com o preço da assinatura Max antes de decidir.

Outros modelos do HiAPI (GPT, DeepSeek etc.) podem ser usados no Claude Code?

Não. O Claude Code é uma ferramenta da Anthropic e só pode usar modelos da série Claude. Mas os modelos não-Claude do HiAPI podem ser usados em outras ferramentas de programação compatíveis com interface OpenAI (como Codex CLI, Cursor etc.), com a mesma Key cobrindo várias ferramentas.

Há limite de taxa ao usar os modelos Claude do HiAPI?

O HiAPI aplica limite de taxa às API Keys; os valores específicos estão no console. Em cenários normais de programação o limite não é atingido. Se for usar de forma contínua e intensa por muito tempo, confirme antes no console o limite atual.

---

Escolhendo o HiAPI para conectar o Claude Code, a maior mudança não é a economia em si, mas não precisar mais pagar uma mensalidade separada por uma ferramenta. Uma Key gerencia o Claude Code e também outros ambientes de programação, voltando à lógica simples de pagar pelo uso.

Ver detalhes do modelo Claude Sonnet 4.6 · Ver detalhes do modelo Claude Opus 5.5