スクリーンリーダーモードは Claude Code を基本的なターミナル体験に戻します。プレーンで順序立ったテキストに、ラベルとキューが追加され、視覚的な装飾はありません。スクリーンリーダーユーザーと共に、またはスクリーンリーダーユーザーのために構築されており、点字ディスプレイ、低速接続、またはトランスクリプト用のプレーン出力を望む誰にとっても有用です。
スクリーンリーダーモードをオンにする
スクリーンリーダーモードには Claude Code バージョン 2.1.181 以降が必要であり、複数の方法で有効にできます:
1 つのセッション用:
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 リポジトリで問題を開き、タイトルにスクリーンリーダーを記載してください。オペレーティングシステム、ターミナルアプリケーション、およびスクリーンリーダーの名前とバージョンを含めてください。
注:混同しやすい設定の 1 つ:CLAUDE_CODE_ACCESSIBILITY=1 は異なる無関係な設定です。スクリーンマグニファイアーのターミナルカーソルを表示したままにしますが、スクリーンリーダーモードはオンになりません。スクリーンリーダーの場合は、上記の方法を使用してください。
