Langsung ke konten utama
Claude Code memiliki mode pembaca layar yang menggantikan antarmuka terminal visualnya dengan teks biasa dan linear. Alih-alih kotak, animasi kemajuan, dan penggambaran ulang di tempat, mode ini mencetak baris berlabel yang dibaca pembaca layar seperti VoiceOver atau NVDA secara berurutan, sehingga Anda dapat melakukan percakapan lengkap, menyetujui izin alat, dan meninjau output dari awal hingga akhir. Mode pembaca layar bersifat opt-in. Jika Anda menggunakan pembesar layar, gerakan berkurang, atau tema ramah buta warna alih-alih pembaca layar, lihat Pengaturan aksesibilitas di luar mode pembaca layar.
Mode pembaca layar memerlukan Claude Code v2.1.181 atau lebih baru. Versi sebelumnya menolak flag --ax-screen-reader dengan error: unknown option '--ax-screen-reader'.

​
Aktifkan mode pembaca layar

Pilih metode yang sesuai dengan seberapa sering Anda menggunakan pembaca layar:
  • Untuk satu sesi: jalankan claude --ax-screen-reader.
  • Untuk sesi yang dimulai dari satu shell: atur variabel lingkungan CLAUDE_AX_SCREEN_READER ke 1. Di Bash atau Zsh, jalankan export CLAUDE_AX_SCREEN_READER=1; di PowerShell, jalankan $env:CLAUDE_AX_SCREEN_READER = "1". Tambahkan baris ke profil shell Anda untuk mencakup setiap shell.
  • Untuk setiap sesi di mesin: tambahkan "axScreenReader": true ke file pengaturan pengguna Anda. Ini mencakup terminal apa pun, termasuk terminal terintegrasi VS Code.
Metode-metode tersebut tercantum dalam urutan prioritas: flag --ax-screen-reader menggantikan variabel lingkungan CLAUDE_AX_SCREEN_READER, yang menggantikan pengaturan axScreenReader.
Jika Anda menggunakan Claude Code melalui SSH, atur variabel lingkungan atau pengaturan pada mesin jarak jauh tempat Claude Code berjalan. Ketika mode aktif, hal pertama yang dicetak Claude Code adalah baris konfirmasi yang menyebutkan metode yang mengaktifkannya: [Screen Reader Mode: on via flag], [Screen Reader Mode: on via env], atau [Screen Reader Mode: on via settings]; format penamaan metode ini memerlukan Claude Code v2.1.206 atau lebih baru. Versi sebelumnya mencetak [Accessible screen reader mode: on].

​
Matikan mode pembaca layar

Balikkan metode apa pun yang mengaktifkan mode: mulai tanpa flag, batalkan pengaturan variabel lingkungan, atau atur axScreenReader ke false. Mengatur CLAUDE_AX_SCREEN_READER=0 membuat mode tetap mati bahkan ketika pengaturan adalah true.

​
Apa yang didengar pembaca layar Anda

Dalam mode pembaca layar, Claude Code menulis teks datar:
  • tidak ada karakter penggambar kotak untuk chrome antarmuka
  • tidak ada petunjuk warna saja
  • tidak ada penggambaran ulang konten yang belum berubah; spinner kemajuan dirender sebagai teks statis
  • tabel dalam balasan Claude dibaca sebagai kalimat Header: value alih-alih kisi karakter kotak. Memerlukan Claude Code v2.1.198 atau lebih baru; versi sebelumnya menggambar tabel sebagai kisi bahkan dalam mode pembaca layar.
Output terakumulasi dalam scrollback terminal Anda, sehingga Anda dapat membaca kembali giliran sebelumnya dengan perintah tinjauan pembaca layar Anda atau pencarian terminal Anda. Mode pembaca layar dirender sebagai teks gulir biasa, bahkan jika Anda telah mengaktifkan rendering layar penuh dengan pengaturan tui; pengaturan tidak berpengaruh saat mode aktif. Sesi latar belakang yang terlampir masih dirender layar penuh; lihat Batasan yang diketahui. Setiap pesan dalam transkrip dimulai dengan label yang diumumkan pembaca layar Anda, menyebutkan apa itu: pesan Anda, balasan Claude, aktivitas alat, kesalahan, dan prompt. Label juga dapat dicari, sehingga Anda dapat melompat antar bagian transkrip dengan mencari scrollback terminal Anda:
LabelArti
you:Pesan Anda
claude:Balasan Claude
tool:Aktivitas alat, seperti pengeditan file atau perintah yang dijalankan
tool error:Alat yang gagal
error:Kesalahan dalam percakapan, seperti permintaan API yang gagal
Permission Required:Prompt izin menunggu jawaban Anda
Cost:Ringkasan biaya sesi ketika Claude Code keluar, jika akun Anda menampilkan biaya
Kursor terminal mengikuti tanda sisip input, sehingga perintah baca-baris-saat-ini pembaca layar Anda menjawab “di mana saya” dengan prompt yang Anda edit.

