Claude Code de graça: o que dá para fazer sem pagar e quando o custo começa

A página de preços da Anthropic descreve o plano gratuito com um convite generoso: US$ 0, "free for everyone", com chat na web, no desktop e no celular, busca na web, criação de arquivos, execução de código e memória entre conversas. Logo abaixo, na tabela de recursos, a linha do Claude Code (abre em nova aba) traz uma resposta seca ao plano Free: No. É esse contraste entre o "grátis para todos" e o "não incluído" que organiza este guia, porque grande parte da confusão em torno do uso sem custo da ferramenta nasce exatamente ali.

O ponto de partida, portanto, é honesto: segundo a documentação da própria Anthropic, não existe caminho gratuito documentado para o Claude Code. O que existe são três formas de acesso com custos e lógicas diferentes: assinaturas pessoais (Pro e Max), créditos de API pagos por uso no Console e, fora do terminal, o pacote de recursos realmente gratuitos do aplicativo Claude. Este guia mapeia cada caminho, mostra como instalar e conectar a ferramenta, quais limites esperar e onde o Brasil entra na história.

O que é o Claude Code e por que ele fica fora do plano gratuito

O Claude Code é uma ferramenta de desenvolvimento que dá acesso aos modelos Claude no terminal ou em IDEs suportadas. A descrição oficial, no artigo do Help Center da Anthropic (abre em nova aba), fala em "coding tool" que roda no terminal ou em IDE compatível, cobrindo o VS Code, o Cursor, forks do VS Code e IDEs JetBrains como IntelliJ e PyCharm. Na prática, é um agente que lê o seu repositório, propõe edições, executa comandos e itera sobre o resultado, consumindo tokens em cada interação.

Consumir tokens é a palavra-chave. Um agente que atravessa uma base de código inteira gera custo proporcional ao trabalho, e a Anthropic trata esse custo como algo a ser cobrado por assinatura ou por uso de API. O plano gratuito fica restrito aos recursos do aplicativo: chat, busca na web, arquivos, Artifacts e os produtos Claude Design, Slides e Docs. Suficiente para muita gente. Para quem quer um agente operando dentro do repositório, não.

Vale registrar o que a página de produtos do Claude Code diz sobre os planos pagos: o Pro é apresentado para "sprints curtos de código em bases pequenas", com acesso ao Sonnet 4.6 e ao Opus 4.8; o Max 5x, a US$ 100 por mês, para uso diário em bases maiores; o Max 20x, a US$ 200 por mês, para ainda mais uso incluso. Os cards da própria página avisam que limites de uso se aplicam, que os preços não incluem impostos aplicáveis e que planos e preços podem mudar a critério da Anthropic.

Pré-requisitos: conta, sistema e uma decisão de custo

Antes de instalar, três condições precisam estar resolvidas.

A terceira condição é a decisão financeira, e ela depende do padrão de uso. A documentação oficial de custos, em Manage costs effectively (abre em nova aba), traz números que a própria Anthropic publica como referência: custo médio de US$ 6 por desenvolvedor por dia na API, com 90% dos usuários abaixo de US$ 12 diários, e uma média de US$ 100 a US$ 200 por desenvolvedor por mês com o Sonnet, com alta variação conforme o número de instâncias simultâneas e o uso em automação. Esses valores são orientação da Anthropic, não benchmark independente, e servem exatamente para dimensionar a escolha entre assinatura fixa e cobrança por token.

Para equipes, a leitura muda. A documentação registra que, no modelo de API, o Claude Code cobra pelo consumo de tokens, e a página de custos sugere faixas de rate limit por time, como 200 mil a 300 mil tokens por minuto e 5 a 7 requisições por minuto por usuário em times de 1 a 5 pessoas. Quem gerencia orçamento de equipe precisa tratar esses números como planejamento, não como garantia.

Passo a passo: instalar e conectar o Claude Code

Com os pré-requisitos cumpridos, a sequência de instalação e conexão segue a ordem documentada pela Anthropic.

1. Assine um plano Pro ou Max, se ainda não tiver. O upgrade é feito em claude.ai/upgrade. O sinal de sucesso é o plano ativo aparecendo nas configurações da conta.

