WissenClaude Code & Vibe Coding
Claude Code Fehler beim ersten Setup, die häufigsten Stolpersteine
Ein nicht gefundener Befehl, eine stille Rechnung obwohl du ein Abo hast, eine Anmeldung, die einfach nicht durchgeht. Die häufigsten Fehler beim Einrichten von Claude Code und wie du sie findest.
Du installierst Claude Code, tippst claude ins Terminal, und bekommst nur eine Fehlermeldung zurück. Genau an dieser Stelle scheitern die meisten, nicht an der eigentlichen Arbeit mit dem Agenten danach, sondern an fünf, sechs bekannten Stolpersteinen davor.
Kurz gesagt
Die häufigsten Fehler beim Einrichten von Claude Code fallen in wenige Kategorien: der Befehl wird nicht gefunden, weil der Installationsordner im PATH fehlt, die Anmeldung hängt, oder eine vergessene Umgebungsvariable rechnet heimlich über die API ab statt über dein Abo. Der Befehl claude doctor prüft die häufigsten Ursachen automatisch. Unter Windows ist die native PowerShell Pflicht, Git Bash unterstützt die nötigen Terminal-Funktionen nicht.
Der Befehl wird nicht gefunden
Der klassische erste Fehler unter Windows: claude wird von der Kommandozeile nicht erkannt. Die ausführbare Datei landet standardmäßig unter %USERPROFILE%\.local\bin\claude.exe, dieser Ordner muss aber in der PATH-Variable deiner Shell eingetragen sein, sonst weiß Windows nicht, wo es suchen soll. Seit 2025 gibt es einen nativen Windows-Installer, der ohne den Umweg über WSL auskommt, was die Installation deutlich vereinfacht hat, aber genau deshalb landen ältere Installationsanleitungen, die noch WSL voraussetzen, schnell auf dem falschen Pfad.
Genauso wichtig, aber oft übersehen: die richtige Shell. Claude Code braucht Terminalfunktionen, die Git Bash schlicht nicht mitbringt. Empfohlen ist die native Windows PowerShell, nicht die 32-Bit-Version, nicht die klassische Eingabeaufforderung.
Die Anmeldung hängt oder schlägt fehl
Ein zweiter häufiger Block ist die Authentifizierung. Der zuverlässigste Weg aus einer feststeckenden Anmeldung: /logout ausführen, Claude Code vollständig beenden, claude neu starten und dich frisch anmelden. Das behebt einen überraschend großen Teil der Fälle, die sich sonst wie ein grundsätzlicher Fehler anfühlen.
Die stille Rechnung trotz Abo
Der teuerste Fehler ist unsichtbar: eine gesetzte Umgebungsvariable ANTHROPIC_API_KEY, oft aus einem alten Projekt, einer .env-Datei oder einem Tool wie direnv, das sie automatisch lädt. Ist sie gesetzt, rechnet Claude Code jede Interaktion über diesen API-Schlüssel ab, komplett unabhängig davon, ob du gleichzeitig mit einem Pro- oder Max-Abo angemeldet bist. Die Warnung dazu ist leicht zu übersehen, ein kurzer Hinweis auf einen Konflikt zwischen Token und Schlüssel beim Start. Wer die Sitzung ausschließlich über sein Abo statt über die API laufen lassen will, sollte gezielt prüfen: Get-ChildItem Env:ANTHROPIC* in der PowerShell zeigt jede gesetzte Umgebungsvariable mit diesem Präfix. Ist eine gefunden, entfernen und die Shell neu starten, danach neu anmelden.
Der schnellste Weg zur Diagnose
Bevor du einzelne Ursachen einzeln durchgehst, lohnt sich ein einziger Befehl: claude doctor direkt im Terminal. Er prüft automatisch Installationsart, ob der PATH korrekt gesetzt ist, den Anmeldestatus und die aktuelle Konfiguration, und zeigt an, an welcher Stelle genau es klemmt, statt dass du jede mögliche Ursache selbst durchprobierst.
Berechtigungen und Erweiterungen als vierte Fehlerquelle
Ein Fehler, der oft erst nach der eigentlichen Installation auftaucht: eine zu enge oder zu weite Berechtigung, ein nicht erreichbarer MCP-Server, oder eine Erweiterung, die mit den Grundeinstellungen kollidiert. Wer diese Fehler von den reinen Installationsfehlern trennen kann, spart sich viel Zeit beim Suchen, weil die Lösungswege komplett unterschiedlich sind, das eine ist eine Frage der Berechtigungen, das andere eine Frage der Umgebung.
Ich denke, fast jeder dieser Fehler hat denselben Kern: eine Voreinstellung von woanders, einem alten Projekt, einer anderen Shell-Einrichtung, einer vergessenen Umgebungsvariable, die sich unbemerkt in die neue Installation einschleicht. Wer beim ersten Setup einmal bewusst mit einer sauberen Umgebung startet, statt bestehende Konfigurationsdateien einfach zu übernehmen, erspart sich die meisten dieser Fehler von vornherein.
Quellen: Error reference (Claude Code Docs) · Manage API key environment variables in Claude Code (Anthropic Help Center) · Claude Code Install Errors 2026, 12 Fixes for npm EACCES, PATH, WSL & Windows Failures (Morph)
Häufige Fragen
Warum meldet Windows, dass claude kein bekannter Befehl ist?
Meist fehlt der Installationsordner im PATH. Die ausführbare Datei liegt unter %USERPROFILE%\.local\bin\claude.exe, dieser Ordner muss in der PATH-Variable deiner Shell stehen, sonst findet Windows den Befehl nicht.
Reicht Git Bash für die Arbeit mit Claude Code unter Windows?
Nein. Claude Code braucht Terminalfunktionen, die Git Bash nicht mitbringt. Empfohlen ist die native Windows PowerShell, nicht die x86-Version, nicht Git Bash, nicht die klassische Kommandozeile.
Wie finde ich schnell heraus, was bei mir kaputt ist?
Der Befehl claude doctor direkt im Terminal prüft Installationsart, PATH, Anmeldestatus und Konfiguration automatisch und zeigt an, wo es klemmt.
Was mache ich, wenn die Anmeldung einfach hängen bleibt?
Einmal komplett neu aufsetzen: /logout ausführen, Claude Code vollständig schließen, claude erneut starten und dich frisch anmelden. Das behebt die meisten hängenden Sitzungen.
Willst du das bei dir umsetzen?
In der Community zeige ich, was bei mir hält. Im Erstgespräch schauen wir uns dein Vorhaben konkret an.