Im vorigen Kapitel haben wir KI-Coding-Werkzeuge in drei Typen unterteilt und darunter Claude Code, dem man die Umsetzung weitgehend anvertrauen kann, zur Hauptfigur dieses Kurses gewählt. In diesem Kapitel legen wir nun endlich Hand an. Schritt für Schritt – Installation → Start → Anmeldung → erste Anweisung → Freigabe der Änderungen – gehen wir den gesamten Ablauf durch, achten dabei auf die typischen Stolperstellen und führen Sie bis zu dem Punkt, an dem Claude Code in Ihrem Terminal läuft.
Das Ziel: „Claude Code in der eigenen Umgebung die erste Aufgabe erledigen lassen“
Was ist Claude Code (Rückblick auf das vorige Kapitel)
Noch einmal in einem Satz: Claude Code ist ein „CLI-Agent“ von Anthropic. Statt Code in einen Browser-Chat zu kopieren, liest, ändert es Projektdateien direkt in Ihrem Terminal, führt Befehle aus und lässt Tests laufen. Sie sagen nur in natürlicher Sprache „So hätte ich es gern“, und die KI stellt selbst einen Plan auf und treibt die Arbeit über mehrere Dateien hinweg voran. Genau wie ein Partner, der neben Ihnen sitzt und mit anpackt.
📖 Zwei offizielle Quellen zum Einstieg. Die Schritte dieses Kapitels sind ein Wegweiser für Einsteiger. Die genauen Systemvoraussetzungen, die aktuelle Einrichtungsweise und die Tarife prüfen Sie bitte immer an der Primärquelle – mit den beiden Lesezeichen offizielle Doku code.claude.com/docs und Produktseite anthropic.com/claude-code sind Sie auf Dauer bestens versorgt.
Einrichten – Installation
Claude Code wird in einer Node.js-Umgebung installiert und genutzt. Schwierige Vorbereitungen braucht es nicht. Legen Sie zunächst die beiden Voraussetzungen bereit.
Das Fundament, auf dem Claude Code läuft. Falls noch nicht vorhanden, die LTS-Version von der offiziellen Seite nodejs.org installieren. Ob schon vorhanden, sehen Sie mit node -v – wird eine Version angezeigt, ist alles gut.
Das Fenster, in das Sie Befehle tippen. Auf macOS das „Terminal“, unter Windows „PowerShell“ oder WSL, unter Linux das Standard-Terminal. Die im vorigen Kapitel angesprochenen Grundoperationen genügen.
Ist alles bereit, tippen Sie im Terminal die folgende Befehlszeile ein. Sie installieren Claude Code lediglich mit npm (dem zu Node.js gehörenden Paketmanager) so, dass es systemweit verfügbar ist.
npm install -g @anthropic-ai/claude-code
-g bedeutet „global installieren (also aus jedem Ordner heraus aufrufbar)“. Nach Abschluss starten Sie mit dem folgenden Befehl.
claude
⚠️ Wenn claude: command not found erscheint. Die Installation war erfolgreich, aber der Befehl wird nicht erkannt – das ist eine der häufigsten Stolperstellen für Einsteiger. Meist liegt es an den PATH-Einstellungen von Node.js/npm, und die Lösung ist klar umrissen. Im Artikel „command not found / Installationsfehler“ finden Sie die Behebung je nach Betriebssystem.
Genaue Systemvoraussetzungen, empfohlene Schritte je nach Betriebssystem und alternative Installationswege hängen von der Umgebung ab. Die aktuellsten und genauesten Informationen entnehmen Sie bitte immer der offiziellen Doku code.claude.com/docs.
Erster Start und Anmeldung
Starten Sie claude zum ersten Mal, werden Sie zur Anmeldung (Authentifizierung) mit einem Anthropic-Konto aufgefordert. Sie folgen einfach den Hinweisen auf dem Bildschirm; in den meisten Fällen öffnet sich ein Browser, und sobald Sie sich dort anmelden, ist die Authentifizierung abgeschlossen und Sie kehren zum Terminal zurück.
Im Terminal claude eingeben. Beim ersten Mal erscheint ein Bildschirm zur Wahl der Anmeldemethode.
Den Hinweisen folgen und sich im Browser mit dem Anthropic-Konto anmelden. Nach Erlaubnis ist die Authentifizierung abgeschlossen.
Zurück im Terminal wartet die Eingabezeile. Hier beginnt der Dialog. Als Nächstes geben Sie die erste Anweisung.
Für die Anmeldung gibt es den Weg über ein Claude-Abonnement mit passendem Tarifvertrag und den Weg über einen API-Schlüssel. Welcher davon für Sie nutzbar ist und wie Kosten entstehen, hängt vom Tarif ab, daher legen wir uns hier nicht fest. Welche Methode zu Ihrem Vertrag passt, entnehmen Sie bitte der offiziellen Doku.
🔑 Wenn die Anmeldung nicht klappt oder ein Authentifizierungsfehler auftritt. Der Browser öffnet sich nicht, der eingefügte Code wird abgewiesen, es bleibt unterwegs stecken – auch rund um die Authentifizierung gibt es typische Stolperstellen. Die Behebung nach Ursache finden Sie im Artikel „Anmelde- / Authentifizierungsfehler“. Löst das nichts, hilft auch Kapitel 5 „Aus Sackgassen herauskommen“, das Sackgassen systematisch behandelt.
Die erste Anweisung geben – die Grundschleife
Ist die Authentifizierung erledigt, geht es endlich richtig los. Zuerst ist wichtig, Claude Code im Ordner des Projekts zu starten, an dem Sie arbeiten wollen. Claude Code betrachtet den „aktuellen Ordner“ als Arbeitsziel; verwechselt man das, arbeitet es an der falschen Stelle.
cd my-project
claude
Danach teilen Sie einfach in natürlicher Sprache mit, was Sie erledigt haben möchten. „Lies die README und erkläre, was dieses Projekt tut“ oder „Füge der Startseite ein Kontaktformular hinzu“ – Sie bitten in ganz normalen Worten. Von hier an werden die folgenden vier Schritte zur immer wiederkehrenden Grundschleife.
In natürlicher Sprache mitteilen, was erledigt werden soll. Je konkreter statt vage, desto zielgenauer läuft es.
Die KI liest die betreffenden Dateien, legt fest, was wie geändert wird, und legt los.
Welche Zeile wie umgeschrieben wird, zeigt der Diff. Grün ist Ergänzung, Rot ist Löschung.
Sind Sie einverstanden, freigeben und übernehmen. Wenn nicht, ablehnen, die Korrektur in Worten mitteilen und erneut versuchen.
Der Kern ist SCHLEIFE 3, die „Prüfung der Änderungen“. Bevor Claude Code eine Datei umschreibt, zeigt es zunächst den Diff „Ich ändere hier dies“ und übernimmt es erst nach Ihrer Freigabe. Den Inhalt zu lesen und zu beurteilen, ob er der Absicht entspricht, ist die Rolle des Menschen. Wie im vorigen Kapitel erwähnt, ist es Ihre Aufgabe, den entstandenen Code zu lesen und über gut oder schlecht zu urteilen.
✅ Der erste Schritt: „klein und überprüfbar“. Bitten Sie nicht gleich um einen großen Umbau, sondern gewöhnen Sie sich mit kleinen Aufträgen, deren Ergebnis Sie mit eigenen Augen prüfen können, ein – etwa „Erkläre diese Datei“ oder „Füge eine kleine Funktion hinzu“. Läuft es gut, erweitern Sie den Umfang des Delegierten nach und nach – das ist der Kniff ohne Umwege.
Das Anweisen selbst (die passende Wahl zwischen dem lockeren „Vibe Coding“ und der spezifikationsgetriebenen Entwicklung, bei der man erst die Spezifikation festzurrt) vertiefen wir ausführlich in Kapitel 4 „Gut anweisen“. Zunächst genügt es, wenn diese Vier-Schritte-Schleife läuft.
Grundlagen der Rechtemodi – sicher delegieren
„Löscht die KI nicht eigenmächtig Dateien oder führt gefährliche Befehle aus?“ – eine berechtigte Sorge. Claude Code ist genau hier sauber gestaltet: Vor folgenreichen Operationen wie dem Bearbeiten von Dateien oder dem Ausführen von Befehlen fragt es immer nach. Das sind die Rechtemodi.
Das Verhalten ist in mehrere Stufen gegliedert. Prägen Sie sich hier nur das Konzept grob ein.
Fragt bei jeder Bearbeitung und Befehlsausführung nach. Da man einzeln freigibt, am sichersten. Damit gewöhnt man sich zuerst ein.
Ändert nichts tatsächlich, sondern lässt nur den Plan „was getan wird“ aufstellen. Nützlich, wenn Sie vor einer großen Arbeit die Marschrichtung festzurren wollen.
Überspringt die jeweilige Rückfrage und treibt einen bestimmten Bereich von Operationen automatisch voran. Schnell, aber weil man seltener hinsieht, mit Vorsicht.
Ein mächtiger Modus, der alle Rückfragen überspringt. Für Einsteiger besser zu meiden. Einsatzfälle und Gefahren siehe Hinweis unten.
💡 „Rückfragen nerven, also alles per Bypass“ ist tabu. Der Modus, der alle Rückfragen überspringt, ist mächtig, aber im Gegenzug können Sie ungewollte Löschungen oder Befehlsausführungen nicht mehr stoppen. Wollen Sie Sicherheit mit Tempo, wechseln Sie nicht sofort zum Bypass, sondern richten zuerst Rechteregeln ein, die nur vertrauenswürdige Operationen erlauben – das ist der saubere Weg. Auch eine „Sandbox“, die Arbeit isoliert und sicher laufen lässt, ist eine Option.
Hier genügt es, sich zu merken: „Claude Code läuft nicht eigenmächtig Amok, sondern fragt nach“ und „dieses Verhalten lässt sich über Modi einstellen“. Ausführlicher können Sie in eigenen Artikeln und Leitfäden tiefer eintauchen.
Unterschiede und Umschalten der Modi unter Rechtemodi im Detail.
Wie man Erlaubnis-/Verbotsregeln schreibt, unter Rechteregeln und Einstellungen.
Das Konzept der Sandbox unter Sandbox – Einführung.
CLAUDE.md und Grundlagen der Einstellungen
Nutzt man Claude Code intensiver, empfindet man es bald als lästig, „jedes Mal dieselben Hinweise zu geben“. „Einrückung mit zwei Leerzeichen“, „diesen Ordner nicht anfassen“, „antworte auf Deutsch“ – solche projektweiten Regeln jedes Mal aufs Neue zu bitten, ist ineffizient.
Hier kommt CLAUDE.md ins Spiel. Legen Sie im Projektstamm eine Datei dieses Namens ab, liest Claude Code sie beim Start automatisch ein und arbeitet unter Beachtung der darin festgehaltenen Regeln. Sozusagen eine „Betriebsanleitung dieses Projekts“, die Sie dem Partner in die Hand geben.
# Über dieses Projekt
- Sprache: TypeScript / Framework: Next.js
- Antworten und Kommentare auf Deutsch schreiben
- Einrückung mit zwei Leerzeichen
- src/legacy/ nicht anfassen
- Vor dem Commit npm run lint bestehen
Der Kniff: „kurz, konkret und nur, was wirklich eingehalten werden soll“ schreiben. Zu lang oder zu vage – und die Regeln werden eher schlechter befolgt. Beginnen Sie mit ein paar Zeilen und ergänzen Sie, was Ihnen als „das sage ich jedes Mal“ auffällt – so lässt sie sich am besten heranziehen.
💡 In die CLAUDE.md geschrieben, aber es hält sich nicht daran? Häufig sind es zu viele Regeln, zu abstrakte Regeln oder Widersprüche. Ursachen und Behebung finden Sie im Artikel „Wenn die CLAUDE.md-Regeln nicht wirken“. Kennt man die „Kniffe, damit sie wirken“, wird die Genauigkeit der KI spürbar stabiler.
Einstellungen gibt es nicht nur über die CLAUDE.md. Auch die zuvor genannten Rechteregeln, die Modellauswahl und diverses Verhalten lassen sich über Konfigurationsdateien feinjustieren – aber das kommt nach und nach. Zunächst genügt es, „ein paar Zeilen Projektregeln in die CLAUDE.md zu schreiben“, und das Gefühl ändert sich.
- Claude Code ist ein CLI-Agent von Anthropic. In der Node.js-Umgebung mit
npm install -g @anthropic-ai/claude-codeinstallieren und mitclaudestarten. - Beim ersten Mal Anmeldung (Authentifizierung) mit einem Anthropic-Konto. Bei Problemen zu den Artikeln über command not found / Authentifizierungsfehler.
- Der Grundablauf ist die Schleife bitten → planen → Diff prüfen → freigeben. Den Diff zu lesen und über gut oder schlecht zu urteilen, ist Aufgabe des Menschen.
- Mit Rechtemodi verhindert man einen Amoklauf. Einsteiger meiden den Bypass und erweitern den delegierten Umfang, während sie prüfen.
- Schreibt man in die CLAUDE.md ein paar Zeilen Projektregeln, hält sich die KI leichter daran.
Damit läuft Claude Code in Ihrem Terminal, und Sie können ihm die erste Aufgabe anvertrauen. Im nächsten Kapitel 3 „Werkzeuge vergleichen und einsetzen“ ordnen wir die Unterschiede zu Weggefährten wie Cursor, GitHub Copilot und Codex und lernen die passende Wahl je nach Situation.