螢幕閱讀器模式將 Claude Code 恢復為基本終端體驗:純文字、循序呈現,並加入標籤和提示,不含視覺裝飾。此模式是與螢幕閱讀器使用者共同開發的,對於需要純文字輸出的點字顯示器、低速連線或文字稿的使用者也很有用。
開啟螢幕閱讀器模式
螢幕閱讀器模式需要 Claude Code 版本 2.1.181 或更新版本,可以透過多種方式啟用:
單次工作階段:執行
claude --ax-screen-reader終端中的每個工作階段:設定環境變數
CLAUDE_AX_SCREEN_READER=1永久設定:在 Claude Code 設定檔 (
~/.claude/settings.json) 中新增"axScreenReader": true
工作階段的第一行會宣告螢幕閱讀器模式已開啟。在 Claude Code v2.1.206 及更新版本中,它會宣告:[Screen Reader Mode: on via flag](或 via env / via settings)。
預期結果
您的提示和 Claude 的回應都有標籤。您的訊息以
you:開頭,Claude 的回覆以claude:開頭。工具活動以tool:開頭,權限提示以Permission Required:開頭。這些標籤也可搜尋,因此您可以使用終端的搜尋功能在對話的各個部分之間跳轉。選單變成編號清單。您不需要用方向鍵移動反白選項,而是聽到每個選項作為編號行,然後輸入您想要的選項編號並按 Enter。對於是/否提示,輸入
y或n並按 Enter。視覺裝飾已移除。旋轉動畫、進度動畫和就地重繪變成按順序讀取的純文字,裝飾性字元(例如方框繪製線)已移除。
終端鈴聲會告訴您何時 Claude 需要您。當 Claude 完成回覆、出現權限提示或長時間執行的工具完成時,您會聽到終端的警示音。如果您沒有聽到,請檢查終端應用程式中的鈴聲設定—某些終端預設會關閉警示音。Claude Code 自己的通知頻道可以透過
/config在通知下設定。
若要探索有關行標記、清單導覽和現有限制的完整文件,請造訪 Claude Code 指南的無障礙部分。
回報問題
如果您的螢幕閱讀器或終端有任何問題,請在 Claude Code GitHub 儲存庫開啟議題,並在標題中提及您的螢幕閱讀器。請包含您的作業系統、終端應用程式以及螢幕閱讀器名稱和版本。
注意:一個容易混淆的設定:CLAUDE_CODE_ACCESSIBILITY=1 是不同的無關設定—它會保持終端游標可見以供螢幕放大鏡使用,不會開啟螢幕閱讀器模式。若要使用螢幕閱讀器,請使用上述方法。
