CLAUDE_AX_SCREEN_READER

環境変数

1 に設定すると、装飾的な枠線やアニメーションを含まないフラットなテキストで、スクリーンリーダーに適した出力を描画する。0 に設定すると、axScreenReader が true の場合でもスクリーンリーダーモードを強制的にオフにする。--ax-screen-reader フラグが優先される。プロジェクト設定とローカル設定では無視される。Claude Code v2.1.181 以降が必要

使い方・用途

  • シェルから起動するセッションごとにスクリーンリーダーモードを有効にしたい場合に、シェルプロファイルでこの環境変数を 1 に設定しておくだけで毎回有効化できる
  • スクリーンリーダー利用時には装飾的な枠線やアニメーションを含まないフラットなテキスト出力で読み上げさせたい場合に、この変数で画面読み上げに適したレンダリングに切り替えられる
  • ユーザー設定ファイルの axScreenReader が true になっている環境で一時的にスクリーンリーダーモードを無効化したい場合に、この変数を 0 に設定して強制オフにできる
英語原文

Set to 1 to render screen-reader friendly output: flat text without decorative borders or animations. Set to 0 to force screen-reader mode off even when axScreenReader is true. The --ax-screen-reader flag takes precedence. Ignored in project and local settings. Requires Claude Code v2.1.181 or later

関連する変更履歴

v2.1.307(1件)

axScreenReader 設定と設定の env ブロック内の CLAUDE_AX_SCREEN_READER が、ユーザー設定、管理設定、または --settings による設定にのみ適用されるよう変更した (2.1.305 以降)
英語原文を表示
Changed the axScreenReader setting and CLAUDE_AX_SCREEN_READER in a settings env block to apply only from user, managed or --settings settings (since 2.1.305)

変更後

スクリーンリーダー設定がユーザー設定や管理設定など信頼できる設定ファイルからのみ適用されるようになり、プロジェクト単位の設定で意図せず出力形式が切り替わるのを防げる。

関連ドキュメント

v2.1.208(1件)

スクリーンリーダーモードを追加した。スクリーンリーダー利用者のためにプレーンテキストでのレンダリングを選択できるようになった。claude --ax-screen-reader を実行するか、環境変数 CLAUDE_AX_SCREEN_READER=1 を設定、あるいは設定ファイルに "axScreenReader": true を追加することで利用できる。
英語原文を表示
Added screen reader mode: opt-in plain-text rendering for screen reader users. Run claude --ax-screen-reader, set CLAUDE_AX_SCREEN_READER=1, or add "axScreenReader": true to settings.

変更後

スクリーンリーダーで CLI の出力を読み上げる際に、装飾記号などに邪魔されず内容を直接把握できるようになります。

関連ドキュメント