Claude Code está incluído no Claude Pro?

O Claude Code está incluído no Claude Pro?

Sim. O Claude Code está incluído no Claude Pro e também nas licenças Max, Team e Enterprise. Uma subscrição cobre as aplicações de chat e a ferramenta de terminal. O plano gratuito do Claude não o inclui. A documentação de configuração da Anthropic é explícita: o Claude Code requer uma conta Pro, Max, Team, Enterprise ou Console, e o plano gratuito não inclui acesso ao Claude Code. Só precisa de uma chave de API (application programming interface key, faturada por token) quando não tem uma subscrição ou quando pretende executar tarefas automatizadas com faturação separada do seu trabalho interativo.

A parte que costuma causar confusão vem a seguir. O Claude Code não tem uma quota própria. Utiliza o mesmo orçamento de utilização da subscrição que as conversas no chat utilizam. Por isso, uma sessão de programação longa reduz a janela de chat disponível depois. A Anthropic afirma que os planos Pro e Max têm limites de utilização partilhados entre o Claude e o Claude Code. Isto significa que toda a atividade nas duas ferramentas conta para os mesmos limites de utilização.

O que cada plano oferece na prática

• Free: não inclui o Claude Code. Permite conversar na Web e nas aplicações, mas não disponibiliza nada no terminal.
• Pro: inclui o Claude Code dentro dos limites de utilização do Pro. Custa $20 por mês nos Estados Unidos em agosto de 2026, com um preço inferior na faturação anual.
• Max: inclui o mesmo Claude Code, com uma quota de utilização maior, em dois níveis a $100 e $200 por mês em agosto de 2026.
• Team e Enterprise: incluídos no seat. A quota pertence ao seat, e um seat premium inclui mais utilização do que um seat standard.

Estes são os únicos preços apresentados aqui, porque os preços dos planos mudam e esta página não é atualizada com a mesma frequência. Os valores atuais estão em uma análise completa dos custos do Claude Code, a escolha entre os níveis é explicada em uma comparação plano a plano das subscrições Claude, e vale a pena consultar o que o nível gratuito do Claude inclui antes de concluir que não tem outra opção.

Por que uma sessão de programação encurta a sua janela de chat

Uma assinatura paga é regida por duas janelas. O limite de sessão é reposto a cada cinco horas. O limite semanal é reposto numa hora fixa de cada semana, atribuída à sua conta. Pode consultar a hora da reposição no ecrã de utilização. Nenhum dos dois limites corresponde a uma contagem de mensagens que possa calcular antecipadamente, porque o consumo depende da duração das conversas e do modelo utilizado. Considere-os valores a monitorizar, não números para os quais deve reservar uma margem. Os mecanismos dos limites em detalhe merecem ser lidos uma vez, antes de atingir um deles.

O Claude Code consome esse orçamento mais depressa do que o chat devido ao conteúdo de cada interação de programação. Cada pedido envia toda a conversa existente até esse momento. Cada chamada de ferramenta, leitura de ficheiro ou execução de teste envia outro pedido com os resultados da interação anterior. As orientações da própria Anthropic para administradores recomendam reservar mais utilização para uma licença de programação do que para uma licença de chat precisamente por este motivo: uma sessão de depuração pode consumir mais do que um dia de chat.

O armazenamento em cache de prompts reduz este efeito, mas não o elimina. O contexto repetido é processado novamente a uma taxa de cache. Por isso, uma pergunta de uma linha numa sessão aberta durante todo o dia continua a consumir utilização correspondente a toda a conversa anterior. Numa assinatura, a cache permanece válida durante uma hora. Se interromper o trabalho para almoçar, a primeira mensagem depois do regresso não utiliza a cache. Todo o contexto é então processado novamente à taxa normal. Essa única mensagem pode custar mais do que as vinte mensagens anteriores.

Os sinais práticos de que está a consumir o orçamento partilhado

Execute /usage no Claude Code. Num plano pago, o comando apresenta barras de utilização para os limites do seu plano, com uma discriminação do que os está a consumir. Prima d para ver as últimas 24 horas e w para ver os últimos 7 dias.

