Claude Code 从 v2.1.181 起提供了专门的屏幕阅读器模式（Screen Reader Mode），把原本依赖视觉呈现（方框、加载动画、原地重绘）的终端界面，替换成屏幕阅读器能够顺畅逐行朗读的纯文本布局。本文基于官方无障碍文档，梳理完整的开启方法和使用细节。
为什么需要专门的模式
普通终端界面大量依赖视觉元素——方框绘制字符、进度动画、原地刷新的内容——这些对屏幕阅读器用户来说几乎是噪音甚至完全不可用。屏幕阅读器模式把整个交互界面改造成 VoiceOver、NVDA 这类工具能够正常识别和朗读的纯文本、按行输出的格式，让用户能完整进行对话、批准工具权限、并逐条查看输出结果。
三种开启方式
根据使用频率选择合适的开启方式：
# 方式一：仅本次会话
claude --ax-screen-reader
# 方式二：当前 Shell 启动的所有会话（Bash/Zsh）
export CLAUDE_AX_SCREEN_READER=1
# 方式二：当前 Shell 启动的所有会话（PowerShell）
$env:CLAUDE_AX_SCREEN_READER = "1"
# 方式三：这台机器上的所有会话（包括 VS Code 集成终端）
# 写入用户设置文件// settings.json
{
"axScreenReader": true
}三种方式存在明确的优先级覆盖关系：--ax-screen-reader 命令行参数 > CLAUDE_AX_SCREEN_READER 环境变量 > axScreenReader 设置项。如果你通过 SSH 使用 Claude Code，需要在运行 Claude Code 的远程机器上设置环境变量或配置项。
开启后的确认提示
模式开启后，Claude Code 打印的第一行会明确告知是通过哪种方式开启的：
[Screen Reader Mode: on via flag]
[Screen Reader Mode: on via env]
[Screen Reader Mode: on via settings]
打印完这行确认信息后，Claude Code 会暂停界面渲染 3 秒，留出时间让屏幕阅读器读完这行文字，然后再渲染第一个提示符。按任意键可以提前结束这个等待。等待时长可以通过环境变量调整：
# 调整等待时长（单位毫秒），默认 3000，设为 0 跳过等待，上限 600000（10分钟）
export CLAUDE_AX_STARTUP_QUIET_MS=0（该配置项需要 v2.1.217 及以上版本）
关闭屏幕阅读器模式
反向操作即可：不带参数启动、取消设置环境变量、或者把 axScreenReader 设为 false。有一个细节需要注意——显式设置 CLAUDE_AX_SCREEN_READER=0 会强制关闭该模式，即便设置文件中 axScreenReader 为 true 也不例外，这是环境变量优先级更高的体现。
屏幕阅读器实际听到的内容
该模式下，Claude Code 输出的是完全扁平的文本：
- 没有用于界面装饰的方框绘制字符
- 没有纯颜色传达的提示（避免视觉依赖）
- 内容未变化时不会重绘，进度动画会渲染成静态文本
- 回复中的表格会读成
字段名: 值这样的句子，而不是方框网格（此特性需要 v2.1.198 及以上版本，更早版本即使开启模式，表格依然会画成网格）
输出会持续累积在终端的回滚缓冲区（scrollback）中，可以用屏幕阅读器自身的「回顾」命令或终端的搜索功能重新阅读之前的内容。
另外一个重要提示：即便你同时开启了全屏渲染（tui 设置项），屏幕阅读器模式下依然会渲染成纯滚动文本——该设置在屏幕阅读器模式激活时不生效。不过已附加的后台会话仍会以全屏方式渲染，这是一个已知的限制。
转录记录中的标签系统
转录记录中的每条消息都以一个屏幕阅读器会朗读的标签开头，标明这是什么内容：你的消息、Claude 的回复、工具活动、错误、还是提示。这些标签也是可搜索的，可以通过搜索终端回滚缓冲区在转录记录的不同段落之间跳转：
| 标签 | 含义 |
|---|---|
you: | 你发送的消息 |
claude: | Claude 的回复（文档中省略了完整表格，此处基于命名规律推断还包括 tool、error 等类别的标签） |
无障碍相关的其他设置
如果你使用的是屏幕放大镜、需要减少动画效果、或者需要色盲友好主题，而非严格意义上的屏幕阅读器，官方文档中还有专门的「Accessibility settings beyond screen reader mode」章节涵盖这些场景，屏幕阅读器模式本身是**可选开启（opt-in）**的功能，不会影响默认体验。
版本要求提醒
基础功能：v2.1.181 及以上（更早版本会报错 unknown option）
方式命名格式（[on via flag] 等）：v2.1.206 及以上
表格转为 Header: value 句子：v2.1.198 及以上
CLAUDE_AX_STARTUP_QUIET_MS 可配置：v2.1.217 及以上
总结
屏幕阅读器模式是 Claude Code 在无障碍访问上一次相当扎实的投入——不是简单地「去掉一些视觉元素」，而是系统性地重新设计了确认提示时序、表格呈现方式、标签可搜索性等一系列细节，确保 VoiceOver、NVDA 用户能够获得和视觉用户同等完整的交互体验。如果你或你的团队成员依赖屏幕阅读器工作，这是一个值得立刻尝试的功能。
来源：Use Claude Code with a screen reader — Claude Code 官方文档，Anthropic