Acesso ilimitado ao Claude Code

Claude Code é o agente oficial de linha de comando da Anthropic para desenvolvimento de software. Ele opera com uma janela de contexto de 200k, cria subagentes com contextos próprios e independentes, lê arquivos inteiros e os inclui no histórico da conversa, e reenvia o contexto completo a cada interação — gerando um crescimento quadrático no consumo de tokens ao longo de sessões extensas. Isso o torna uma das ferramentas para desenvolvedores que mais consomem tokens. Conectar Claude Code a um gateway ilimitado com tarifa fixa transforma uma ferramenta cujo uso precisa ser cuidadosamente racionado em um verdadeiro parceiro de desenvolvimento sempre disponível.

Por que o consumo de tokens do Claude Code cresce de forma quadrática

Do ponto de vista da API, Claude Code não mantém estado entre as interações. Cada mensagem que você envia inclui todo o histórico da conversa — todas as mensagens anteriores, todo o conteúdo dos arquivos lidos, todos os resultados de ferramentas e todas as respostas do assistente. A primeira mensagem pode ter 5,000 tokens. Na décima troca de mensagens, você já está enviando 50,000 tokens de histórico, além de qualquer novo conteúdo adicionado. Na vigésima troca, o contexto pode ultrapassar 150,000 tokens por requisição.

Os subagentes agravam essa situação. Quando Claude Code delega trabalho a um subagente, esse agente recebe sua própria janela de contexto e começa a acumular seu próprio histórico de forma independente. O contexto do agente principal cresce para incluir o resumo do subagente, enquanto o próprio subagente acumula custos de tokens. Equipes de agentes — nas quais vários subagentes colaboram — multiplicam ainda mais esse consumo. Uma tarefa complexa pode ter um agente principal e três subagentes, cada um com mais de 100k tokens de contexto, todos usando a mesma chave de API.

O comando /compact ajuda ao resumir o histórico e truncar o contexto antigo, mas é uma intervenção manual que troca detalhes por espaço. Na cobrança por token, os usuários compactam compulsivamente para controlar os custos. No plano ilimitado, você pode deixar as conversas crescerem naturalmente, compactar apenas quando a qualidade do contexto se deteriorar e usar subagentes livremente, sem fazer cálculos mentais sobre o custo deles.

Configuração de variáveis de ambiente

Claude Code lê sua configuração de API a partir de variáveis de ambiente. As duas variáveis essenciais são ANTHROPIC_BASE_URL e uma das opções ANTHROPIC_API_KEY ou ANTHROPIC_AUTH_TOKEN. Defina ANTHROPIC_BASE_URL como https://unlimited.aiprimetech.io — o host raiz sem /v1, pois o SDK da Anthropic acrescenta o caminho da API automaticamente. Para a chave, use ANTHROPIC_API_KEY se o seu gateway espera autenticação pelo cabeçalho x-api-key, o formato padrão da Anthropic.

Defina essas variáveis no perfil do seu shell (.bashrc, .zshrc ou $PROFILE do PowerShell) para manter a configuração persistente. No Windows, você também pode defini-las como variáveis de ambiente do sistema pela caixa de diálogo Configurações Avançadas do Sistema. Claude Code as lê na inicialização — se você alterá-las, reinicie a sessão do Claude Code para que os novos valores entrem em vigor.

Para substituir as configurações por projeto, crie um arquivo .env na raiz do projeto. Claude Code carrega arquivos .env do diretório de trabalho. Isso permite usar configurações de API diferentes em cada projeto — útil se você tiver alguns projetos no plano ilimitado e outros com cobrança direta da Anthropic. O arquivo .env tem precedência sobre as variáveis de ambiente do sistema.

Mapeamento de modelos para Sonnet, Opus, Haiku e Fable

Claude Code usa aliases internos de modelos que você pode substituir com variáveis de ambiente. ANTHROPIC_DEFAULT_SONNET_MODEL controla qual modelo é usado na seleção padrão 'sonnet'. ANTHROPIC_DEFAULT_OPUS_MODEL substitui a opção 'opus'. ANTHROPIC_DEFAULT_HAIKU_MODEL e ANTHROPIC_DEFAULT_FABLE_MODEL controlam os demais níveis. Defina essas variáveis com os IDs exatos dos modelos compatíveis com o seu gateway.

Por exemplo, defina ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 e ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6.. Quando você seleciona um nível de modelo no Claude Code usando /model ou a opção de inicialização, ele é resolvido para o modelo que você mapeou. Isso é especialmente útil se o gateway disponibiliza identificadores de modelos personalizados ou se você quer fixar versões específicas dos modelos.

No plano ilimitado, a escolha do modelo é uma decisão puramente entre qualidade e velocidade. Não há diferença de custo entre os níveis. Use Opus como padrão para obter a máxima qualidade e só mude para Sonnet ou Haiku quando precisar de respostas mais rápidas durante ciclos curtos de iteração. O comando /effort ajusta ainda mais o grau de profundidade com que Claude Code aborda cada tarefa — combine um nível alto de esforço com Opus para obter a configuração mais capaz.

Subagentes, equipes de agentes e agentes em segundo plano

Claude Code pode criar subagentes — instâncias independentes do Claude com suas próprias janelas de contexto, que executam subtarefas delegadas. Quando o agente principal encontra uma tarefa complexa, ele pode delegar pesquisa, implementação ou verificação a subagentes que trabalham isoladamente e depois apresentam seus resultados. Cada subagente começa com um contexto novo e acumula seu próprio histórico de conversa.

