Claude Code 2.1.317 amplía controles y notificaciones

En 2 de noviembre de 2026, a las 22:25 BRT, Anthropic publicó Claude Code v2.1.317. El lanzamiento actualiza agente, Agent SDK y gateway, sin nuevo modelo. Ver la lista oficial.

La lista incluye avisos de permiso, bloqueo por falla en hooks y nuevos datos operativos, además de correcciones para sesiones, MCP y ejecución.

En este artículo verás:

• Las nuevas confirmaciones antes de compartir datos y conectores
• El comportamiento de onFailure: "block" en los hooks del Agent SDK
• Los reportes y atributos nuevos para equipos
• Las correcciones que afectan sesiones, MCP y automatizaciones

Claude Code 2.1.317 pide confirmación antes de dos acciones sensibles

El lanzamiento añade un aviso a /schedule cuando una nueva tarea en la nube recibe conectores no solicitados. La interfaz explica cómo quitarlos, evitando que integraciones inesperadas pasen desapercibidas.

Esto no bloquea toda la configuración ni revisa permisos. El aviso trata solo de los conectores no solicitados durante la creación de una tarea programada en la nube.

Otra confirmación aparece antes de que una llamada de herramienta web o shell envíe la dirección de correo electrónico de la cuenta a la red. Esto hace explícito un dato que podría salir del entorno durante una acción iniciada por el agente.

El aviso aumenta la transparencia, pero no detecta todo dato sensible. El equipo aún debe revisar destino y contenido antes del envío.

Imagen: Anthropic, captura de la página oficial de Claude Code.

La versión 2.1.316 y sus controles de subagentes cubrió cambios anteriores; el v2.1.317 trae los avisos y correcciones descritos aquí.

Agent SDK puede bloquear la acción cuando un hook falla

El Agent SDK pasa a aceptar onFailure: "block" en callbacks de hook. Si el callback falla, la acción correspondiente se bloquea en lugar de continuar como si la validación se hubiera completado.

Un hook es un callback ejecutado en puntos definidos del flujo. Los equipos pueden insertar en él verificaciones propias antes o después de acciones del agente.

La opción crea un modo de falla cerrado: si una verificación necesaria falla, la acción no prosigue automáticamente. Esto ayuda a evitar que una política dependa de un callback no disponible.

El lanzamiento no afirma que todos los hooks pasen a bloquear por defecto. El cambio es la disponibilidad de la configuración onFailure: "block"; el equipo necesita definir dónde aplicarla y probar el comportamiento esperado.

Esto no es un mecanismo completo de seguridad. La opción cubre callbacks configurados en el SDK y no sustituye controles de acceso, validación o revisión humana.

Gateway de Claude gana datos para observar costos y sesiones

La API de Claude apps gateway gana GET /v1/organizations/analytics/cost, para consultar costos anteriores por período y agrupar resultados en el total, por desarrollador, día o grupo de identidad.

Para ello, los gateways con admin: registran diariamente los grupos de identidad de cada desarrollador. La retención sigue admin.identity_retention_days, que los administradores deben revisar.

El v2.1.317 incluye anthropic.plan, anthropic.seat_type, anthropic.provider y anthropic.custom_base_url en métricas, eventos y spans de OpenTelemetry. Estos atributos relacionan telemetría con las configuraciones de la cuenta y del proveedor.

OpenTelemetry estandariza señales como métricas y rastros distribuidos. La nota lista los atributos nuevos, pero no dice que todo entorno los exporte por defecto.

Hay además un ajuste para claude -p en un runner autoalojado. La variable CLAUDE_CODE_DISABLE_NESTED_SESSION_ID=1 hace que la ejecución dentro de una sesión use el identificador y la transcripción de esa sesión, como en versiones anteriores.

Para contexto sobre aislamiento de MCP en llamadas auxiliares, ver el artículo de TokenEconomizer. Esta novedad trata del gateway de Anthropic.

Claude Code 2.1.317 corrige fallas en MCP, autenticación y automatizaciones

La release corrige servidores MCP de proyecto y locales que podían desconectarse después del primer turno en algunas sesiones de Claude Desktop, afectando integraciones usadas durante la conversación.

claude auth status podía terminar antes de guardar una actualización lenta del token, haciendo que la próxima ejecución cierre la sesión. La versión corrige ese orden.

En /schedule, los resultados vuelven a mostrar la próxima hora y el enlace de la tarea. Otra corrección permite listar y quitar tareas almacenadas después de desactivar el recurso.

Una verificación de seguridad del modo automático deja de repetir fallas en gateways HTTP 403 o 422. El caso 403 con apiKeyHelper permanece sin cambios.

Si el disco está lleno o la cuota impide grabar la transcripción o la configuración, claude -p ahora muestra error y devuelve código 1, también en los formatos de texto y JSON.

La release lista correcciones para sesiones largas, compresión, telemetría por proxy, memoria e inicio sin interfaz. Consulta la lista completa para el resto de detalles.

Cómo evaluar Claude Code 2.1.317 sin interrumpir tu flujo

Identifica si tu entorno usa tareas programadas, conectores, hooks de Agent SDK, gateway administrativo o runners autoalojados. Los cambios no afectan a todos los equipos de la misma forma.

En una tarea no crítica, valida las advertencias de conectores y envío de correo. Confirma que la persona responsable entiende el motivo y sabe revisar o quitar la integración.

Si usas callbacks de Agent SDK, prueba un caso exitoso y otro con falla. Confirma que onFailure: "block" interrumpe la acción prevista, sin asumir que la opción ya está activa.

Los administradores deben revisar la configuración de la API de costos, los atributos de telemetría, quién accede a los reportes, qué grupos se registran y el período de retención.

Para actualizar, sigue la documentación oficial y los procedimientos del equipo. La release no presenta un nuevo comando de instalación, así que valida las instrucciones antes de reutilizar comandos antiguos.