跳至主要內容

搭配螢幕閱讀器使用 Claude Code CLI

螢幕閱讀器模式將 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。對於是/否提示,輸入 yn 並按 Enter。

  • 視覺裝飾已移除。旋轉動畫、進度動畫和就地重繪變成按順序讀取的純文字,裝飾性字元(例如方框繪製線)已移除。

  • 終端鈴聲會告訴您何時 Claude 需要您。當 Claude 完成回覆、出現權限提示或長時間執行的工具完成時,您會聽到終端的警示音。如果您沒有聽到,請檢查終端應用程式中的鈴聲設定—某些終端預設會關閉警示音。Claude Code 自己的通知頻道可以透過 /config 在通知下設定。

若要探索有關行標記、清單導覽和現有限制的完整文件,請造訪 Claude Code 指南的無障礙部分

回報問題

如果您的螢幕閱讀器或終端有任何問題,請在 Claude Code GitHub 儲存庫開啟議題,並在標題中提及您的螢幕閱讀器。請包含您的作業系統、終端應用程式以及螢幕閱讀器名稱和版本。

注意:一個容易混淆的設定:CLAUDE_CODE_ACCESSIBILITY=1 是不同的無關設定—它會保持終端游標可見以供螢幕放大鏡使用,不會開啟螢幕閱讀器模式。若要使用螢幕閱讀器,請使用上述方法。

是否回答了您的問題?