Die 10 häufigsten Anfängerfehler mit Claude Code

1. Claude rät, statt nachzusehen

Claude ist ein Sprachmodell und bildet Text, der plausibel klingt. Lücken füllt es mit glaubhaft wirkenden Angaben, ohne zu sagen, dass es rät. Verlangen Sie zu jeder Aussage eine Fundstelle und lassen Sie Vermutungen kennzeichnen.

Symptom:

Claude nennt Klickwege, Preise oder Produktnamen, die es so nicht gibt.

Gegenmittel:

Fundstellen verlangen, Vermutungen kennzeichnen lassen und bei fremden Programmen zuerst die aktuelle Dokumentation lesen lassen.

Dieser Satz im Auftrag hilft:

Nenne zu jeder Zahl und jeder Aussage die Fundstelle. Kennzeichne Vermutungen mit "Vermutung" und Unbelegtes mit "nicht belegt".

2. Falscher Ordner, falsches Projekt

Der Ordner, in dem Sie claude starten, bestimmt, welche Dateien Claude sieht und welche CLAUDE.md es liest. Starten Sie im falschen Ordner, gelten die falschen Dateien und Regeln. Prüfen Sie vor dem Start die Eingabezeile in PowerShell und nennen Sie den Ordner im ersten Satz Ihres Auftrags.

Symptom:

Claude ändert Dateien im falschen Bereich oder kennt Ihre aufgeschriebenen Regeln nicht.

Gegenmittel:

Vor jedem Start die Eingabezeile lesen, mit cd in den richtigen Ordner wechseln und den Ordner im Auftrag nennen.

Dieser Satz im Auftrag hilft:

Startordner ist [Pfad Ihres Ordners]. Arbeite nur dort und ändere nichts außerhalb dieses Ordners.

3. "Fertig" ohne Beleg

Claude meldet Erfolg, ohne das sichtbare Ergebnis geprüft zu haben. "Erledigt" ist eine Aussage und kein Nachweis. Legen Sie vorab fest, woran Sie Erfolg erkennen, und verlangen Sie den Beleg ausdrücklich.

Symptom:

Claude meldet Erfolg, Sie sehen aber keine Änderung.

Gegenmittel:

Vor dem Auftrag ein nachprüfbares Kriterium festlegen (Zahl, Datei oder Screenshot) und den Beleg verlangen.

Dieser Satz im Auftrag hilft:

Fertig ist die Aufgabe, wenn [Kriterium, das sich nachzählen lässt]. Zeige mir den Beleg, bevor du "fertig" sagst.

4. Die Sitzung wird zu lang

Claude hat ein begrenztes Kontextfenster, vergleichbar mit einem Schreibtisch, von dem bei zu viel Material Dinge herunterrutschen. Nehmen Sie eine Aufgabe pro Sitzung vor, prüfen Sie den Füllstand mit /context, fassen Sie mit /compact zusammen und beginnen Sie mit /clear neu. Lassen Sie vorher den Stand in eine Datei schreiben.

Symptom:

Claude vergisst Absprachen vom Anfang oder wiederholt sich.

Gegenmittel:

Eine Aufgabe pro Sitzung, Füllstand mit /context prüfen, mit /compact zusammenfassen, vor /clear den Zwischenstand speichern lassen.

Dieser Satz im Auftrag hilft:

Schreibe den Zwischenstand in ZWISCHENSTAND.md nach dieser Vorlage.

5. Zugangsdaten im Chat

Was Sie in die Sitzung tippen, wird über das Netzwerk gesendet und lokal im Sitzungsprotokoll gespeichert. Passwörter und Schlüssel gehören daher in eine eigene Datei namens .env, die Claude nicht lesen darf. Ein Schlüssel, der offen im Gespräch stand, wird beim Anbieter ersetzt.

Symptom:

Passwörter oder Schlüssel stehen im Gesprächsverlauf.

Gegenmittel:

