[DOCS] `axScreenReader` description lists only "decorative borders and animations"; v2.1.200 added glyph hiding, transcript labels, and nested-table-as-`Header: value.` rendering

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/settings

Section/Topic

The axScreenReader row in settings.md, the matching CLAUDE_AX_SCREEN_READER row in env-vars.md, and the --ax-screen-reader row in cli-reference.md.

Current Documentation

All three rows describe the screen-reader mode the same way:

Render screen-reader friendly output: flat text without decorative borders or animations. Screen-reader mode always uses the classic renderer, so the tui setting has no effect while it is active. The CLAUDE_AX_SCREEN_READER environment variable and the --ax-screen-reader flag take precedence. Requires Claude Code v2.1.181 or later

The fullscreen page describes screen-reader mode as opting for the classic renderer and stripping decorations, but does not enumerate the v2.1.200 changes.

What's Wrong or Missing?

A. v2.1.200 added three concrete changes that are not described anywhere

The v2.1.200 changelog says:

Improved screen-reader output: decorative glyphs are now hidden, transcript symbols read as short labels, and nested tables read as Header: value. lines

After v2.1.200 the screen-reader mode does three new things beyond the v2.1.181 "flat text, no borders or animations" behavior:

1. Hides decorative glyphs that were still emitted in the v2.1.181 flat-text rendering.
2. Replaces transcript symbols (such as the ► markers in the chat) with short labels that read as text.
3. Reads nested tables as Header: value. lines instead of leaving the screen reader to navigate cells.

None of the three rows above mention any of these three changes. A screen-reader user on v2.1.181 will read the docs, see only the original description, and not know that v2.1.200 changed anything about how tables and symbols are read aloud.

B. The "Requires Claude Code v2.1.181 or later" marker is misleading

The three rows still carry a min-version: 2.1.181 marker attached to the entire behavior description. After v2.1.200, the behavior is more than what v2.1.181 shipped. A reader who upgrades to v2.1.200 will not realize the prose is incomplete.

C. The "flat text" wording is no longer sufficient on its own

"Flat text without decorative borders or animations" describes the visual rendering, not the new screen-reader semantics. A screen-reader user reading the docs gets no hint that the transcript and tables have changed.

Suggested Improvement

Update each of the three rows to describe the v2.1.200 behavior, for example:

axScreenReader — Render screen-reader friendly output: flat text without decorative borders or animations. {/ min-version: 2.1.200 /}As of v2.1.200, decorative glyphs are hidden, transcript symbols read as short labels, and nested tables read as Header: value. lines. Screen-reader mode always uses the classic renderer, so the tui setting has no effect while it is active. The CLAUDE_AX_SCREEN_READER environment variable and the --ax-screen-reader flag take precedence. Requires Claude Code v2.1.181 or later (v2.1.200 for the glyph/label/table improvements).

Mirror the same wording in the matching CLAUDE_AX_SCREEN_READER row and the --ax-screen-reader row.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/settings | 226 | axScreenReader row |
| https://code.claude.com/docs/en/env-vars | 145 | CLAUDE_AX_SCREEN_READER row |
| https://code.claude.com/docs/en/cli-reference | 64 | --ax-screen-reader row |

Total scope: 3 pages, all describing the same mode.

The release note for this improvement appears in v2.1.200 (July 3, 2026).