Claude Code nutzen: planen, prompten und die Kontrolle behalten

Die meisten kennen Claude aus einem Chatfenster: Du fügst Code ein, bekommst eine Antwort, kopierst sie zurück und hoffst, dass sie passt. Claude Code funktioniert anders. Es läuft direkt in deinem Projekt, liest die Dateien selbst, nimmt die Änderungen vor, führt deine Tests aus und committet das Ergebnis und fragt dabei um Erlaubnis. Dadurch ist es für echte Softwarearbeit weit nützlicher als ein Chatbot und weit leichter falsch einzusetzen. Dieser Ratgeber zeigt dir, wie du Claude Code richtig nutzt: Installation, erste Sitzung, Planen, bevor es etwas schreibt, Prompts, mit denen es arbeiten kann, das Setup, das es auf Kurs hält, und die Grenzen, die du kennen solltest, bevor du ihm deine Codebasis anvertraust.

Was Claude Code ist (und was nicht)

Claude Code ist das agentische Coding-Tool von Anthropic. „Agentisch“ heißt, es schlägt nicht nur Code vor: Es arbeitet in einer Schleife, wählt seinen nächsten Schritt selbst, nutzt Tools und prüft das Ergebnis, bis die Aufgabe erledigt ist. Praktisch heißt das: Es durchsucht dein Repository, liest und bearbeitet Dateien im ganzen Projekt, führt Shell-Befehle wie deine Testsuite oder deinen Linter aus, nutzt git und verbindet sich mit externen Tools. Die Grundidee hinter dieser Schleife erklärt unser Ratgeber, was KI-Agenten sind.

Es läuft an mehreren Orten, alle mit derselben Engine, deine Projekteinstellungen gelten also überall:

• Das Terminal – die vollständige Kommandozeilenversion, um die es hier vor allem geht.
• VS Code und JetBrains-IDEs – Erweiterungen mit Inline-Diffs und der Möglichkeit, deine aktuelle Auswahl zu teilen.
• Die Desktop-App – der Tab „Code“ in der Claude-App, mit visueller Diff-Ansicht und mehreren Sitzungen nebeneinander.
• Die Web- und Mobil-Apps – unter claude.ai/code, für lang laufende Aufgaben in Repositorys, die du nicht lokal hast.

Was es nicht ist: eine Autovervollständigung für die Zeile, die du gerade tippst, oder ein Ersatz dafür, zu wissen, was dein Code tun soll. Es ähnelt eher einer schnellen, unermüdlichen Kollegin, die gerade ins Team gekommen ist. Sie kann alles schnell lesen, weiß aber nur, was im Repository steht und was du ihr sagst. Willst du vor allem Antworten, Erklärungen oder eine zweite Meinung zu einem Codeschnipsel, ist der normale Chat aus unserem Ratgeber, wie du Claude nutzt, einfacher.

So installierst du Claude Code und startest eine Sitzung

Du brauchst einen kostenpflichtigen Claude-Tarif (Pro, Max, Ultra, Team oder Enterprise), ein Konto in der Claude Console mit API-Guthaben oder Zugang über einen unterstützten Cloud-Anbieter wie Amazon Bedrock. Im kostenlosen Tarif ist es nicht enthalten.

Der empfohlene Installer ist ein einziger Befehl. Unter macOS, Linux oder WSL führst du im Terminal curl -fsSL https://claude.ai/install.sh | bash aus. In der Windows PowerShell lautet der Befehl irm https://claude.ai/install.ps1 | iex. Homebrew (brew install --cask claude-code) und WinGet (winget install Anthropic.ClaudeCode) funktionieren ebenfalls, aktualisieren sich aber anders als der native Installer nicht selbst. Unter nativem Windows installierst du zusätzlich Git for Windows, damit Claude Code eine Bash-Shell nutzen kann.

Danach:

