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, no Max, no Ultra, em todos os lugares Team e nos lugares Enterprise atuais. Uma subscrição cobre as aplicações de chat e a ferramenta de terminal. Num contrato Enterprise antigo, isso depende do tipo de lugar: apenas os lugares Premium e Chat + Claude Code incluem a ferramenta. Confirme que tipo de lugar possui. O plano Claude gratuito não a inclui. A documentação de configuração da Anthropic é explícita: o Claude Code requer uma conta Pro, Max, Ultra, Team, Enterprise ou Console, e o plano gratuito não inclui acesso ao Claude Code. Uma subscrição não requer uma chave de API (application programming interface, cobrada por token). A chave é opcional: se ANTHROPIC_API_KEY estiver definida e a aprovar, essa sessão será cobrada por token. Isto é útil para execuções automatizadas que pretende faturar separadamente do trabalho interativo, ou para uma sessão ocasional que queira faturar a uma chave específica. Sem uma subscrição, a opção é usar uma conta Console, que cobra por token.

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 de chat utilizam. Por isso, uma sessão longa de programação reduz a janela de chat disponível depois. A Anthropic afirma que os planos Pro, Max e Ultra 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. A única exceção é um plano Enterprise atual baseado na utilização. Este plano não tem um orçamento incluído para partilhar: não existem limites de utilização por lugar, e cada pedido feito em qualquer uma das ferramentas é cobrado às tarifas da API.

O que cada plano oferece na prática

• Free: não inclui Claude Code. Chat na Web e nas aplicações, sem acesso no terminal.
• Pro: inclui Claude Code dentro dos limites de utilização do Pro. Custa $20 por mês nos Estados Unidos em outubro de 2026, com um preço inferior na faturação anual.
• Max: inclui o mesmo Claude Code, com cinco vezes a utilização do Pro a cada cinco horas e a cada semana. Custa $100 por mês na Web em outubro de 2026 e só permite faturação mensal. Inclui $100 por mês em créditos de API.
• Ultra: inclui o mesmo Claude Code, com dez vezes a utilização do Pro por semana. Custa $200 por mês na Web em outubro de 2026 e só permite faturação mensal. Inclui $200 por mês em créditos de API. Os preços para dispositivos móveis dos planos Max e Ultra podem variar.
• Team e Enterprise: incluídos em cada lugar do Team, sendo que o limite pertence ao lugar e um lugar Premium inclui mais utilização do que um lugar standard. Os planos Enterprise atuais usam um único tipo de lugar que inclui Claude Code, sem limite incluído por lugar: toda a utilização é faturada segundo as tarifas da API, dentro dos limites de despesa definidos pelo administrador. Os contratos Enterprise antigos usam tipos de lugar separados: apenas os lugares Premium e Chat + Claude Code incluem Claude Code, e apenas os contratos baseados em lugares têm um limite incluído.

Estes são os únicos preços apresentados aqui, porque os preços dos planos mudam e esta página não é atualizada com eles. Os valores atuais estão em uma análise completa dos custos do Claude Code, a escolha entre os planos é 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 reduz a sua janela de chat

Duas janelas regem uma subscrição Pro, Max ou Team, e um lugar num contrato Enterprise antigo baseado em lugares. O limite de sessão é reposto a cada cinco horas. O limite semanal é reposto numa hora fixa todas as semanas, atribuída à sua conta, e pode consultar a sua própria hora de reposição no ecrã de utilização. As contas Ultra verificadas não têm limite de cinco horas; as contas não verificadas têm um limite temporário. O Ultra continua a ter um limite semanal para todos os modelos, e Max e Ultra limitam o Fable a metade da atribuição semanal normal, usando o mesmo orçamento e consumindo-o mais depressa do que os outros modelos. Um plano Enterprise atual baseado no uso não tem nenhuma destas janelas: cobra o consumo, e os administradores controlam-no com limites de despesa. Nenhuma das janelas corresponde a uma contagem de mensagens que possa calcular antecipadamente, porque o consumo depende da duração das conversas e do modelo utilizado. Considere-as limites a monitorizar, não um número para definir no orçamento. Vale a pena ler Os mecanismos dos limites em detalhe uma vez, antes de atingir um deles.

