Este artigo se aplica a consumidores individuais que usam assinaturas dos planos Pro, Max ou Ultra para acessar Claude Code. Se você é membro de uma organização com plano Team ou Enterprise, consulte Use Claude Code com seu plano Team ou Enterprise.
O que é Claude Code?
Claude Code é uma ferramenta de codificação que oferece acesso aos modelos Claude diretamente no seu terminal ou IDE compatível, permitindo que você delegue tarefas de codificação complexas mantendo transparência e controle. Com os planos Pro, Max e Ultra, você agora tem acesso tanto ao Claude na web, aplicativos desktop e mobile quanto ao Claude Code no seu terminal com uma única assinatura unificada.
Por que usar Claude e Claude Code?
Use dois produtos de IA poderosos em uma assinatura simples.
Use Claude para escrita, pesquisa, análise e muito mais—no trabalho e em casa.
Use Claude Code para seus fluxos de trabalho de codificação baseados em terminal.
Como conectar Claude Code ao seu plano Pro, Max ou Ultra
Certifique-se de ter uma assinatura ativa do plano Pro, Max ou Ultra
Se você ainda não está inscrito, faça upgrade em claude.ai/upgrade
Instale Claude Code
Visite a página Claude Code em nossa Claude Docs para baixar e instalar Claude Code.
Siga as instruções de instalação para seu sistema operacional.
Autentique-se com suas credenciais Claude
Quando solicitado durante a configuração ou primeiro uso, faça login com as mesmas credenciais que você usa para Claude.
Isso conectará sua assinatura do plano Pro, Max ou Ultra ao Claude Code.
Se você já está conectado ao Claude Code via Claude Console PAYG, execute /login dentro do Claude Code para alternar para seu plano de assinatura.
Tendo dificuldades para usar seu plano Pro, Max ou Ultra para acessar Claude Code?
Se você não está vendo a opção de autenticar com sua conta preferida, siga estas etapas para atualizar Claude Code:
Faça logout de sua sessão ativa completamente usando o comando /logout.
Execute claude update.
Reinicie seu terminal completamente para que a alteração tenha efeito.
Execute claude e selecione a conta correta para usar Claude Code.
Importante: Se você tiver uma variável de ambiente ANTHROPIC_API_KEY definida em seu sistema, Claude Code usará essa chave de API para autenticação em vez de sua assinatura Claude (planos Pro, Max, Ultra, Team ou Enterprise), resultando em cobranças de uso de API em vez de usar o uso incluído em sua assinatura. Consulte este artigo para mais informações: Gerenciando variáveis de ambiente de chave de API em Claude Code.
Use Claude Code em seu IDE
Seu plano Pro, Max ou Ultra também cobre Claude Code em IDEs compatíveis, incluindo VS Code, Cursor e outros forks do VS Code, e IDEs JetBrains como IntelliJ e PyCharm. Faça login com as mesmas credenciais Claude que você usa no terminal. O uso do IDE conta para os mesmos limites de uso compartilhados entre Claude e Claude Code.
Para instalar e configurar a extensão para seu IDE, consulte Plataformas e integrações em nossa Claude Code Docs.
O que acontece quando você atinge os limites de uso
Os planos Pro e Max têm um limite de sessão de cinco horas e um limite semanal. Os planos Ultra têm um limite semanal, e contas Ultra verificadas não têm um limite de sessão de cinco horas. Saiba mais.
Os planos Max e Ultra também têm um limite semanal separado para Fable. Esses limites são compartilhados entre Claude e Claude Code, o que significa que toda atividade em ambas as ferramentas conta para os mesmos limites. Para ajudá-lo a monitorar seu uso, você verá mensagens de aviso conforme se aproxima de qualquer limite.
Se você atingir seu limite de sessão de cinco horas enquanto Claude Code está no meio de uma resposta, ele pode continuar funcionando brevemente para poder concluir a etapa em andamento em vez de parar no meio da etapa. Enquanto isso acontece, você verá "Usage limit reached · wrapping up" em Claude Code. Essa permissão de encerramento é pequena e limitada, e o uso conta para seu limite semanal. Aplica-se apenas a uma resposta que já está em andamento, não a uma nova mensagem que você envia após atingir seu limite.
No plano Pro, aplica-se até uma vez por período de uso semanal. No plano Max, pode ser aplicado cada vez que você atinge um limite de sessão de cinco horas, dentro de seu limite semanal. Contas Ultra verificadas não têm um limite de cinco horas, portanto a permissão de encerramento não se aplica. Se sua conta Ultra tiver um limite temporário, a permissão de encerramento funciona da mesma forma que no plano Max até que o limite seja removido.
Está sendo implementado gradualmente, portanto pode não estar disponível em sua conta ainda. Saiba mais sobre a permissão de encerramento do Claude Code.
Quando você atinge seus limites de uso, você pode selecionar entre algumas opções com base em suas necessidades:
Usuários do plano Pro
Considere fazer upgrade para o plano Max se você consistentemente atinge limites e precisa de mais capacidade para repositórios maiores.
Ative créditos de uso para continuar usando Claude com seu plano Pro após atingir seu limite de sessão de cinco horas ou seu limite semanal.
Mude para uma conta Claude Console e compre créditos de uso de API para sprints de codificação intensivos.
Aguarde até que seus limites de uso sejam redefinidos.
Usuários do plano Max
Considere fazer upgrade para o plano Ultra se você consistentemente atinge limites.
Ative créditos de uso para continuar usando Claude com seu plano Max após atingir seu limite de sessão de cinco horas, seu limite semanal geral ou seu limite semanal separado para Fable.
Mude para uma conta Claude Console e compre créditos de uso de API para sprints de codificação intensivos.
Créditos de API mensais inclusos no plano Max não podem ser usados em Claude Code ou nos aplicativos Claude, incluindo para créditos de uso. Saiba mais sobre créditos de API mensais para planos Max, Ultra e Team.
Aguarde até que seus limites de uso sejam redefinidos.
Usuários do plano Ultra
Ative créditos de uso para continuar usando Claude com seu plano Ultra após atingir seu limite semanal geral ou seu limite semanal separado para Fable.
Mude para uma conta Claude Console e compre créditos de uso de API para sprints de codificação intensivos.
Créditos de API mensais inclusos no plano Ultra não podem ser usados em Claude Code ou nos aplicativos Claude, incluindo para créditos de uso. Saiba mais sobre créditos de API mensais para planos Max, Ultra e Team.
Aguarde até que seus limites de uso sejam redefinidos.
Para mais detalhes sobre uso eficiente, consulte nossas Melhores práticas de limite de uso.
Faturamento do Claude Code
Entendendo dois sistemas distintos
É importante reconhecer que estes são sistemas separados:
Claude Code: Apresenta opções para continuar o uso através de créditos de API.
Claude Console / Claude API: Contém configurações opcionais de recarga automática para gerenciamento de créditos de API onde seu terminal está localizado.
Escolhendo usar créditos de API
Se você deseja usar créditos de API através do Claude Code:
O uso será faturado em taxas de API padrão (distintas do preço do plano Pro/Max/Ultra).
Se a recarga automática estiver ativada em sua conta Console, créditos adicionais serão adicionados automaticamente quando seu saldo ficar baixo.
Mantendo-se dentro de seu plano
Para manter o uso estritamente dentro de sua alocação do plano Pro, Max ou Ultra:
Recuse a opção de crédito de API quando apresentada.
Permita que seu período de uso seja redefinido antes de continuar a usar Claude Code.
Monitore sua alocação restante usando o comando /status.
Recusando créditos de API para Claude Code
Se você preferir evitar que a opção de crédito de API apareça completamente:
Execute claude logout em seu terminal.
Execute claude login e autentique-se usando apenas suas credenciais do plano Pro, Max ou Ultra.
Evite adicionar qualquer credencial Claude Console durante o processo de login.
Isso garante que Claude Code usará apenas sua alocação de plano e você não será solicitado a usar créditos de API quando atingir seus limites.
Gerenciando configurações de recarga automática
A funcionalidade de recarga automática é gerenciada em sua conta Claude Console, não através do Claude Code:
Revise suas configurações de Faturamento do Console para verificar o status de recarga automática.
Ajuste essas configurações no Console se você preferir evitar compras automáticas de créditos.
Lembre-se, a recarga automática só se aplica quando você escolheu usar créditos de API.
Resumo
Claude Code mantém controle rigoroso do usuário sobre decisões de faturamento.
A recarga automática é um recurso independente do Claude Console.
Para manter seu orçamento do plano Pro, Max ou Ultra, simplesmente recuse as opções de crédito de API quando oferecidas.