メインコンテンツにスキップ

スクリーンリーダーで Claude Code CLI を使用する

スクリーンリーダーモードは 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 は異なる無関係な設定です。スクリーンマグニファイアーのターミナルカーソルを表示したままにしますが、スクリーンリーダーモードはオンになりません。スクリーンリーダーの場合は、上記の方法を使用してください。

こちらの回答で解決しましたか?