O Claude Code esgota esse orçamento mais depressa do que o chat por causa do 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 pedido anterior. As próprias orientações da Anthropic para administradores recomendam reservar mais orçamento para um lugar de programação do que para um lugar de chat precisamente por este motivo: uma sessão de depuração pode consumir mais do que um dia de chat.

A colocação em cache de prompts reduz este efeito, mas não o elimina. O contexto repetido é lido novamente a uma taxa de cache, por isso uma pergunta de uma linha dentro de uma sessão aberta durante todo o dia continua a consumir utilização correspondente a toda a conversa que a antecede. Numa subscrição, enquanto estiver dentro da utilização incluída no seu plano, a conversa principal tem uma duração de cache de uma hora; os subagentes, a compactação e a maioria dos outros pedidos que o Claude Code faz fora dessa conversa usam, por predefinição, cinco minutos. Se se afastar durante mais de uma hora, a sua primeira mensagem ao regressar não encontra o cache, o que significa que todo o contexto é novamente escrito no cache à taxa de escrita do cache. Essa taxa é superior à taxa normal de entrada, não é igual: a Anthropic cobra as escritas de cache de uma hora a 2 vezes o preço base de entrada e as escritas de cache de cinco minutos a 1.25 vezes. Essa mensagem pode custar mais do que as vinte anteriores.

Os sinais práticos de que está a esgotar 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 consumiu. 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 contexto longo ou falhas de cache, e atribui a utilização a skills, subagentes, plugins e servidores MCP (model context protocol) individuais. Há uma ressalva 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

As duas janelas aplicam-se a todos os modelos. Por isso, mudar de modelo com /model não devolve 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á 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 colocam a gestão do contexto em primeiro lugar, 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 tem qualquer custo e inicia o pedido seguinte com menos contexto para transportar. Se já perdeu o acesso, as opções quando um limite é atingido resumem-se a esperar, fazer upgrade ou ativar créditos de utilização. Se a Anthropic tiver disponibilizado uma reposição gratuita do limite para a sua conta, existe uma quarta opção: utilize-a em Settings > Usage na Web ou no Claude Desktop (não no próprio Claude Code). O limite de sessão ou semanal abrangido volta a ficar completo no Claude Code.

Como uma chave de API pode assumir a faturação

Este problema é especialmente grave num servidor. Se a variável de ambiente ANTHROPIC_API_KEY estiver definida e você autorizar a utilização, o Claude Code autentica-se com essa chave em vez de usar a sua subscrição, e o trabalho é faturado por token na sua conta de API. Numa sessão interativa, ele pergunta uma vez se deve usar a chave e guarda a resposta. Assim, uma chave autorizada há meses continua a ser usada sem outro pedido de confirmação. Para alterar essa escolha mais tarde, use o seletor "Use custom API key" em /config. Essa opção só aparece enquanto a variável estiver definida. No modo não interativo (claude -p), qualquer chave presente é usada sem qualquer pergunta. O seu saldo Pro, Max ou Ultra permanece intacto enquanto a fatura aumenta. Também não existe um saldo gratuito disponível do outro lado, porque a Claude API não tem um nível gratuito além do pequeno crédito concedido no registo. Os créditos mensais de API incluídos nos planos Max, Ultra e Team não cobrem o Claude Code interativo. Cobrem execuções claude -p e trabalho com o Agent SDK iniciado por si com uma chave de API da organização do Console associada ao seu plano.

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. A recomendação da própria Anthropic é manter ANTHROPIC_API_KEY indefinida se quiser que a sua subscrição seja usada para a faturação e definir uma chave apenas na sessão de terminal que precisa dela. Depois de iniciar sessão, o Claude Code também apresenta um aviso quando uma sessão iniciada com uma subscrição e uma chave de API estão ativas ao mesmo tempo. Verifique antes de começar:

printenv ANTHROPIC_API_KEY

Se nada for apresentado, não existe uma chave de API definida nesta shell. Isso, por si só, não prova que o Claude Code vai usar a sua subscrição. Uma credencial também pode vir de ANTHROPIC_AUTH_TOKEN, de um script apiKeyHelper ou do bloco env de um ficheiro de definições, incluindo definições geridas por um administrador. Qualquer uma dessas fontes tem precedência sobre um início de sessão em claude.ai. Execute /status dentro do Claude Code para ver qual está ativa. Se for apresentada uma chave, a próxima sessão será faturada através da API se já tiver autorizado essa chave ou executado claude -p. Caso contrário, o Claude Code pergunta primeiro, e recusar mantém a utilização da subscrição. Limpe a chave nesta 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. Dentro de uma sessão, /login troca de conta, /status apresenta o método de autenticação em uso e /usage confirma o tipo de faturação utilizado. 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 sem barras do plano. O restante da configuração no servidor, incluindo como manter uma sessão ativa depois de desligar, está descrito em executar o Claude Code num VPS dentro do tmux. A parte relativa às permissões está descrita em executar o Claude Code em segurança num servidor que lhe pertence.

