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# Claude Code mit einem Bildschirmleser verwenden
6
7> Richten Sie Claude Code für Bildschirmleser wie VoiceOver und NVDA ein, sowie Einstellungen für Bildschirmlupe, reduzierte Bewegung und farbenblindfreundliche Designs.
8
9Claude Code verfügt über einen Bildschirmleser-Modus, der die visuelle Terminaloberfläche durch einfachen, linearen Text ersetzt. Anstelle von Kästchen, Fortschrittsanimationen und direkten Neuzeichnungen gibt der Modus beschriftete Zeilen aus, die ein Bildschirmleser wie VoiceOver oder NVDA der Reihe nach vorliest, sodass Sie ein vollständiges Gespräch führen, Werkzeugberechtigungen genehmigen und die Ausgabe von Anfang bis Ende überprüfen können.
10
11Der Bildschirmleser-Modus ist optional. Wenn Sie stattdessen eine Bildschirmlupe, reduzierte Bewegung oder ein farbenblindfreundliches Design verwenden, siehe [Barrierefreiheitseinstellungen außerhalb des Bildschirmleser-Modus](#accessibility-settings-beyond-screen-reader-mode).
12
13<Note>
14 Der Bildschirmleser-Modus erfordert Claude Code v2.1.181 oder später. Frühere Versionen lehnen das Flag `--ax-screen-reader` mit `error: unknown option '--ax-screen-reader'` ab.
15</Note>
16
17<h2 id="turn-on-screen-reader-mode">
18 Bildschirmleser-Modus aktivieren
19</h2>
20
21Wählen Sie die Methode, die Ihrer Häufigkeit der Bildschirmleser-Nutzung entspricht:
22
23* Für eine Sitzung: Führen Sie `claude --ax-screen-reader` aus.
24* Für Sitzungen, die von einer Shell aus gestartet werden: Setzen Sie die Umgebungsvariable `CLAUDE_AX_SCREEN_READER` auf `1`. In Bash oder Zsh führen Sie `export CLAUDE_AX_SCREEN_READER=1` aus; in PowerShell führen Sie `$env:CLAUDE_AX_SCREEN_READER = "1"` aus. Fügen Sie die Zeile zu Ihrem Shell-Profil hinzu, um alle Shells abzudecken.
25* Für jede Sitzung auf dem Computer: Fügen Sie `"axScreenReader": true` zu Ihrer Benutzerdatei [Einstellungsdatei](/de/settings) hinzu. Dies deckt jedes Terminal ab, einschließlich des integrierten VS Code-Terminals.
26
27<Note>
28 Die Methoden sind in Prioritätsreihenfolge aufgelistet: Das Flag [`--ax-screen-reader`](/de/cli-reference#cli-flags) überschreibt die Umgebungsvariable [`CLAUDE_AX_SCREEN_READER`](/de/env-vars), die die Einstellung [`axScreenReader`](/de/settings#available-settings) überschreibt.
29</Note>
30
31Wenn Sie Claude Code über SSH verwenden, setzen Sie die Umgebungsvariable oder Einstellung auf dem Remote-Computer, auf dem Claude Code ausgeführt wird.
32
33Wenn der Modus aktiviert ist, gibt Claude Code zunächst eine Bestätigungszeile aus, die die Methode benennt, die ihn aktiviert hat: `[Screen Reader Mode: on via flag]`, `[Screen Reader Mode: on via env]` oder `[Screen Reader Mode: on via settings]`; dieses Methodenbenennungsformat erfordert Claude Code v2.1.206 oder später.
34{/* max-version: 2.1.205 */}Frühere Versionen geben `[Accessible screen reader mode: on]` aus.
35
36<h2 id="turn-off-screen-reader-mode">
37 Bildschirmleser-Modus deaktivieren
38</h2>
39
40Kehren Sie die Methode um, die den Modus aktiviert hat: Starten Sie ohne das Flag, heben Sie die Umgebungsvariable auf, oder setzen Sie `axScreenReader` auf `false`. Das Setzen von `CLAUDE_AX_SCREEN_READER=0` hält den Modus aus, auch wenn die Einstellung `true` ist.
41
42<h2 id="what-your-screen-reader-hears">
43 Was Ihr Bildschirmleser hört
44</h2>
45
46Im Bildschirmleser-Modus schreibt Claude Code flachen Text:
47
48* keine Zeichnungszeichen für die Oberflächenelemente
49* keine nur farbbasierten Hinweise
50* keine Neuzeichnungen von Inhalten, die sich nicht geändert haben; Fortschrittsanzeigen werden als statischer Text dargestellt
51* Tabellen in Claudes Antworten werden als `Header: value`-Sätze statt als Zeichnungsgitter gelesen. {/* min-version: 2.1.198 */}Erfordert Claude Code v2.1.198 oder später; frühere Versionen zeichnen Tabellen auch im Bildschirmleser-Modus als Gitter.
52
53Die Ausgabe sammelt sich im Scrollback Ihres Terminals an, sodass Sie frühere Züge mit den Überprüfungsbefehlen Ihres Bildschirmlesers oder der Suchfunktion Ihres Terminals erneut lesen können.
54
55Der Bildschirmleser-Modus wird als einfacher scrollender Text dargestellt, auch wenn Sie das [Vollbildrendering](/de/fullscreen) mit der Einstellung [`tui`](/de/settings#available-settings) aktiviert haben; die Einstellung hat keine Auswirkung, während der Modus aktiv ist. Angehängte Hintergrundsitzungen werden weiterhin im Vollbildmodus dargestellt; siehe [Bekannte Einschränkungen](#known-limitations).
56
57Jede Nachricht im Transkript beginnt mit einer Beschriftung, die Ihr Bildschirmleser ankündigt und benennt, was es ist: Ihre Nachrichten, Claudes Antworten, Werkzeugaktivität, Fehler und Eingabeaufforderungen. Die Beschriftungen sind auch durchsuchbar, sodass Sie zwischen Abschnitten des Transkripts springen können, indem Sie den Scrollback Ihres Terminals durchsuchen:
58
59| Beschriftung | Bedeutung |
60| :--------------------- | :----------------------------------------------------------------------------------------------------------- |
61| `you:` | Ihre Nachrichten |
62| `claude:` | Claudes Antworten |
63| `tool:` | Werkzeugaktivität, z. B. eine Dateibearbeitung oder ein ausgeführter Befehl |
64| `tool error:` | Ein Werkzeug, das fehlgeschlagen ist |
65| `error:` | Ein Fehler in der Konversation, z. B. eine fehlgeschlagene API-Anfrage |
66| `Permission Required:` | Eine Berechtigungsaufforderung, die auf Ihre Antwort wartet |
67| `Cost:` | Die Sitzungskostenzusammenfassung, wenn Claude Code beendet wird, wenn Ihr Konto [Kosten anzeigt](/de/costs) |
68
69Der Terminal-Cursor folgt der Eingabemarke, sodass der Befehl zum Lesen der aktuellen Zeile eines Bildschirmlesers die Frage „Wo bin ich?" mit der Eingabeaufforderung beantwortet, die Sie bearbeiten.
70
71<h3 id="jump-between-turns">
72 Zwischen Zügen springen
73</h3>
74
75Claude Code gibt OSC 133-Shell-Integrations-Marker an Zuggrenzen aus, sodass die Taste zum Springen zur vorherigen Eingabeaufforderung Ihres Terminals zwischen Zügen wechselt, ohne das gesamte Transkript zu lesen:
76
77* iTerm2: Cmd+Shift+Up
78* VS Code-Terminal: Ctrl+Up unter Windows, Cmd+Up auf macOS
79* Windows Terminal: Standardmäßig keine Taste; binden Sie die Aktion `scrollToMark` in seinen Einstellungen
80* Kitty und Ghostty: Überprüfen Sie die Dokumentation des Terminals auf seine Taste zum Springen zur Eingabeaufforderung
81
82macOS Terminal reagiert nicht auf die Marker, und Claude Code gibt sie in WezTerm nicht aus. Durchsuchen Sie in diesen Terminals stattdessen den Scrollback nach der Beschriftung `you:`.
83
84<h2 id="answer-menus-and-prompts">
85 Menüs und Eingabeaufforderungen beantworten
86</h2>
87
88Im Bildschirmleser-Modus werden Menüs, die Sie normalerweise mit den Pfeiltasten navigieren würden, einschließlich Berechtigungsaufforderungen, zu nummerierten Listen. Jede Option wird als nummerierte Zeile angekündigt, gefolgt von einer Eingabeaufforderung `Enter selection`, die den gültigen Bereich benennt. Geben Sie die Nummer der gewünschten Option ein und drücken Sie die Eingabetaste.
89
90* Um ein verwerfbares Menü abzubrechen: Drücken Sie Escape. Seine Eingabeaufforderung endet mit `or Escape to cancel`.
91* Wenn Sie eine Nummer eingeben, die nicht auf der Liste steht: Claude Code kündigt den gültigen Bereich an und lässt Sie es erneut versuchen.
92
93Ja-oder-Nein-Aufforderungen fragen nach einer eingegebenen Antwort statt eines Zwei-Optionen-Menüs. Antworten Sie mit `y` oder `n` und drücken Sie die Eingabetaste. `yes` und `no` funktionieren auch.
94
95<h2 id="hear-when-claude-code-needs-you">
96 Hören Sie, wenn Claude Code Sie braucht
97</h2>
98
99Im Bildschirmleser-Modus läutet Claude Code die Terminal-Glocke, wenn es Ihre Aufmerksamkeit braucht, sodass Sie nicht ständig das Transkript überprüfen müssen. Die Glocke läutet, wenn:
100
101* Claude eine Antwort beendet
102* eine Berechtigungsaufforderung erscheint
103* ein Werkzeug, das länger als 5 Sekunden lief, beendet wird
104
105Die Glocke ist die Standard-Warnung Ihres Terminals. Um sie stummzuschalten, ändern Sie die Glockeneinstellung in Ihrer Terminalanwendung. Die Glocke erfordert keinen Bildschirmleser-Modus: Außerhalb des Modus setzen Sie [`preferredNotifChannel`](/de/settings#available-settings) auf `"terminal_bell"` für ähnliche Warnungen, wenn Claude auf Sie wartet. Siehe [Terminal-Glocke oder Benachrichtigung erhalten](/de/terminal-config#get-a-terminal-bell-or-notification).
106
107<h2 id="accessibility-settings-beyond-screen-reader-mode">
108 Barrierefreiheitseinstellungen außerhalb des Bildschirmleser-Modus
109</h2>
110
111Diese Optionen behandeln Barrierefreiheitsanforderungen außerhalb des Bildschirmleser-Modus. Alle funktionieren zusammen mit ihm.
112
113* Die Umgebungsvariable `CLAUDE_CODE_ACCESSIBILITY` [environment variable](/de/env-vars) ist für Bildschirmlupe. Setzen Sie `CLAUDE_CODE_ACCESSIBILITY=1`, um den nativen Terminal-Cursor sichtbar zu halten, damit Lupen wie macOS Zoom die Cursor-Position verfolgen können.
114* Die Einstellung `prefersReducedMotion` [setting](/de/settings#available-settings) reduziert oder deaktiviert Spinner, Shimmer und andere Animationen, ohne den Rest der Oberfläche zu ändern.
115* Die Einstellung `theme` [setting](/de/settings#available-settings) wählt die Oberflächenfarben aus, einschließlich der farbenblindfreundlichen Designs `dark-daltonized` und `light-daltonized`.
116
117<h2 id="known-limitations">
118 Bekannte Einschränkungen
119</h2>
120
121Einige Verhaltensweisen sind nicht für den Bildschirmleser-Modus angepasst:
122
123* Der Bildschirmleser-Modus wird nicht automatisch aktiviert, wenn ein Bildschirmleser ausgeführt wird.
124* Modusänderungen, z. B. das Eingeben des [Plan-Modus](/de/permission-modes#analyze-before-you-edit-with-plan-mode), werden noch nicht angekündigt.
125* Das Anhängen an eine [Hintergrundsitzung](/de/agent-view) mit `claude attach` oder aus der Agent-Ansicht betritt den alternativen Bildschirm des Terminals, der keinen nativen Scrollback hat. Dies ist das [gleiche Verhalten wie bei anderen angehängten Sitzungen](/de/fullscreen). Um herauszukommen, drücken Sie den linken Pfeil bei einer leeren Eingabeaufforderung oder Ctrl+Z, wenn ein Dialog den Fokus hat.
126* Claude Code kündigt Kosten in der Zusammenfassung an, die es beim Beenden ausgibt, nicht pro Zug.
127* Der Bildschirmleser-Modus ändert den [nicht-interaktiven Modus](/de/headless) mit dem Flag `-p` nicht. Der nicht-interaktive Modus schreibt bereits einfachen Text und bleibt eine Alternative zum Scripting.
128
129<h2 id="report-an-issue">
130 Problem melden
131</h2>
132
133Wenn etwas mit Ihrem Bildschirmleser, Ihrer Lupe oder Ihrem Terminal nicht funktioniert, öffnen Sie ein Problem im [Claude Code Issue Tracker](https://github.com/anthropics/claude-code/issues) und erwähnen Sie Ihre Hilfstechnologie im Titel. Fügen Sie Ihr Betriebssystem, Ihre Terminalanwendung sowie den Namen und die Version Ihrer Hilfstechnologie in den Bericht ein.
134
135<h2 id="related-resources">
136 Verwandte Ressourcen
137</h2>
138
139Diese Seiten enthalten die vollständigen Referenzeinträge und verwandte Einrichtung für das, was diese Seite behandelt:
140
141* [Einstellungen](/de/settings#available-settings): die Einträge `axScreenReader`, `prefersReducedMotion`, `theme` und `preferredNotifChannel`
142* [Umgebungsvariablen](/de/env-vars): die Einträge `CLAUDE_AX_SCREEN_READER` und `CLAUDE_CODE_ACCESSIBILITY`
143* [CLI-Referenz](/de/cli-reference#cli-flags): das Flag `--ax-screen-reader`
144* [Terminal-Konfiguration](/de/terminal-config): Glocken, Benachrichtigungen und Designs außerhalb des Bildschirmleser-Modus
145* [Nicht-interaktiver Modus](/de/headless): Skriptgesteuerte `claude -p`-Läufe, die einfachen Text ohne Bildschirmleser-Modus schreiben