Skip to content
← Back to release · 2.1.307
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, set CLAUDE_AX_SCREEN_READER to 1 in your shell, or add "axScreenReader": true to 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": false to your user settings file, or remove the axScreenReader key and the CLAUDE_AX_SCREEN_READER variable from the project's settings files.

Documentation snapshot · 2026-11-20

Change details