Elena Artemova · Елена Артемова · Publicado · Actualizado · Propósito de la herramienta · Con ejemplo de aplicación.
Por qué un bloqueo es más peligroso que un error
Un agente que espera una respuesta sin fin parece estar trabajando. La tarea no se completó ni se rechazó, el lugar en la cola sigue ocupado y el operador no sabe si debe intervenir. Un error, en cambio, devuelve el sistema a un estado comprensible: la causa se conoce y la decisión puede tomarse.
La publicación limita la espera de una llamada a una dirección externa a un valor predeterminado de 300 segundos, y la variable CLAUDE_CODE_WEBFETCH_DEADLINE_MS permite fijar un límite propio o desactivarlo. El sentido no está en el número. Una finalización explícita por tiempo convierte la incertidumbre en un evento observable sobre el que se puede actuar.
Qué cambió en la versión 2.1.268
Además del límite de espera, la versión añade un aviso sobre una lista vacía de redes permitidas en la pasarela (access_control.allow_cidrs) y un aviso único en el primer acceso desde una dirección pública. Aparece el ajuste gatewayInternalNetworks: el administrador puede permitir la entrada a través de la pasarela para el bloque propio de direcciones públicas de la organización.
También se describe un modo de ejecutor autónomo con eliminación del estado de las sesiones al finalizar. En materia de aislamiento se precisa que las reglas de prohibición se aplican igualmente a los directorios accesibles por enlace simbólico. En las sesiones principales, los datos de consumo y de volumen ahora se conservan al salir, en lugar de empezar de cero tras la reanudación.
Por qué conservar el consumo al reanudar
Un límite de consumo solo tiene sentido cuando el contador sobrevive a una interrupción. Si tras un reinicio o una reanudación de la sesión el total vuelve a cero, la restricción se debilita sin que nadie lo note: veinte ejecuciones cortas parecen más baratas que una larga, aunque el trabajo realizado sea el mismo.
Conservar los totales al salir devuelve su sentido original a la contabilidad. Se vuelve posible relacionar el consumo con una ejecución concreta, detectar desviaciones y explicar su causa. No es contabilidad por la contabilidad: sin ella no se puede discutir ni el presupuesto, ni las causas del aumento de costo, ni los límites de carga admisibles.
Dónde hacen falta límites y no esperanza
Una regla de prohibición que se esquiva escribiendo la misma ruta de otra forma no es una restricción. Por eso es importante la precisión sobre los enlaces simbólicos: si un directorio es accesible tanto por su ruta real como por un enlace, la comprobación debe activarse en ambos casos.
La misma pregunta surge con las órdenes compuestas del intérprete: si la excepción se activa sobre una parte de la orden pero se ejecuta la expresión completa, la frontera deja de significar algo.
El límite de espera y las reglas de aislamiento son útiles allí donde el agente trabaja sin supervisión constante. Para una llamada puntual que alguien observa, basta un tratamiento de error sencillo. La decisión sobre los medios de control conviene tomarla por las consecuencias de una operación sin terminar, y no por la comodidad de configurarla.
Ejemplo ilustrativo
Una llamada a una fuente externa no termina
- problema
- En un proceso de ejemplo, el agente lee un documento externo. El servidor acepta la conexión, pero no envía respuesta ni la cierra.
- El papel de la herramienta.
- En la aplicación se ha fijado un límite de espera. Al agotarse, la llamada se interrumpe y en el registro quedan la dirección, el tiempo de espera y la marca de error. El total de consumo de la sesión se conserva al salir.
- Resultado esperado
- El resultado esperado es que la tarea termine con un error comprensible en lugar de quedar en espera indefinidamente; el consumo atribuye el trabajo a una ejecución concreta.
- Que comprobar
- Si tras la reanudación el contador empieza de cero, el límite de consumo deja de restringir. El ejemplo es ilustrativo; no se realizaron mediciones.
Claude Code es útil allí donde la espera debe terminar en error y el consumo debe corresponder a una ejecución concreta.
Fuente y razones
fecha de lanzamiento:
La fuente principal describe el instrumento y su desarrollo. Conclusiones sobre la elección - análisis editorial del laboratorio. Un ejemplo explica el propósito de la herramienta; no se realizaron mediciones sobre él. Fecha de la fuente verificada el 8 de septiembre de 2026.
Preguntas sobre el tema
¿Claude Code sustituye la verificación de permisos de acceso?
No. Define el comportamiento del entorno de ejecución. La composición de los datos, los permisos y las reglas de acceso se determinan al margen de la herramienta.
¿Por qué avisar sobre una lista de redes vacía?
Una lista vacía significa que la pasarela es accesible en un rango más amplio de lo que suponía el administrador. El aviso lo hace visible antes de un incidente.
¿Hace falta un límite de espera en cada llamada?
Es útil donde el sistema externo puede no responder. Para llamadas internas rápidas, el límite sigue siendo una red de seguridad.