Claude Code ist eine KI, die im Terminal wohnt und Ihr Repository direkt liest und schreibt. Code in ein Browser-Chatfenster kopieren und die Antwort wieder zurückkopieren – dieses Hin und Her fällt weg.

In diesem Kapitel bauen wir das mentale Modell, auf dem alle sechs folgenden Kapitel aufbauen. Wer es überspringt, wird in den späteren Kapiteln nie ganz verstehen, warum die Dinge so entworfen sind, wie sie sind.

Zuerst die Einordnung – wo dieses Werkzeug läuft

Werkzeuge, mit denen KI Code schreibt, teilen sich danach auf, wo sie laufen – in drei Gruppen. Claude Code gehört zur ersten.

TYPE 1
CLI-Agenten

Laufen im Terminal und fassen Dateien direkt an. Claude Code, Codex CLI und Ähnliches. Stark darin, ein ganzes Arbeitspaket zu übernehmen.

TYPE 2
KI-Editoren

Sind in den Editor eingebaut und schlagen direkt neben dem vor, was Sie gerade tippen. Cursor, GitHub Copilot und Ähnliches. Stark darin, unter Ihren Augen zu schreiben.

TYPE 3
Cloud-Builder

Alles passiert im Browser, und von dort aus können Sie direkt veröffentlichen. v0, Bolt, Lovable und Ähnliches. Stark darin, ganz ohne lokale Einrichtung auszukommen.

Den Dreiervergleich selbst behandelt Kapitel 1 des Kurses zum KI-Coding. Dieser Kurs beschränkt sich auf den ersten Typ und geht dafür in die Tiefe.

Claude Code ist übrigens nicht auf das Terminal beschränkt. Dasselbe gibt es als Erweiterung für VS Code oder JetBrains, als Desktop-App und im Browser. Aber sein Entwurfsdenken beginnt am Terminal, und wer das verstanden hat, verläuft sich auch an keinem der anderen Zugänge.

Der entscheidende Unterschied zu Chat-Werkzeugen

„Claude im Browser kann doch auch Code schreiben – was ist also wirklich anders?“ Diese Frage kommt immer zuerst. Der Unterschied liegt nicht in der Klugheit, sondern in der Reichweite.

Chat-Form (Claude im Browser)

Sieht nur, was Sie hineinkopieren. Zurück kommt Text. Anwenden müssen Sie ihn selbst. Erstreckt sich die Änderung über 10 Dateien, sind das 10-mal Kopieren und 10-mal Zurücktragen.

Agenten-Form (Claude Code)

Sucht und liest selbst. Zurück kommt ein Diff. Es lässt die Tests laufen, und wenn sie scheitern, bessert es nach und lässt sie erneut laufen. Die 10 Dateien findet es allein.

Spürbar wird dieser Unterschied, sobald die Arbeit ein Nachforschen enthält. „Finde heraus, von wo diese Funktion überall aufgerufen wird, und korrigiere alles“ heißt bei einem Chat-Werkzeug: Sie forschen nach. Ein Agent sucht selbst.

Umgekehrt gilt: Je weiter die Reichweite, desto weiter auch der Schaden, wenn etwas schiefgeht. Deshalb müssen die Rechte entworfen werden (Kapitel 5). „Klug“ heißt nicht „sicher“.

Die Agentenschleife – sammeln → handeln → prüfen

Während Claude Code arbeitet, dreht sich darunter immer derselbe Zyklus.

STEP 1
Kontext sammeln

Es sucht Dateien, liest sie und durchsucht sie bei Bedarf. Was Sie es hier lesen lassen, entscheidet über das Ergebnis.

STEP 2
Handeln

Es schreibt Dateien um und führt Befehle aus. Hier sitzt die Rechte-Schranke.

STEP 3
Das Ergebnis prüfen

Es liest die Ausgabe von Tests und Typprüfungen. Sind sie fehlgeschlagen, geht es zurück zu STEP 1.

Entscheidend ist, dass es STEP 3 gibt. Ein Chat-Werkzeug endet bei „das ist vermutlich richtig“. Ein Agent kann seine eigene Ausgabe ausführen und nachsehen. Dass er so lange nachbessern kann, bis die Tests durchlaufen, verdankt er dieser Schleife.

Umgekehrt heißt das: Bei Aufgaben, die sich nicht prüfen lassen, verschwindet dieser Vorteil. „Mach diesen Code sauber“ hat keine Definition von Erfolg, also dreht die Schleife leer. Das Muster aus Kapitel 3 – ihm vorab ein Prüfmittel mitzugeben – kommt genau von hier.

Werkzeuge und Rechte – was möglich ist und was Sie stoppen können

Was Claude Code kann, bestimmt der Umfang der „Werkzeuge“, die es bekommen hat. Eine Datei lesen, eine Datei schreiben, einen Befehl ausführen, suchen – jedes davon ist ein eigenes Werkzeug.

Und bei jedem Werkzeugaufruf läuft eine Rechteprüfung. Standardmäßig fragt es jedes Mal nach Ihrer Zustimmung, wenn es eine Datei umschreibt oder einen Befehl ausführt. Es gibt Einstellungen, die diese Zustimmung überspringen; worauf dabei zu achten ist, behandelt Kapitel 5.

