Claude Code v2.1.248: Modo restringido y TTL de caché

Claude Code v2.1.248 se lanzó con un nuevo modo de ejecución restringido, configuración de TTL de caché por agente y un lote de correcciones de estabilidad para el almacenamiento en caché de prompts y la gestión de sesiones.

Modo restringido

Ahora puede ejecutar Claude Code con --restricted (o configurar CLAUDE_CODE_RESTRICTED=1). Esto elimina todas las herramientas integradas que ejecutan comandos o código, además de WebFetch a menos que se nombre explícitamente en --tools. Las operaciones de archivos permanecen dentro del directorio de trabajo, se rechaza bypassPermissions y se ignoran los archivos de configuración de usuario/proyecto/local. Esto es útil para revisiones de código no confiables o entornos de CI.

TTL de caché por agente

Ahora puede establecer un TTL de caché de prompt en el frontmatter del agente mediante experimental.cacheTtl: "5m" o "1h". Esto se aplica cuando no hay un TTL de subagente configurado, lo que le da un control más preciso sobre la expiración de la caché para agentes específicos.

Diagnóstico de ejecutor autoalojado y configuración

El comando claude self-hosted-runner gana una bandera --client-label (o SELF_HOSTED_RUNNER_CLIENT_LABEL) para anular la etiqueta predeterminada (nombre de host). El inicio ahora advierte si la configuración administrada por el servidor no se carga, y /doctor y /status explican el motivo del fallo. Además, /usage-credits permite a los miembros de Enterprise solicitar límites más altos a los administradores (AWS Marketplace, autoservicio, pruebas).

Mensajería entre sesiones

Se agregaron SendMessage y ListAgents para mensajería entre sesiones en la misma máquina, ahora compatibles con Bedrock, Vertex, Foundry y cuando la telemetría está deshabilitada.

Correcciones clave

Fallos de caché de prompt en sesiones largas (aproximadamente cada hora) causados por el re-renderizado de herramientas después de la actualización de OAuth — corregido.
Definición de la herramienta ScheduleWakeup que cambiaba en exceso, causando fallos de caché en --resume — corregido.
Sesiones de Desktop/Cowork que desaparecían después de 30 días — corregido; el nuevo ajuste desktopSessionCleanupPeriodDays limita la exención.
Bucle de inicio de sesión cuando otro proceso mantenía el bloqueo de actualización de token — ahora devuelve un error reintentable.
Windows: la lista de agentes ahora responde al teclado después de desacoplarse o en modo de entrada win32.
/login con ANTHROPIC_API_KEY establecido recurre a inicio de sesión con clave API en lugar de fallar con OAuth.
Los nombres de modelo en /model se muestran como código (por ejemplo, [1m] literal).
Los agentes omiten la solicitud de confianza del espacio de trabajo cuando CI está configurado — corregido para mostrarla.
La vista de agente ya no resucita sesiones de fondo obsoletas; las sesiones detenidas se muestran como detenidas.
Procesos duplicados en sesiones reanudadas — prevenido.
Eliminación de sesiones con ramas fusionadas pero no enviadas — permitido.
Las respuestas de hook inválidas ahora muestran el nombre del hook y el error de esquema.
El JSON inválido de los hooks se reporta como error, no se trata silenciosamente como texto.
/mcp lista las entradas de conectores bajo el alcance real, y los servidores MCP con headersHelper re-ejecutan el helper en 401 en lugar de recurrir a OAuth.