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# Installationsfehler und Anmeldungsprobleme beheben
6
7> Beheben Sie Fehler wie „Befehl nicht gefunden“, PATH, Berechtigungen, Netzwerk und Authentifizierungsfehler bei der Installation oder Anmeldung bei Claude Code.
8
9Wenn die Installation fehlschlägt oder Sie sich nicht anmelden können, finden Sie Ihren Fehler unten. Für Laufzeitprobleme nach der Installation von Claude Code siehe [Fehlerbehebung](/de/troubleshooting). Für Konfigurationsprobleme wie nicht angewendete Einstellungen oder nicht ausgelöste Hooks siehe [Konfiguration debuggen](/de/debug-your-config).
10
11## Finden Sie Ihren Fehler
12
13Ordnen Sie die Fehlermeldung oder das Symptom, das Sie sehen, einer Lösung zu:
14
15| Was Sie sehen | Lösung |
16| :------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------- |
17| `command not found: claude` oder `'claude' is not recognized` | [Beheben Sie Ihren PATH](#command-not-found-claude-after-installation) |
18| `syntax error near unexpected token '<'` | [Installationsskript gibt HTML zurück](#install-script-returns-html-instead-of-a-shell-script) |
19| `curl: (56) Failure writing output to destination` | [Überprüfen Sie die Konnektivität oder verwenden Sie ein alternatives Installationsprogramm](#curl-56-failure-writing-output-to-destination) |
20| `Killed` während der Installation unter Linux | [Fügen Sie Swap-Speicher für Server mit wenig Speicher hinzu](#install-killed-on-low-memory-linux-servers) |
21| `TLS connect error` oder `SSL/TLS secure channel` | [Aktualisieren Sie CA-Zertifikate](#tls-or-ssl-connection-errors) |
22| `Failed to fetch version` oder kann den Download-Server nicht erreichen | [Überprüfen Sie Netzwerk- und Proxy-Einstellungen](#check-network-connectivity) |
23| `irm is not recognized` oder `&& is not valid` | [Verwenden Sie den richtigen Befehl für Ihre Shell](#wrong-install-command-on-windows) |
24| `'bash' is not recognized as the name of a cmdlet` | [Verwenden Sie den Windows-Installationsbefehl](#wrong-install-command-on-windows) |
25| `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell` | [Installieren Sie eine Shell](#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell) |
26| `Claude Code does not support 32-bit Windows` | [Öffnen Sie Windows PowerShell, nicht den x86-Eintrag](#claude-code-does-not-support-32-bit-windows) |
27| `The process cannot access the file ... because it is being used by another process` | [Leeren Sie den Downloads-Ordner und versuchen Sie es erneut](#the-process-cannot-access-the-file-during-windows-install) |
28| `Error loading shared library` | [Falsche Binärvariante für Ihr System](#linux-musl-or-glibc-binary-mismatch) |
29| `Illegal instruction` | [Architektur- oder CPU-Befehlssatz-Nichtübereinstimmung](#illegal-instruction) |
30| `cannot execute binary file: Exec format error` in WSL | [WSL1 native-binary Regression](#exec-format-error-on-wsl1) |
31| PowerShell-Installationsprogramm wird abgeschlossen, aber `claude` wird nicht gefunden oder zeigt eine alte Version | [Starten Sie Ihr Terminal neu und überprüfen Sie PATH](#verify-your-path) |
32| `dyld: cannot load`, `dyld: Symbol not found` oder `Abort trap` unter macOS | [Binärinkompatibilität](#dyld-cannot-load-on-macos) |
33| `Invoke-Expression: Missing argument in parameter list` | [Installationsskript gibt HTML zurück](#install-script-returns-html-instead-of-a-shell-script) |
34| `App unavailable in region` | Claude Code ist in Ihrem Land nicht verfügbar. Siehe [unterstützte Länder](https://www.anthropic.com/supported-countries). |
35| `unable to get local issuer certificate` | [Konfigurieren Sie Unternehmens-CA-Zertifikate](#tls-or-ssl-connection-errors) |
36| `OAuth error` oder `403 Forbidden` | [Beheben Sie die Authentifizierung](#login-and-authentication) |
37| `Could not load the default credentials` oder `Could not load credentials from any providers` | [Bedrock-, Vertex- oder Foundry-Anmeldedaten](#bedrock-vertex-or-foundry-credentials-not-loading) |
38| `ChainedTokenCredential authentication failed` oder `CredentialUnavailableError` | [Bedrock-, Vertex- oder Foundry-Anmeldedaten](#bedrock-vertex-or-foundry-credentials-not-loading) |
39| `API Error: 500`, `529 Overloaded`, `429` oder andere 4xx und 5xx Fehler, die oben nicht aufgeführt sind | Siehe die [Fehlerreferenz](/de/errors) |
40
41Wenn Ihr Problem nicht aufgeführt ist, führen Sie die Diagnoseprüfungen unten durch, um die Ursache einzugrenzen.
42
43<Tip>
44 Wenn Sie das Terminal lieber ganz vermeiden möchten, können Sie mit der [Claude Code Desktop-App](/de/desktop-quickstart) Claude Code über eine grafische Benutzeroberfläche installieren und verwenden. Laden Sie sie für [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs) oder [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) herunter und beginnen Sie zu programmieren, ohne dass Sie eine Befehlszeileneinrichtung benötigen.
45</Tip>
46
47## Führen Sie Diagnoseprüfungen durch
48
49### Überprüfen Sie die Netzwerkkonnektivität
50
51Das Installationsprogramm lädt von `downloads.claude.ai` herunter. Überprüfen Sie, ob Sie es erreichen können:
52
53```bash theme={null}
54curl -sI https://downloads.claude.ai/claude-code-releases/latest
55```
56
57Eine `HTTP/2 200` Zeile bedeutet, dass Sie den Server erreicht haben. Wenn Sie keine Ausgabe, `Could not resolve host` oder ein Verbindungs-Timeout sehen, blockiert Ihr Netzwerk die Verbindung. Häufige Ursachen:
58
59* Unternehmens-Firewalls oder Proxys, die `downloads.claude.ai` blockieren
60* Regionale Netzwerkbeschränkungen: Versuchen Sie ein VPN oder ein alternatives Netzwerk
61* TLS/SSL-Probleme: Aktualisieren Sie die CA-Zertifikate Ihres Systems, oder überprüfen Sie, ob `HTTPS_PROXY` konfiguriert ist
62
63Wenn Sie sich hinter einem Unternehmens-Proxy befinden, setzen Sie `HTTPS_PROXY` und `HTTP_PROXY` auf die Adresse Ihres Proxys, bevor Sie installieren. Fragen Sie Ihr IT-Team nach der Proxy-URL, wenn Sie diese nicht kennen, oder überprüfen Sie die Proxy-Einstellungen Ihres Browsers.
64
65Dieses Beispiel setzt beide Proxy-Variablen und führt dann das Installationsprogramm über Ihren Proxy aus:
66
67<Tabs>
68 <Tab title="macOS/Linux">
69 ```bash theme={null}
70 export HTTP_PROXY=http://proxy.example.com:8080
71 export HTTPS_PROXY=http://proxy.example.com:8080
72 curl -fsSL https://claude.ai/install.sh | bash
73 ```
74 </Tab>
75
76 <Tab title="Windows PowerShell">
77 ```powershell theme={null}
78 $env:HTTP_PROXY = 'http://proxy.example.com:8080'
79 $env:HTTPS_PROXY = 'http://proxy.example.com:8080'
80 irm https://claude.ai/install.ps1 | iex
81 ```
82 </Tab>
83</Tabs>
84
85### Überprüfen Sie Ihren PATH
86
87Wenn die Installation erfolgreich war, aber Sie einen `command not found` oder `not recognized` Fehler beim Ausführen von `claude` erhalten, befindet sich das Installationsverzeichnis nicht in Ihrem PATH. Ihre Shell sucht nach Programmen in Verzeichnissen, die in PATH aufgeführt sind, und das Installationsprogramm platziert `claude` unter `~/.local/bin/claude` auf macOS/Linux oder `%USERPROFILE%\.local\bin\claude.exe` unter Windows.
88
89Überprüfen Sie, ob sich das Installationsverzeichnis in Ihrem PATH befindet, indem Sie Ihre PATH-Einträge auflisten und nach `local/bin` filtern:
90
91<Tabs>
92 <Tab title="macOS/Linux">
93 ```bash theme={null}
94 echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"
95 ```
96
97 Wenn dies `/Users/you/.local/bin` oder `/home/you/.local/bin` ausgibt, befindet sich das Verzeichnis in Ihrem PATH und Sie können zu [Überprüfen Sie auf konfliktfreie Installationen](#check-for-conflicting-installations) springen. Wenn es keine Ausgabe gibt, fügen Sie es zu Ihrer Shell-Konfiguration hinzu.
98
99 Für Zsh, das Standard auf macOS:
100
101 ```bash theme={null}
102 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
103 source ~/.zshrc
104 ```
105
106 Für Bash, das Standard auf den meisten Linux-Distributionen:
107
108 ```bash theme={null}
109 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
110 source ~/.bashrc
111 ```
112
113 Alternativ können Sie Ihr Terminal schließen und erneut öffnen.
114
115 Für andere Shells wie fish oder Nushell fügen Sie `~/.local/bin` zu Ihrem PATH mit der eigenen Konfigurationssyntax Ihrer Shell hinzu und starten Sie dann Ihr Terminal neu.
116
117 Überprüfen Sie, ob die Behebung funktioniert hat:
118
119 ```bash theme={null}
120 claude --version
121 ```
122 </Tab>
123
124 <Tab title="Windows PowerShell">
125 ```powershell theme={null}
126 $env:PATH -split ';' | Select-String '\.local\\bin'
127 ```
128
129 Wenn es keine Ausgabe gibt, fügen Sie das Installationsverzeichnis zu Ihrem Benutzer-PATH hinzu:
130
131 ```powershell theme={null}
132 $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
133 [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
134 ```
135
136 Starten Sie Ihr Terminal neu, damit die Änderung wirksam wird.
137
138 Überprüfen Sie, ob die Behebung funktioniert hat:
139
140 ```powershell theme={null}
141 claude --version
142 ```
143 </Tab>
144
145 <Tab title="Windows CMD">
146 ```batch theme={null}
147 echo %PATH% | findstr /i "local\bin"
148 ```
149
150 Wenn es keine Ausgabe gibt, öffnen Sie Systemeinstellungen, gehen Sie zu Umgebungsvariablen und fügen Sie `%USERPROFILE%\.local\bin` zu Ihrer Benutzer-PATH-Variable hinzu. Starten Sie Ihr Terminal neu.
151
152 Überprüfen Sie, ob die Behebung funktioniert hat:
153
154 ```batch theme={null}
155 claude --version
156 ```
157 </Tab>
158</Tabs>
159
160### Überprüfen Sie auf konfliktfreie Installationen
161
162Mehrere Claude Code-Installationen können zu Versionskonflikten oder unerwartetem Verhalten führen. Überprüfen Sie, was installiert ist:
163
164<Tabs>
165 <Tab title="macOS/Linux">
166 Listet alle `claude` Binärdateien auf, die in Ihrem PATH gefunden werden:
167
168 ```bash theme={null}
169 which -a claude
170 ```
171
172 Wenn dies nichts ausgibt, befindet sich noch kein `claude` in Ihrem PATH. Gehen Sie zurück zu [Überprüfen Sie Ihren PATH](#verify-your-path).
173
174 Überprüfen Sie die drei Orte, von denen eine `claude` Binärdatei stammen kann. `~/.local/bin/claude` ist das native Installationsprogramm, `~/.claude/local/` ist eine ältere lokale npm-Installation, die von älteren Versionen von Claude Code erstellt wurde, und die npm-globale Liste zeigt eine `-g` Installation:
175
176 ```bash theme={null}
177 ls -la ~/.local/bin/claude
178 ```
179
180 ```bash theme={null}
181 ls -la ~/.claude/local/
182 ```
183
184 ```bash theme={null}
185 npm -g ls @anthropic-ai/claude-code 2>/dev/null
186 ```
187 </Tab>
188
189 <Tab title="Windows PowerShell">
190 Listet alle `claude` Binärdateien auf, die in Ihrem PATH gefunden werden:
191
192 ```powershell theme={null}
193 where.exe claude
194 ```
195
196 Überprüfen Sie, ob das native Installationsprogramm eine Binärdatei platziert hat:
197
198 ```powershell theme={null}
199 Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
200 ```
201 </Tab>
202</Tabs>
203
204Wenn Sie mehrere Installationen finden, behalten Sie nur eine. Die native Installation unter `~/.local/bin/claude` auf macOS/Linux oder `%USERPROFILE%\.local\bin\claude.exe` unter Windows wird empfohlen. Entfernen Sie die zusätzlichen:
205
206Deinstallieren Sie eine globale npm-Installation:
207
208```bash theme={null}
209npm uninstall -g @anthropic-ai/claude-code
210```
211
212Entfernen Sie die ältere lokale npm-Installation:
213
214```bash theme={null}
215rm -rf ~/.claude/local
216```
217
218Unter Windows verwenden Sie PowerShell:
219
220```powershell theme={null}
221Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"
222```
223
224Entfernen Sie eine Homebrew-Installation auf macOS. Wenn Sie das `claude-code@latest` Cask installiert haben, ersetzen Sie diesen Namen:
225
226```bash theme={null}
227brew uninstall --cask claude-code
228```
229
230Entfernen Sie eine WinGet-Installation unter Windows:
231
232```powershell theme={null}
233winget uninstall Anthropic.ClaudeCode
234```
235
236### Überprüfen Sie Verzeichnisberechtigungen
237
238Das Installationsprogramm benötigt Schreibzugriff auf `~/.local/bin/` und `~/.claude/` auf macOS und Linux. Unter Windows befindet sich der Installationsort unter `%USERPROFILE%`, das standardmäßig von Ihrem Benutzer beschreibbar ist, daher gilt dieser Abschnitt dort selten.
239
240Überprüfen Sie, ob die Verzeichnisse beschreibbar sind:
241
242```bash theme={null}
243test -w ~/.local/bin && echo "writable" || echo "not writable"
244test -w ~/.claude && echo "writable" || echo "not writable"
245```
246
247Wenn eines der Verzeichnisse nicht beschreibbar ist, erstellen Sie das Installationsverzeichnis und setzen Sie Ihren Benutzer als Eigentümer:
248
249```bash theme={null}
250sudo mkdir -p ~/.local/bin
251sudo chown -R $(whoami) ~/.local
252```
253
254### Überprüfen Sie, ob die Binärdatei funktioniert
255
256Wenn `claude --version` eine Version ausgibt, aber `claude` beim Start abstürzt oder hängt, führen Sie diese Prüfungen durch, um die Ursache einzugrenzen. Wenn `claude --version` sagt, dass der Befehl nicht gefunden wurde, gehen Sie zuerst zu [Überprüfen Sie Ihren PATH](#verify-your-path); die folgenden Befehle gehen davon aus, dass `claude` in Ihrem PATH ist.
257
258Bestätigen Sie, dass die Binärdatei existiert und ausführbar ist:
259
260```bash theme={null}
261ls -la "$(command -v claude)"
262```
263
264Unter Windows verwenden Sie PowerShell:
265
266```powershell theme={null}
267Get-Command claude | Select-Object Source
268```
269
270Überprüfen Sie unter Linux auf fehlende gemeinsame Bibliotheken. Wenn `ldd` fehlende Bibliotheken anzeigt, müssen Sie möglicherweise Systempakete installieren. Auf Alpine Linux und anderen musl-basierten Distributionen siehe [Alpine Linux-Setup](/de/setup#alpine-linux-and-musl-based-distributions).
271
272```bash theme={null}
273ldd "$(command -v claude)" | grep "not found"
274```
275
276Bestätigen Sie, dass die Binärdatei ausgeführt werden kann:
277
278```bash theme={null}
279claude --version
280```
281
282## Häufige Installationsprobleme
283
284Dies sind die am häufigsten auftretenden Installationsprobleme und deren Lösungen.
285
286### Installationsskript gibt HTML statt eines Shell-Skripts zurück
287
288Beim Ausführen des Installationsbefehls können Sie einen dieser Fehler sehen:
289
290```text theme={null}
291bash: line 1: syntax error near unexpected token `<'
292bash: line 1: `<!DOCTYPE html>'
293```
294
295In PowerShell erscheint das gleiche Problem als:
296
297```text theme={null}
298Invoke-Expression: Missing argument in parameter list.
299```
300
301Dies bedeutet, dass die Installations-URL eine HTML-Seite statt des Installationsskripts zurückgegeben hat. Wenn die HTML-Seite „App unavailable in region" sagt, ist Claude Code in Ihrem Land nicht verfügbar. Siehe [unterstützte Länder](https://www.anthropic.com/supported-countries).
302
303Andernfalls kann dies aufgrund von Netzwerkproblemen, regionalen Routing-Problemen oder einer vorübergehenden Dienstunterbrechung geschehen.
304
305**Lösungen:**
306
3071. **Verwenden Sie eine alternative Installationsmethode**:
308
309 Auf macOS installieren Sie über Homebrew:
310
311 ```bash theme={null}
312 brew install --cask claude-code
313 ```
314
315 Unter Windows installieren Sie über WinGet:
316
317 ```powershell theme={null}
318 winget install Anthropic.ClaudeCode
319 ```
320
3212. **Versuchen Sie es nach einigen Minuten erneut**: Das Problem ist oft vorübergehend. Warten Sie und versuchen Sie den ursprünglichen Befehl erneut.
322
323### `command not found: claude` nach der Installation
324
325Die Installation ist abgeschlossen, aber `claude` funktioniert nicht. Die genaue Fehlermeldung variiert je nach Plattform:
326
327| Plattform | Fehlermeldung |
328| :---------- | :--------------------------------------------------------------------- |
329| macOS | `zsh: command not found: claude` |
330| Linux | `bash: claude: command not found` |
331| Windows CMD | `'claude' is not recognized as an internal or external command` |
332| PowerShell | `claude : The term 'claude' is not recognized as the name of a cmdlet` |
333
334Dies bedeutet, dass sich das Installationsverzeichnis nicht im Suchpfad Ihrer Shell befindet. Siehe [Überprüfen Sie Ihren PATH](#verify-your-path) für die Behebung auf jeder Plattform.
335
336### `curl: (56) Failure writing output to destination`
337
338Der Befehl `curl ... | bash` lädt das Skript herunter und leitet es an Bash zur Ausführung weiter. Dieser Fehler bedeutet, dass die Verbindung unterbrochen wurde, bevor das Skript vollständig heruntergeladen wurde. Häufige Ursachen sind Netzwerkunterbrechungen, der Download wird mitten im Strom blockiert oder Systemressourcenlimits.
339
340**Lösungen:**
341
3421. **Überprüfen Sie die Netzwerkstabilität**: Claude Code-Binärdateien werden unter `downloads.claude.ai` gehostet. Testen Sie, ob Sie es erreichen können:
343 ```bash theme={null}
344 curl -sI https://downloads.claude.ai/claude-code-releases/latest
345 ```
346 Eine `HTTP/2 200` Zeile bedeutet, dass Sie den Server erreicht haben und der ursprüngliche Fehler wahrscheinlich vorübergehend war; versuchen Sie den Installationsbefehl erneut. Wenn Sie `Could not resolve host` oder ein Verbindungs-Timeout sehen, blockiert Ihr Netzwerk den Download.
347
3482. **Versuchen Sie eine alternative Installationsmethode**:
349
350 Auf macOS:
351
352 ```bash theme={null}
353 brew install --cask claude-code
354 ```
355
356 Unter Windows:
357
358 ```powershell theme={null}
359 winget install Anthropic.ClaudeCode
360 ```
361
362### TLS- oder SSL-Verbindungsfehler
363
364Fehler wie `curl: (35) TLS connect error`, `schannel: next InitializeSecurityContext failed` oder PowerShells `Could not establish trust relationship for the SSL/TLS secure channel` deuten auf TLS-Handshake-Fehler hin.
365
366**Lösungen:**
367
3681. **Aktualisieren Sie Ihre System-CA-Zertifikate**:
369
370 Auf Ubuntu/Debian:
371
372 ```bash theme={null}
373 sudo apt-get update && sudo apt-get install ca-certificates
374 ```
375
376 Auf macOS verwendet das System-curl den Keychain-Vertrauensspeicher; das Aktualisieren von macOS selbst aktualisiert die Root-Zertifikate.
377
3782. **Aktivieren Sie unter Windows TLS 1.2** in PowerShell, bevor Sie das Installationsprogramm ausführen:
379 ```powershell theme={null}
380 [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
381 irm https://claude.ai/install.ps1 | iex
382 ```
383
3843. **Überprüfen Sie auf Proxy- oder Firewall-Interferenz**: Unternehmens-Proxys, die TLS-Inspektion durchführen, können diese Fehler verursachen, einschließlich `unable to get local issuer certificate` und `SELF_SIGNED_CERT_IN_CHAIN`. Für den Installationsschritt zeigen Sie curl auf Ihr Unternehmens-CA-Bundle mit `--cacert`:
385 ```bash theme={null}
386 curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash
387 ```
388 Für Claude Code selbst nach der Installation setzen Sie `NODE_EXTRA_CA_CERTS`, damit API-Anfragen dem gleichen Bundle vertrauen:
389 ```bash theme={null}
390 export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
391 ```
392 Fragen Sie Ihr IT-Team nach der Zertifikatsdatei, wenn Sie diese nicht haben. Sie können auch auf einer direkten Verbindung versuchen, um zu bestätigen, dass der Proxy die Ursache ist.
393
3944. **Unter Windows Zertifikatssperrprüfungen umgehen**, wenn Sie `CRYPT_E_NO_REVOCATION_CHECK (0x80092012)` oder `CRYPT_E_REVOCATION_OFFLINE (0x80092013)` sehen. Diese bedeuten, dass curl den Server erreicht hat, aber Ihr Netzwerk die Zertifikatssperrprüfung blockiert, was hinter Unternehmens-Firewalls häufig vorkommt. Fügen Sie `--ssl-revoke-best-effort` zum Installationsbefehl hinzu:
395 ```batch theme={null}
396 curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
397 ```
398 Alternativ installieren Sie mit `winget install Anthropic.ClaudeCode`, was curl ganz vermeidet.
399
400### `Failed to fetch version from downloads.claude.ai`
401
402Das Installationsprogramm konnte den Download-Server nicht erreichen. Dies bedeutet normalerweise, dass `downloads.claude.ai` in Ihrem Netzwerk blockiert ist.
403
404**Lösungen:**
405
4061. **Testen Sie die Konnektivität direkt**:
407 ```bash theme={null}
408 curl -sI https://downloads.claude.ai/claude-code-releases/latest
409 ```
410
4112. **Wenn Sie sich hinter einem Proxy befinden**, setzen Sie `HTTPS_PROXY`, damit das Installationsprogramm es durchleiten kann. Siehe [Proxy-Konfiguration](/de/network-config#proxy-configuration) für Details.
412 ```bash theme={null}
413 export HTTPS_PROXY=http://proxy.example.com:8080
414 curl -fsSL https://claude.ai/install.sh | bash
415 ```
416
4173. **Wenn Sie sich in einem eingeschränkten Netzwerk befinden**, versuchen Sie ein anderes Netzwerk oder VPN, oder verwenden Sie eine alternative Installationsmethode:
418
419 Auf macOS:
420
421 ```bash theme={null}
422 brew install --cask claude-code
423 ```
424
425 Unter Windows:
426
427 ```powershell theme={null}
428 winget install Anthropic.ClaudeCode
429 ```
430
431### Falscher Installationsbefehl unter Windows
432
433Wenn Sie `'irm' is not recognized`, `The token '&&' is not valid` oder `'bash' is not recognized as the name of a cmdlet` sehen, haben Sie den Installationsbefehl für eine andere Shell oder ein anderes Betriebssystem kopiert.
434
435* **`irm` nicht erkannt**: Sie befinden sich in CMD, nicht in PowerShell. Sie haben zwei Optionen:
436
437 Öffnen Sie PowerShell, indem Sie im Startmenü nach „PowerShell" suchen, und führen Sie dann den ursprünglichen Installationsbefehl aus:
438
439 ```powershell theme={null}
440 irm https://claude.ai/install.ps1 | iex
441 ```
442
443 Oder bleiben Sie in CMD und verwenden Sie stattdessen das CMD-Installationsprogramm:
444
445 ```batch theme={null}
446 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
447 ```
448
449* **`&&` nicht gültig**: Sie befinden sich in PowerShell, haben aber den CMD-Installationsbefehl ausgeführt. Verwenden Sie das PowerShell-Installationsprogramm:
450 ```powershell theme={null}
451 irm https://claude.ai/install.ps1 | iex
452 ```
453
454* **`bash` nicht erkannt**: Sie haben das macOS/Linux-Installationsprogramm unter Windows ausgeführt. Verwenden Sie stattdessen das PowerShell-Installationsprogramm:
455 ```powershell theme={null}
456 irm https://claude.ai/install.ps1 | iex
457 ```
458
459### `The process cannot access the file` während der Windows-Installation
460
461Wenn das PowerShell-Installationsprogramm mit `Failed to download binary: The process cannot access the file ... because it is being used by another process` fehlschlägt, konnte das Installationsprogramm nicht in `%USERPROFILE%\.claude\downloads` schreiben. Dies bedeutet normalerweise, dass ein vorheriger Installationsversuch noch läuft, oder Antivirus-Software scannt eine teilweise heruntergeladene Binärdatei in diesem Ordner.
462
463Schließen Sie alle anderen PowerShell-Fenster, die das Installationsprogramm ausführen, und warten Sie, bis Antivirus-Scans die Datei freigeben. Löschen Sie dann den Downloads-Ordner und führen Sie das Installationsprogramm erneut aus:
464
465```powershell theme={null}
466Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
467irm https://claude.ai/install.ps1 | iex
468```
469
470### Installation auf Linux-Servern mit wenig Speicher beendet
471
472Wenn Sie während der Installation auf einem VPS oder einer Cloud-Instanz `Killed` sehen:
473
474```text theme={null}
475Setting up Claude Code...
476Installing Claude Code native build latest...
477bash: line 142: 34803 Killed "$binary_path" install ${TARGET:+"$TARGET"}
478```
479
480Der Linux OOM-Killer hat den Prozess beendet, weil dem System der Speicher ausgegangen ist. Claude Code benötigt mindestens 4 GB verfügbaren RAM.
481
482**Lösungen:**
483
4841. **Fügen Sie Swap-Speicher hinzu**, wenn Ihr Server über begrenzte RAM verfügt. Swap verwendet Festplattenspeicher als Überlauf-Speicher, sodass die Installation auch bei wenig physischem RAM abgeschlossen werden kann.
485
486 Erstellen Sie eine 2-GB-Swap-Datei und aktivieren Sie sie:
487
488 ```bash theme={null}
489 sudo fallocate -l 2G /swapfile
490 sudo chmod 600 /swapfile
491 sudo mkswap /swapfile
492 sudo swapon /swapfile
493 ```
494
495 Versuchen Sie dann die Installation erneut:
496
497 ```bash theme={null}
498 curl -fsSL https://claude.ai/install.sh | bash
499 ```
500
5012. **Schließen Sie andere Prozesse**, um Speicher vor der Installation freizugeben.
502
5033. **Verwenden Sie eine größere Instanz**, wenn möglich. Claude Code benötigt mindestens 4 GB RAM.
504
505### Installation hängt in Docker
506
507Beim Installieren von Claude Code in einem Docker-Container kann die Installation als Root in `/` zu Hängern führen.
508
509**Lösungen:**
510
5111. **Setzen Sie ein Arbeitsverzeichnis**, bevor Sie das Installationsprogramm ausführen. Wenn es von `/` aus ausgeführt wird, scannt das Installationsprogramm das gesamte Dateisystem, was zu übermäßiger Speichernutzung führt. Das Setzen von `WORKDIR` begrenzt den Scan auf ein kleines Verzeichnis:
512 ```dockerfile theme={null}
513 WORKDIR /tmp
514 RUN curl -fsSL https://claude.ai/install.sh | bash
515 ```
516
5172. **Erhöhen Sie die Docker-Speicherlimits**, wenn Sie Docker Desktop verwenden:
518 ```bash theme={null}
519 docker build --memory=4g .
520 ```
521
522### Claude Desktop überschreibt den `claude` Befehl unter Windows
523
524Wenn Sie eine ältere Version von Claude Desktop installiert haben, kann sie eine `Claude.exe` im `WindowsApps` Verzeichnis registrieren, die PATH-Priorität über Claude Code CLI hat. Das Ausführen von `claude` öffnet die Desktop-App statt der CLI.
525
526Aktualisieren Sie Claude Desktop auf die neueste Version, um dieses Problem zu beheben.
527
528### Claude Code unter Windows benötigt entweder Git für Windows (für Bash) oder PowerShell
529
530Claude Code unter nativem Windows benötigt mindestens eine Shell: entweder [Git für Windows](https://git-scm.com/downloads/win) für Bash oder PowerShell. Wenn keine gefunden wird, erscheint dieser Fehler beim Start. Wenn nur PowerShell gefunden wird, verwendet Claude Code das PowerShell-Tool statt Bash.
531
532**Wenn keines installiert ist**, installieren Sie eines:
533
534* Git für Windows: Laden Sie es von [git-scm.com/downloads/win](https://git-scm.com/downloads/win) herunter. Wählen Sie während der Einrichtung „Add to PATH" aus. Starten Sie Ihr Terminal nach der Installation neu.
535* PowerShell 7: Laden Sie es von [aka.ms/powershell](https://aka.ms/powershell) herunter.
536
537**Wenn Git bereits installiert ist**, aber Claude Code kann es nicht finden, setzen Sie den Pfad in Ihrer [settings.json Datei](/de/settings):
538
539```json theme={null}
540{
541 "env": {
542 "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
543 }
544}
545```
546
547Wenn Ihr Git an einem anderen Ort installiert ist, finden Sie den Pfad, indem Sie `where.exe git` in PowerShell ausführen, und verwenden Sie den `bin\bash.exe` Pfad aus diesem Verzeichnis.
548
549### Claude Code unterstützt 32-Bit Windows nicht
550
551Windows enthält zwei PowerShell-Einträge im Startmenü: `Windows PowerShell` und `Windows PowerShell (x86)`. Der x86-Eintrag wird als 32-Bit-Prozess ausgeführt und löst diesen Fehler auch auf einer 64-Bit-Maschine aus. Um zu überprüfen, welcher Fall vorliegt, führen Sie dies im gleichen Fenster aus, das den Fehler verursacht hat:
552
553```powershell theme={null}
554[Environment]::Is64BitOperatingSystem
555```
556
557Wenn dies `True` ausgibt, ist Ihr Betriebssystem in Ordnung. Schließen Sie das Fenster, öffnen Sie `Windows PowerShell` ohne das x86-Suffix und führen Sie den Installationsbefehl erneut aus.
558
559Wenn dies `False` ausgibt, befinden Sie sich auf einer 32-Bit-Edition von Windows. Claude Code benötigt ein 64-Bit-Betriebssystem. Siehe die [Systemanforderungen](/de/setup#system-requirements).
560
561### Linux musl oder glibc Binärvarianten-Nichtübereinstimmung
562
563Wenn Sie nach der Installation Fehler über fehlende gemeinsame Bibliotheken wie `libstdc++.so.6` oder `libgcc_s.so.1` sehen, hat das Installationsprogramm möglicherweise die falsche Binärvariante für Ihr System heruntergeladen.
564
565```text theme={null}
566Error loading shared library libstdc++.so.6: No such file or directory
567```
568
569Dies kann auf glibc-basierten Systemen geschehen, auf denen musl-Cross-Compilation-Pakete installiert sind, was das Installationsprogramm dazu veranlasst, das System fälschlicherweise als musl zu erkennen.
570
571**Lösungen:**
572
5731. **Überprüfen Sie, welche libc Ihr System verwendet**:
574 ```bash theme={null}
575 ldd --version 2>&1 | head -1
576 ```
577 Die Ausgabe, die `GNU libc` oder `GLIBC` erwähnt, bedeutet glibc. Die Ausgabe, die `musl` erwähnt, bedeutet musl.
578
5792. **Wenn Sie auf glibc sind, aber die musl-Binärdatei erhalten haben**, entfernen Sie die Installation und installieren Sie erneut. Sie können die richtige Binärdatei auch manuell mit dem Manifest unter `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json` herunterladen. Melden Sie ein [GitHub-Problem](https://github.com/anthropics/claude-code/issues) mit der Ausgabe von `ldd --version` und `ls /lib/libc.musl*`.
580
5813. **Wenn Sie sich tatsächlich auf musl befinden**, wie Alpine Linux, installieren Sie die erforderlichen Pakete:
582 ```bash theme={null}
583 apk add libgcc libstdc++ ripgrep
584 ```
585
586### `Illegal instruction`
587
588Wenn das Ausführen von `claude` oder dem Installationsprogramm `Illegal instruction` ausgibt, verwendet die native Binärdatei CPU-Befehle, die Ihr Prozessor nicht unterstützt. Es gibt zwei unterschiedliche Ursachen.
589
590**Architektur-Nichtübereinstimmung.** Das Installationsprogramm hat die falsche Binärdatei heruntergeladen, zum Beispiel x86 auf einem ARM-Server. Überprüfen Sie mit `uname -m` auf macOS oder Linux oder `$env:PROCESSOR_ARCHITECTURE` in PowerShell. Wenn das Ergebnis nicht mit der Binärdatei übereinstimmt, die Sie erhalten haben, [melden Sie ein GitHub-Problem](https://github.com/anthropics/claude-code/issues) mit der Ausgabe.
591
592**Fehlender AVX-Befehlssatz.** Wenn Ihre Architektur korrekt ist, aber Sie immer noch `Illegal instruction` sehen, fehlt Ihrer CPU wahrscheinlich AVX oder ein anderer Befehl, den die Binärdatei benötigt. Dies betrifft ungefähr Intel- und AMD-Prozessoren vor 2013 und virtuelle Maschinen, bei denen der Hypervisor AVX nicht an den Gast durchleitet.
593
594Auf einem VPS oder einer VM führen Sie `grep -m1 -ow avx /proc/cpuinfo` aus; ein leeres Ergebnis bedeutet, dass AVX für den Gast nicht verfügbar ist.
595
596Es gibt keine native-binary Umgehung; verfolgen Sie [Problem #50384](https://github.com/anthropics/claude-code/issues/50384) für den Status und geben Sie Ihr CPU-Modell von `grep -m1 "model name" /proc/cpuinfo` unter Linux oder `sysctl -n machdep.cpu.brand_string` auf macOS an, wenn Sie es melden.
597
598Alternative Installationsmethoden laden die gleiche native Binärdatei herunter und werden keine der beiden Ursachen beheben.
599
600### `dyld: cannot load` auf macOS
601
602Wenn Sie während der Installation `dyld: cannot load`, `dyld: Symbol not found` oder `Abort trap: 6` sehen, ist die Binärdatei mit Ihrer macOS-Version oder Hardware nicht kompatibel.
603
604```text theme={null}
605dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)
606Abort trap: 6
607```
608
609Ein `Symbol not found` Fehler, der auf `libicucore` verweist, zeigt auch an, dass Ihre macOS-Version älter ist als die Binärdatei unterstützt:
610
611```text theme={null}
612dyld: Symbol not found: _ubrk_clone
613 Referenced from: claude-darwin-x64 (which was built for Mac OS X 13.0)
614 Expected in: /usr/lib/libicucore.A.dylib
615```
616
617**Lösungen:**
618
6191. **Überprüfen Sie Ihre macOS-Version**: Claude Code benötigt macOS 13.0 oder später. Öffnen Sie das Apple-Menü und wählen Sie „Über diesen Mac", um Ihre Version zu überprüfen.
620
6212. **Aktualisieren Sie macOS**, wenn Sie eine ältere Version verwenden. Die Binärdatei verwendet Befehle und Systembibliotheken, die ältere macOS-Versionen nicht unterstützen. Alternative Installationsmethoden wie Homebrew laden die gleiche Binärdatei herunter und werden diesen Fehler nicht beheben.
622
623### `Exec format error` auf WSL1
624
625Wenn das Ausführen von `claude` in WSL `cannot execute binary file: Exec format error` ausgibt, befinden Sie sich auf WSL1 und treffen auf eine bekannte native-binary Regression, die in [Problem #38788](https://github.com/anthropics/claude-code/issues/38788) verfolgt wird. Die Programm-Header der Binärdatei haben sich auf eine Weise geändert, die der WSL1-Loader nicht verarbeiten kann.
626
627Die sauberste Behebung ist die Konvertierung Ihrer Distribution zu WSL2 von PowerShell:
628
629```powershell theme={null}
630wsl --set-version <DistroName> 2
631```
632
633Wenn Sie auf WSL1 bleiben müssen, rufen Sie die Binärdatei über den dynamischen Linker auf. Fügen Sie diese Funktion zu `~/.bashrc` in WSL hinzu, ersetzen Sie den Pfad, wenn sich Ihr Home-Verzeichnis unterscheidet:
634
635```bash theme={null}
636claude() {
637 /lib64/ld-linux-x86-64.so.2 "$(readlink -f "$HOME/.local/bin/claude")" "$@"
638}
639```
640
641Führen Sie dann `source ~/.bashrc` aus und versuchen Sie `claude` erneut.
642
643### npm-Installationsfehler in WSL
644
645Diese Probleme gelten, wenn Sie Claude Code mit `npm install -g` in WSL installiert haben. Wenn Sie das [native Installationsprogramm](/de/setup) verwendet haben, überspringen Sie diesen Abschnitt.
646
647**Betriebssystem- oder Plattformerkennung Probleme.** Wenn npm während der Installation einen Plattform-Nichtübereinstimmung meldet, verwendet WSL wahrscheinlich das Windows `npm`. Führen Sie zuerst `npm config set os linux` aus, dann installieren Sie mit `npm install -g @anthropic-ai/claude-code --force`. Verwenden Sie nicht `sudo`.
648
649**`exec: node: not found` beim Ausführen von `claude`.** Ihre WSL-Umgebung verwendet wahrscheinlich die Windows-Installation von Node.js. Bestätigen Sie mit `which npm` und `which node`: Pfade, die mit `/mnt/c/` beginnen, sind Windows-Binärdateien, während Linux-Pfade mit `/usr/` beginnen. Um dies zu beheben, installieren Sie Node über den Paketmanager Ihrer Linux-Distribution oder über [`nvm`](https://github.com/nvm-sh/nvm).
650
651**nvm Versionskonflikte.** Wenn Sie nvm sowohl in WSL als auch in Windows installiert haben, kann das Wechseln von Node-Versionen in WSL fehlschlagen, da WSL standardmäßig den Windows-PATH importiert und das Windows-nvm Priorität hat. Die häufigste Ursache ist, dass nvm nicht in Ihrer Shell geladen wird. Fügen Sie den nvm-Loader zu `~/.bashrc` oder `~/.zshrc` hinzu:
652
653```bash theme={null}
654export NVM_DIR="$HOME/.nvm"
655[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
656[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
657```
658
659Oder laden Sie es in Ihrer aktuellen Sitzung:
660
661```bash theme={null}
662source ~/.nvm/nvm.sh
663```
664
665Wenn nvm geladen ist, aber Windows-Pfade immer noch Priorität haben, stellen Sie Ihren Linux-Node-Pfad explizit voran:
666
667```bash theme={null}
668export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"
669```
670
671<Warning>
672 Vermeiden Sie das Deaktivieren des Windows-PATH-Imports über `appendWindowsPath = false`, da dies die Möglichkeit bricht, Windows-Ausführbare aus WSL aufzurufen. Vermeiden Sie auch das Deinstallieren von Node.js von Windows, wenn Sie es für Windows-Entwicklung verwenden.
673</Warning>
674
675### Berechtigungsfehler während der Installation
676
677Wenn das native Installationsprogramm mit Berechtigungsfehlern fehlschlägt, ist das Zielverzeichnis möglicherweise nicht beschreibbar. Siehe [Überprüfen Sie Verzeichnisberechtigungen](#check-directory-permissions).
678
679Wenn Sie zuvor mit npm installiert haben und npm-spezifische Berechtigungsfehler erhalten, wechseln Sie zum nativen Installationsprogramm:
680
681```bash theme={null}
682curl -fsSL https://claude.ai/install.sh | bash
683```
684
685### Native Binärdatei nicht gefunden nach npm-Installation
686
687Das `@anthropic-ai/claude-code` npm-Paket zieht die native Binärdatei durch eine pro-Plattform optionale Abhängigkeit wie `@anthropic-ai/claude-code-darwin-arm64` ein. Wenn das Ausführen von `claude` nach der Installation `Could not find native binary package "@anthropic-ai/claude-code-<platform>"` ausgibt, überprüfen Sie die folgenden Ursachen:
688
689* **Optionale Abhängigkeiten sind deaktiviert.** Entfernen Sie `--omit=optional` aus Ihrem npm-Installationsbefehl, `--no-optional` von pnpm oder `--ignore-optional` von yarn, und überprüfen Sie, dass `.npmrc` nicht `optional=false` setzt. Dann installieren Sie erneut. Die native Binärdatei wird nur als optionale Abhängigkeit bereitgestellt, daher gibt es keinen JavaScript-Fallback, wenn sie übersprungen wird.
690* **Nicht unterstützte Plattform.** Vorkompilierte Binärdateien werden für `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64` und `win32-arm64` veröffentlicht. Claude Code liefert keine Binärdatei für andere Plattformen; siehe die [Systemanforderungen](/de/setup#system-requirements).
691* **Unternehmens-npm-Spiegel fehlen die Plattform-Pakete.** Stellen Sie sicher, dass Ihr Registry alle acht `@anthropic-ai/claude-code-*` Plattform-Pakete zusätzlich zum Meta-Paket spiegelt.
692
693Die Installation mit `--ignore-scripts` löst diesen Fehler nicht aus. Der Postinstall-Schritt, der die Binärdatei verknüpft, wird übersprungen, daher fällt Claude Code auf einen Wrapper zurück, der die Plattform-Binärdatei bei jedem Start findet und startet. Dies funktioniert, aber startet langsamer; installieren Sie mit aktivierten Skripten für direkte Ausführung erneut.
694
695## Anmeldung und Authentifizierung
696
697Diese Abschnitte behandeln Anmeldungsfehler, OAuth-Fehler und Token-Probleme.
698
699### Setzen Sie Ihre Anmeldung zurück
700
701Wenn die Anmeldung fehlschlägt und die Ursache nicht offensichtlich ist, löst eine saubere Neuer-Authentifizierung die meisten Fälle:
702
7031. Führen Sie `/logout` aus, um sich vollständig abzumelden
7042. Schließen Sie Claude Code
7053. Starten Sie mit `claude` neu und schließen Sie den Authentifizierungsprozess ab
706
707Wenn der Browser während der Anmeldung nicht automatisch geöffnet wird, drücken Sie `c`, um die OAuth-URL in Ihre Zwischenablage zu kopieren, und fügen Sie sie dann manuell in einen Browser ein. Dies funktioniert auch, wenn die URL in einem schmalen oder SSH-Terminal über mehrere Zeilen verläuft und nicht direkt angeklickt werden kann.
708
709### OAuth-Fehler: Ungültiger Code
710
711Wenn Sie `OAuth error: Invalid code. Please make sure the full code was copied` sehen, ist der Anmeldecode abgelaufen oder wurde beim Kopieren und Einfügen gekürzt.
712
713**Lösungen:**
714
715* Drücken Sie Enter, um zu wiederholen und die Anmeldung schnell nach dem Öffnen des Browsers abzuschließen
716* Geben Sie `c` ein, um die vollständige URL zu kopieren, wenn der Browser nicht automatisch geöffnet wird
717* Wenn Sie eine Remote-/SSH-Sitzung verwenden, kann der Browser auf der falschen Maschine geöffnet werden. Kopieren Sie die im Terminal angezeigte URL und öffnen Sie sie stattdessen in Ihrem lokalen Browser.
718
719### 403 Forbidden nach der Anmeldung
720
721Wenn Sie `API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}}` nach der Anmeldung sehen:
722
723* **Claude Pro/Max-Benutzer**: Überprüfen Sie, dass Ihr Abonnement unter [claude.ai/settings](https://claude.ai/settings) aktiv ist
724* **Anthropic Console-Benutzer**: Bestätigen Sie, dass Ihr Konto die Rolle „Claude Code" oder „Developer" hat. Admins weisen dies in der Anthropic Console unter Einstellungen → Mitglieder zu.
725* **Hinter einem Proxy**: Unternehmens-Proxys können API-Anfragen beeinträchtigen. Siehe [Netzwerkkonfiguration](/de/network-config) für Proxy-Einrichtung.
726
727### Diese Organisation wurde mit einem aktiven Abonnement deaktiviert
728
729Wenn Sie `API Error: 400 ... "This organization has been disabled"` sehen, obwohl Sie ein aktives Claude-Abonnement haben, überschreibt eine `ANTHROPIC_API_KEY` Umgebungsvariable Ihr Abonnement. Dies geschieht häufig, wenn ein alter API-Schlüssel von einem früheren Arbeitgeber oder Projekt noch in Ihrem Shell-Profil gesetzt ist.
730
731Wenn `ANTHROPIC_API_KEY` vorhanden ist und Sie es genehmigt haben, verwendet Claude Code diesen Schlüssel statt der OAuth-Anmeldedaten Ihres Abonnements. Im nicht-interaktiven Modus mit dem `-p` Flag wird der Schlüssel immer verwendet, wenn er vorhanden ist. Siehe [Authentifizierungs-Priorität](/de/authentication#authentication-precedence) für die vollständige Auflösungsreihenfolge.
732
733Um stattdessen Ihr Abonnement zu verwenden, heben Sie die Umgebungsvariable auf und entfernen Sie sie aus Ihrem Shell-Profil:
734
735```bash theme={null}
736unset ANTHROPIC_API_KEY
737claude
738```
739
740Überprüfen Sie `~/.zshrc`, `~/.bashrc` oder `~/.profile` auf `export ANTHROPIC_API_KEY=...` Zeilen und entfernen Sie sie, um die Änderung dauerhaft zu machen. Unter Windows überprüfen Sie Ihr PowerShell-Profil unter `$PROFILE` und Ihre Benutzer-Umgebungsvariablen auf `ANTHROPIC_API_KEY`. Führen Sie `/status` in Claude Code aus, um zu bestätigen, welche Authentifizierungsmethode aktiv ist.
741
742### OAuth-Anmeldung schlägt in WSL2, SSH oder Containern fehl
743
744Wenn Claude Code in WSL2, auf einem Remote-Rechner über SSH oder in einem Container ausgeführt wird, öffnet sich der Browser normalerweise auf einem anderen Host und seine Umleitung kann Claude Code's lokalen Callback-Server nicht erreichen. Nachdem Sie sich anmelden, zeigt der Browser einen Anmeldecode statt einer automatischen Umleitung an. Fügen Sie diesen Code in das Terminal bei der Aufforderung `Paste code here if prompted` ein, um die Anmeldung abzuschließen.
745
746Wenn der Browser überhaupt nicht aus WSL2 geöffnet wird, setzen Sie die `BROWSER` Umgebungsvariable auf Ihren Windows-Browser-Pfad:
747
748```bash theme={null}
749export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
750claude
751```
752
753Alternativ drücken Sie `c` bei der interaktiven Anmeldungsaufforderung, um die OAuth-URL zu kopieren, oder kopieren Sie die URL, die `claude auth login` ausgibt, und öffnen Sie sie in einem Browser auf Ihrem lokalen Rechner.
754
755Wenn das Einfügen des Codes in die interaktive Aufforderung nichts bewirkt, erreicht die Paste-Bindung Ihres Terminals wahrscheinlich nicht das Eingabefeld. Versuchen Sie die alternative Paste-Verknüpfung Ihres Terminals, oft Rechtsklick oder Shift+Insert in Windows Terminal, oder verwenden Sie stattdessen `claude auth login`, das den eingefügten Code aus der Standardeingabe liest:
756
757```bash theme={null}
758claude auth login
759```
760
761Dieser Fallback gilt auch auf nativem Windows oder jedem Terminal, bei dem das Einfügen in die interaktive Aufforderung fehlschlägt.
762
763### Nicht angemeldet oder Token abgelaufen
764
765Wenn Claude Code Sie nach einer Sitzung erneut zur Anmeldung auffordert, ist Ihr OAuth-Token möglicherweise abgelaufen.
766
767Führen Sie `/login` aus, um sich erneut zu authentifizieren. Wenn dies häufig geschieht, überprüfen Sie, dass Ihre Systemuhr genau ist, da die Token-Validierung von korrekten Zeitstempeln abhängt.
768
769Auf macOS kann die Anmeldung auch fehlschlagen, wenn der Keychain gesperrt ist oder sein Passwort nicht mit Ihrem Kontopasswort synchronisiert ist, was Claude Code daran hindert, Anmeldedaten zu speichern. Führen Sie `claude doctor` aus, um den Keychain-Zugriff zu überprüfen. Um den Keychain manuell zu entsperren, führen Sie `security unlock-keychain ~/Library/Keychains/login.keychain-db` aus. Wenn das Entsperren nicht hilft, öffnen Sie Keychain Access, wählen Sie den `login` Keychain und wählen Sie Bearbeiten > Passwort für Keychain „login" ändern, um es mit Ihrem Kontopasswort zu resynchronisieren.
770
771### Bedrock-, Vertex- oder Foundry-Anmeldedaten werden nicht geladen
772
773Wenn Sie Claude Code für die Verwendung eines Cloud-Anbieters konfiguriert haben und `Could not load credentials from any providers` auf Bedrock, `Could not load the default credentials` auf Vertex oder `ChainedTokenCredential authentication failed` auf Foundry sehen, ist Ihre Cloud-Anbieter-CLI wahrscheinlich nicht in der aktuellen Shell authentifiziert.
774
775Für Bedrock bestätigen Sie, dass Ihre AWS-Anmeldedaten gültig sind:
776
777```bash theme={null}
778aws sts get-caller-identity
779```
780
781Für Vertex AI bestätigen Sie, dass `ANTHROPIC_VERTEX_PROJECT_ID` und `CLOUD_ML_REGION` in Ihrer Shell gesetzt sind, dann setzen Sie Anwendungs-Standard-Anmeldedaten:
782
783```bash theme={null}
784gcloud auth application-default login
785```
786
787Für Microsoft Foundry bestätigen Sie, dass `ANTHROPIC_FOUNDRY_API_KEY` gesetzt ist, oder melden Sie sich mit der Azure CLI an, damit die Standard-Anmeldedaten-Kette Ihr Konto finden kann:
788
789```bash theme={null}
790az login
791```
792
793Wenn Anmeldedaten in Ihrem Terminal funktionieren, aber nicht in der VS Code oder JetBrains-Erweiterung, hat der IDE-Prozess wahrscheinlich Ihre Shell-Umgebung nicht geerbt. Setzen Sie die Anbieter-Umgebungsvariablen in den IDE-eigenen Einstellungen, oder starten Sie die IDE von einem Terminal aus, in dem sie bereits exportiert sind.
794
795Siehe [Amazon Bedrock](/de/amazon-bedrock), [Google Vertex AI](/de/google-vertex-ai) oder [Microsoft Foundry](/de/microsoft-foundry) für die vollständige Anbieter-Einrichtung.
796
797## Immer noch festgefahren
798
799Wenn keine der obigen Lösungen Ihr Problem behebt:
800
8011. Überprüfen Sie das [GitHub-Repository](https://github.com/anthropics/claude-code/issues) auf bekannte Probleme, oder öffnen Sie ein neues mit Ihrem Betriebssystem, dem Installationsbefehl, den Sie ausgeführt haben, und der vollständigen Fehlerausgabe
8022. Wenn `claude --version` funktioniert, aber etwas anderes ist falsch, führen Sie `claude doctor` aus, um einen automatisierten Diagnosebericht zu erhalten
8033. Wenn Sie eine Sitzung starten können, verwenden Sie `/feedback` in Claude Code, um das Problem zu melden