Sie: „Repariere die Tests rund um die Authentifizierung“ ↓ [SUCHE] Dateien finden, die Auth betreffen ← Lesen. Standardmäßig ohne Rückfrage ↓ [LESEN] auth.test.ts lesen ← Lesen ↓ [ÄNDERN] auth.test.ts umschreiben ← Schreiben. Hier kommt die Rückfrage ↓ [AUSFÜHREN] npm test laufen lassen ← Ausführen. Auch hier eine Rückfrage ↓ Den Fehlschlag lesen, zurück zu [ÄNDERN]

Wer diesen Ablauf vor Augen hat, weiß, warum es an dieser Stelle stehen geblieben ist. Es ist nicht steckengeblieben, sondern an eine Rechte-Schranke gestoßen.

Das Kontextfenster als Grenze

Wie viel Claude Code auf einmal „im Kopf behalten“ kann, hat eine Obergrenze. Diese Grenze ist das Kontextfenster. Je länger das Gespräch läuft und je mehr Dateien gelesen werden, desto voller wird es.

Wenn es sich füllt, passieren zwei Dinge.

Die Antworten werden träge

Bei jedem Zug wird ein riesiger Verlauf erneut gelesen, also wird es langsamer und teurer. Das führt direkt zur Kostenfrage in Kapitel 7.

Der Anfang wird vergessen

Die Voraussetzungen, die Sie zu Beginn gesetzt haben, werden hinausgedrängt. „Das habe ich doch schon gesagt“ ist meistens genau das.

Die Abhilfe heißt zusammenfalten – das Gespräch entweder zusammenfassen und verdichten oder es abschneiden und neu beginnen. Wann gefaltet werden sollte, verlangt ein Urteil; die Kriterien arbeitet Sollte man /compact von Hand ausführen? durch. Die Handgriffe dazu stehen in Kapitel 3.

Wofür es taugt und wofür nicht

Die Umrisse eines Werkzeugs bekommt man in den Griff, wenn man weiß, worin es schwach ist.

Passt gut

Korrekturen über mehrere Dateien hinweg / bestehenden Code untersuchen / so lange wiederholen, bis die Tests durchlaufen / gleichförmige Migrationsarbeit / von einer Fehlermeldung zur Ursache zurückverfolgen

Passt schlecht

Arbeit ohne Definition von richtig / Bereiche, die sich nicht ausführen und nachprüfen lassen / geschäftliche Entscheidungen, die nur Sie kennen / einzeilige Korrekturen (das Hin und Her der Zustimmung kostet mehr)

Die Seite „passt schlecht“ ist keine Frage der Fähigkeit, sondern ein strukturelles Problem: Die Prüfschleife kann sich nicht drehen. Deshalb löst auch ein Wechsel zu einem klügeren Modell das nicht.

Die Landkarte dieses Kurses

So ordnen sich die verbleibenden sechs Kapitel ein. Der Reihe nach zu lesen ist der Normalfall, aber wer schon feststeckt, darf gern bei Kapitel 4 einsteigen.

2. Einrichtung und die erste Stunde

Installieren, verbinden und die erste Anweisung durchbringen.

3. Der tägliche Arbeitsablauf

Die Arbeit auf die Spur erkunden → planen → umsetzen → committen setzen.

4. Aus der Sackgasse heraus

Ein Vorgehen, das vom Symptom zur Ursache hinabführt.

5. Rechte und Sicherheit

Entwerfen, wie weit Sie abgeben und wo Sie stoppen.

6. Erweitern

Wann Sie zu CLAUDE.md, Hooks, Subagenten und MCP greifen.

7. Kosten und Grenzen

Das Betriebswissen für den langen Einsatz.

Es gibt auch eine offizielle Lernseite. Anthropic betreibt die kostenlose Lernplattform Claude Academy, und dort gibt es auch einen Kurs zu Claude Code. Dieser Kurs ersetzt ihn nicht, sondern setzt auf Erklärungen auf Deutsch und auf das Rückwärtsrechnen von Fällen, in denen tatsächlich jemand feststeckte. Beides zu nutzen dürfte der schnellere Weg sein.

Zusammenfassung

  • Claude Code ist ein Werkzeug der Agenten-Form, das im Terminal läuft und Ihr Repository direkt liest und schreibt
  • Der Abstand zu Chat-Werkzeugen liegt nicht in der Klugheit, sondern in der Reichweite. Es sucht selbst, liefert Diffs zurück und führt aus, um nachzuprüfen
  • Darunter läuft eine Schleife aus sammeln → handeln → prüfen. Weil es STEP 3 gibt, kann es so lange nachbessern, bis die Tests durchlaufen
  • Was möglich ist, bestimmt der Umfang der Werkzeuge, und bei jedem Werkzeugaufruf steht eine Rechte-Schranke
  • Füllt sich das Kontextfenster, wird es träge und vergisst den Anfang. Wann gefaltet wird, verlangt ein Urteil
  • Schlecht passen Aufgaben, bei denen sich die Prüfschleife nicht drehen kann. Ein Modellwechsel löst das nicht

Bis hierher sollten Sie im Griff haben, was für ein Werkzeug Claude Code ist. Als Nächstes lassen wir es tatsächlich laufen. Weiter zu Kapitel 2 „Einrichtung und die erste Stunde“.