A discriminação assinala qualquer comportamento responsável por 10 por cento ou mais da utilização recente, como contextos longos ou falhas de cache, e atribui a utilização a skills, subagentes, plugins e servidores MCP (model context protocol) individuais. Há uma limitação importante. Estes valores são calculados a partir do histórico local de sessões na máquina que está a utilizar. Por isso, o trabalho feito noutra máquina ou em claude.ai não aparece na discriminação. As barras do plano são globais. A atribuição é local.

Quando esgota o limite, a mensagem indica qual foi o teto atingido:

You've hit your session limit
You've hit your weekly limit

Ambas as janelas aplicam-se a todos os modelos. Por isso, mudar de modelo com /model não repõe o acesso. Uma mensagem específica de um modelo, como You've hit your Opus limit, é diferente. Nesse caso, /model permite continuar a trabalhar com outro modelo. Um aviso de contexto ou uma notificação de compactação automática não é um limite de utilização. Significa que a conversa está perto do limite de contexto da sessão e que o histórico mais antigo está prestes a ser resumido. As orientações de custos da Anthropic dão prioridade à gestão do contexto, e manter a janela de contexto pequena tem o efeito mais claro na velocidade a que o orçamento é consumido. /clear entre tarefas não relacionadas não custa nada e inicia o pedido seguinte com menos conteúdo para transportar. Se já perdeu o acesso, as opções quando um limite é atingido limitam-se a esperar, fazer um upgrade ou ativar créditos de utilização.

Como uma chave de API pode assumir a cobrança sem pedir autorização

Este problema é especialmente grave num servidor. Se a variável de ambiente ANTHROPIC_API_KEY estiver definida, o Claude Code autentica-se com essa chave em vez de usar a subscrição, e o trabalho é cobrado por token na sua conta de API. O limite da subscrição Pro ou Max permanece intacto enquanto a fatura aumenta. Também não existe um limite gratuito do outro lado, porque a Claude API não tem um plano gratuito além do pequeno crédito concedido no registo.

Num VPS, isto acontece acidentalmente com mais frequência do que num portátil, porque o mesmo perfil de shell costuma conter chaves para outras ferramentas. Verifique antes de começar:

printenv ANTHROPIC_API_KEY

Se nada for apresentado, nenhuma chave está definida e o Claude Code usará a sua subscrição. Se for apresentada uma chave, a sessão seguinte será cobrada na API. Remova-a desta shell e procure depois o ficheiro que continua a defini-la:

unset ANTHROPIC_API_KEY
grep -rn ANTHROPIC_API_KEY ~/.bashrc ~/.profile ~/.bash_profile 2>/dev/null

Agora, inicie o Claude Code e autentique-se com a conta da subscrição:

claude

A primeira execução inicia um início de sessão no navegador. Durante uma sessão, /login troca de conta e /usage confirma em que conta de cobrança iniciou sessão: um subscritor vê barras de utilização do plano, enquanto uma conta de API vê um bloco de sessão com os custos dos tokens e não vê barras do plano. O restante da configuração no servidor, incluindo a forma de manter uma sessão ativa depois de desligar, é explicado em executar o Claude Code num VPS dentro do tmux, e a parte relacionada com permissões em executar o Claude Code em segurança num servidor que lhe pertence.

Existe outra armadilha relacionada. Quando o limite do plano se esgota, pode ativar créditos de utilização para continuar a trabalhar além desse limite, com cobrança adicional à subscrição. Quando utiliza créditos, a duração da cache de prompts diminui de uma hora para cinco minutos. Assim, os mesmos intervalos de inatividade que antes eram gratuitos começam a gerar custos. /usage-credits abre as definições de cobrança para um subscritor Pro ou Max.

Qual deve pagar?

Tudo isto pressupõe que decidiu pagar, e saber se o Claude Code recupera o custo à sua própria tarifa horária é o cálculo que fundamenta essa decisão. Se estiver a avaliar a subscrição em si, e não a ferramenta de terminal, saber se o Claude Pro compensa para a forma como utiliza efetivamente o Claude parte de uma pergunta diferente: com que frequência o limite gratuito o impede de continuar.

