Use Claude Code with a screen reader

Use Claude Code with a screen reader 문서는 Claude Code 공식 문서(accessibility)를 한국어로 정리한 가이드입니다. Set up Claude Code for screen readers such as VoiceOver and NVDA, plus settings for screen magnifiers, reduced motion, and colorblind-friendly themes. 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치 버전과 공식 원문을 확인하세요.

핵심 요약

Set up Claude Code for screen readers such as VoiceOver and NVDA, plus settings for screen magnifiers, reduced motion, and colorblind-friendly themes.

한국어 가이드 범위: accessibility 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

Use Claude Code with a screen reader
Turn on screen reader mode
Turn off screen reader mode
What your screen reader hears
Jump between turns
Answer menus and prompts
Hear when Claude Code needs you
Accessibility settings beyond screen reader mode
Known limitations
Report an issue
Related resources

상세 내용

Pick the method that matches how often you use a screen reader:

주요 항목:

For one session: run claude --ax-screen-reader.
For sessions started from one shell: set the CLAUDE_AX_SCREEN_READER environment variable to 1. In Bash or Zsh, run export CLAUDE_AX_SCREEN_READER=1; in PowerShell, run $env:CLAUDE_AX_SCREEN_READER = "1". Add the line to your shell profile to cover every shell.
For every session on the machine: add "axScreenReader": true to your user settings file. This covers any terminal, including the VS Code integrated terminal.

Reverse whichever method turned the mode on: start without the flag, unset the environment variable, or set axScreenReader to false. Setting CLAUDE_AX_SCREEN_READER=0 keeps the mode off even when the setting is true.

In screen reader mode, Claude Code writes flat text:

주요 항목:

no box-drawing characters for the interface chrome
no color-only cues
no redraws of content that hasn't changed; progress spinners render as static text
tables in Claude's replies read as Header: value sentences instead of a box-character grid. {/* min-version: 2.1.198 */}Requires Claude Code v2.1.198 or later; earlier versions draw tables as grids even in screen reader mode.
Deleting a word with Ctrl+W, Option+Delete on macOS, or Ctrl+Backspace on Windows
Deleting to the start of the line with Ctrl+U or Cmd+Backspace
Deleting to the end of the line with Ctrl+K

Label	Meaning
`you:`	Your messages
`claude:`	Claude's replies
`tool:`	Tool activity, such as a file edit or a command run
`tool error:`	A tool that failed
`error:`	An error in the conversation, such as a failed API request
`Permission Required:`	A permission prompt waiting for your answer
`Cost:`	The session cost summary when Claude Code exits, if your account shows costs

Jump between turns

Claude Code emits OSC 133 shell-integration markers at turn boundaries, so your terminal's jump-to-previous-prompt key moves between turns without reading through the whole transcript:

주요 항목:

iTerm2: Cmd+Shift+Up
VS Code terminal: Ctrl+Up on Windows, Cmd+Up on macOS
Windows Terminal: no key by default; bind the scrollToMark action in its settings
Kitty and Ghostty: check the terminal's documentation for its jump-to-prompt key

Answer menus and prompts

In screen reader mode, menus you'd normally navigate with the arrow keys, including permission prompts, become numbered lists. Each option is announced as a numbered line, followed by an Enter selection prompt that names the valid range. Type the number of the option you want and press Enter.

주요 항목:

To cancel a dismissible menu: press Escape. Its prompt ends with or Escape to cancel.
If you type a number that isn't on the list: Claude Code announces the valid range and lets you try again.

Hear when Claude Code needs you

In screen reader mode, Claude Code rings the terminal bell when it needs your attention, so you don't have to keep checking the transcript. The bell rings when:

주요 항목:

Claude finishes a reply
a permission prompt appears
a tool that ran longer than 5 seconds finishes

These options address accessibility needs outside of screen reader mode. All of them work alongside it.

주요 항목:

