Skip to content
BENIBIX Learn

--ax-screen-reader Flag

Also known as claude --ax-screen-reader, CLAUDE_AX_SCREEN_READER, axScreenReader

It prints plain text that screen readers can read well.

Think of it like

It is like a book with no pictures in the way. It is easy to read out loud.

Example

Jack uses a screen reader. With --ax-screen-reader, his reader speaks Claude's replies and not the lines of box borders around them.

Why it matters

People who listen to their screen can use Claude Code without wading through noise.

Definition

--ax-screen-reader makes Claude Code print plain text for screen readers. There are no boxes, borders or moving parts. It uses the old classic screen, so the tui setting does nothing. It also wins over CLAUDE_AX_SCREEN_READER and the axScreenReader setting.

Example code

bash
claude --ax-screen-reader
Start with flat text, no borders or motion.

Common mistake

Expecting attached background sessions to change too. They still show the full screen view.

Key takeaways

  1. 1
    Flat text. No borders.
  2. 2
    No motion. No spinners.
  3. 3
    Classic screen. Overrides tui.

Learn it properly