• Programação ocasional ou por hobby: Pro. Uma ferramenta, uma fatura e capacidade suficiente para algumas sessões por semana. Os detalhes da franquia estão em preço e limites do plano Pro.
• Programação diária contínua: Max. Se atingir a janela de sessão na maioria dos dias, a solução mais barata é uma franquia maior, não uma segunda conta. A escolha entre os dois níveis Max depende da frequência com que atinge o limite semanal, e não o limite de cinco horas.
• Várias pessoas: licenças Team ou Enterprise, em que a franquia acompanha a licença e um administrador pode consultar os gastos de cada utilizador. Comparar o custo de uma licença com o custo do mesmo trabalho por token é o cálculo a fazer antes de comprar licenças em volume.
• Execuções intermitentes ou automatizadas: faturação da API. Uma tarefa noturna ou uma etapa de CI (integração contínua) não tem motivo para competir com o seu trabalho interativo pela mesma franquia.

Estes dois últimos casos combinam bem. Mantenha a subscrição para o trabalho que faz manualmente e atribua à automação a sua própria chave de API. Assim, uma execução noturna não esgota a janela de que precisa na manhã seguinte. A comparação entre os custos da API e da subscrição mostra onde ocorre o ponto de equilíbrio.

FAQ

Posso usar o Claude Code no plano Claude gratuito?

Não. O Claude Code requer uma conta Pro, Max, Team, Enterprise ou Console. A documentação de configuração da Anthropic informa que o plano Claude gratuito não inclui acesso ao Claude Code. Por isso, executar claude pedirá que inicie sessão numa conta paga ou que se autentique com uma chave de API. O plano gratuito continua a incluir conversas nas aplicações web e desktop. Isso é suficiente para testar se o Claude responde ao tipo de pergunta que pretende fazer antes de pagar.

O Claude Code usa os mesmos limites de utilização que o chat do Claude?

Sim, nos planos Pro e Max. A Anthropic informa que os limites de utilização são partilhados entre o Claude e o Claude Code. Toda a atividade nas duas ferramentas conta para os mesmos limites. O limite de uma sessão é reposto a cada cinco horas. O limite semanal é reposto a uma hora fixa todas as semanas, definida para a sua conta. Na prática, uma tarde de refatoração intensa pode deixar uma janela de chat curta nessa noite. Execute /usage para ver as barras e a hora da próxima reposição.

Porque é que a minha utilização diminuiu tão rapidamente durante uma sessão de programação?

Porque uma interação de programação transporta muito mais contexto do que uma mensagem de chat. Cada pedido envia a conversa completa. Cada resultado de uma ferramenta acrescenta outro pedido que volta a transportar esse contexto. Execute /usage e consulte os indicadores de comportamento. Tudo o que representar 10 por cento ou mais da utilização recente fica assinalado. Os responsáveis mais comuns são o contexto longo e as falhas de cache. Uma sessão deixada aberta durante todo o dia continua a reenviar o histórico completo. Um intervalo de inatividade superior à duração de uma hora da cache faz com que a mensagem seguinte volte a processar tudo à taxa normal. Usar /clear entre tarefas não relacionadas resolve ambos os problemas.

Quando é que uma chave de API fica mais barata do que uma subscrição Pro ou Max?

Quando o trabalho é intermitente ou automatizado. A faturação da API é feita por token e não tem um custo mensal mínimo. Por isso, um script executado duas vezes por semana custa apenas o valor desses tokens. Uma subscrição paga por um mês de capacidade que pode não utilizar. A utilização diária e contínua para programação funciona ao contrário. Uma subscrição tem um preço fixo para um limite elevado. Pagar por token pelo mesmo volume custa mais. Definir ANTHROPIC_API_KEY numa máquina onde também programa manualmente é o erro a evitar. Nesse caso, o Claude Code fatura através da API e deixa por utilizar o limite incluído na subscrição.