1. Prüf die Installation in einem neuen Terminal mit claude --version. Wird er nicht gefunden, liegt der Installationsordner noch nicht im PATH.
2. Wechsle mit cd in einen Projektordner und tippe claude.
3. Melde dich an, wenn du dazu aufgefordert wirst. Dabei öffnet sich dein Browser; die Zugangsdaten werden gespeichert, das passiert also nur einmal.
4. Tippe /help, um die verfügbaren Befehle zu sehen. Tippst du nur /, siehst du Befehle und Skills schon beim Schreiben.

Lieber kein Terminal? Dann installier die Erweiterung für VS Code oder öffne den Tab „Code“ in der Desktop-App. Alles Folgende gilt dort genauso, teils mit Schaltflächen statt Tastenkürzeln.

Deine erste Sitzung: erst erkunden, dann eine kleine Änderung

Fang nicht mit „Bau mir ein Feature“ an. Lass Claude Code erst das Projekt lesen und berichten, was es gefunden hat. So lernst du, wie es denkt, und erkennst Missverständnisse, bevor daraus Änderungen werden. Einfache Fragen reichen: „Was macht dieses Projekt?“, „Wo ist der Haupteinstiegspunkt?“ oder „Erklär mir die Ordnerstruktur“. Bei einer fremden Codebasis bittest du um eine richtige Führung:

Dann nimmst du eine kleine, risikoarme Änderung vor, etwa einen Tippfehler in der README, einen fehlenden Test oder eine klarere Fehlermeldung. Beobachte, was es tut. Claude Code zeigt jede Änderung als Diff, und je nach Berechtigungsmodus der Sitzung fragt es vorher nach oder legt los und sagt dir Bescheid. Wähl Yes, wenn die Änderung stimmt; sag, was falsch ist, wenn nicht.

Auch git funktioniert im Gespräch: „Welche Dateien habe ich geändert?“, „Erstell einen Branch namens fix/login-timeout“ oder „Committe meine Änderungen mit einer aussagekräftigen Nachricht“. Arbeite von Anfang an auf einem Branch, damit sich jedes Experiment leicht verwerfen lässt.

Erst planen, dann programmieren lassen

Bei allem, was über einen kleinen Fix hinausgeht, ist die nützlichste Gewohnheit, Denken und Tippen zu trennen. Im Plan-Modus darf Claude Code Dateien lesen und erkunden, bearbeitet deinen Quellcode aber erst, wenn du einen schriftlichen Plan freigegeben hast. Drück Shift+Tab, um dorthin zu wechseln (in der Statuszeile steht dann „plan mode on“), oder beginne einen einzelnen Prompt mit /plan.

Ein guter Planungs-Prompt beschreibt das Ziel, die Einschränkungen und woran du erkennst, dass es funktioniert:

Ist der Plan fertig, bietet Claude Code an, ihn freizugeben und weiterzumachen, ihn freizugeben, aber jede Änderung einzeln zu prüfen, oder weiterzuplanen. Lies ihn gründlich. Jetzt erwischst du eine falsche Annahme am günstigsten, etwa die Bearbeitung einer generierten Datei oder einen übersehenen Aufruf an anderer Stelle im Code. Mit Ctrl+G öffnest du den Plan in deinem Editor und kannst ihn vor der Freigabe ändern.

So schreibst du Prompts, mit denen Claude Code arbeiten kann

Claude Code liest dein Repository, aber weder deine Gedanken noch deinen Bildschirm. Die offiziellen Empfehlungen laufen darauf hinaus: Sag ihm, was es nicht selbst herausfinden kann. Nenn die Datei, beschreib das Symptom und sag, wie „behoben“ aussieht. „Behebe den Bug“ schickt es auf die Suche; „Behebe den Login-Bug, bei dem Nutzer nach einem falschen Passwort einen leeren Bildschirm sehen“ bringt es direkt an die Arbeit.

Ein paar Wege, Kontext direkt mitzugeben:

