スクリーンリーダーモードには Claude Code v2.1.181 以降が必要です。以前のバージョンは
--ax-screen-reader フラグを error: unknown option '--ax-screen-reader' で拒否します。スクリーンリーダーモードをオンにする
スクリーンリーダーを使用する頻度に合わせて方法を選択してください。- 1 つのセッション用：
claude --ax-screen-readerを実行します。 - 1 つのシェルから開始されたセッション用：
CLAUDE_AX_SCREEN_READER環境変数を1に設定します。Bash または Zsh ではexport CLAUDE_AX_SCREEN_READER=1を実行し、PowerShell では$env:CLAUDE_AX_SCREEN_READER = "1"を実行します。すべてのシェルをカバーするために、シェルプロファイルに行を追加します。 - マシン上のすべてのセッション用：ユーザー設定ファイルに
"axScreenReader": trueを追加します。これは VS Code 統合ターミナルを含むすべてのターミナルをカバーします。
メソッドは優先順位順にリストされています。
--ax-screen-reader フラグは CLAUDE_AX_SCREEN_READER 環境変数をオーバーライドし、これは axScreenReader 設定をオーバーライドします。[Screen Reader Mode: on via flag]、[Screen Reader Mode: on via env]、または [Screen Reader Mode: on via settings] です。このメソッド命名形式には Claude Code v2.1.206 以降が必要です。
以前のバージョンは [Accessible screen reader mode: on] を出力します。
スクリーンリーダーモードをオフにする
モードをオンにした方法を逆にします。フラグなしで開始するか、環境変数を設定解除するか、axScreenReader を false に設定します。CLAUDE_AX_SCREEN_READER=0 を設定すると、設定が true の場合でもモードはオフのままです。
スクリーンリーダーが聞くもの
スクリーンリーダーモードでは、Claude Code はフラットテキストを書き込みます。- インターフェースクロムのボックス描画文字なし
- 色のみのキューなし
- 変更されていないコンテンツの再描画なし。プログレススピナーは静的テキストとしてレンダリングされます
- Claude の返信のテーブルは、ボックス文字グリッドの代わりに
Header: value文として読み上げられます。Claude Code v2.1.198 以降が必要です。以前のバージョンはスクリーンリーダーモードでもテーブルをグリッドとして描画します。
tui 設定でオンにしている場合でも、プレーンなスクロールテキストとしてレンダリングされます。モードがアクティブな間、設定は効果がありません。アタッチされたバックグラウンドセッションは引き続きフルスクリーンでレンダリングされます。既知の制限事項を参照してください。
トランスクリプト内の各メッセージは、スクリーンリーダーが発表するラベルで始まり、それが何であるかを名前付けします。あなたのメッセージ、Claude の返信、ツールアクティビティ、エラー、プロンプトです。ラベルは検索可能でもあるため、ターミナルのスクロールバックを検索してトランスクリプトのセクション間をジャンプできます。
| ラベル | 意味 |
|---|---|
you: | あなたのメッセージ |
claude: | Claude の返信 |
tool: | ファイル編集やコマンド実行などのツールアクティビティ |
tool error: | 失敗したツール |
error: | 失敗した API リクエストなどの会話内のエラー |
Permission Required: | あなたの回答を待っている権限プロンプト |
Cost: | Claude Code が終了するときのセッションコスト概要（アカウントがコストを表示している場合） |
ターン間をジャンプする
Claude Code はターン境界で OSC 133 シェル統合マーカーを出力するため、ターミナルの前のプロンプトにジャンプするキーはトランスクリプト全体を読まずにターン間を移動します。- iTerm2：Cmd+Shift+Up
- VS Code ターミナル：Windows では Ctrl+Up、macOS では Cmd+Up
- Windows Terminal：デフォルトではキーなし。設定で
scrollToMarkアクションをバインドします - Kitty と Ghostty：ターミナルのドキュメントでプロンプトにジャンプするキーを確認してください
you: ラベルを検索してください。
メニューとプロンプトに答える
スクリーンリーダーモードでは、通常は矢印キーで移動するメニュー（権限プロンプトを含む）は番号付きリストになります。各オプションは番号付きの行として発表され、その後に有効な範囲を名前付けするEnter selection プロンプトが続きます。希望するオプションの番号を入力して Enter キーを押します。
- 却下可能なメニューをキャンセルするには：Escape キーを押します。そのプロンプトは
or Escape to cancelで終わります。 - リストにない番号を入力した場合：Claude Code は有効な範囲を発表し、もう一度試すことができます。
y または n で答えて Enter キーを押します。yes と no も機能します。
Claude Code があなたを必要とするときに聞く
スクリーンリーダーモードでは、Claude Code はあなたの注意が必要なときにターミナルベルを鳴らすため、トランスクリプトを常にチェックする必要はありません。ベルは以下の場合に鳴ります。- Claude が返信を完了した
- 権限プロンプトが表示される
- 5 秒以上実行されたツールが完了する
preferredNotifChannel を "terminal_bell" に設定して、Claude があなたを待っているときに同様のアラートを取得します。ターミナルベルまたは通知を取得するを参照してください。
スクリーンリーダーモード以外のアクセシビリティ設定
これらのオプションはスクリーンリーダーモード外のアクセシビリティニーズに対応しています。すべてそれと一緒に機能します。CLAUDE_CODE_ACCESSIBILITY環境変数はスクリーン拡大鏡用です。CLAUDE_CODE_ACCESSIBILITY=1を設定して、ネイティブターミナルカーソルを表示したままにして、macOS Zoom などの拡大鏡がカーソル位置を追跡できるようにします。prefersReducedMotion設定は、インターフェースの残りを変更せずにスピナー、シマー、その他のアニメーションを削減または無効にします。theme設定はインターフェースの色を選択します。カラーブラインド対応のdark-daltonizedおよびlight-daltonizedテーマを含みます。
既知の制限事項
一部の動作はスクリーンリーダーモード用に適応していません。- スクリーンリーダーモードは、スクリーンリーダーが実行されているときに自動的にオンになりません。
- プランモードに入るなどのモード変更はまだ発表されていません。
claude attachまたは agent view からバックグラウンドセッションにアタッチすると、ターミナルの代替画面に入ります。これはネイティブスクロールバックがありません。これは他のアタッチされたセッションと同じ動作です。抜け出すには、空のプロンプトで左矢印を押すか、ダイアログにフォーカスがある場合は Ctrl+Z を押します。- Claude Code はコストを終了時に出力するサマリーで発表し、ターンごとではありません。
- スクリーンリーダーモードは
-pフラグで非対話型モードを変更しません。非対話型モードは既にプレーンテキストを書き込み、スクリプト作成の代替案のままです。
問題を報告する
スクリーンリーダー、拡大鏡、またはターミナルで何かが機能しない場合は、Claude Code issue tracker で問題を開き、タイトルに支援技術を記載してください。レポートにオペレーティングシステム、ターミナルアプリケーション、支援技術の名前とバージョンを含めます。関連リソース
これらのページには、このページがカバーする内容の完全なリファレンスエントリと関連セットアップが含まれています。- 設定：
axScreenReader、prefersReducedMotion、theme、およびpreferredNotifChannelエントリ - 環境変数：
CLAUDE_AX_SCREEN_READERおよびCLAUDE_CODE_ACCESSIBILITYエントリ - CLI リファレンス：
--ax-screen-readerフラグ - ターミナル設定：スクリーンリーダーモード外のベル、通知、テーマ
- 非対話型モード：スクリプト化された
claude -p実行。スクリーンリーダーモードなしでプレーンテキストを書き込みます