Claude Code v2.1.317 añade API de analítica de costes, atributos de usuario OTel y hooks de bloqueo ante fallos

Claude Code v2.1.317 es una versión de mantenimiento con algunas novedades pensadas para equipos que ejecutan la aplicación a través de una puerta de enlace, la monitorizan mediante OpenTelemetry o desarrollan sobre el Agent SDK.

Informes de costes en la puerta de enlace

La API de administración de la puerta de enlace de Claude apps ahora expone GET /v1/organizations/analytics/cost. Devuelve el gasto pasado en un rango de fechas, desglosado en total, por desarrollador, por día o por grupo de IdP. Para admitir la agrupación por IdP, las puertas de enlace con admin: configurado ahora guardan un registro diario de los grupos de IdP de cada desarrollador, conservado durante admin.identity_retention_days.

Atributos de OpenTelemetry

Se añaden cuatro nuevos atributos a las métricas, eventos y spans de OTel:

• anthropic.plan
• anthropic.seat_type
• anthropic.provider
• anthropic.custom_base_url

Si ya recopilas la telemetría de Claude Code en un panel, estos atributos te permiten dividir las trazas por nivel de suscripción o por el proveedor/URL base a través del que se realizó la solicitud.

Comportamiento de los hooks del Agent SDK

Las funciones de devolución de llamada de los hooks ahora aceptan onFailure: "block". Antes, si una función de devolución de llamada fallaba, la acción continuaba; con esta opción, el fallo bloquea la acción.

Protecciones de privacidad y programación

Dos nuevos avisos reducen la exposición accidental de datos:

• Se muestra una comprobación antes de que una llamada a una herramienta web o de shell envíe tu dirección de correo electrónico de la cuenta por la red.
• /schedule advierte cuando una nueva tarea programada en la nube incorpora conectores que no solicitaste e indica cómo eliminarlos.

También es nuevo: avisos en la pestaña Code de Claude Desktop cuando la configuración administrada remota de tu organización aún no se ha cargado y cuando ya lo ha hecho. El modo automático ahora muestra un aviso cuando su comprobación no tiene respuesta para la llamada a una herramienta de un subagente, en lugar de dejar la vista principal vacía.

Válvula de escape para ejecutores autoalojados

Configura CLAUDE_CODE_DISABLE_NESTED_SESSION_ID=1 en un ejecutor autoalojado para que claude -p dentro de una sesión use el ID y la transcripción de esa sesión, restaurando el comportamiento anterior al cambio.

Correcciones destacadas

• Los servidores MCP de proyecto y locales se desconectaban tras el primer turno en algunas sesiones de escritorio.
• El modo automático fallaba en cada turno cuando una URL base de puerta de enlace LLM devolvía 403/422 a la comprobación de seguridad del lado del servidor (el 403 con apiKeyHelper no cambia).
• claude auth status finalizaba antes de que se guardara una actualización lenta del token, lo que podía cerrar tu sesión en la siguiente ejecución.
• claude --from-pr informaba de "No conversations found" para sesiones vinculadas antiguas en proyectos con muchas sesiones.
• claude -p salía con código 0 cuando un disco lleno o una cuota hacían perder su transcripción o las escrituras en ~/.claude.json; ahora imprime un error y sale con código 1 en la salida de texto y JSON. Es posible que no se detecten exportaciones NFS completas.
• Las ediciones en archivos de configuración realizadas en el primer segundo aproximadamente tras el inicio no surtían efecto hasta otro cambio de configuración.
• Las transcripciones antiguas no se limpiaban cuando las ejecuciones omitían la limpieza, p. ej., con --setting-sources.
• La puerta de enlace de Claude apps ocultaba el error "Input is too long." de Bedrock, lo que dejaba sesiones fallando en cada turno con "upstream rejected the request" en lugar de compactar.

Hay otra docena de correcciones para equipos de agentes, /team-onboarding, despertares de /loop, títulos de sesiones en la nube, habilidades sincronizadas desde claude.ai y verbosidad de lectores de pantalla; la lista completa está en las notas de la versión.