​
Lompat antar giliran

Claude Code memancarkan penanda integrasi shell OSC 133 di batas giliran, sehingga kunci lompat-ke-prompt-sebelumnya terminal Anda bergerak antar giliran tanpa membaca seluruh transkrip:
  • iTerm2: Cmd+Shift+Up
  • Terminal VS Code: Ctrl+Up di Windows, Cmd+Up di macOS
  • Windows Terminal: tidak ada kunci secara default; ikat tindakan scrollToMark dalam pengaturannya
  • Kitty dan Ghostty: periksa dokumentasi terminal untuk kunci lompat-ke-prompt-nya
macOS Terminal tidak bertindak atas penanda, dan Claude Code tidak memancarkannya di WezTerm. Di terminal tersebut, cari scrollback untuk label you: sebagai gantinya.

​
Jawab menu dan prompt

Dalam mode pembaca layar, menu yang biasanya Anda navigasikan dengan tombol panah, termasuk prompt izin, menjadi daftar bernomor. Setiap opsi diumumkan sebagai baris bernomor, diikuti oleh prompt Enter selection yang menyebutkan rentang yang valid. Ketik nomor opsi yang Anda inginkan dan tekan Enter.
  • Untuk membatalkan menu yang dapat ditutup: tekan Escape. Promptnya berakhir dengan or Escape to cancel.
  • Jika Anda mengetik nomor yang tidak ada dalam daftar: Claude Code mengumumkan rentang yang valid dan membiarkan Anda mencoba lagi.
Prompt ya-atau-tidak meminta jawaban yang diketik alih-alih menu dua opsi. Jawab y atau n dan tekan Enter. yes dan no juga berfungsi.

​
Dengarkan ketika Claude Code membutuhkan Anda

Dalam mode pembaca layar, Claude Code membunyikan bel terminal ketika membutuhkan perhatian Anda, sehingga Anda tidak perlu terus memeriksa transkrip. Bel berbunyi ketika:
  • Claude menyelesaikan balasan
  • prompt izin muncul
  • alat yang berjalan lebih lama dari 5 detik selesai
Bel adalah peringatan standar terminal Anda. Untuk membungkamnya, ubah pengaturan bel di aplikasi terminal Anda. Bel tidak memerlukan mode pembaca layar: di luar mode, atur preferredNotifChannel ke "terminal_bell" untuk peringatan serupa ketika Claude menunggu Anda. Lihat Dapatkan bel terminal atau notifikasi.

​
Pengaturan aksesibilitas di luar mode pembaca layar

Opsi-opsi ini mengatasi kebutuhan aksesibilitas di luar mode pembaca layar. Semuanya bekerja bersama dengannya.
  • Variabel lingkungan CLAUDE_CODE_ACCESSIBILITY adalah untuk pembesar layar. Atur CLAUDE_CODE_ACCESSIBILITY=1 untuk menjaga kursor terminal asli tetap terlihat sehingga pembesar, seperti macOS Zoom, dapat melacak posisi kursor.
  • Pengaturan prefersReducedMotion mengurangi atau menonaktifkan spinner, shimmer, dan animasi lainnya tanpa mengubah sisa antarmuka.
  • Pengaturan theme memilih warna antarmuka, termasuk tema ramah buta warna dark-daltonized dan light-daltonized.

​
Batasan yang diketahui

Beberapa perilaku tidak disesuaikan untuk mode pembaca layar:
  • Mode pembaca layar tidak aktif secara otomatis ketika pembaca layar sedang berjalan.
  • Perubahan mode, seperti memasuki plan mode, belum diumumkan.
  • Melampirkan ke sesi latar belakang dengan claude attach atau dari tampilan agen memasuki layar alternatif terminal, yang tidak memiliki scrollback asli. Ini adalah perilaku yang sama seperti sesi terlampir lainnya. Untuk keluar, tekan Left Arrow pada prompt kosong, atau Ctrl+Z jika dialog memiliki fokus.
  • Claude Code mengumumkan biaya dalam ringkasan yang dicetak saat keluar, bukan per giliran.
  • Mode pembaca layar tidak mengubah mode non-interaktif dengan flag -p. Mode non-interaktif sudah menulis teks biasa dan tetap menjadi alternatif untuk scripting.

​
Laporkan masalah

Jika sesuatu tidak berfungsi dengan pembaca layar, pembesar, atau terminal Anda, buka masalah di pelacak masalah Claude Code dan sebutkan teknologi bantu Anda dalam judul. Sertakan sistem operasi, aplikasi terminal, dan nama serta versi teknologi bantu Anda dalam laporan. Halaman-halaman ini menyimpan entri referensi lengkap dan pengaturan terkait untuk apa yang halaman ini bahas: