Skip to main content
Claude Code tiene un modo lector de pantalla que reemplaza su interfaz de terminal visual con texto plano y lineal. En lugar de cuadros, animaciones de progreso y redibujados en el lugar, Claude Code imprime líneas etiquetadas que un lector de pantalla como VoiceOver o NVDA lee en orden. Puede mantener una conversación completa, aprobar permisos de herramientas y revisar la salida de principio a fin. El modo lector de pantalla es opcional. Si utiliza un ampliador de pantalla, movimiento reducido o un tema seguro para daltónicos en lugar de un lector de pantalla, configure CLAUDE_CODE_ACCESSIBILITY, prefersReducedMotion o theme desde la tabla Configuración de accesibilidad. El modo lector de pantalla adapta solo la interfaz de terminal, por lo que no lo necesita en el panel de chat de la extensión de VS Code. En Claude Code v2.1.236 o posterior, la extensión anuncia la actividad de la conversación a su lector de pantalla allí sin ninguna configuración.

​
Activar el modo lector de pantalla

Elija el método que se ajuste a la frecuencia con la que utiliza un lector de pantalla:
  • Para una sesión: ejecute claude --ax-screen-reader.
  • Para sesiones iniciadas desde un shell: establezca la variable de entorno CLAUDE_AX_SCREEN_READER en 1. En Bash o Zsh, ejecute export CLAUDE_AX_SCREEN_READER=1. En PowerShell, ejecute $env:CLAUDE_AX_SCREEN_READER = "1". Agregue esa línea a su perfil de shell para mantenerla en shells futuros.
  • Para cada sesión en la máquina: agregue "axScreenReader": true a su archivo de configuración de usuario. La configuración se aplica en cualquier terminal, incluida la terminal integrada de VS Code.
Si combina métodos, Claude Code aplica la bandera --ax-screen-reader sobre la variable de entorno CLAUDE_AX_SCREEN_READER, y la variable sobre la configuración axScreenReader. Si utiliza Claude Code a través de SSH, establezca la variable de entorno o la configuración en la máquina remota donde se ejecuta Claude Code. La primera línea que imprime Claude Code confirma el modo: [Screen Reader Mode: on via flag], [Screen Reader Mode: on via env], o [Screen Reader Mode: on via settings].

​
Desactivar el modo lector de pantalla

Invierta el método que activó el modo: comience sin la bandera, desestablezca la variable de entorno o establezca axScreenReader en false. Si establece CLAUDE_AX_SCREEN_READER en 0, Claude Code mantiene el modo desactivado incluso cuando la configuración es true.

​
Configuración de accesibilidad

La tabla enumera cada opción de accesibilidad, si la establece como una bandera, una variable de entorno o una configuración, y qué cambia.

​
Lo que escucha tu lector de pantalla

En modo lector de pantalla, Claude Code escribe texto plano:
  • Sin caracteres de dibujo de cuadros para la interfaz
  • Sin señales que dependan solo del color
  • Sin redibujos de contenido que no ha cambiado. Los indicadores de progreso se renderizan como texto estático
  • Las tablas en las respuestas de Claude se leen como oraciones Encabezado: valor en lugar de una cuadrícula con caracteres de cuadro
  • Los diffs se leen como texto plano, línea por línea, con + y - marcando las líneas agregadas y eliminadas, para que puedas escuchar el cambio propuesto en una solicitud de aprobación de edición de archivo antes de responderla
Claude Code deja todo lo que imprime en el historial de desplazamiento de tu terminal, para que puedas releer turnos anteriores con los comandos de revisión de tu lector de pantalla o la búsqueda de tu terminal. Claude Code ignora el ajuste tui en modo lector de pantalla. Aparte de las sesiones en segundo plano adjuntas enumeradas en Limitaciones conocidas, imprime texto de desplazamiento en lugar de renderizado a pantalla completa. Después de que Claude Code imprime la línea de confirmación al iniciar, espera 3 segundos antes de dibujar el prompt, para que tu lector de pantalla pueda terminar la línea. Presiona cualquier tecla para finalizar la espera. Para cambiar la duración de la espera, establece CLAUDE_AX_STARTUP_QUIET_MS. Cada mensaje en la transcripción comienza con una etiqueta que tu lector de pantalla anuncia, nombrando qué es: tus mensajes, las respuestas y el pensamiento de Claude, la actividad de herramientas, errores y advertencias, y prompts. Las etiquetas también se pueden buscar, para que puedas saltar entre secciones de la transcripción buscando en el historial de desplazamiento de tu terminal: Claude Code mantiene el cursor de la terminal en el símbolo de intercalación de entrada, para que el comando de lectura de línea actual de tu lector de pantalla lea el prompt que estás editando. Mientras escribes al final de la línea de entrada, o presionas Backspace allí, Claude Code escribe solo los caracteres que cambian. Tu lector de pantalla repite solo esos caracteres. Cuando eliminas una palabra o una línea con uno de los atajos de edición de texto, Claude Code anuncia el texto eliminado:
  • Eliminar palabras con Ctrl+W o Alt+D, o con Option+Delete en macOS o Ctrl+Backspace en Windows
  • Eliminar hasta el inicio de la línea con Ctrl+U o Cmd+Backspace
  • Eliminar hasta el final de la línea con Ctrl+K
