Jonas Keil
KI-Kompass →
Jonas Keil
KI-Kompass →
← Alle Artikel
Jonas Keil Jonas Keil 4 Min. Lesezeit

Claude Code Fehler: 7 Fallen, die Anfänger Zeit kosten

Claude Code ist einsteigerfreundlicher geworden, seit es direkt in der Claude-App steckt. Trotzdem sehe ich immer wieder dieselben Claude Code Fehler: Einsteiger programmieren mit dem falschen Modell, überspringen den Plan und wundern sich dann, warum die Ergebnisse schwanken und das Kontingent so schnell weg ist. In diesem Artikel gehe ich die sieben häufigsten Fallen durch und zeige dir, wie du sie vermeidest.

Fehler 1: Du bleibst in der Theorie hängen

Der häufigste Fehler passiert schon vor dem ersten Prompt: noch ein Tutorial, noch ein Artikel. Die Fähigkeiten, die dir im Job wirklich etwas bringen, baust du aber nur durchs Anwenden auf.

Dabei ist die Hürde niedriger, als du denkst. Ein Satz wie „Erstelle mir ein Wortsuchspiel mit schönen Animationen und öffne es lokal in meinem Browser" reicht, und ein paar Minuten später läuft deine erste eigene App. Überleg dir danach etwas, das dir privat oder im Job wirklich nützt, und bau genau das. Wenn du bei den ersten Schritten unsicher bist, nimmt dich die Einsteiger-Anleitung Schritt für Schritt an die Hand.

Fehler 2: Du programmierst mit dem falschen Modell

In Claude Code wählst du unten rechts zwischen Haiku, Sonnet und Opus. Viele Einsteiger bleiben beim voreingestellten Modell oder nehmen bewusst ein kleineres, um Kontingent zu sparen.

Fürs Programmieren ist das die falsche Sparsamkeit. Ich empfehle dir, in Claude Code ausschließlich mit dem neuesten Opus-Modell zu arbeiten, aktuell Opus 4.7 mit einem Kontextfenster von einer Million Token. Wenn Claude dir Apps oder Automatisierungen baut, willst du das stärkste Modell am Werk haben. Sonnet und Haiku sind für einfache Aufgaben gedacht, nicht für deine Codebase.

Fehler 3: Du lässt den Aufwand auf niedrig

Neben dem Modell gibt es den Aufwands-Regler, von niedrig bis Max. Er steuert, wie lange das Modell über die eigene Antwort nachdenkt und sich dabei selbst auf Fehler überprüft.

Der Regler auf Max fühlt sich langsam an, zahlt sich aber aus. Wer mit niedrigem Aufwand arbeitet, bekommt schneller eine Antwort, iteriert dafür aber fünfmal über denselben Fehler. Mit Opus und Max-Aufwand sitzt das Ergebnis oft schon beim ersten Versuch, und genau das spart unterm Strich Zeit und Token. Qualität vor Quantität gilt beim Programmieren mehr als irgendwo sonst, denn schlechter Code produziert mit der Zeit immer mehr Folgefehler, die immer schwerer zu beheben sind.

Fehler 4: Du baust größere Projekte ohne Plan-Modus

Einfach die Idee eintippen und Claude Code machen lassen funktioniert, und für kleine Tests ist das auch völlig in Ordnung. So arbeiten die meisten beim ersten Mal. Bei größeren Projekten führt dieser Ansatz aber zu Überraschungen statt zu konstant guten Ergebnissen.

Der Plan-Modus, den du über den Modus-Button unten links aktivierst, dreht den Spieß um: Claude Code darf keine Dateien erstellen oder bearbeiten, sondern liest, analysiert und legt dir erst einen Plan vor. Häng an deine Idee am besten noch den Satz „Stell mir Fragen und erstelle dann einen Plan" an. Die Rückfragen helfen gerade dann, wenn du selbst noch keine genaue Vorstellung vom Projekt hast.

Fehler 5: Du akzeptierst den Plan, ohne ihn zu lesen

Der Plan-Modus bringt dir wenig, wenn du jeden Plan ungelesen abnickst. Ich kann dir versprechen: In 70 Prozent der Fälle findest du noch etwas, wenn du den Plan wirklich durchgehst. Mal ist das Layout anders gedacht, als du es wolltest, mal fehlt eine Funktion, die dir wichtig ist.

Genau dafür gibt es den Überarbeiten-Button. Beschreib, was anders sein soll, und Claude Code legt dir kurz darauf den korrigierten Plan vor. Erst wenn alles passt, akzeptierst du und lässt Claude Code im Automodus durcharbeiten. Wie dieser Ablauf an einem echten Projekt aussieht, siehst du in meinen Claude Code Tricks.

Fehler 6: Du lässt den Chat endlos wachsen

Das ist der teuerste Fehler auf dieser Liste. Je länger dein Chat, desto voller das Kontextfenster, desto abgelenkter arbeitet Claude Code und desto mehr kostet dich jede weitere Anfrage. Den Füllstand prüfst du über den kleinen Kreis neben der Modellauswahl.

Meine Regel für kleinere Projekte: nie über 200.000 Token. Zwei Befehle helfen dir dabei. /compact komprimiert den Chat zu einer Zusammenfassung, bei mir zum Beispiel von 155.000 auf 33.000 Token. /clear setzt die Session komplett zurück. Das ist weniger dramatisch, als es klingt, denn Claude Code erschließt sich den Projekt-Kontext in der Regel selbst wieder aus den Code-Dateien in deinem Ordner. In der Praxis setze ich lieber häufiger zurück und starte jedes neue Feature frisch mit Plan-Modus und Automodus.

Fehler 7: Alles in einem Ordner, alles in der CLAUDE.md

Zwei Ordnungsfehler, die auf dasselbe hinauslaufen: zu viel Ballast im Kontext.

Erstens: alle Projekte in einen einzigen Ordner werfen. Für die ersten Tests ist das egal. Sobald du mehrere Projekte hast, leg für jedes einen eigenen Unterordner an und verbinde Claude Code zu Beginn der Session mit genau diesem Ordner.

Zweitens: die CLAUDE.md vollstopfen. Diese Datei ist der Systemprompt von Claude Code. Wichtige Punkte aus einer Konversation kannst du dort dauerhaft festhalten, bevor du den Chat zurücksetzt. Aber lass die Datei niemals zu groß werden, sie wandert schließlich in jede einzelne Session mit.

Fazit

Die meisten dieser Fehler laufen auf zwei Grundsätze hinaus: Gib Claude Code die besten Voraussetzungen, also ein starkes Modell, genug Aufwand und einen sauberen Plan. Und halte den Kontext schlank. Beides kannst du ab deiner ersten Session üben. Falls du vorher noch einmal verstehen willst, was Claude Code überhaupt ist und was es kann, findest du die Grundlagen in Was ist Claude Code?.

Jonas Keil
Jonas Keil Ich zeige dir, wie du KI wirklich für dich nutzt. Jede Woche neu auf YouTube, Schritt für Schritt lernst du alle Essentials im KI-Kompass.