1. Instale o Claude Code seguindo as instruções por sistema operacional da página de documentação. A própria página de produto exibe o comando de instalação para ambientes Unix:

curl -fsSL https://claude.ai/install.sh | bash

O instalador segue com as instruções específicas do seu sistema. O sinal de sucesso é a ferramenta instalada e o fluxo de autenticação iniciando.

1. Autentique com as mesmas credenciais da sua assinatura Claude. O Help Center descreve esse passo como obrigatório para que o consumo caia na cota do Pro ou do Max, e não em uma cobrança separada.

1. Se você já usava o Claude Console com pagamento por uso e uma chave de API, rode o comando /login dentro do Claude Code para trocar o modo de autenticação para a assinatura. Sem isso, a sessão continua cobrando da API, token por token.

1. Para usar dentro da IDE, instale a extensão ou o plugin correspondente: VS Code, Cursor, outros forks do VS Code ou IDEs JetBrains como IntelliJ e PyCharm. A autenticação é a mesma, e o consumo entra no mesmo pool de limites.

A ordem dos passos 3 e 4 importa por uma razão prática: a variável de ambiente ANTHROPIC_API_KEY, quando definida, faz o Claude Code preferir a chave de API, e aí cada interação vira cobrança de API, mesmo com assinatura ativa. É o tipo de configuração que sobrevive meses num .bashrc sem ninguém notar, até a fatura chegar.

Como verificar que a conexão funcionou

Instalação sem verificação é meio caminho para surpresa na fatura. A Anthropic documenta dois comandos de conferência.

O /status mostra a alocação restante da sua assinatura. Se o comando responder com o estado do plano e do consumo, a sessão está autenticada via assinatura, e não via API. Esse é o sinal verificável mais direto de que a conexão caiu no lugar certo.

O /cost reporta o custo acumulado da sessão, mas a documentação avisa que ele não se destina a assinantes Pro e Max. A página de custos publica um exemplo de saída, com custo total de US$ 0,55 e duração de API de 6m 19,7s, mas o número relevante ali é para quem paga por token. Assinante que acompanha cota usa /status.

Mais um teste de sanidade, recomendado antes de qualquer trabalho sério: rode uma tarefa pequena em um repositório de teste e observe se o /status reflete consumo após a execução. O objetivo não é medir performance, é confirmar de que bolso o custo está saindo.

Limites reais: janela de cinco horas, teto semanal e um pool único

O modelo de limites do Claude Code por assinatura tem três peças, todas documentadas no Help Center e na página de preços.

A primeira é a janela de sessão: os planos pagos usam uma janela contínua de cinco horas, mais um limite semanal. A segunda é o compartilhamento: web, desktop, celular e Claude Code bebem do mesmo pool. Passar a manhã conversando no aplicativo reduz o que sobra para o agente à tarde. A terceira é a ausência de número fixo: a Anthropic declara que não há contagem fixa de mensagens, porque o consumo depende do comprimento e da complexidade da conversa, do modelo e dos recursos usados.

O Pro, segundo a página de preços, entrega pelo menos 5x mais uso por sessão de cinco horas que o plano Free. O Max 5x e o Max 20x multiplicam o uso do Pro. O Max ainda tem um limite semanal separado para um modelo específico, o Fable, conforme o Help Center.

Quando o limite bate, as saídas documentadas são quatro: esperar o reset da janela, habilitar usage credits, trocar para créditos de API do Console cobrados nas tarifas padrão ou fazer upgrade de plano. Note a assimetria: os créditos mensais de API que acompanham o Max servem para construir na plataforma Claude, e o Help Center afirma que eles não podem ser usados dentro do Claude Code nem nos aplicativos. Crédito que parece bônus de codificação não é.

Quanto custa cada caminho, com números oficiais

A tabela abaixo reúne os preços publicados pela página de preços da Anthropic (abre em nova aba) e pela página de produto, sem impostos.

Para quem prefere não ter assinatura, o caminho é o Console com créditos pré-pagos, consumidos por token. A documentação de custos reposiciona o /cost exatamente nesse cenário, e os valores médios de US$ 6 a US$ 12 por dia por desenvolvedor dão a ordem de grandeza. Uma sessão pesada de refatoração custa diferente de dez perguntas pontuais; a variância é grande, e a Anthropic diz isso expressamente.