Existe outra armadilha relacionada. Quando o saldo do plano termina, pode ativar créditos de utilização para continuar a trabalhar, com faturação adicional à subscrição. Depois de começar a utilizar créditos, o Claude Code reduz a duração da cache de prompts da conversa principal de uma hora para cinco minutos. Assim, os mesmos períodos de inatividade que antes eram gratuitos começam a gerar custos, exceto se definir manualmente a opção promptCacheTtl como 1h. /usage-credits abre Settings > Usage para um subscritor Pro, Max ou Ultra.

Qual opção deve pagar?

Tudo isto parte do princípio de que decidiu pagar. Saber se o Claude Code recupera o custo à sua tarifa horária é o cálculo que sustenta essa decisão. Se o que está a avaliar é a subscrição, e não a ferramenta de terminal, saber se o Claude Pro compensa para a forma como usa realmente 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 ou Ultra. O Max oferece cinco vezes o uso do Pro em ambas as janelas. O Ultra oferece dez vezes o uso semanal do Pro e remove o limite de cinco horas para contas verificadas. A escolha entre Max e Ultra depende da frequência com que atinge o limite semanal e da necessidade de trabalhar sem um limite de cinco horas.
• Várias pessoas: licenças Team ou Enterprise. A franquia acompanha a licença. Num plano Enterprise atual baseado no uso, cada pedido é faturado às tarifas da API, dentro dos limites de despesa definidos pelo administrador. O administrador também pode consultar a despesa por utilizador. Comparar o custo de uma licença com o custo da mesma operação por token é o cálculo a fazer antes de comprar licenças em quantidade.
• Execuções variáveis ou automatizadas: faturação da API. Um job noturno ou uma etapa de CI (integração contínua) não tem motivo para competir com o trabalho interativo pela mesma franquia.

Os dois últimos casos combinam bem. Mantenha a subscrição para o trabalho manual e atribua à automação a sua própria chave de API. Assim, uma execução noturna não esgota a janela de utilização 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, Ultra, 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 autentique com uma API key. O plano gratuito continua a incluir o chat nas aplicações web e desktop. Isso é suficiente para testar se o Claude responde ao tipo de perguntas 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, Max e Ultra. A Anthropic informa que os limites de utilização são partilhados entre o Claude e o Claude Code. Portanto, toda a atividade nas duas ferramentas conta para os mesmos limites. Os planos Pro e Max têm um limite de sessão que é reposto a cada cinco horas. Os três planos têm também um limite semanal que é reposto numa hora fixa de cada semana, definida para a sua conta. As contas Ultra verificadas não têm limite de cinco horas. As contas não verificadas têm um limite temporário. O Max e o Ultra limitam o Fable a metade da utilização semanal normal. Esse consumo sai do mesmo saldo e esgota-o mais depressa do que outros modelos. 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 próxima hora de 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 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 for responsável por 10 por cento ou mais da utilização recente fica marcado. Os culpados habituais 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 da cache — uma hora para a conversa principal numa subscrição dentro da utilização incluída no plano, cinco minutos para subagentes e depois de passar a utilizar créditos — faz com que a mensagem seguinte grave novamente tudo na cache à taxa de escrita da cache. Essa taxa é superior à taxa normal de entrada: 2 vezes a entrada base para uma escrita de cache de uma hora e 1.25 vezes para uma de cinco minutos. Usar /clear entre tarefas não relacionadas resolve ambos os problemas.

Quando é que uma API key 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 desses tokens. Uma subscrição paga por um mês de capacidade que pode nunca utilizar. A programação diária contínua tem o resultado inverso. Uma subscrição oferece um preço fixo por um limite de utilização elevado. 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. Depois de aprovar a API key no prompt, ou de executar claude -p com a chave presente, o Claude Code passa a faturar a API e deixa o limite da subscrição por utilizar.