Improvements / v2.1.307
Restrict axScreenReader to trusted settings sources
CHANGELOG · original
Changed the axScreenReader setting and CLAUDE_CODE_AX_SCREEN_READER in a settings env block to apply only from user, managed or --settings settings (since 2.1.305) Open official changelog ↗ Documentation
Documentation excerpt
Project settings can't turn on screen reader mode
The startup line Screen reader mode is off: project settings can't turn it on means the project asked for screen reader mode and nothing else turns it on. Claude Code ignores both the axScreenReader key and a CLAUDE_AX_SCREEN_READER value under env in the project's .claude/settings.json and .claude/settings.local.json, whatever their value.
- To turn the mode on: start Claude Code with
--ax-screen-reader, setCLAUDE_AX_SCREEN_READERto1in your shell, or add"axScreenReader": trueto your user settings file and restart Claude Code. You don't need to change the project's files. Once you turn the mode on, the confirmation line appears at startup instead. - If you don't use a screen reader: you don't need to do anything. To stop the line from appearing, add
"axScreenReader": falseto your user settings file, or remove theaxScreenReaderkey and theCLAUDE_AX_SCREEN_READERvariable from the project's settings files.
Documentation snapshot · 2026-11-20