Claude Code é gratuito? Como funciona o plano grátis, como obter o teste de 7 dias e quanto custa o uso por consumo

O Claude Code não é gratuito: o plano grátis do Claude não permite usar o Claude Code. A única forma gratuita é receber de um assinante Pro ou Max um “passe de convidado” (guest pass), que dá direito a um teste grátis de 7 dias do plano Pro. Fora isso, é necessário assinar um plano pago ou usar uma chave de API com cobrança por consumo. O motivo é simples: a CLI e as extensões do editor podem ser instaladas gratuitamente, mas cada ação do Claude Code chama um modelo Claude, e essas chamadas são pagas.

Esta página explica, em ordem, onde está a diferença entre o gratuito e o 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 uma tarefa com chave de API e a opção mais barata sem assinatura.

Fontes (verificadas em 10 de outubro de 2026): a documentação de configuração do Claude Code da Anthropic, os artigos da central de ajuda sobre passes de convidado e o uso do Claude Code com os planos Pro ou Max, além da página de preços claude.com/pricing. Os preços unitários e o valor mínimo de recarga da Kunavo são obtidos diretamente do catálogo de modelos e das configurações de recarga, sem números inseridos manualmente.

O que é gratuito e o que é pago

O Claude Code lê arquivos, propõe alterações, executa comandos e verifica resultados; cada ação chama o modelo Claude. O que custa são essas chamadas, não a ferramenta em si. A instalação e os ajustes de configuração são gratuitos; a partir do primeiro prompt enviado, é necessário entrar com um plano pago ou configurar uma chave de API. Consulte o tutorial de instalação do Claude Code para ver as etapas de instalação.

Quais planos permitem usar o Claude Code

A documentação de configuração da Anthropic informa que o Claude Code requer um plano Pro, Max, Team ou Enterprise, ou uma conta Console (API); o plano grátis do claude.ai não inclui acesso ao Claude Code. Os preços da tabela são os publicados em claude.com/pricing, em dólares americanos e sem impostos.

Se você optar por uma assinatura, também precisa considerar os limites. Os planos Pro e Max têm um limite de sessão de cinco horas e um limite semanal, compartilhados entre o chat do Claude e o Claude Code: quanto mais você usar o chat em um dia, menos capacidade sobrará para o Claude Code. Para ver as opções ao atingir um limite, consulte Limites do Claude Pro; para o ponto de equilíbrio entre assinatura e API, consulte Custos do Claude Code.

A única opção gratuita: passe de convidado (teste grátis de 7 dias do plano Pro)

Não há um plano com teste grátis em claude.com/pricing. Para experimentar o Claude Code gratuitamente, a única opção é o sistema de convites que a Anthropic chama de “passe de convidado”: assinantes elegíveis Pro / Max recebem alguns passes para enviar, e quem os recebe pode usar gratuitamente o plano Pro por 7 dias, incluindo o Claude Code, o Cowork e o Claude Design. Estas são as condições listadas pela central de ajuda:

• Quem pode enviar: apenas assinantes elegíveis Pro / Max. Execute /passes no Claude Code para ver os passes restantes e os links de convite.
• Quem pode resgatar: apenas quem nunca teve uma assinatura paga do Claude. Quem já assinou um plano pago não é elegível.
• O que você recebe: 7 dias de uso grátis do plano Pro, incluindo o Claude Code.
• Ao se cadastrar: é necessário informar os dados de pagamento; se você não continuar usando após o fim do teste de 7 dias, não será cobrado.
• Após 7 dias: se você não cancelar, a assinatura será convertida automaticamente em um plano Pro pago.
• Quantidade: o número de passes é limitado; eles podem expirar ou ser revogados. Se forem enviados a mais pessoas do que o número de passes disponíveis, eles serão concedidos por ordem de resgate.

Portanto, a resposta para “por quanto tempo é possível testar o Claude Code gratuitamente?” é 7 dias, com duas condições: um assinante precisa convidar você, e você não pode ter usado antes um plano pago do Claude. Se não quiser renovar, lembre-se de cancelar antes do fim do sétimo dia. Os dados de pagamento informados ao se cadastrar para o teste são usados para pagar a Anthropic e não têm relação com a recarga da Kunavo descrita abaixo.

Quanto custa uma tarefa com uma chave de API?

Se você não conseguir um passe de convidado ou seu volume de uso ainda não justificar uma mensalidade, pode passar a usar uma chave de API com cobrança por consumo. Você pode criar a chave no Console da Anthropic ou em um gateway como a Kunavo; em ambos os casos, a cobrança é por token.

