스크린 리더 모드는 Claude Code를 기본 터미널 경험으로 돌려놓습니다: 시각적 장식 없이 추가된 레이블과 신호가 있는 평문, 순차적 텍스트입니다. 스크린 리더 사용자와 함께 그리고 그들을 위해 구축되었으며, 점자 디스플레이, 느린 연결 또는 기록을 원하는 모든 사람에게 유용합니다.
스크린 리더 모드 켜기
스크린 리더 모드는 Claude Code 버전 2.1.181 이상이 필요하며 여러 방법으로 활성화할 수 있습니다:
한 세션의 경우:
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 저장소에서 문제를 열고 제목에 스크린 리더를 언급하세요. 운영 체제, 터미널 애플리케이션, 스크린 리더 이름 및 버전을 포함하세요.
참고: 혼동하기 쉬운 한 가지 설정: CLAUDE_CODE_ACCESSIBILITY=1은 다른 관련 없는 설정입니다. 이는 화면 확대기를 위해 터미널 커서를 표시하고 스크린 리더 모드를 켜지 않습니다. 스크린 리더의 경우 위의 방법을 사용하세요.