Um detalhe. A comparação entre assinatura e API não é sobre preço absoluto, é sobre forma de risco: a assinatura converte uso intenso em custo previsível dentro de limites; a API converte uso intenso em fatura variável. Times que rodam automações fora do horário comercial tendem a sentir a diferença rápido, e a própria página de custos aponta o uso em automação como fator de alta variância.

Claude Code no Brasil: região suportada, moeda e pagamento

A política de regiões suportadas da Anthropic (abre em nova aba) lista o Brasil entre os países com acesso aos produtos da empresa, incluindo o Claude.ai, o Claude Code e a API. A regra vale para pessoas físicas no território e, com nuances, para entidades: a política também proíbe uso por entidades incorporadas ou sediadas em regiões não listadas, e por entidades controladas majoritariamente por pessoas de regiões não suportadas. O Brasil está dentro da lista, então a barreira jurídica básica não existe.

O que a página de regiões não traz é preço local. Não há tarifa em reais, método de pagamento brasileiro documentado ou promessa de cobrança em BRL nas páginas consultadas, e o leitor deve assumir cobrança em dólar pelo cartão internacional, com os impostos e eventuais encargos do emissor por cima, já que as páginas oficiais avisam que os preços não incluem impostos aplicáveis. Para um desenvolvedor autônomo, isso cabe no cartão pessoal. Para um time de dez pessoas, a decisão de centralizar ou distribuir assinaturas precisa considerar o câmbio e o rateio, e lembrar que o modelo Enterprise, a US$ 20 por assento mais uso tarifado como API e faturamento anual, existe exatamente para esse caso.

Há ainda uma restrição contratual que costuma pegar equipes técnicas de surpresa. Segundo a documentação legal do Claude Code (abre em nova aba), clientes não podem pagar por, revender ou intermediar uso de Claude em nome de usuários finais: cada usuário final precisa autenticar com as próprias credenciais, seja chave de API, credencial de assinatura ou credencial de provedor terceiro, e o uso é faturado a ele. A autenticação OAuth, a que usa login de assinatura, destina-se exclusivamente ao uso pessoal e ordinário por donos de planos Free, Pro, Max, Team e Enterprise. Quem constrói produtos, inclusive com o Agent SDK, deve usar autenticação por chave de API via Claude Console ou provedor de nuvem suportado. Colocar o login do seu Pro dentro de uma ferramenta distribuída ao público não é atalho: é violação dos termos.

Erros comuns e soluções

Os problemas abaixo vêm direto da documentação oficial, e cada um tem correção conhecida.

• A fatura da API sobe mesmo com assinatura ativa. Causa provável: a variável ANTHROPIC_API_KEY está definida no ambiente, e o Claude Code prefere a chave à assinatura, cobrando por uso. Solução documentada: remover a variável ou rodar /login para trocar o modo de autenticação para a assinatura.

• /cost não mostra o que você esperava. O comando não se destina a assinantes Pro e Max, segundo a documentação de custos. Para acompanhar cota, o comando certo é /status.

• Limite atingido no meio da tarde. Janela de cinco horas esgotada ou teto semanal alcançado, lembrando que o pool é compartilhado com o uso nos aplicativos. Solução: esperar o reset, habilitar usage credits, migrar a sessão para créditos de API do Console ou fazer upgrade.

• Créditos do Max não funcionam no Claude Code. O Help Center é explícito: os créditos mensais de API inclusos no Max servem para a plataforma Claude, não para a ferramenta. Planeje a API separadamente.

• Compartilhar uma assinatura entre colegas. Os termos proíbem intermediar uso em nome de terceiros e exigem autenticação individual. O consumo por OAuth vale apenas para uso pessoal do dono do plano. Em equipe, cada pessoa conecta a própria conta, ou o time migra para um contrato Team ou Enterprise.

• Contar com um número fixo de mensagens no plano. A Anthropic não publica contagem fixa, e o consumo varia com modelo, comprimento de conversa e recursos. Orçar por "mensagens" é orçar por algo que a documentação não garante.

Perguntas frequentes