螢幕閱讀器模式跟一般的無障礙輔助功能(例如放大鏡、對比色主題)是同一套設定嗎?
不是同一套。螢幕閱讀器模式(透過 --ax-screen-reader 旗標或對應設定開啟)專門處理的是「終端機的視覺化呈現方式,螢幕閱讀器唸不出來或會卡住」這個具體問題,運作方式是把整個畫面渲染邏輯換成線性文字輸出。放大鏡、減少動態效果、色盲友善主題這幾類需求,則是分別對應到不同的設定項目(CLAUDE_CODE_ACCESSIBILITY、prefersReducedMotion、主題設定),這些設定不會去改變畫面本身是不是用視覺化方式渲染,只是調整視覺呈現的細節。
這代表如果你的需求是放大畫面或降低動態效果,不需要,也不應該去開啟螢幕閱讀器模式——那是為了完全不同的情境(畫面本身對螢幕閱讀器不友善)設計的,兩者是並行、各自獨立的設定分類,不是同一個無障礙總開關底下的子選項。
為什麼要特別針對「進度動畫、原地重繪」這類視覺效果去改動,而不是直接讓螢幕閱讀器自己想辦法讀懂終端機畫面?
問題出在螢幕閱讀器原本的設計邏輯,跟終端機動態重繪的方式本質上衝突——螢幕閱讀器習慣的是「畫面內容照順序、穩定地變化」,一行唸完換下一行;但進度動畫、原地重繪這類效果,是讓同一塊畫面區域被快速、重複地覆寫更新,對螢幕閱讀器而言,這種變化模式很難判斷「現在該唸哪一行」「這個內容是新的還是舊的重複刷新」,實務上反映出來的結果,就是社群裡提到的螢幕閱讀器唸出奇怪字元、或整個卡住沒有反應。
與其要求螢幕閱讀器自己想辦法適應這種本質上不穩定的畫面更新模式,直接在終端機這一端改變輸出方式(換成線性、逐行印出的純文字),是更直接的解法——這代表問題被解決在輸出源頭,而不是要求接收端(螢幕閱讀器)去硬啃一個原本就不是為它設計的畫面格式。
如果我開啟了螢幕閱讀器模式,結果原本熟悉的某個視覺化功能(例如背景 session 附加)沒辦法正常運作,這是設定錯了嗎?
不一定是設定錯誤——官方文件裡明確列出「已知限制」這個項目,代表螢幕閱讀器模式雖然涵蓋了大部分核心功能(完整對話、核准工具權限、檢視輸出),但不是百分之百對應原本視覺化介面的每一項功能。背景 session 附加就是文件裡明確提到、目前還沒有在這個模式下完全支援的項目之一。
比較實際的做法,是先假設某個功能在螢幕閱讀器模式下可能有限制,遇到問題時先去查官方文件裡「已知限制」這個章節,確認是不是屬於已知、還沒解決的情況,而不是先假設自己設定錯了、反覆重新設定同一件事——這個模式本身也還在持續調整,已知限制的範圍未來可能會縮小,但現階段不能假設它跟原本的視覺化介面功能完全對等。
我自己看得到螢幕,但團隊裡有視障同事會用 Claude Code,我該怎麼幫他確認這個設定有沒有正確生效?
最直接的確認方式,是看終端機啟動時印出的確認訊息——啟用螢幕閱讀器模式之後,啟動時會有一行文字明確標示目前是透過旗標、環境變數、還是設定檔開啟的(較舊版本則是印出「Accessible screen reader mode: on」這樣的訊息),這行文字本身就是純文字格式,你自己用眼睛看畫面也能確認,不需要額外操作螢幕閱讀器就能判斷模式是否已經生效。
如果你想從旁協助設定,比較建議的順序是:先確認對方 Claude Code 的版本是否在 2.1.181 以上(可以請對方執行版本查詢指令,或直接看啟動時印出的版本號),再根據對方的使用頻率決定用哪一種啟用方式——如果他多數時候都在同一台機器上工作,設定檔裡的 axScreenReader: true 通常最省事,不需要每次啟動都額外加旗標或擔心環境變數有沒有正確載入。
Claude Code 原本的終端機介面,對螢幕閱讀器使用者來說並不友善——方框、進度動畫、原地重繪這些視覺效果,螢幕閱讀器往往念不出來,甚至會卡住、整段停止回應。這個問題在社群裡被明確反映過:NVDA 使用者提到終端機在串流輸出或進度指示器更新時經常凍結,得反覆重啟螢幕閱讀器或終端機本身才能繼續使用。Claude Code 後來加入的螢幕閱讀器模式,就是針對這個具體問題設計的。這篇文章整理實際怎麼開啟、關閉,以及開啟之後行為上有哪些具體差異。
啟用之後,Claude Code 會把原本的視覺化終端機介面,換成一般的線性文字輸出——不再有方框、進度動畫、原地重繪這些畫面效果,取而代之的是一行一行帶有標籤的純文字,讓 VoiceOver、NVDA 這類螢幕閱讀器可以照順序念出來。啟用這個模式之後,你依然可以完整地進行對話、核准工具使用權限、從頭到尾檢視輸出內容,不會因為介面換了就少了某些功能。
如果只是這一次 session 想用,直接在啟動指令後面加上 --ax-screen-reader 旗標;如果你想讓某個 shell 啟動的所有 session 都預設開啟,把環境變數 CLAUDE_AX_SCREEN_READER 設成 1(在 Bash 或 Zsh 裡執行 export CLAUDE_AX_SCREEN_READER=1,PowerShell 則是 $env:CLAUDE_AX_SCREEN_READER = "1"),並把這行加進你的 shell 設定檔,才能涵蓋每一次開啟的 shell;如果想讓這台機器上所有的 session 都固定開啟,在使用者設定檔裡加上 "axScreenReader": true,這個設定連 VS Code 內建終端機都會套用。要注意的是,這個功能需要 Claude Code 2.1.181 版以上才有,舊版本會直接回傳「未知選項」的錯誤,代表你得先確認自己的版本符不符合需求。
Claude 回覆裡原本用方框字元畫出來的表格,會改成「欄位名稱:數值」這種逐句唸出的格式,而不是螢幕閱讀器很難處理的方框網格。Claude Code 會把之前印出的所有內容留在終端機的捲動紀錄裡,你可以用螢幕閱讀器的回顧指令,或終端機本身的搜尋功能,回頭重新讀取之前的對話內容。這個模式只調整終端機介面本身,如果你是透過 VS Code 擴充功能裡的對話面板在使用 Claude Code,不需要另外開啟這個模式。另外,螢幕閱讀器模式底下,原本的 tui 設定會被忽略,除了「已知限制」裡提到的背景 session 附加功能之外,畫面基本上都是用捲動文字呈現,不是全螢幕重繪。
Claude Code 在螢幕閱讀器模式下,有兩個地方會刻意暫停,讓螢幕閱讀器有時間跟上——其中一個是印出確認訊息之後,會先等待 3 秒才畫出下一個提示符,讓螢幕閱讀器有機會把那一行念完,你也可以按任意鍵提前結束這段等待,如果覺得預設的等待時間太長或太短,可以透過 CLAUDE_AX_STARTUP_QUIET_MS 這個環境變數調整長度。這代表這個模式不只是把畫面換成文字而已,連時間節奏都有針對螢幕閱讀器的閱讀速度做調整。
如果你平常用的是螢幕放大鏡、需要減少動態效果,或需要色盲友善的主題,不需要開啟螢幕閱讀器模式——這些情境有各自對應的設定(例如透過 CLAUDE_CODE_ACCESSIBILITY、prefersReducedMotion、或主題設定調整),螢幕閱讀器模式本身是設計給「終端機畫面本身無法被有效念出來」這個特定情境用的,不是一個涵蓋所有視覺輔助需求的總開關。