As equipes de agentes ampliam esse conceito ao permitir que vários subagentes colaborem simultaneamente em trabalhos relacionados. O agente principal atua como coordenador, distribuindo trabalho e sintetizando resultados. Isso é extremamente poderoso para mudanças de grande escala — um subagente pode refatorar o módulo A enquanto outro cuida do módulo B —, mas o consumo da API cresce linearmente com o número de agentes ativos.

Os agentes em segundo plano são executados de forma assíncrona enquanto você continua trabalhando na sessão principal. Eles atuam em tarefas separadas e apresentam os resultados ao concluí-las. Na cobrança por token, executar vários agentes em segundo plano simultaneamente fica caro rapidamente. No plano ilimitado, você pode iniciar vários agentes em segundo plano, deixá-los trabalhar em diferentes aspectos do projeto e revisar os resultados quando estiverem prontos — tudo incluído na tarifa fixa.

Defina CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 para impedir que Claude Code envie telemetria e requisições não essenciais. Essa é uma boa prática em qualquer gateway personalizado para reduzir o ruído. Além disso, CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 instrui Claude Code a consultar o gateway para obter os modelos disponíveis, em vez de usar listas fixas no código.

Modo sem interface interativa e integração com CI/CD

O modo sem interface interativa do Claude Code (opção --headless) é executado sem prompts interativos, o que o torna adequado para pipelines de CI/CD, revisão automatizada de código e processamento em lote. Nesse modo, Claude Code lê a entrada de stdin ou de argumentos da linha de comando e envia os resultados para stdout. Ele encerra a execução quando a tarefa é concluída, em vez de aguardar novas entradas.

Para integração com CI, defina as variáveis de ambiente na configuração do seu pipeline (segredos do GitHub Actions, variáveis do GitLab CI, credenciais do Jenkins) e invoque Claude Code com a descrição da tarefa como argumento. Casos de uso comuns em CI incluem revisão automatizada de PRs, geração de documentação, criação de testes e scripts de migração.

No plano ilimitado, o modo sem interface interativa permite fluxos de trabalho de alto volume. Você pode executar Claude Code em cada PR de um repositório, gerar suítes de testes em lote para módulos sem testes ou automatizar atualizações de documentação a cada lançamento — tudo sem se preocupar com o custo por execução. A tarifa fixa cobre todo o volume, desde que ele permaneça dentro dos limites de requisições da política de uso justo.

Memória do projeto em CLAUDE.md e hooks

Os arquivos CLAUDE.md fornecem contexto persistente do projeto, que Claude Code carrega automaticamente. Coloque um arquivo CLAUDE.md na raiz do projeto com padrões de código, decisões de arquitetura, padrões comuns e instruções específicas do projeto. Esse conteúdo é incluído no prompt de sistema de cada requisição, acrescentando tokens a cada chamada, mas melhorando significativamente a qualidade e a consistência das respostas.

Na cobrança por token, os usuários mantêm CLAUDE.md mínimo para controlar os custos — cada palavra acrescenta tokens a todas as requisições durante toda a sessão. No plano ilimitado, escreva todo o contexto que realmente ajude: documentação detalhada da arquitetura, guias de estilo completos, explicações sobre dependências e convenções da equipe. Os tokens adicionais por requisição não custam nada a mais, e a melhoria na qualidade se acumula a cada interação.

Os hooks permitem executar scripts personalizados em pontos específicos da execução do Claude Code — antes e depois de chamadas de ferramentas, no início da sessão e durante a compactação. Use hooks para inserir contexto dinâmico, validar alterações com CI, formatar código automaticamente ou acionar notificações. Os hooks se integram perfeitamente ao gateway ilimitado, pois operam no nível da CLI, e não no nível da API.

Solução de problemas do gateway no Claude Code

Se Claude Code não conseguir se conectar, verifique se ANTHROPIC_BASE_URL está definido como o host raiz sem /v1. Execute echo $ANTHROPIC_BASE_URL (ou $env:ANTHROPIC_BASE_URL no PowerShell) para confirmar o valor. O SDK acrescenta /v1/messages automaticamente — se você incluir /v1 na URL base, as requisições serão enviadas para /v1/v1/messages, que retorna um erro 404.

Erros de modelo não encontrado significam que o ID do modelo na sua variável de mapeamento não corresponde ao que o gateway disponibiliza. Confira os identificadores exatos compatíveis no seu painel da AI Prime Tech e atualize ANTHROPIC_DEFAULT_SONNET_MODEL de acordo. Lembre-se de que os IDs de modelos diferenciam maiúsculas de minúsculas e incluem sufixos de versão.

Se as sessões funcionam, mas os subagentes falham, o problema pode estar na forma como os subagentes herdam as variáveis de ambiente, que varia conforme o modo como são iniciados. Certifique-se de que suas variáveis de ambiente estejam definidas no nível do sistema, e não apenas na sessão atual do shell, especialmente no Windows, onde os processos filhos podem não herdar variáveis locais do shell.

# Shell environment (add to .bashrc / .zshrc / $PROFILE)
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_API_KEY="<your AI Prime Tech Unlimited key>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# Or per-project .env file:
# ANTHROPIC_BASE_URL=https://aiprimetech.io
# ANTHROPIC_API_KEY=sk-...
# ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5

# Run Claude Code:
# claude            (interactive)
# claude --headless (CI/CD mode)

Perguntas frequentes

AI Prime Tech é um gateway de API independente. Não tem afiliação com a Anthropic, não é endossado por ela e não é seu revendedor. Claude e os nomes dos modelos relacionados são marcas comerciais de seus respectivos proprietários.