• Dateien mit @ referenzieren – @ plus Pfad, etwa @src/auth/session.ts, nimmt diese Datei in deine Nachricht auf.
• Den echten Fehler einfügen – der vollständige Stacktrace oder die Ausgabe des fehlschlagenden Tests ist besser als eine Umschreibung.
• Screenshots einfügen – praktisch bei Layout-Bugs oder einem Design, das nachgebaut werden soll.
• Große Aufgaben in nummerierte Schritte zerlegen – erst die Tabelle, dann den Endpunkt, dann die Seite, die ihn nutzt.

Für Bugs funktioniert diese Struktur gut:

Die letzte Zeile ist wichtig. Unter dem Druck, einen Test zum Bestehen zu bringen, ist jedes Coding-Modell versucht, den Test zu ändern oder den Fehler abzufangen und zu verstecken. Schließt du das vorab aus, vermeidest du es. In unseren KI-Prompts fürs Programmieren findest du weitere Vorlagen für Reviews, Refactorings und Dokumentation, und der Claude-Prompt-Generator macht aus einer groben Anfrage einen strukturierten Prompt wie die oben.

CLAUDE.md, Berechtigungen und Rückgängigmachen: die Kontrolle behalten

CLAUDE.md ist eine einfache Markdown-Datei im Stammverzeichnis deines Projekts, die Claude Code zu Beginn jeder Sitzung liest. Führ /init aus, und es entwirft eine aus deiner Codebasis; deine Aufgabe ist dann vor allem, Zeilen zu streichen. Halte sie kurz (die Dokumentation empfiehlt unter 200 Zeilen) und nimm nur auf, was Claude nicht aus dem Code ableiten kann: die genauen Build- und Testbefehle, Konventionen, auf die sich dein Team geeinigt hat, den Deploy-Schritt, der nur in jemandes Kopf existiert, Ordner, die es nie anfassen soll. Gibt es schon eine AGENTS.md für andere Coding-Agenten, kann Claude Code stattdessen diese lesen. Solche Anweisungen ähneln stark einem System-Prompt; unser System-Prompt-Generator hilft dir, sie zu strukturieren.

Berechtigungsmodi legen fest, was ohne Nachfrage läuft. Mit Shift+Tab wechselst du zwischen ihnen:

• Manual (manuell) – Claude liest frei, fragt aber, bevor es Dateien bearbeitet oder Befehle ausführt.
• Accept edits (Änderungen annehmen) – Dateiänderungen und gängige Dateibefehle in deinem Projektordner laufen direkt; andere Befehle fragen weiterhin nach.
• Plan – Erkunden und ein schriftlicher Plan, keine Änderungen am Quellcode.
• Auto, wo verfügbar – alles läuft, wobei ein separates Klassifizierungsmodell riskante Aktionen vorher prüft.

Zwei Dinge betont die Dokumentation klar. Erstens: CLAUDE.md ist eine Richtlinie, und Claude kann entscheiden, dass eine Zeile nicht zutrifft. Alles, was jedes Mal passieren muss, gehört in eine Deny-Regel (etwa eine, die das Lesen von .env-Dateien blockiert) oder einen Hook, also ein Skript, das Claude Code an festen Punkten ausführt, zum Beispiel vor jeder Änderung oder wenn Claude fertig werden will. Zweitens: Nutze den Modus, der alle Prüfungen umgeht, niemals außerhalb eines Wegwerf-Containers oder einer virtuellen Maschine.

Läuft etwas schief, stoppst du es mit Esc mitten in der Aktion und lenkst um. Drückst du bei leerem Prompt zweimal Esc oder tippst /rewind, setzt du den Code, das Gespräch oder beides auf einen früheren Stand zurück. Diese Checkpoints umfassen nur Dateien, die Claude mit seinen eigenen Bearbeitungstools geändert hat, nicht Änderungen durch Shell-Befehle. Committe also trotzdem regelmäßig in git.

Lange Sitzungen, Kosten und Automatisierung

Jede Nachricht schickt das bisherige Gespräch erneut mit, deshalb verbrauchen lange Sitzungen mehr von deinem Tarifkontingent oder API-Budget. Die meisten aktuellen Claude-Modelle haben ein Kontextfenster von einer Million Tokens, und Claude Code verdichtet ältere Verläufe automatisch, sodass der Platz selten ausgeht. Das Problem ist unnötiger Verlauf, der kostet und ablenkt. Diese Gewohnheiten helfen:

