Claude Code v2.1.307: control de versiones de /claude-api, telemetría de eventos de seguridad y correcciones de fiabilidad de MCP

Claude Code v2.1.307 incluye dos novedades orientadas a desarrolladores —fijación de versión de API para el código de la API de Claude y telemetría de seguridad por llamada de herramienta— junto con una larga lista de correcciones en MCP, el runner y el estado de sesión.

Nuevo: fijación de versión de API y telemetría de eventos de seguridad

• /claude-api api-version pasa el código de la API de Claude a la versión de API 2026-10-21. Útil cuando necesitas que las llamadas generadas apunten a una versión fechada específica en lugar de la que el modelo use por defecto.
• Un nuevo evento de OpenTelemetry, claude_code.safety_event, se dispara por cada llamada de herramienta que una regla de permisos, el modo automático, una verificación de seguridad, un hook o el sandbox haya detenido, solicitado confirmación o devuelto. Esto te da un registro estructurado de cada intervención en tus bucles de agente en lugar de inferirlo a partir de las transcripciones.

Correcciones destacadas

• Alias de contexto de 1M: las solicitudes ya no fallan con modelo no encontrado cuando CLAUDE_CODE_DISABLE_1M_CONTEXT está activo y el modelo es un alias con el sufijo [1m], p. ej. opus[1m].
• Caché de prompts: la cabecera beta prompt-caching-scope ya no se envía detrás de pasarelas ANTHROPIC_BASE_URL personalizadas ni en Foundry, donde no tenía efecto.
• Autenticación MCP en macOS: claude -p ya no informa "necesita autenticación" cuando el llavero de inicio de sesión está bloqueado —indica el motivo, y la siguiente ejecución tras desbloquearlo se conecta sin un nuevo inicio de sesión.
• MCP sleep/timeout: los servidores que estaban conectándose mientras una máquina macOS o Linux entraba en suspensión ya no se reportan como agotados por tiempo de espera y atascados en estado fallido en ejecuciones sin interfaz.
• Llamadas dobles de HTTP MCP: las llamadas de herramienta ya no se envían dos veces cuando la conexión se cierra a mitad de la llamada; solo se reintentan las herramientas de solo lectura o idempotentes.
• Herramientas SDK MCP: un turno ya no comienza sin las herramientas más recientes de un servidor SDK MCP cuando había una tarea en segundo plano en ejecución.
• Autocompact: se reducen los errores "Autocompact is thrashing" en turnos que leen muchas páginas PDF, imágenes o resultados de herramientas grandes; /autocompact en sesiones en la nube también conserva su ventana entre reinicios.
• Persistencia de /clear: una conversación borrada con /clear ya no reaparece después de que se reinicie una sesión de runner en la nube o autoalojado.
• setModel() del SDK de agente: los cambios de modelo ya no se rechazan cuando la API tarda más de 5 segundos en confirmar —ahora Claude Code espera hasta 15 segundos.
• Interfaz de permisos: /permissions > Recently denied ahora muestra el comando de shell denegado, y aprobar una fila nombra el comando en lugar de su descripción; el clasificador local del modo automático ahora respeta esa aprobación en un comando reintentado.
• Herramientas de escritura de GitHub MCP: se corrigió un formulario que se cerraba sin crear nada en la pestaña Code de la aplicación de escritorio cuando el servidor está configurado directamente.

Otras mejoras

• Las llamadas de herramienta no analizables se reintentan hasta dos veces antes de que el turno termine con un error.
• Los subagentes fork lanzados juntos reciben cada uno información sobre cuál es su propio lanzamiento, lo que reduce el trabajo cruzado.
• El inicio de sesión en el navegador muestra la página de éxito en cuanto se completa el inicio de sesión, sin esperar al perfil de la cuenta.
• Los errores 403 de búsqueda web en sesiones de runner en la nube y autoalojado ahora muestran el motivo del servidor en lugar de un genérico "Authentication error".
• Se mejoró el tiempo de conexión de Remote Control para sesiones con imágenes grandes pegadas o lecturas de PDF.
• El aviso de presupuesto agotado de WebSearch ahora también indica a Claude que no consulte motores de búsqueda mediante un navegador o uso de computadora.

Los usuarios de runner autoalojado obtienen dos correcciones específicas: las sesiones con --use-anthropic-git-proxy ya no confirman un .claude/settings.local.json que dejó en el clon una sesión anterior, y archivar o reencolar una sesión durante su hook de checkout ya no deja procesos de hook en ejecución ni retiene la ranura del runner.