O Claude Code pode ser usado gratuitamente? Escopo do plano grátis, teste de 7 dias com passe de convidado e custo real por consumo

O Claude Code não pode ser usado no plano gratuito do Claude. A única forma de usá-lo gratuitamente é por 7 dias com um passe de convidado recebido de alguém que assine o Pro ou o Max (uma avaliação gratuita do plano Pro). Fora isso, é necessária uma assinatura mensal ou uma chave de API com cobrança por uso. Isso porque, mesmo que a instalação da CLI ou da extensão para editor seja gratuita, os modelos Claude chamados pelo Claude Code durante as tarefas são pagos.

Nesta página, explicamos em sequência o que é gratuito e o que é pago, quais planos permitem usar o Claude Code, as condições do passe de convidado e a conversão automática após 7 dias, o custo real de cada tarefa com uma chave de API e a forma mais barata de usá-lo sem assinatura.

Fontes (verificadas em 10 de outubro de 2026): documentação de configuração do Claude Code da Anthropic, o artigo sobre o passe de convidado e o artigo sobre como usar o Claude Code nos planos Pro / Max da Central de Ajuda, e claude.com/ja/pricing, a página de preços. Os preços unitários e a recarga mínima da Kunavo são carregados do catálogo de modelos e das configurações de preços; nenhum número foi inserido manualmente.

O que é gratuito e o que é pago

O Claude Code chama um modelo Claude em cada operação: ler arquivos, sugerir alterações, executar comandos e verificar resultados. O que custa é essa chamada, não a ferramenta em si. A instalação e a configuração são gratuitas; para enviar o primeiro prompt, você precisa estar conectado a um plano ou ter uma chave de API. As instruções de instalação estão reunidas em Como instalar o Claude Code.

Por plano: quais permitem usar o Claude Code

A documentação de configuração da Anthropic afirma explicitamente que o Claude Code exige um plano Pro, Max, Team ou Enterprise, ou uma conta do Console (API), e que o plano gratuito do claude.ai não inclui acesso ao Claude Code. Os preços da tabela são os exibidos em claude.com/ja/pricing e não incluem impostos.

Ao usar uma assinatura, também é preciso ficar atento aos limites. Os planos Pro e Max têm limites de sessão de 5 horas e limites semanais, compartilhados entre o chat do Claude e o Claude Code. Isso significa que, se você usar muito o chat em um dia, terá menos uso disponível no Claude Code. O que fazer ao atingir o limite está explicado em Limites do Claude Pro; o ponto de equilíbrio entre assinatura e API é calculado em Preços do Claude Code.

A única forma de testar gratuitamente: avaliação gratuita do Pro por 7 dias com um passe de convidado

claude.com/ja/pricing não anuncia uma avaliação gratuita. A única forma de testar o Claude Code gratuitamente é pelo sistema de convites que a Anthropic chama de “passe de convidado”. Assinantes Pro / Max elegíveis recebem alguns passes para distribuir, e quem recebe um pode usar o plano Pro gratuitamente por 7 dias, com Claude Code, Cowork e Claude Design incluídos. As condições informadas na Central de Ajuda são as seguintes:

• Quem pode enviar: somente assinantes Pro / Max elegíveis. Execute /passes no Claude Code para consultar os passes restantes e os links de convite.
• Quem pode receber: somente quem nunca teve uma assinatura paga do Claude. Quem já assinou um plano pago não é elegível.
• O que inclui: 7 dias de uso gratuito do plano Pro, incluindo o Claude Code.
• Ao se cadastrar: é necessário informar os dados de pagamento. Não haverá cobrança se você não continuar usando o serviço depois que terminar a avaliação de 7 dias.
• Depois de 7 dias: se você não cancelar, a assinatura será convertida automaticamente para um plano Pro pago.
• Quantidade de passes: o número é limitado, e os passes podem expirar ou ser revogados. Se o convite for enviado a mais pessoas do que o número de passes disponíveis, eles serão usados por ordem de chegada.

Em resumo, o período gratuito do Claude Code é de 7 dias, e há duas condições para usá-lo: receber um convite de um assinante e nunca ter usado um plano pago. Se não quiser continuar, cancele antes do fim do sétimo dia. Os dados de pagamento informados no cadastro são para pagamentos à Anthropic e não têm relação com a recarga da Kunavo explicada abaixo.

Quanto custa cada tarefa com uma chave de API?

Para quem não consegue um passe de convidado ou não usa o serviço o suficiente para justificar uma mensalidade, há a opção de uma chave de API com cobrança por uso. É possível criar uma chave de API no Console da Anthropic ou em um gateway como a Kunavo; em ambos os casos, a cobrança é proporcional aos tokens.

