O Claude Code é gratuito? O que é gratuito, o que não é e quanto custa um mês

A CLI do Claude Code é gratuita para instalar. Executá-la não é. Cada ação realizada pelo Claude Code — ler um arquivo, propor uma edição, executar um comando, verificar o resultado — é uma chamada de modelo que alguém paga. A Anthropic oferece às novas contas de API uma pequena quantidade de crédito gratuito para testes, mas não existe um nível gratuito além dessa concessão — quando ela acaba, cada chamada é cobrada.

O custo depende inteiramente de qual das duas formas de pagamento você escolhe — uma assinatura claude.ai ou uma chave de API cobrada por token — e elas atendem a padrões de uso muito diferentes. A forma mais barata de executá-lo sem uma assinatura é uma chave conforme o uso: na Kunavo, todos os modelos Claude custam 30% menos que a tabela da Anthropic, a partir de uma recarga de $10, sem taxa mensal, e a configuração exige algumas variáveis de ambiente (abaixo). Eis a matemática real.

O que é gratuito e o que não é

A única forma gratuita de começar é com um passe de convidado. Assinantes elegíveis dos planos Pro e Max podem compartilhar passes que dão a quem nunca teve um plano pago do Claude um teste de 7 dias do Pro, incluindo o Claude Code. Os remetentes encontram os passes com o comando /passes. Os passes são limitados e podem expirar, então servem para experimentar o Claude Code, não para continuar usando-o gratuitamente (artigo da Anthropic sobre passes de convidado, consultado em 2026-10-10). O plano Free não inclui o Claude Code.

O Codex funciona de forma oposta: o plano Free do ChatGPT inclui o Codex no aplicativo para desktop, com limites. Veja a comparação lado a lado em O Codex é gratuito?.

As duas formas de pagar

As duas opções não se acumulam, e importa qual está ativa: enquanto uma variável de credencial como ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_API_KEY estiver definida, o Claude Code a utiliza em vez de de um login claude.ai salvo. Sua assinatura permanece em espera e sem uso, seus limites deixam de se aplicar e o uso é cobrado na chave. Remova a variável e o Claude Code voltará à assinatura. Execute /status para ver qual está ativa agora.

Quanto custa um mês real

O custo acompanha etapas agênticas, não dias do calendário. O Claude Code reenvia o prompt do sistema, a conversa e o contexto de arquivo atualizado a cada etapa, então uma etapa é maior que uma mensagem de chat — normalmente cerca de 25.000 tokens de entrada e 1.200 de saída. Nas tarifas da Kunavo em claude-sonnet-5:

Esses são números não otimizados — sem cache de prompts, tudo no modelo principal. O uso leve ou exploratório fica na casa de um dígito por mês; o que pesa é o trabalho agêntico diário sustentado, exatamente onde a tarifa por token se acumula. Faça seus próprios cálculos na calculadora de custos ou veja os preços do Claude Code para os níveis de assinatura, a tabela completa de tarifas por modelo e o ponto de equilíbrio entre as duas opções. A coluna “Na tabela da Anthropic” acima vem dos preços oficiais da API da Anthropic, que trazem o preço atual por token de cada modelo Claude ao lado do custo do mesmo modelo aqui.

A forma mais barata de executá-lo

O Claude Code lê ANTHROPIC_BASE_URL nativamente, então funciona com qualquer endpoint que ofereça a API Anthropic Messages — sem plugin, binário modificado ou proxy para supervisionar. Essa é a rota compatível para obter uma tarifa menor por token:

export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Os mesmos modelos, o mesmo CLI, cerca de 30% abaixo do preço de tabela no modelo principal. Mantenha as linhas de modelo: o padrão integrado ao Claude Code e os aliases opus e sonnet acompanham os modelos mais recentes da Anthropic e, se a Kunavo ainda não oferecer um deles, a solicitação retornará 404. O alias sonnet solicita o Sonnet 5.5, que a Kunavo não oferece; portanto, /model sonnet, a fase de execução de opusplan e os subagentes definidos como sonnet retornarão 404, a menos que ANTHROPIC_DEFAULT_SONNET_MODEL o fixe. A definição opus corresponde ao Opus 5.5, que exige o Claude Code v2.1.280 ou posterior — execute claude update em uma instalação mais antiga. Pagamento conforme o uso a partir de uma recarga de US$ 10, sem mensalidade, e o saldo não expira — portanto, um mês tranquilo realmente não custa nada. O passo a passo completo está no guia de configuração do Claude Code. Se você já tem um plano e continua atingindo o limite da janela, o que acontece quando você atinge um limite do Claude calcula o ponto de equilíbrio entre manter o plano e adicionar uma chave para as horas em que ele deixou de atender.

Quatro alavancas que realmente alteram o valor

1. Direcione o trabalho em segundo plano para o Haiku. O Claude Code faz suas próprias chamadas para resumos e títulos. ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 ($0.70 / $3.50 por 1M) transfere essas chamadas para o modelo mais barato. Uma linha, economia permanente — a lista de preços da API Anthropic Claude traz as tarifas por modelo entre as quais essa troca é feita, oficiais e descontadas lado a lado.
2. Comece tarefas novas. O contexto é reenviado a cada etapa, então uma sessão longa tem custo quadrático. Uma tarefa nova volta a ter um contexto pequeno.
3. Deixe o cache de prompts funcionar. A entrada em cache é cobrada a 10% da tarifa de entrada. Em um loop que reenvia um prefixo estável a cada etapa, essa é a maior economia disponível (como funciona).
4. Limite a chave. Dê ao editor sua própria chave com um limite de gastos no painel. Um loop descontrolado passa a ter um limite, em vez de gerar uma surpresa.

O que as pessoas entendem errado sobre isso

“O Claude Code é de código aberto, então é gratuito”

O fato de o cliente ser gratuito para instalar não diz nada sobre as chamadas de modelo. A CLI é a parte barata; a inferência é o custo.

“Minha assinatura Claude Pro cobre a API”

Não cobre. Assinaturas e chaves de API são produtos separados, com faturamento separado — claude.ai cuida de um, console.anthropic.com do outro. O Pro financia o Claude Code somente pela rota da assinatura, não por uma chave.

“Deve existir um nível gratuito se eu usar um modelo pequeno”

Mais barato, não gratuito. claude-haiku-4-5 a $0.70 / $3.50 por 1M é uma fração do Sonnet, mas ainda é cobrado.

“Um gateway significa que posso usá-lo sem pagar à Anthropic”

Você ainda está pagando pela inferência — apenas a uma tarifa diferente, para outra parte. O que muda é o preço e o modelo de cobrança, não o fato de haver um custo.

Perguntas frequentes