Cuando alternas modos de permisos con Shift+Tab, Claude Code anuncia el modo de permisos en el que aterrizas, como [plan mode on] o [accept edits on]. Claude Code imprime el anuncio una vez y no lo repite en redibujos posteriores.

​
Leer la salida anterior sin perder tu lugar

Si tu lector de pantalla salta de vuelta al prompt mientras lees la salida anterior, está siguiendo el cursor de la terminal. Claude Code mueve el cursor de la terminal de vuelta al prompt cada vez que escribe texto nuevo. Para mantener tu lugar mientras lees, evita que tu lector de pantalla siga el cursor de la terminal. En NVDA, presiona NVDA+6 para que el cursor de revisión deje de seguir el cursor de la terminal. Presiona NVDA+6 de nuevo para volver a activar el seguimiento.

​
Saltar entre turnos

Claude Code emite marcadores de integración de shell OSC 133 en los límites de turno, para que la tecla de salto al prompt anterior de tu terminal se mueva entre turnos sin leer toda la transcripción:
  • iTerm2: Cmd+Shift+Up
  • Terminal de VS Code: Ctrl+Up en Windows, Cmd+Up en macOS
  • Windows Terminal: sin tecla por defecto; vincula la acción scrollToMark en su configuración
  • Kitty y Ghostty: consulta la documentación de la terminal para su tecla de salto al prompt
macOS Terminal no actúa sobre los marcadores, y Claude Code no los emite en WezTerm. En esas terminales, busca en el historial de desplazamiento la etiqueta you: en su lugar.

​
Responder a menús y solicitudes

En modo lector de pantalla, los menús que normalmente navegaría con las teclas de flecha, incluidas las solicitudes de permiso, se convierten en listas numeradas. Claude Code anuncia cada opción como una línea numerada, seguida de una solicitud Select with numbers que nombra el rango válido. Escriba el número de la opción que desea y presione Enter.
  • Presione Escape para cancelar un menú cuya solicitud termina con or Escape to cancel.
  • Si escribe un número que no está en la lista, Claude Code anuncia el rango válido y le permite intentar de nuevo.
El selector /effort, que es un control deslizante fuera del modo lector de pantalla, se convierte en el mismo tipo de lista numerada. Las solicitudes de sí o no piden una respuesta escrita en lugar de un menú de dos opciones. Responda y o n y presione Enter. yes y no también funcionan.

​
Escucha cuando Claude Code te necesita

En modo lector de pantalla, Claude Code suena la campana de la terminal cuando necesita tu atención, para que no tengas que estar verificando constantemente la transcripción. La campana suena cuando:
  • Claude termina una respuesta
  • Un aviso o diálogo necesita tu respuesta, como un aviso de permiso
  • Una herramienta que se ejecutó más de 5 segundos termina
La campana es la alerta estándar de tu terminal. Para silenciarla, cambia la configuración de campana en tu aplicación de terminal. Fuera del modo lector de pantalla, establece preferredNotifChannel en "terminal_bell" para obtener una campana similar cuando Claude esté esperando tu respuesta.

​
Limitaciones conocidas

Algunos comportamientos no se adaptan al modo lector de pantalla:
  • El modo lector de pantalla no se activa automáticamente cuando se ejecuta un lector de pantalla.
  • Claude Code no anuncia un cambio de modo de permisos que realices con un comando, como entrar en modo plan con /plan.
  • Adjuntarse a una sesión de fondo con claude attach o desde la vista de agente entra en la pantalla alternativa de la terminal, que no tiene scrollback nativo. Este es el mismo comportamiento que otras sesiones adjuntas. Para salir, presione la flecha izquierda en una solicitud vacía, o Ctrl+Z si un diálogo tiene el foco.
  • Claude Code anuncia costos en el resumen que imprime al salir, no por turno.
  • El modo lector de pantalla no cambia el modo no interactivo con la bandera -p. El modo no interactivo ya escribe texto plano y sigue siendo una alternativa para scripting.

​
Reportar un problema

Si algo no funciona con su lector de pantalla, ampliador o terminal, abra un problema en el rastreador de problemas de Claude Code y mencione su tecnología de asistencia en el título. Incluya su sistema operativo, aplicación de terminal y nombre y versión de la tecnología de asistencia en el informe.