Claude Code v2.1.311 corrige los bloqueos de inicio, las ediciones de líneas largas y las interrupciones por desbordamiento de contexto

Claude Code v2.1.311 llega con dos nuevas opciones para el ejecutor autoalojado y una gran cantidad de correcciones de errores que abordan problemas reales para los desarrolladores: bloqueos al iniciar, desbordamiento de contexto y ediciones en archivos grandes.

Nuevas opciones para el ejecutor autoalojado

La versión añade --hold-idle-file y --max-hold-min a self-hosted-runner. Estas mantienen viva una sesión inactiva mientras tu host informa de procesos que dejó en ejecución; resulta útil cuando un proceso generado sobrevive al turno del agente.

El desbordamiento de contexto ahora se compacta en lugar de detenerse

Las sesiones con contexto estándar solían detenerse con Usage credits required for 1M context cuando una solicitud superaba los 200K tokens. En v2.1.311, Claude Code compacta la conversación y continúa. Se acabaron las sesiones muertas por una lectura o edición larga.

Bloqueos al iniciar y al editar archivos

• Bloqueos prolongados al iniciar y después de leer o editar archivos cuando un archivo CLAUDE.md contiene un elemento de lista muy largo.
• Write y Edit se bloquean hasta 5 segundos después de completarse e informan de 0 líneas cambiadas al editar miles de líneas.
• Las interrupciones no surten efecto hasta que se agota el tiempo de espera mientras un servidor MCP no había respondido a una lectura de recurso o una habilidad aún se estaba descargando.

Correcciones en subagentes y MCP

• Los subagentes ahora pueden usar herramientas MCP de servidores que terminan de conectarse después de que el subagente se inicie.
• Claude ya no ve contenido obsoleto de MEMORY.md y CLAUDE.md justo después de una compactación automática cuando esos archivos se editaron antes en la sesión.
• Los hooks SubagentStop ahora se activan una vez al finalizar en lugar de aproximadamente dos veces por minuto por cada subagente en ejecución.
• El árbol de trabajo aislado de un subagente ya no se elimina mientras un subagente en segundo plano que inició sigue trabajando en él.

Correcciones en sesiones y CLI

• Las sesiones de claude -p y del SDK ya no guardan los mensajes de transcripción fuera de orden ni conservan mensajes retractados.
• claude mcp add, claude mcp remove y /mcp ahora nombran la entrada del proyecto en ~/.claude.json en lugar de la carpeta actual cuando se ejecutan por debajo de la raíz de un repositorio.
• claude mcp list y claude mcp get ya no duplican códigos de error (ENOENT: ENOENT:).
• claude respawn <id> ya no inicia el servicio en segundo plano antes de informar que ninguna sesión coincide con el id.
• El error «background service did not respond» ahora sugiere claude daemon stop --any en lugar del deshabilitado claude daemon restart.

Correcciones en Cloud y Remote Control

• Las sesiones de Remote Control ya no se quedan colgadas en «Connecting» durante ~2 minutos cuando un proxy bloquea una solicitud de inicio.
• Los mensajes que Claude envía a una sesión de Cloud o Remote Control ya no aparecen como propios en las aplicaciones móviles.
• Ahora se informa a Claude de la causa cuando falla el guardado de un archivo adjunto (por ejemplo, disco lleno) o cuando se descartan los archivos adjuntos posteriores a los primeros 20.
• WebFetch y WebSearch en sesiones de Cowork Cloud ahora fallan después de 300 segundos ante una respuesta bloqueada en lugar de quedarse colgados.
• Las sesiones de Cowork Cloud ahora ignoran la configuración agent para que los conectores y las herramientas sobrevivan a los reinicios.

Detalles de interfaz y herramientas

• El selector de archivos @ ahora respeta las reglas de negación de .ignore/.rgignore que vuelven a incluir archivos ignorados por git.
• La descripción de la herramienta Bash ya no afirma que el directorio de trabajo siempre persiste entre llamadas.
• El bloque de entorno ya no nombra un shell en el que no se ejecutan los comandos (por ejemplo, fish cuando Bash usa zsh).
• Las sesiones de equipo de agentes vuelven a mostrar la lista de tareas con --resume, --continue, /resume o --session-id, incluso después de /clear o de un fallo.
• Pegar texto que menciona una ruta de imagen (por ejemplo, ! open /tmp/shot.png) ya no adjunta la imagen ni elimina la ruta del prompt.

Si usas Claude Code a diario, vale la pena actualizar a esta versión, especialmente si te has encontrado con la detención a los 200K tokens o el bloqueo de Write/Edit con archivos grandes.