Limite de ferramentas do Claude nesta interação
A mensagem indica que Claude esgotou as chamadas de ferramentas permitidas nesta interação, não a cota do plano. Saiba como continuar a tarefa.
O que significa o limite de uso de ferramentas nesta interação
Um limite de uso de ferramentas nesta interação significa que Claude interrompeu a resposta a meio porque esgotou o número de chamadas de ferramentas permitido, e não porque a sua conta esgotou a utilização disponível. Tudo o que encontrou antes da interrupção continua na conversa. Envie outra mensagem a pedir para continuar. Isso inicia uma nova interação com um novo limite.
No Agent SDK, uma interação corresponde a uma passagem pelo ciclo do agente. Claude produz uma resposta que contém chamadas de ferramentas, o cliente executa essas ferramentas e os resultados são enviados novamente para Claude para a decisão seguinte. O ciclo repete-se sem devolver o controlo ao utilizador. O ciclo termina quando Claude produz uma resposta sem chamadas de ferramentas. O limite de interações do SDK contabiliza cada passagem, incluindo a resposta final sem chamadas de ferramentas.
O limite de uso do seu plano é um controle separado
O limite do plano contabiliza o que você usou durante um período. A página do centro de ajuda da Anthropic sobre mensagens de erro, consultada em 9 de novembro de 2026, indica Approaching session limit quando você está perto desse limite e 5-hour limit reached - resets [time] quando o ultrapassa. O limite semanal apresenta mensagens semelhantes, que informam um dia e uma hora para a reposição. Em ambos os casos, a mensagem informa um horário. Sem créditos de uso, aguardar até esse horário resolve o problema, e nada do que você escrever nesse intervalo ajudará. Se os créditos de uso estiverem ativados em um plano pago, a página informa que o trabalho continua usando créditos, e a mensagem é 5-hour limit resets [time] - continuing with usage credits. Essa continuidade termina quando você atinge o limite mensal de gastos ou quando o saldo de créditos acaba com o recarregamento automático desativado. As contas Ultra verificadas não têm limite de sessão de cinco horas, mas os limites semanais continuam aplicáveis.
A mensagem sobre uso de ferramentas funciona de forma oposta. Ela aparece no meio de uma tarefa, e uma única mensagem de seguimento permite que o trabalho continue imediatamente. As chamadas de ferramentas já realizadas continuam contando para o uso do seu plano. Continuar não repõe a sua cota, e os créditos de uso também podem permitir que o trabalho continue depois que um limite do plano for atingido. No caso da cota, o que fazer quando o Claude informa que o limite foi atingido apresenta as opções, e como os limites de uso do Claude são contabilizados explica os períodos aplicados.
Por que uma interação tem um orçamento de ferramentas
Cada chamada de ferramenta consome contexto. A chamada é enviada, a ferramenta é executada e todo o resultado volta para a conversa. Ler um ficheiro grande ou executar um comando com uma saída extensa pode consumir milhares de tokens num único passo, e esse texto permanece no contexto durante o resto da sessão. A documentação do loop de agentes da Anthropic indica claramente a consequência: o contexto acumula-se entre interações, por isso uma sessão com muitas chamadas de ferramentas contém muito mais informação do que uma sessão curta.
Um orçamento para a interação impede um loop que já não está a progredir. Um agente que pesquisa, lê, pesquisa novamente e continua sem encontrar nada prosseguirá até ser interrompido. O orçamento faz essa interrupção. Devolve o controlo quando ainda pode redirecionar o trabalho, o que custa muito menos do que deixar o loop chegar ao fim da janela de contexto.
Onde esse limite é visível na API
A documentação pública de erros da Anthropic não informa um número de chamadas de ferramentas por turno para o aplicativo Claude. Portanto, qualquer valor exato que você leia é uma estimativa de outra pessoa. O mesmo tipo de limite é documentado para a API (application programming interface), e é nessa documentação que o comportamento real fica visível.
O campo stop_reason em uma resposta da Messages API informa por que a geração foi interrompida. Os valores documentados são end_turn, max_tokens, stop_sequence, tool_use, pause_turn, refusal e model_context_window_exceeded. Dois deles descrevem a situação deste guia.
pause_turn é retornado quando o loop de amostragem no lado do servidor atinge o limite de iterações ao executar ferramentas no servidor, como a pesquisa na web. Em 25 October 2026, a página de motivos de parada e fallback informa que o valor padrão é 10 iterações por solicitação. A correção documentada é enviar a resposta de volta sem alterações como a mensagem do assistant, para que o Claude continue de onde parou. Não adicione uma nova mensagem do usuário pedindo para continuar: o exemplo documentado envia apenas a mensagem original do usuário seguida do conteúdo pausado do assistant.
max_tokens significa que a resposta atingiu o limite de tokens de saída definido na solicitação. Se ela for truncada dentro de um bloco incompleto de uso de ferramenta, a chamada da ferramenta não poderá ser executada. Nesse caso, a orientação documentada é repetir a solicitação com um max_tokens maior.
Consulte os valores atuais na página de motivos de parada e fallback, em vez de confiar nos valores escritos aqui. Os valores padrão dessa página mudam, e um número desatualizado é pior do que nenhum número.
O que faz um chat ficar sem chamadas de ferramentas
- Uma pergunta sem um ponto natural de paragem. "Encontre tudo o que foi escrito sobre X" não fornece ao modelo nenhuma indicação de que a pesquisa terminou.
- Leituras repetidas do mesmo material, porque a resposta não está onde o modelo esperava encontrá-la.
- Resultados grandes das ferramentas. Uma página web longa ou um ficheiro grande ocupa o espaço de que o resto do turno precisava.
- Várias tarefas independentes numa única mensagem. Cada tarefa precisa das suas próprias chamadas de ferramentas, e todas consomem o mesmo orçamento.
- Connectors e servidores MCP (model context protocol) que não está a utilizar nesta tarefa. Depois de carregados, ocupam espaço na conversa e dão ao modelo mais formas de consumir o turno.
Como obter a resposta completa
Responda com "continue" ou, melhor ainda, com uma instrução curta que indique o que falta. Isso abre um novo turno com um novo orçamento. A conversa anterior continua no contexto, por isso Claude retoma o trabalho em vez de repetir as chamadas de ferramentas que já fez.
Se parar duas vezes no mesmo ponto, a tarefa é demasiado ampla para um único turno, por isso divida-a. Em vez de pedir uma auditoria completa de um repositório, peça primeiro a lista de ficheiros e depois pergunte por um ficheiro em cada mensagem. Quatro turnos pequenos concluem um trabalho que um turno grande não consegue concluir.
Limite aquilo que o modelo tem de procurar. Forneça o caminho exato do ficheiro ou a mensagem de erro exata, e cole o log quando já o tiver. Colar um log custa uma mensagem. Fazer o modelo procurar esse log custa várias chamadas de ferramentas, e pode encontrar o ficheiro errado.
Desative os connectors de que não precisa neste momento. O centro de ajuda da Anthropic diz que cada connector ocupa espaço numa conversa. Na definição Auto predefinida, Claude decide que connectors carregar, enquanto Always available carrega todos no início, e cada connector carregado consome contexto e aumenta o conjunto de ações que o modelo pode escolher. Se mantiver um conjunto grande de connectors, a definição On demand carrega-os apenas depois de Claude procurar o connector correto. O mesmo raciocínio aplica-se a uma sessão longa de programação, em que manter pequeno o contexto de uma sessão do Claude Code faz a diferença entre um agente que termina o trabalho e um que para a meio.
Defina o orçamento de turnos ao executar um agent
Se executar o Claude a partir do seu próprio código, o orçamento de turnos do loop é uma configuração sob o seu controlo. O Claude Agent SDK (kit de desenvolvimento de software) disponibiliza max_turns em Python e maxTurns em TypeScript. Esses parâmetros contam os turnos com chamadas de ferramentas e a resposta final apenas com texto. O limite predefinido documentado é ilimitado.
Quando esse limite é atingido, o SDK devolve um resultado cujo subtype é error_max_turns. Uma chamada query() isolada gera então um erro que contém o texto Reached maximum number of turns. A página do loop do agente do Agent SDK também documenta uma saída diferente de zero do processo Claude Code subjacente para esse erro de chamada isolada. O resultado ainda inclui num_turns e session_id. Assim, pode retomar a mesma sessão com um limite superior em vez de reiniciar a tarefa.
Na CLI (interface de linha de comandos), o mesmo controlo é uma flag e aplica-se apenas ao modo de impressão:
claude -p --max-turns 3 "summarise the failing tests"A referência das flags indica que, por predefinição, não existe limite. Com --input-format stream-json, uma mensagem que ainda esteja na fila quando o limite termina um turno permanece na fila e inicia um novo turno com o seu próprio limite. Existe uma versão da mesma ideia baseada no custo: max_budget_usd em Python e maxBudgetUsd em TypeScript interrompem o loop ao atingir um limite de despesa, em vez de uma quantidade de turnos. A despesa dos subagentes também conta para esse total. O orçamento é verificado depois da chegada das respostas do modelo. Por isso, a despesa pode ultrapassar o limite devido à resposta que o atinge e aos subagentes em segundo plano que terminem antes de serem interrompidos. Se executar agents num servidor cujo custo é cobrado mensalmente, vale a pena configurar o controlo do custo de um agente de IA num VPS antes da primeira execução longa.
Uma pausa à espera de aprovação é uma situação diferente. Se o seu agent parar e não houver despesa em curso, consulte permission_mode em vez da contagem de turnos, porque uma ferramenta está à espera de uma resposta humana que nunca chega. O modo automático e as definições de permissões do Claude Code explica quais os modos que pedem confirmação e quais executam sem a pedir.
Como verificar o comportamento atual
O comportamento muda sem anúncio. Por isso, considere cada número deste guia como datado, não como fixo. Há dois locais que mostram o que é válido atualmente.
- A documentação da API sobre motivos de paragem, que indica o valor predefinido de iteração da ferramenta do servidor e como continuar depois de o atingir.
- A página do centro de ajuda da Anthropic sobre mensagens de erro, que apresenta o texto do limite de utilização. Verificada em 9 November 2026, essa página documenta as mensagens de utilização de cinco horas e semanal, incluindo as versões apresentadas quando os créditos de utilização assumem o controlo, e não menciona qualquer limite de ferramentas por turno. É por isso que não é indicado aqui nenhum valor oficial para a aplicação de chat.
Em vez disso, meça as suas próprias execuções. No Claude Code, /context apresenta a utilização atual do contexto como uma grelha colorida e indica quais são as ferramentas que mais espaço consomem; /compact resume a conversa até ao momento para libertar espaço. No Agent SDK, todos os resultados incluem num_turns. Assim, pode ver quantos turnos uma tarefa típica realmente requer antes de definir um limite. Um número obtido na sua própria carga de trabalho vale mais do que um número publicado numa mensagem de fórum.
FAQ
O limite de uso de ferramentas é igual ao meu limite de uso do Claude?
Não. O limite de uso contabiliza o que foi utilizado durante um período e informa quando será reposto, por isso basta aguardar. A mensagem de uso de ferramentas interrompe uma resposta a meio porque essa resposta esgotou as chamadas de ferramentas disponíveis. O envio de outra mensagem inicia imediatamente um novo turno com um novo orçamento. O uso de ferramentas continua a contar para o uso incluído no seu plano. como são contabilizados os limites de uso do Claude explica integralmente o caso da quota.
Como faço o Claude concluir uma tarefa que foi interrompida a meio?
Envie mais uma mensagem. "Continue" funciona, mas uma instrução que indique o que ainda falta funciona melhor, porque evita que o modelo reconstrua o contexto que já tem. Se parar novamente no mesmo ponto, divida a tarefa em partes menores e envie uma parte por mensagem. Indicar os caminhos exatos dos ficheiros ou colar diretamente o conteúdo elimina a pesquisa que esgotou o orçamento inicialmente.
O que significa "límite de uso de herramientas" ou "limite de uso de ferramentas"?
Estas são as versões em espanhol e português da mesma mensagem, normalmente apresentadas como "límite de uso de herramientas en este turno" ou "limite de uso de ferramentas neste turno". O significado é idêntico em qualquer idioma: o Claude esgotou as chamadas de ferramentas permitidas numa única resposta, e a quota do seu plano não está envolvida. A solução também é a mesma. Responda a pedir que continue ou divida o pedido em passos menores. O limite de faturação aparece numa mensagem separada e indica uma hora de reposição.
A atualização do meu plano aumenta o limite de uso de ferramentas por turno?
O nível do plano e o orçamento de ferramentas por turno são controlos diferentes. A atualização aumenta o volume que pode utilizar durante um período, que é o limite que indica uma hora de reposição. O número de chamadas de ferramentas que uma única resposta pode fazer é uma propriedade do ciclo que executa o modelo, e a Anthropic não publica esse valor para a aplicação de conversação. Dividir a tarefa em turnos menores é o que realmente ajuda, em qualquer plano.
Por que motivo o meu próprio agente para depois de apenas algumas chamadas de ferramentas?
Verifique se definiu um limite. O Claude Agent SDK aceita max_turns em Python e maxTurns em TypeScript, e a interface de linha de comandos aceita --max-turns no modo de impressão. Quando um desses limites é atingido, o SDK devolve um resultado com um subtype de error_max_turns; uma chamada query() de execução única gera então um erro que contém o texto Reached maximum number of turns. Por predefinição, ambos não têm limite. Se não houver nenhum limite definido e a execução continuar a parar, leia stop_reason no resultado: max_tokens significa que o limite de saída foi atingido, e pause_turn significa que o ciclo de ferramentas do servidor atingiu o seu limite de iterações e pretende que a resposta seja enviada de volta para poder continuar.