accessibility.md +145 −0 created
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# Gunakan Claude Code dengan pembaca layar
6
7> Atur Claude Code untuk pembaca layar seperti VoiceOver dan NVDA, plus pengaturan untuk pembesar layar, gerakan berkurang, dan tema ramah buta warna.
8
9Claude 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.
10
11Mode 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](#accessibility-settings-beyond-screen-reader-mode).
12
13<Note>
14 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'`.
15</Note>
16
17<h2 id="turn-on-screen-reader-mode">
18 Aktifkan mode pembaca layar
19</h2>
20
21Pilih metode yang sesuai dengan seberapa sering Anda menggunakan pembaca layar:
22
23* Untuk satu sesi: jalankan `claude --ax-screen-reader`.
24* 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.
25* Untuk setiap sesi di mesin: tambahkan `"axScreenReader": true` ke [file pengaturan](/id/settings) pengguna Anda. Ini mencakup terminal apa pun, termasuk terminal terintegrasi VS Code.
26
27<Note>
28 Metode-metode tersebut tercantum dalam urutan prioritas: flag [`--ax-screen-reader`](/id/cli-reference#cli-flags) menggantikan variabel lingkungan [`CLAUDE_AX_SCREEN_READER`](/id/env-vars), yang menggantikan pengaturan [`axScreenReader`](/id/settings#available-settings).
29</Note>
30
31Jika Anda menggunakan Claude Code melalui SSH, atur variabel lingkungan atau pengaturan pada mesin jarak jauh tempat Claude Code berjalan.
32
33Ketika 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.
34{/* max-version: 2.1.205 */}Versi sebelumnya mencetak `[Accessible screen reader mode: on]`.
35
36<h2 id="turn-off-screen-reader-mode">
37 Matikan mode pembaca layar
38</h2>
39
40Balikkan 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`.
41
42<h2 id="what-your-screen-reader-hears">
43 Apa yang didengar pembaca layar Anda
44</h2>
45
46Dalam mode pembaca layar, Claude Code menulis teks datar:
47
48* tidak ada karakter penggambar kotak untuk chrome antarmuka
49* tidak ada petunjuk warna saja
50* tidak ada penggambaran ulang konten yang belum berubah; spinner kemajuan dirender sebagai teks statis
51* tabel dalam balasan Claude dibaca sebagai kalimat `Header: value` alih-alih kisi karakter kotak. {/* min-version: 2.1.198 */}Memerlukan Claude Code v2.1.198 atau lebih baru; versi sebelumnya menggambar tabel sebagai kisi bahkan dalam mode pembaca layar.
52
53Output terakumulasi dalam scrollback terminal Anda, sehingga Anda dapat membaca kembali giliran sebelumnya dengan perintah tinjauan pembaca layar Anda atau pencarian terminal Anda.
54
55Mode pembaca layar dirender sebagai teks gulir biasa, bahkan jika Anda telah mengaktifkan [rendering layar penuh](/id/fullscreen) dengan [pengaturan `tui`](/id/settings#available-settings); pengaturan tidak berpengaruh saat mode aktif. Sesi latar belakang yang terlampir masih dirender layar penuh; lihat [Batasan yang diketahui](#known-limitations).
56
57Setiap 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:
58
59| Label | Arti |
60| :--------------------- | :-------------------------------------------------------------------------------------------- |
61| `you:` | Pesan Anda |
62| `claude:` | Balasan Claude |
63| `tool:` | Aktivitas alat, seperti pengeditan file atau perintah yang dijalankan |
64| `tool error:` | Alat yang gagal |
65| `error:` | Kesalahan dalam percakapan, seperti permintaan API yang gagal |
66| `Permission Required:` | Prompt izin menunggu jawaban Anda |
67| `Cost:` | Ringkasan biaya sesi ketika Claude Code keluar, jika akun Anda [menampilkan biaya](/id/costs) |
68
69Kursor terminal mengikuti tanda sisip input, sehingga perintah baca-baris-saat-ini pembaca layar Anda menjawab "di mana saya" dengan prompt yang Anda edit.
70
71<h3 id="jump-between-turns">
72 Lompat antar giliran
73</h3>
74
75Claude 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:
76
77* iTerm2: Cmd+Shift+Up
78* Terminal VS Code: Ctrl+Up di Windows, Cmd+Up di macOS
79* Windows Terminal: tidak ada kunci secara default; ikat tindakan `scrollToMark` dalam pengaturannya
80* Kitty dan Ghostty: periksa dokumentasi terminal untuk kunci lompat-ke-prompt-nya
81
82macOS Terminal tidak bertindak atas penanda, dan Claude Code tidak memancarkannya di WezTerm. Di terminal tersebut, cari scrollback untuk label `you:` sebagai gantinya.
83
84<h2 id="answer-menus-and-prompts">
85 Jawab menu dan prompt
86</h2>
87
88Dalam 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.
89
90* Untuk membatalkan menu yang dapat ditutup: tekan Escape. Promptnya berakhir dengan `or Escape to cancel`.
91* Jika Anda mengetik nomor yang tidak ada dalam daftar: Claude Code mengumumkan rentang yang valid dan membiarkan Anda mencoba lagi.
92
93Prompt ya-atau-tidak meminta jawaban yang diketik alih-alih menu dua opsi. Jawab `y` atau `n` dan tekan Enter. `yes` dan `no` juga berfungsi.
94
95<h2 id="hear-when-claude-code-needs-you">
96 Dengarkan ketika Claude Code membutuhkan Anda
97</h2>
98
99Dalam mode pembaca layar, Claude Code membunyikan bel terminal ketika membutuhkan perhatian Anda, sehingga Anda tidak perlu terus memeriksa transkrip. Bel berbunyi ketika:
100
101* Claude menyelesaikan balasan
102* prompt izin muncul
103* alat yang berjalan lebih lama dari 5 detik selesai
104
105Bel 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`](/id/settings#available-settings) ke `"terminal_bell"` untuk peringatan serupa ketika Claude menunggu Anda. Lihat [Dapatkan bel terminal atau notifikasi](/id/terminal-config#get-a-terminal-bell-or-notification).
106
107<h2 id="accessibility-settings-beyond-screen-reader-mode">
108 Pengaturan aksesibilitas di luar mode pembaca layar
109</h2>
110
111Opsi-opsi ini mengatasi kebutuhan aksesibilitas di luar mode pembaca layar. Semuanya bekerja bersama dengannya.
112
113* Variabel lingkungan [`CLAUDE_CODE_ACCESSIBILITY`](/id/env-vars) 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.
114* Pengaturan [`prefersReducedMotion`](/id/settings#available-settings) mengurangi atau menonaktifkan spinner, shimmer, dan animasi lainnya tanpa mengubah sisa antarmuka.
115* Pengaturan [`theme`](/id/settings#available-settings) memilih warna antarmuka, termasuk tema ramah buta warna `dark-daltonized` dan `light-daltonized`.
116
117<h2 id="known-limitations">
118 Batasan yang diketahui
119</h2>
120
121Beberapa perilaku tidak disesuaikan untuk mode pembaca layar:
122
123* Mode pembaca layar tidak aktif secara otomatis ketika pembaca layar sedang berjalan.
124* Perubahan mode, seperti memasuki [plan mode](/id/permission-modes#analyze-before-you-edit-with-plan-mode), belum diumumkan.
125* Melampirkan ke [sesi latar belakang](/id/agent-view) 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](/id/fullscreen). Untuk keluar, tekan Left Arrow pada prompt kosong, atau Ctrl+Z jika dialog memiliki fokus.
126* Claude Code mengumumkan biaya dalam ringkasan yang dicetak saat keluar, bukan per giliran.
127* Mode pembaca layar tidak mengubah [mode non-interaktif](/id/headless) dengan flag `-p`. Mode non-interaktif sudah menulis teks biasa dan tetap menjadi alternatif untuk scripting.
128
129<h2 id="report-an-issue">
130 Laporkan masalah
131</h2>
132
133Jika sesuatu tidak berfungsi dengan pembaca layar, pembesar, atau terminal Anda, buka masalah di [pelacak masalah Claude Code](https://github.com/anthropics/claude-code/issues) dan sebutkan teknologi bantu Anda dalam judul. Sertakan sistem operasi, aplikasi terminal, dan nama serta versi teknologi bantu Anda dalam laporan.
134
135<h2 id="related-resources">
136 Sumber daya terkait
137</h2>
138
139Halaman-halaman ini menyimpan entri referensi lengkap dan pengaturan terkait untuk apa yang halaman ini bahas:
140
141* [Settings](/id/settings#available-settings): entri `axScreenReader`, `prefersReducedMotion`, `theme`, dan `preferredNotifChannel`
142* [Environment variables](/id/env-vars): entri `CLAUDE_AX_SCREEN_READER` dan `CLAUDE_CODE_ACCESSIBILITY`
143* [CLI reference](/id/cli-reference#cli-flags): flag `--ax-screen-reader`
144* [Terminal configuration](/id/terminal-config): bel, notifikasi, dan tema di luar mode pembaca layar
145* [Non-interactive mode](/id/headless): jalankan `claude -p` yang ditulis skrip, yang menulis teks biasa tanpa mode pembaca layar