• /clear zwischen unabhängigen Aufgaben – das kostet nichts. /clear [NAME] benennt außerdem die Sitzung, die du verlässt, damit du später zu ihr zurückkehren kannst.
• /compact mit Schwerpunkt – /compact behalte die API-Änderungen und die Testbefehle fasst den Rest zusammen.
• /usage und /context – zeigen, wofür dein Verbrauch draufgegangen ist und was das Kontextfenster füllt.
• Fortsetzen statt neu erklären – claude -c setzt die letzte Sitzung in diesem Ordner fort; mit /rename und claude --resume [NAME] nimmst du benannte Arbeit auch Tage später wieder auf.

Sitzen die Grundlagen, kann Claude Code weit mehr als Chat. claude -p "[AUFGABE]" führt einen einzelnen Prompt aus und beendet sich, sodass du Logs hineinleiten oder es aus Skripten und CI aufrufen kannst; für GitHub Actions und GitLab gibt es fertige Integrationen. MCP-Server verbinden es mit Tools wie Issue-Trackern, Datenbanken und Design-Dateien. Skills bündeln wiederkehrende Abläufe, etwa eine Release-Checkliste, die Claude nur bei Bedarf lädt, und Subagenten erledigen Nebenaufgaben parallel, ohne dein Hauptgespräch zu überfrachten.

Was Claude Code nicht kann

• Wissen, was nirgends aufgeschrieben ist – Geschäftsregeln, den Grund für seltsamen Code oder einen Deploy-Prozess, den niemand dokumentiert hat. Steht es nicht im Repository, in der CLAUDE.md oder in deinem Prompt, rät Claude.
• Korrekten Code garantieren – es kann plausiblen Code schreiben, der schwache Tests besteht und trotzdem Randfälle, Sicherheit oder Performance falsch behandelt. Prüf Diffs wie den Pull Request einer Kollegin, vor allem alles, was Authentifizierung, Zahlungen oder das Löschen von Daten betrifft.
• Dir das Verständnis deines eigenen Systems abnehmen – es alles schreiben zu lassen, ohne es zu lesen, ist Vibe Coding: in Ordnung für Prototypen, riskant für alles, was du pflegen musst.
• Sich allein gegen feindselige Anweisungen wehren – Webseiten, Issues, Abhängigkeiten oder Dateien, die es liest, können Text enthalten, der es manipulieren soll. Berechtigungsabfragen, Deny-Regeln und die Sandbox (/sandbox) gibt es unter anderem deshalb; mehr dazu in unserem Ratgeber zu Prompt Injection.
• Kostenlos laufen – es braucht einen kostenpflichtigen Tarif oder API-Guthaben, und intensive Sitzungen verbrauchen die Tariflimits schnell. Prüf die aktuellen Preise, bevor du es in einen Team-Workflow einbaust.
• Lange gleich bleiben – Funktionen, Befehle und Standardeinstellungen ändern sich oft. Verhält sich ein Befehl aus diesem Ratgeber anders, sind die offizielle Dokumentation und /help maßgeblich.

Richtig eingesetzt nimmt dir Claude Code die zähen Teile des Programmierens ab: dich in fremdem Code zurechtzufinden, die Tests zu schreiben, die du sonst ausgelassen hättest, einen Bug durch sechs Dateien zu verfolgen. Das Muster, das funktioniert, ist immer dasselbe. Erst erkunden, vor dem Bearbeiten planen, ihm eine Prüfung zum Ausführen geben, die CLAUDE.md kurz und zutreffend halten und prüfen, was es dir zurückgibt. Die Entwicklerarbeit bleibt bei dir; es übernimmt das Tippen.

Quellen

• Anthropic — Claude Code im Überblick (offizielle Dokumentation)
• Anthropic — Best Practices für Claude Code
• Wikipedia — Claude