The CLAUDE_CODE_ACCESSIBILITY environment variable is for screen magnifiers. Set CLAUDE_CODE_ACCESSIBILITY=1 to keep the native terminal cursor visible so that magnifiers, such as macOS Zoom, can track the cursor position. The cursor follows keyboard focus: the input caret while you type, and the highlighted row as you move through menus and panels, such as /config and /plugin, with the arrow keys. {/* min-version: 2.1.218 */}Row tracking in menus and panels requires Claude Code v2.1.218 or later.
The prefersReducedMotion setting reduces or disables spinners, shimmer, and other animations without changing the rest of the interface.
The theme setting selects the interface colors, including the colorblind-friendly dark-daltonized and light-daltonized themes.

Known limitations

Some behaviors aren't adapted for screen reader mode:

주요 항목:

Screen reader mode doesn't turn on automatically when a screen reader is running.
Claude Code doesn't announce a permission mode change made in any way other than cycling with Shift+Tab, such as entering plan mode from a command.
Attaching to a background session with claude attach or from agent view enters the terminal's alternate screen, which has no native scrollback. This is the same behavior as other attached sessions. To get back out, press Left Arrow on an empty prompt, or Ctrl+Z if a dialog has focus.
Claude Code announces costs in the summary it prints at exit, not per turn.
Screen reader mode doesn't change non-interactive mode with the -p flag. Non-interactive mode already writes plain text and remains an alternative for scripting.

Report an issue

If something doesn't work with your screen reader, magnifier, or terminal, open an issue on the Claude Code issue tracker and mention your assistive technology in the title. Include your operating system, terminal application, and assistive technology name and version in the report.

These pages hold the full reference entries and related setup for what this page covers:

주요 항목:

Settings: the axScreenReader, prefersReducedMotion, theme, and preferredNotifChannel entries
Environment variables: the CLAUDE_AX_SCREEN_READER and CLAUDE_CODE_ACCESSIBILITY entries
CLI reference: the --ax-screen-reader flag
Terminal configuration: bells, notifications, and themes outside screen reader mode
Non-interactive mode: scripted claude -p runs, which write plain text without screen reader mode

실습 체크리스트

공식 문서와 로컬/SDK 버전을 대조합니다.
관련 CLI·SDK 옵션은 공식 페이지와 --help로 교차 확인합니다.
Agent SDK 예시는 TypeScript/Python 패키지 최신 API를 우선합니다.
권한·호스팅·보안 설정 변경 후 통합 테스트를 실행합니다.

Use Claude Code with a screen reader

핵심 요약

Set up Claude Code for screen readers such as VoiceOver and NVDA, plus settings for screen magnifiers, reduced motion, and colorblind-friendly themes.

한국어 가이드 범위: accessibility 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

Use Claude Code with a screen reader
Turn on screen reader mode
Turn off screen reader mode
What your screen reader hears
Jump between turns
Answer menus and prompts
Hear when Claude Code needs you
Accessibility settings beyond screen reader mode
Known limitations
Report an issue
Related resources

상세 내용

Pick the method that matches how often you use a screen reader:

주요 항목:

For one session: run claude --ax-screen-reader.
For sessions started from one shell: set the CLAUDE_AX_SCREEN_READER environment variable to 1. In Bash or Zsh, run export CLAUDE_AX_SCREEN_READER=1; in PowerShell, run $env:CLAUDE_AX_SCREEN_READER = "1". Add the line to your shell profile to cover every shell.
For every session on the machine: add "axScreenReader": true to your user settings file. This covers any terminal, including the VS Code integrated terminal.

In screen reader mode, Claude Code writes flat text:

주요 항목:

no box-drawing characters for the interface chrome
no color-only cues
no redraws of content that hasn't changed; progress spinners render as static text
tables in Claude's replies read as Header: value sentences instead of a box-character grid. {/* min-version: 2.1.198 */}Requires Claude Code v2.1.198 or later; earlier versions draw tables as grids even in screen reader mode.
Deleting a word with Ctrl+W, Option+Delete on macOS, or Ctrl+Backspace on Windows
Deleting to the start of the line with Ctrl+U or Cmd+Backspace
Deleting to the end of the line with Ctrl+K

