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 subscrições Max, Team e Enterprise, pelo que 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 API key (chave de interface de programação de aplicações, faturada por token) quando não tem uma subscrição ou quando quer que as execuções automatizadas sejam faturadas separadamente do seu trabalho interativo.

A parte que costuma causar confusão vem a seguir. O Claude Code não tem uma quota própria separada. Utiliza o mesmo orçamento de utilização da subscrição que as conversas de chat utilizam, pelo que uma sessão de programação longa reduz a janela de chat disponível a seguir. 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 realmente inclui

• Free: não inclui Claude Code. Permite conversar na Web e nas aplicações, mas não no seu terminal.
• Pro: inclui 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 de $100 e $200 por mês em agosto de 2026.
• Team e Enterprise: incluídos na licença. A quota pertence à licença, e uma licença premium inclui mais utilização do que uma licença standard.

Estes são os únicos preços apresentados aqui, porque os preços dos planos mudam e esta página não. 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 do Claude, e vale a pena consultar o que o nível gratuito do Claude inclui antes de concluir que não tem alternativas.

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

Uma subscrição paga é regida por duas janelas. 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. Pode consultar a sua própria hora de reposição no ecrã de utilização. Nenhum dos dois limites corresponde a uma contagem de mensagens que possa calcular antecipadamente, porque o progresso depende da duração das conversas e do modelo utilizado. Considere-os comportamentos a monitorizar, não um número para definir um orçamento. Os mecanismos dos limites em detalhe merece ser lido uma vez, antes de atingir um deles.

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 do anterior. As próprias orientações da Anthropic para administradores recomendam prever mais consumo 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 esse efeito, mas não o elimina. O contexto repetido é relido 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 relativa a toda a conversa subjacente. Numa subscrição, o cache permanece válido durante uma hora. Se fizer uma pausa para almoçar, a sua primeira mensagem ao regressar não encontra o contexto no cache. Todo o contexto é então processado novamente à taxa normal. Essa mensagem pode custar mais do que as vinte anteriores.

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

Execute /usage no Claude Code. Num plano pago, o comando mostra barras de utilização para os limites do seu plano e detalha o que os tem consumido. Prima d para consultar as últimas 24 horas e w para consultar os últimos 7 dias.

O detalhamento assinala qualquer comportamento responsável por 10 por cento ou mais da utilização recente, como contexto longo ou falhas de cache. Também 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 onde está a trabalhar. Por isso, o trabalho feito noutra máquina ou em claude.ai não aparece no detalhamento. 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 do 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á próxima do limite de contexto da sessão e que o histórico mais antigo 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 com que o orçamento é consumido. /clear entre tarefas não relacionadas não tem custo 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 upgrade ou ativar créditos de utilização.

Por que uma chave de API pode assumir a faturação sem pedir confirmaçã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 é faturado por token na sua conta de API. O limite da sua subscrição Pro ou Max permanece intacto enquanto a fatura aumenta.

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

printenv ANTHROPIC_API_KEY

Se nada for apresentado, não há nenhuma chave definida e o Claude Code usará a sua subscrição. Se for apresentada uma chave, a próxima sessão será faturada na API. Limpe-a nesta shell e procure 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 login no navegador. Durante uma sessão, /login troca de conta e /usage confirma em qual conta de faturação entrou: um subscritor vê barras de utilização do plano, enquanto uma conta de API vê um bloco da sessão com os custos dos tokens e sem barras do plano. O restante da configuração no servidor, incluindo como manter uma sessão ativa depois de se desligar, é explicado em executar o Claude Code num VPS dentro do tmux, e a parte das permissões em executar o Claude Code com segurança num servidor que possui.

Existe outra armadilha relacionada. Quando o limite do plano se esgota, pode ativar créditos de utilização para continuar a trabalhar, com faturação adicional à subscrição. Quando usa 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 faturação para um subscritor Pro ou Max.

Qual deles deve pagar?

• Programação ocasional ou por hobby: Pro. Uma ferramenta, uma fatura e capacidade suficiente para algumas sessões por semana. Os detalhes da capacidade estão em preço e limites do plano Pro.
• Programação diária contínua: Max. Se atingir o limite da sessão na maioria dos dias, a solução mais barata é ter uma capacidade 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, nas quais a capacidade está associada à licença e um administrador pode consultar os gastos por utilizador.
• Execuções em picos ou automatizadas: faturação da API. Uma tarefa noturna ou uma etapa de CI (integração contínua) não precisa de competir com o seu trabalho interativo pela mesma capacidade.

Os dois últimos casos combinam bem. Mantenha a subscrição para o trabalho que faz manualmente e atribua à automatização a sua própria chave da API, para que uma execução durante a noite não esgote a capacidade de que precisa na manhã seguinte. A comparação de custos entre a API e a subscrição mostra onde fica o ponto de equilíbrio.

FAQ

Posso usar o Claude Code no plano gratuito do Claude?

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 gratuito do Claude não inclui acesso ao Claude Code. Por isso, executar claude pedirá que inicie sessão numa conta paga ou que faça a autenticação 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 numa 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.

Por que motivo a minha utilização diminuiu tão depressa 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 toda a conversa. Cada resultado de uma ferramenta adiciona outro pedido que volta a transportar esse contexto. Execute /usage e leia os indicadores de comportamento. Tudo o que representar 10 por cento ou mais da utilização recente fica assinalado. Os motivos mais comuns são contexto longo e falhas de cache. Uma sessão deixada aberta durante todo o dia continua a reenviar o histórico completo. Um período de inatividade superior à validade de cache de uma hora faz com que a mensagem seguinte processe tudo novamente à 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 é esporádico ou automatizado. A faturação da API é feita por token e não tem um custo mensal mínimo. Assim, um script executado duas vezes por semana custa apenas o valor dos tokens utilizados. Uma subscrição paga por um mês de capacidade que pode não utilizar. Em programação diária contínua, acontece o contrário. Uma subscrição tem um preço fixo para uma franquia elevada. Pagar por token pelo mesmo volume fica mais caro. Definir ANTHROPIC_API_KEY numa máquina onde também programa manualmente é o erro a evitar. Nesse caso, o Claude Code cobra através da API e deixa por utilizar a franquia da sua subscrição.