O Claude Code reenvia o prompt do sistema, a conversa e o conteúdo dos arquivos juntos a cada operação. Por isso, cada ida e volta com o modelo (etapa agêntica) usa aproximadamente 25.000 tokens de entrada e 1.200 de saída. O cálculo para claude-sonnet-5 é o seguinte:

Estes são valores sem considerar o cache de prompts. As entradas lidas do cache são cobradas a um preço muito menor do que as entradas comuns; por isso, a cobrança real costuma ser inferior a esses valores (Como funciona o cache). Com uso ocasional, o custo mensal fica em alguns dólares; nos meses em que você executar tarefas maiores todos os dias, o valor será mais alto.

Com a recarga mínima de US$ 10, você pode executar cerca de 230 etapas, ou aproximadamente 11 tarefas de 20 etapas. Sem um passe de convidado, essa é uma forma paga de experimentar o serviço começando com menos do que os US$ 20 mensais do Pro.

Forma mais barata de usar sem assinatura: chave da Kunavo com cobrança por uso

O Claude Code lê a variável de ambiente ANTHROPIC_BASE_URL por padrão; portanto, se o endpoint for compatível com a Messages API da Anthropic, você pode mudar o destino da conexão sem substituir a CLI. A Kunavo é um gateway de API independente da Anthropic que oferece os mesmos modelos Claude a um preço 30% menor do que a tarifa padrão da Anthropic. Não há mensalidade, a recarga mínima é de US$ 10 e o saldo não expira.

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

Não omita as quatro linhas que especificam os modelos. O modelo padrão do Claude Code e os aliases opus e sonnet apontam para os modelos mais recentes da Anthropic; se o modelo ainda não estiver disponível na Kunavo, a solicitação retornará 404. O Sonnet 5.5, para o qual o alias sonnet aponta atualmente, não está disponível na Kunavo. Portanto, se você não definir ANTHROPIC_DEFAULT_SONNET_MODEL, as fases de execução de /model sonnet e opusplan falharão. O modelo fixado por opus é Claude Opus 5.5 e exige o Claude Code v2.1.280 ou posterior; se você estiver usando uma versão mais antiga, execute claude update primeiro. ANTHROPIC_DEFAULT_HAIKU_MODEL direciona as chamadas menores que o Claude Code faz em segundo plano, como resumos, para Claude Haiku 4.5, com preços por 1M de tokens de $0.70 para entrada e $3.50 para saída.

Enquanto a chave estiver definida na variável de ambiente, o Claude Code dará prioridade a ela em vez do login da assinatura, e o uso será descontado do saldo da chave. Remova a variável para voltar à assinatura. Você pode verificar qual opção está ativa com /status. As instruções para criar uma chave e saber onde configurá-la estão em Como configurar uma chave de API no Claude Code.

Pagamento no Brasil

As recargas da Kunavo são pagas pelo checkout da Stripe. No Japão, estão disponíveis cartões, incluindo JCB (Visa, Mastercard, Amex, JCB e UnionPay), Apple Pay, Google Pay e Link. PayPay e pagamento em lojas de conveniência não são aceitos. O valor pago aqui se torna saldo de API da Kunavo e não pode ser usado para pagar os planos Pro / Max da Anthropic nem as cobranças após a avaliação do passe de convidado. A Kunavo não emite faturas nem faturas qualificadas com número de registro para as recargas. A lista de meios de pagamento da Anthropic está em Formas de pagamento do Claude.

Como interpretar informações que dizem “uso gratuito”

• Conectar a outro modelo: nos resultados de busca, há artigos que dizem que é possível usar o Claude Code “gratuitamente” conectando-o a um modelo gratuito que não seja Claude. É verdade que a CLI é gratuita, mas, nesse caso, quem responde é o modelo conectado, não o Claude.
• “A assinatura Pro também inclui a API”: não inclui. A assinatura do claude.ai e as tarifas de uso da API são contratos separados; pagar a mensalidade do Pro não dá acesso à API.
• “Haiku é grátis”: ele é apenas barato, não grátis. Claude Haiku 4.5 também custa $0.70 para entrada e $3.50 para saída por 1M de tokens.
• “Qualquer pessoa pode conseguir um passe de convidado”: somente assinantes Pro / Max elegíveis podem enviar convites, e apenas quem nunca teve um plano pago pode recebê-los. É necessário informar os dados de pagamento ao se cadastrar; se você não cancelar, a assinatura será convertida para um plano pago.

Depois da instalação, consulte Como usar o Claude Code para saber como escrever o CLAUDE.md, configurar permissões e lidar com o uso cotidiano.

Perguntas frequentes