Label	Meaning
`you:`	Your messages
`claude:`	Claude's replies
`tool:`	Tool activity, such as a file edit or a command run
`tool error:`	A tool that failed
`error:`	An error in the conversation, such as a failed API request
`Permission Required:`	A permission prompt waiting for your answer
`Cost:`	The session cost summary when Claude Code exits, if your account shows costs

Jump between turns

Claude Code emits OSC 133 shell-integration markers at turn boundaries, so your terminal's jump-to-previous-prompt key moves between turns without reading through the whole transcript:

주요 항목:

iTerm2: Cmd+Shift+Up
VS Code terminal: Ctrl+Up on Windows, Cmd+Up on macOS
Windows Terminal: no key by default; bind the scrollToMark action in its settings
Kitty and Ghostty: check the terminal's documentation for its jump-to-prompt key

Answer menus and prompts

주요 항목:

To cancel a dismissible menu: press Escape. Its prompt ends with or Escape to cancel.
If you type a number that isn't on the list: Claude Code announces the valid range and lets you try again.

Hear when Claude Code needs you

In screen reader mode, Claude Code rings the terminal bell when it needs your attention, so you don't have to keep checking the transcript. The bell rings when:

주요 항목:

Claude finishes a reply
a permission prompt appears
a tool that ran longer than 5 seconds finishes

These options address accessibility needs outside of screen reader mode. All of them work alongside it.

주요 항목:

The CLAUDE_CODE_ACCESSIBILITY environment variable is for screen magnifiers. Set CLAUDE_CODE_ACCESSIBILITY=1 to keep the native terminal cursor visible so that magnifiers, such as macOS Zoom, can track the cursor position. The cursor follows keyboard focus: the input caret while you type, and the highlighted row as you move through menus and panels, such as /config and /plugin, with the arrow keys. {/* min-version: 2.1.218 */}Row tracking in menus and panels requires Claude Code v2.1.218 or later.
The prefersReducedMotion setting reduces or disables spinners, shimmer, and other animations without changing the rest of the interface.
The theme setting selects the interface colors, including the colorblind-friendly dark-daltonized and light-daltonized themes.

Known limitations

Some behaviors aren't adapted for screen reader mode:

주요 항목:

Screen reader mode doesn't turn on automatically when a screen reader is running.
Claude Code doesn't announce a permission mode change made in any way other than cycling with Shift+Tab, such as entering plan mode from a command.
Attaching to a background session with claude attach or from agent view enters the terminal's alternate screen, which has no native scrollback. This is the same behavior as other attached sessions. To get back out, press Left Arrow on an empty prompt, or Ctrl+Z if a dialog has focus.
Claude Code announces costs in the summary it prints at exit, not per turn.
Screen reader mode doesn't change non-interactive mode with the -p flag. Non-interactive mode already writes plain text and remains an alternative for scripting.

Report an issue

These pages hold the full reference entries and related setup for what this page covers:

주요 항목:

Settings: the axScreenReader, prefersReducedMotion, theme, and preferredNotifChannel entries
Environment variables: the CLAUDE_AX_SCREEN_READER and CLAUDE_CODE_ACCESSIBILITY entries
CLI reference: the --ax-screen-reader flag
Terminal configuration: bells, notifications, and themes outside screen reader mode
Non-interactive mode: scripted claude -p runs, which write plain text without screen reader mode

실습 체크리스트

공식 문서와 로컬/SDK 버전을 대조합니다.
관련 CLI·SDK 옵션은 공식 페이지와 --help로 교차 확인합니다.
Agent SDK 예시는 TypeScript/Python 패키지 최신 API를 우선합니다.
권한·호스팅·보안 설정 변경 후 통합 테스트를 실행합니다.

Use Claude Code with a screen reader

핵심 요약

문서 구성

상세 내용

Jump between turns

Answer menus and prompts

Hear when Claude Code needs you

Known limitations

Report an issue

실습 체크리스트

관련 링크

관련 가이드

Use Claude Code with a screen reader

핵심 요약

문서 구성

상세 내용

Jump between turns

Answer menus and prompts

Hear when Claude Code needs you

Known limitations

Report an issue

실습 체크리스트

관련 링크

관련 가이드

Use Claude Code with a screen reader

핵심 요약

문서 구성

상세 내용