Hilfe bei Fehlern

Beide Meldungen haben dieselbe Ursache: Claude Code ist noch nicht fertig eingerichtet. Entweder ist der Befehl claude nicht installiert, oder die aktualisierten Nutzungsbedingungen wurden noch nicht bestätigt. Das passiert genau einmal und ist in wenigen Minuten erledigt.

1. Terminal öffnen. In VS Code über das Menü Terminal → Neues Terminal (oder am PC: Windows-Taste drücken, powershell tippen, anklicken).
2. Claude installieren. Kopier die Zeile für dein Gerät, ins Terminal einfügen, Enter.
   Windowsirm https://claude.ai/install.ps1 | iexKopieren
   Maccurl -fsSL https://claude.ai/install.sh | bashKopieren
3. Neues Terminal. Das alte Terminal schließen und neu öffnen. Erst dann wird claude erkannt.
4. Einrichtung komplett durchklicken. Tipp claude, Enter. Die kurze Einrichtung ganz zu Ende machen, nicht abbrechen: ein Design mit den Pfeiltasten wählen (z. B. „Dark mode") und Enter, dann im Browser anmelden, danach die Nutzungsbedingungen mit Enter bestätigen. Warte, bis unten die normale Eingabezeile erscheint. Erst dann das Terminal schließen. Danach VS Code einmal neu starten, der Fehler ist weg. (Mehr dazu unter Rote Meldung „exited with code 1".)

Wichtig: Im Browser-Login oder in der Claude-Desktop-App zu bestätigen reicht nicht. Die Bestätigung muss in Claude Code selbst passieren (Schritt 4).

Lieber bebildert von vorne? Die komplette Einrichtung Schritt für Schritt gibt's als Installations-Anleitung (PDF).

Das Terminal kennt den neuen Befehl erst nach einem Neustart. Schließ das aktuelle Terminal komplett und öffne ein neues über Terminal → Neues Terminal. Tipp claude erneut ein.

Hilft das nicht, schließ VS Code einmal ganz und öffne es neu. Danach wird der Befehl erkannt.

Stand beim Installieren ein gelber Hinweis zu „PATH"? Dann hilft der nächste Punkt.

Lief die Installation mit „successfully installed" durch, steht darunter aber ein gelber Hinweis wie „… is not in your PATH"? Dann ist Claude korrekt installiert, Windows weiß nur noch nicht, in welchem Ordner das Programm liegt. Deshalb meldet claude „nicht erkannt". So behebst du es:

1. Diese Zeile einfügen. Kopier sie, klick ins selbe Terminal, füg sie ein, drück Enter. Es kommt keine Rückmeldung, das ist normal und richtig.
   Windows$p=[Environment]::GetEnvironmentVariable("Path","User"); [Environment]::SetEnvironmentVariable("Path", $p + ";$env:USERPROFILE\.local\bin", "User")Kopieren
2. Neues Terminal. Das aktuelle Terminal komplett schließen (Mülleimer-Symbol) und ein neues öffnen über Terminal → Neues Terminal.
3. Claude starten. Tipp claude, Enter → im Browser anmelden → die Nutzungsbedingungen mit Enter bestätigen. Fertig.

Nur schnell testen, ohne den PATH zu ändern? Gib einmalig & "$env:USERPROFILE\.local\bin\claude.exe" ein. Mit den drei Schritten oben läuft claude aber dauerhaft überall.

