Elena Artemova · Елена Артемова · Publicado · Atualizado · Objetivo da ferramenta · Com exemplo de aplicação.
Porque é que um bloqueio é mais perigoso do que um erro
Um agente que espera indefinidamente por uma resposta parece estar a trabalhar. A tarefa não terminou nem foi rejeitada, o lugar na fila continua ocupado e o operador não sabe se deve intervir. Um erro, pelo contrário, devolve o sistema a um estado compreensível: a causa é conhecida e é possível tomar uma decisão.
A publicação limita a espera por um endereço externo a um valor por omissão de 300 segundos, e a variável CLAUDE_CODE_WEBFETCH_DEADLINE_MS permite definir um limite próprio ou desativá-lo. O essencial não é o número. Uma conclusão explícita por tempo transforma a incerteza num acontecimento observável, com o qual se pode trabalhar.
O que mudou na versão 2.1.268
Além do limite de espera, a versão acrescenta um aviso sobre uma lista vazia de redes permitidas no gateway (access_control.allow_cidrs) e um aviso único no primeiro acesso a partir de um endereço público. Surge a definição gatewayInternalNetworks: o administrador pode autorizar a entrada através do gateway para o bloco próprio de endereços públicos da organização.
É descrito em separado um modo de executor autónomo, com remoção do estado das sessões após a conclusão. Quanto ao isolamento, ficou esclarecido que as regras de proibição se aplicam também a diretórios acessíveis por ligação simbólica. Nas sessões principais, os dados de consumo e de volume passam a ser guardados na saída, em vez de recomeçarem do zero quando a sessão é retomada.
Porque é que vale a pena preservar o consumo ao retomar
Um limite de consumo só faz sentido quando o contador sobrevive a uma interrupção. Se, depois de um reinício ou de uma sessão retomada, o total volta a zero, o limite enfraquece sem que se dê por isso: vinte execuções curtas parecem mais baratas do que uma longa, embora o trabalho realizado seja o mesmo.
Guardar os totais na saída devolve o sentido original ao registo. Passa a ser possível associar o consumo a uma execução concreta, notar desvios e explicar a sua causa. Isto não é relatar por relatar: sem esses dados não se pode discutir o orçamento, as razões do aumento de custo nem os limites de carga admissível.
Onde são precisos limites, e não esperança
Uma regra de proibição que se contorna escrevendo o mesmo caminho de outra forma não é um limite. Por isso, o esclarecimento sobre ligações simbólicas é importante: se um diretório está acessível tanto pelo caminho real como pela ligação, a verificação tem de atuar nos dois casos.
A mesma questão surge com comandos compostos da shell: se a exceção atua sobre uma parte do comando mas a expressão inteira é executada, a fronteira deixa de significar alguma coisa.
O limite de espera e as regras de isolamento são úteis onde o agente trabalha sem vigilância permanente. Para um acesso pontual, acompanhado por uma pessoa, basta um tratamento de erro simples. A decisão sobre meios de controlo deve basear-se nas consequências de uma operação inacabada, e não na facilidade de configuração.
Exemplo Ilustrativo
Um acesso a uma fonte externa não termina
- Problema
- Num processo hipotético, o agente lê um documento externo. O servidor aceita a ligação, mas não envia resposta nem a fecha.
- O papel da ferramenta
- Na aplicação está definido um limite de espera. Quando este expira, o acesso é interrompido e o registo recebe o endereço, o tempo de espera e a marca de erro. O total de consumo da sessão é guardado na saída.
- Resultado esperado
- O resultado esperado é que a tarefa termine com um erro compreensível, em vez de permanecer indefinidamente à espera; o consumo associa o trabalho a uma execução concreta.
- O que verificar
- Se, depois de retomada a sessão, o contador começar do zero, o limite de consumo deixa de limitar. O exemplo é ilustrativo; não foram feitas medições.
O Claude Code é útil onde a espera deve terminar em erro e o consumo deve ser atribuído a uma execução concreta.
Fonte e razões
Data de lançamento:
A fonte primária descreve o instrumento e seu desenvolvimento. Conclusões sobre a escolha – análise editorial do laboratório. Um exemplo explica a finalidade da ferramenta; nenhuma medição foi realizada nele. Data de origem verificada em 8 de setembro de 2026.
Perguntas sobre o tema
O Claude Code substitui a verificação de direitos de acesso?
Não. Define o comportamento do ambiente de execução. A composição dos dados, os direitos e as regras de acesso determinam-se independentemente da ferramenta.
Para que serve avisar sobre uma lista de redes vazia?
Uma lista vazia significa que o gateway está acessível de forma mais ampla do que o administrador supunha. O aviso torna isso visível antes de um incidente.
Todos os acessos precisam de um limite de espera?
É útil onde o sistema externo pode não responder. Em chamadas internas rápidas, o limite continua a ser uma salvaguarda.