Zugangsdaten in einer .env-Datei pflegen, Claude das Lesen sperren und einen offen gezeigten Schlüssel beim Anbieter neu erzeugen.

6. Aufträge werden nur teilweise umgesetzt

Lange Aufträge enthalten viele Einzelheiten, und einzelne gehen unter. Lassen Sie die Anforderungen als nummerierte Liste zurückgeben und am Ende jeden Punkt mit Beleg abhaken. Dann zählen Sie nach.

Symptom:

Von fünf besprochenen Punkten fehlen zwei, Claude meldet trotzdem alles als erledigt.

Gegenmittel:

Anforderungen als nummerierte Liste zurückgeben lassen und am Ende jeden Punkt mit Beleg abhaken lassen.

Dieser Satz im Auftrag hilft:

Gib die Anforderungen als nummerierte Liste zurück. Hake am Ende jede ab und nenne den Beleg.

7. Dieselbe Korrektur zum dritten Mal

Claude behandelt dann das Symptom und sucht immer an derselben Stelle. Beim zweiten Mal verlangen Sie eine Suche an anderer Stelle. Nach dem dritten Mal halten Sie an, lassen die Ursache erklären oder beginnen eine frische Sitzung mit der Fehlermeldung im Wortlaut.

Symptom:

Sie erklären denselben Fehler wieder und wieder, nichts ändert sich.

Gegenmittel:

Beim dritten Mal die Korrektur stoppen und eine Ursachenanalyse verlangen oder mit frischer Sitzung neu beginnen.

Dieser Satz im Auftrag hilft:

Das ist jetzt zum dritten Mal falsch. Höre auf zu ändern. Erkläre mir zuerst, wo die Ursache liegen kann, und nenne drei Stellen, an denen du noch nicht gesucht hast.

8. Zahlen und Daten ungeprüft übernehmen

Claude rechnet mit falschen Annahmen oder übernimmt Werte, ohne sie bis zur Quelle zu verfolgen. Verfolgen Sie jede Zahl zur Quelldatei zurück und lassen Sie Rechnungen mit Annahmen und Zwischenschritten als Tabelle ausgeben. Bei Datumsangaben gehört die Zeitzone in den Auftrag.

Symptom:

Ein Datum oder eine Summe weicht von der Quelle ab, oft merkt es erst der Empfänger.

Gegenmittel:

Jede Zahl bis zur Quelle zurückverfolgen, Rechnungen als Tabelle ausgeben lassen, Zeitzone nennen.

Dieser Satz im Auftrag hilft:

Gib die Rechnung als Tabelle aus: Annahmen, Zwischenschritte, Ergebnis. Nenne zu jeder Zahl die Datei und die Zeile, aus der sie stammt.

9. Versand ohne Probelauf

Bei Serienbriefen und Massen-E-Mails fallen Fehler in Namensfeldern erst auf, wenn alle Empfänger sie bekommen. Machen Sie zuerst einen Probelauf mit drei bis fünf Fällen und setzen Sie die eigene Adresse als einen der Empfänger ein. Erst danach folgt der volle Lauf.

Symptom:

Ein Serienbrief oder eine E-Mail an viele Empfänger enthält Fehler, und alle Empfänger bekommen den Fehler.

Gegenmittel:

Probelauf mit drei bis fünf Fällen und der eigenen Adresse als Empfänger, danach erst der volle Lauf.

10. Falsche Shell unter Windows

Unter Windows gibt es PowerShell und die Eingabeaufforderung (CMD). Beide sehen ähnlich aus und verstehen verschiedene Befehle. Beginnt die Eingabezeile mit PS C:\, sind Sie in PowerShell. Fehlt das PS, sind Sie in CMD und öffnen das passende Fenster über die Windows-Taste und die Eingabe PowerShell.

Symptom:

Fehlermeldungen wie 'The token && is not a valid statement separator' oder 'irm is not recognized'.

Gegenmittel:

Den Anfang der Eingabezeile lesen und das passende Fenster öffnen.