Oben erscheint der rote Hinweis „Error: Claude Code process exited with code 1", unten rechts dazu „… You must run claude in the terminal to review the updated terms" (oft mit Button „Resolve in Terminal"). Beides hat dieselbe Ursache: die einmalige Claude-Einrichtung im Terminal wurde noch nicht abgeschlossen, meist weil beim Auswählen des Designs das Terminal zu früh geschlossen wurde. Genau dieser Bildschirm muss komplett durchgeklickt werden:

1. Einrichtung starten. Klick auf den blauen Button „Resolve in Terminal" in der Meldung. Oder öffne ein Terminal (Terminal → Neues Terminal) und tipp claude, Enter.
2. Design wählen. Beim Willkommensbildschirm mit den Pfeiltasten ein Design auswählen (z. B. „Dark mode") und Enter.
3. Anmelden. Falls gefragt: der Browser öffnet sich → mit deinem Konto einloggen → zurück ins Terminal.
4. Bedingungen bestätigen. Claude zeigt die aktualisierten Nutzungsbedingungen → mit Enter bestätigen.
5. Fertig abwarten. Warte, bis unten eine normale Eingabezeile zum Tippen erscheint (Claude ist bereit). Erst dann das Terminal schließen und das Plugin wieder benutzen.

Wer mitten in der Einrichtung abbricht oder das Terminal zu früh schließt, bekommt wieder dieselbe Meldung. Im Browser oder in der Desktop-App zu bestätigen zählt hier nicht. Es muss in Claude Code im Terminal passieren.

Beim ersten Öffnen eines Ordners zeigt VS Code oben einen Balken mit „Restricted Mode" und dem Hinweis, dass Code hier nur eingeschränkt ausgeführt wird. Solange das steht, kannst du Claude in diesem Ordner nicht richtig nutzen.

1. Auf „Manage" klicken im Balken oben.
2. Ordner freigeben. Die linke Option wählen: „Trust this folder" beziehungsweise „Yes, I trust the authors".
3. Fenster schließen. Danach links auf das Claude-Symbol und eine neue Session starten.

Das machst du pro Projektordner genau einmal. Legst du später einen zweiten Shop als Kopie an, kommt die Abfrage für den neuen Ordner noch einmal.

/plugin-Befehle gehören zu Claude Code selbst. Sie funktionieren nur in einer laufenden Claude-Sitzung im Terminal, nicht im leeren Terminal davor und nicht im Chatfenster des Plugins. Tippst du sie ins leere Terminal, kommt „'/plugin' wurde nicht als Cmdlet … erkannt"; im Plugin-Chat sinngemäß „not supported in this environment".

1. Terminal öffnen. In VS Code: Terminal → Neues Terminal.
2. Claude starten. Tipp claude, Enter. Warte, bis oben „Claude Code v2.x" steht und unten eine Eingabezeile mit „>" erscheint.
3. Erst jetzt den Plugin-Befehl eingeben, direkt in diese Claude-Eingabezeile, z. B.:
   /plugin marketplace add AgriciDaniel/claude-seoKopieren

Kurz: zuerst claude starten, dann den /plugin-Befehl. Nicht andersherum.

Zum Installieren der Plugins lädt Claude die Daten per Git. Diese Meldung heißt: Git ist auf dem Rechner nicht installiert (oder nicht auffindbar). Git ist kostenlos und in zwei Minuten eingerichtet.

1. Git installieren. Zeile fürs Gerät ins Terminal einfügen, Enter:
   Windowswinget install --id Git.Git -e --source wingetKopieren
   Macxcode-select --installKopieren

   Windows alternativ: den Installer von git-scm.com laden und alle Vorgaben bestätigen.

2. Neu starten. Terminal schließen und ein neues öffnen (oder VS Code neu starten), damit git erkannt wird. Prüfen mit git --version: Kommt eine Versionsnummer, passt es.
3. Erneut versuchen. claude starten und den Plugin-Befehl nochmal eingeben (/plugin marketplace add …).

Kommt die Meldung trotz installiertem Git und nennt „unsafe location"? Dann liegt das Projekt in einem Cloud-/Spezialordner (z. B. OneDrive). Verschieb es in einen normalen lokalen Ordner und versuch es erneut.

Du exportierst dein Theme über Onlineshop → Themes, die drei Punkte am Theme und dann Theme-Datei herunterladen → E-Mail senden. Zwei Dinge irritieren dabei regelmäßig:

1. Die Mail kommt nicht sofort. Ein bis zwei Minuten sind normal. Kommt gar nichts an, prüf den Spam-Ordner.
2. Es gibt keinen Button. In der Mail steht nur der blau markierte Text „ThemeExport". Genau das ist der Download-Link, auch wenn nirgends „Download" steht.

Die heruntergeladene Datei musst du weder öffnen noch entpacken noch verschieben. Lass sie im Downloads-Ordner liegen, Claude holt sie sich von dort.

Manchmal legt Claude dir eine Auswahl mit mehreren Vorgehensweisen vor, und alle bedeuten Handarbeit für dich. Du musst keine davon nehmen.

1. „Other" wählen. Die Option steht unten in der Auswahlliste und lässt dich frei antworten.
2. Klartext schreiben. Zum Beispiel: „Das muss automatisch funktionieren. Ich will nichts manuell klicken. Finde einen Weg, wie du das selbst erledigst."
3. Abschicken. In den meisten Fällen sucht sich Claude danach einen automatischen Weg.

Bleibt Claude dabei, dass es nicht ohne dich geht, fehlt ihm oft nur ein Zugang: der Shopify-Connector, ein Token oder eine Berechtigung. Frag direkt nach: „Was genau brauchst du von mir, damit du es selbst machen kannst?"