El modo de lector de pantalla devuelve Claude Code a la experiencia básica de terminal: texto plano y secuencial con etiquetas y señales añadidas, sin adornos visuales. Fue creado con y para usuarios de lectores de pantalla, y es útil para cualquiera que desee salida plana para pantallas braille, conexiones lentas o transcripciones.
Activar el modo de lector de pantalla
El modo de lector de pantalla requiere Claude Code versión 2.1.181 o posterior y se puede habilitar de varias formas:
Para una sesión: ejecuta
claude --ax-screen-readerPara cada sesión en una terminal: establece la variable de entorno
CLAUDE_AX_SCREEN_READER=1Permanentemente: añade
"axScreenReader": truea tu archivo de configuración de Claude Code (~/.claude/settings.json)
La primera línea de la sesión anuncia que el modo de lector de pantalla está activado. En Claude Code v2.1.206 y posterior anuncia: [Screen Reader Mode: on via flag] (o via env / via settings).
Qué esperar
Tus indicaciones y las respuestas de Claude están etiquetadas. Tus mensajes comienzan con
you:y las respuestas de Claude comienzan conclaude:. La actividad de herramientas comienza contool:y los avisos de permiso conPermission Required:. Las etiquetas también se pueden buscar, por lo que puedes usar la búsqueda de tu terminal para saltar entre partes de la conversación.Los menús se convierten en listas numeradas. En lugar de mover un resaltado con las teclas de flecha, escuchas cada opción como una línea numerada, luego escribes el número de la opción que deseas y presionas Intro. Para avisos de sí o no, escribe
yony presiona Intro.Se eliminan las decoraciones visuales. Los spinners, animaciones de progreso y redibujados en el lugar se convierten en texto plano que se lee en orden, y se eliminan caracteres decorativos como líneas de dibujo de cuadros.
Un timbre de terminal te avisa cuando Claude te necesita. Escucharás el sonido de alerta de tu terminal cuando Claude termine una respuesta, cuando aparezca un aviso de permiso y cuando termine una herramienta de larga duración. Si no lo escuchas, verifica la configuración del timbre en tu aplicación de terminal (algunos terminales mantienen el sonido de alerta desactivado de forma predeterminada). El canal de notificación propio de Claude Code se puede configurar con
/configen notificaciones.
Para explorar documentación completa sobre marcadores de línea, navegación de listas y restricciones existentes, visita la sección de Accesibilidad de la guía de Claude Code.
Reportar un problema
Si algo no funciona con tu lector de pantalla o terminal, abre un problema en el repositorio de GitHub de Claude Code y menciona tu lector de pantalla en el título. Por favor, incluye tu sistema operativo, aplicación de terminal, y nombre y versión de tu lector de pantalla.
Nota: Una configuración que es fácil confundir: CLAUDE_CODE_ACCESSIBILITY=1 es una configuración diferente e independiente (mantiene el cursor de terminal visible para ampliadores de pantalla y no activa el modo de lector de pantalla). Para un lector de pantalla, usa los métodos anteriores.