A cada ação, o Claude Code envia novamente todo o prompt do sistema, a conversa e o conteúdo dos arquivos. Por isso, cada interação com o modelo (uma etapa agêntica) corresponde a cerca de 25.000 tokens de entrada e 1.200 de saída. Veja o cálculo com claude-sonnet-5:

Estes valores brutos não incluem o prompt caching. As entradas lidas do cache custam muito menos do que as entradas comuns, então a conta real geralmente fica mais baixa (como funciona o cache). Para uso ocasional, alguns dólares por mês podem ser suficientes; o custo aumenta bastante nos meses em que você executa tarefas grandes todos os dias.

A recarga mínima de $10 dá para executar cerca de 230 etapas, o equivalente a aproximadamente 11 tarefas de 20 etapas. Sem um passe de convidado, essa é uma unidade de “teste pago” menor que os $20 mensais do Pro.

Opção mais barata sem assinatura: chave com cobrança por consumo da Kunavo

O Claude Code lê a variável de ambiente ANTHROPIC_BASE_URL nativamente. Se o endpoint for compatível com a Messages API da Anthropic, basta alterar o destino da conexão sem substituir a CLI. A Kunavo é um gateway de API independente, não afiliado à Anthropic, que oferece os mesmos modelos Claude a preços 30% inferiores aos da Anthropic. Não há mensalidade; a recarga mínima é de $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

As quatro linhas de configuração do modelo são indispensáveis. 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 alias sonnet aponta atualmente para o Sonnet 5.5, que não está disponível na Kunavo. Sem configurar ANTHROPIC_DEFAULT_SONNET_MODEL, a execução de /model sonnet e opusplan falhará. opus está fixado em Claude Opus 5.5 e requer o Claude Code v2.1.280 ou posterior; em versões mais antigas, execute primeiro claude update. ANTHROPIC_DEFAULT_HAIKU_MODEL direciona chamadas auxiliares, como os resumos feitos em segundo plano pelo Claude Code, para Claude Haiku 4.5, que custa $0.70 por 1M de tokens de entrada e $3.50 por 1M de tokens de saída.

Enquanto essas variáveis estiverem configuradas, o Claude Code usará a chave em vez da assinatura da sua conta, e o uso será descontado do saldo da chave. Remova as variáveis para voltar à assinatura. Para confirmar qual método está em uso, execute /status. Consulte Configuração de chave de API do Claude Code para ver os detalhes.

Como pagar em Taiwan

As recargas da Kunavo são processadas pela página de checkout da Stripe. Em Taiwan, é possível pagar com cartões de crédito internacionais (Visa, Mastercard, Amex, JCB e UnionPay), Apple Pay, Google Pay e Link. JKO Pay e LINE Pay não estão entre as formas de pagamento disponíveis. O valor pago aqui é convertido em saldo de API da Kunavo e não pode ser usado para pagar uma assinatura Pro / Max do claude.ai nem as cobranças após o fim do teste do passe de convidado. A Kunavo não emite faturas. Para uma comparação completa das formas de pagamento, consulte Formas de pagamento da API do Claude.

Como avaliar os métodos anunciados como “gratuitos” na internet

• Conectar a outro modelo: alguns artigos nos resultados de busca apresentam como “forma gratuita de uso” a conexão do Claude Code com modelos gratuitos que não são Claude. A CLI é gratuita, mas, nesse caso, as respostas não vêm do Claude, e sim do modelo conectado.
• “A assinatura Pro inclui a API”: não inclui. A assinatura do claude.ai e o uso da API são cobrados separadamente; a mensalidade do Pro não inclui o uso da API.
• “Usar Haiku é grátis”: ele é apenas barato, não grátis. Claude Haiku 4.5 A cada 1M de tokens, também há cobranças de entrada $0.70 e saída $3.50.
• “Qualquer pessoa pode conseguir um passe de convidado”: somente assinantes Pro / Max elegíveis podem enviar convites, e apenas pessoas que estejam assinando um plano pago pela primeira vez podem resgatá-los; é necessário informar os dados de pagamento ao se cadastrar, e a assinatura passa a ser paga se você não cancelar.

O uso cotidiano depois de instalar o Claude Code, como trocar de modelo, consultar os gastos e organizar o contexto, está explicado em Guia do Claude Code.

Perguntas frequentes