Claude Code 2.1: Ein Leitfaden mit praktischen Beispielen

Claude Code ist ein von Anthropic entwickeltes agentes Codierungstool, das direkt in deinem Terminal läuft und auch über eine verbundene Webschnittstelle bedient werden kann. Anstatt isolierte Eingabeaufforderungen zu bearbeiten, versteht Claude Code das ganze Repository, kann über Dateien hinweg Schlussfolgerungen ziehen, Code bearbeiten und Tools ausführen. 

Im Vergleich zu früheren Versionen, die sich hauptsächlich auf interaktive Code-Unterstützung konzentrierten, bietet Claude Code 2.1 jetzt auch Unterstützung für Agenten, Hooks und wiederverwendbare Fähigkeiten, die aktiv beeinflussen können, wie und wann Code-Änderungen passieren.

Claude Code ist für Entwickler gedacht, die sich KI-Unterstützung direkt in ihre Arbeitsabläufe einbauen wollen, anstatt ständig zwischen einem Editor und einer Chat-Benutzeroberfläche hin und her zu wechseln. Auch wenn es noch in der Forschungsphase ist, zeigt es schon jetzt einen starken praktischen Nutzen in echten Entwicklungsabläufen. 

Wenn du mehr über die Claude-Modelle erfahren willst, empfehle ich dir den Kurs Kurs „Einführung in Claude-Modelle“. 

Was ist neu in Claude Code 2.1?

Claude Code 2.1 baut auf der Kernfunktionalität des Terminals auf und bringt ein paar Upgrades mit, die die agentengesteuerten Arbeitsabläufe flexibler machen. Diese Änderungen verändern, wie Claude Code eine Codebasis versteht und wie Entwickler bei echten Entwicklungsaufgaben damit umgehen.

Zu den wichtigsten Neuerungen in Claude Code 2.1 gehören:

• Agent- und Skill-Hooks im Vorspann, mit denen Entwickler vor der Anwendung von Code-Änderungen Prüfungen und Einschränkungen durchsetzen können.
• Verbesserte Unterstützung für Fähigkeiten mit verzweigtem Kontext, Hot Reload und benutzerdefinierten Fähigkeitsdefinitionen, wodurch wiederverwendbare Workflows flexibler und leistungsfähiger werden.
• Mit dem Slash-Befehl (/) kannst du während interaktiver Sitzungen schnell auf oft genutzte Aktionen zugreifen.
• Die Agenten in Claude Code 2.1 hören nicht mehr auf zu arbeiten, wenn ein Tool nicht aufgerufen werden kann, sodass die Arbeitsabläufe ohne Probleme weiterlaufen können.
• Das Tool hat sprachgesteuerte Antworten, die besonders praktisch für mehrsprachige Dokumentationen, Überprüfungen und die Zusammenarbeit im Team sind.
• Wildcard-Tool-Berechtigungen, wie z. B. „ Bash(*-h*) “, bieten genauere Automatisierungssteuerungen.
• Die CLI unterstützt jetzt „ Shift+Enter “ für mehrzeilige Eingaben, was das interaktive Authoring-Erlebnis verbessert, ohne dass man was extra einrichten muss.

In diesem Leitfaden schauen wir uns ein paar praktische Experimente an, die zeigen, wie diese neuen Funktionen in echten Projekten genutzt werden.

Einrichten von Claude Code Cloudbasierte Web-Erfahrung

Claude Code 2.1 ist als webbasierte Lösung verfügbar, die komplett in der Cloud läuft. Dieser Modus ist besonders praktisch für kollaborative Arbeitsabläufe, Pull-Request-Überprüfungen und Automatisierung auf Repository-Ebene, ohne dass eine lokale Einrichtung nötig ist.

Schritt 1: Melde dich an und hol dir Claude Code

Um loszulegen, geh einfach auf https://claude.ai/code und du kommst direkt zur Claude Code (Research Preview)-Oberfläche. 

Schritt 2: Claude Code mit GitHub verbinden

Um mit echten Repositorys zu arbeiten, braucht Claude Code Zugriff auf GitHub. Klick auf „Mit GitHub verbinden“, um die Claude GitHub App zu installieren. 

Bei der Autorisierung fragt GitHub nach der Erlaubnis, sich mit Repositorys zu verbinden, indem es:

• Überprüfe deine GitHub-Identität
• Schau dir an, auf welche Repositorys Claude zugreifen kann.
• In deinem Namen handeln (z. B. Branches oder Commits erstellen)

Du kannst wählen zwischen:

• Alle Repositorys oder
• Nur ausgewählte Repositorys (empfohlen für eine strengere Kontrolle)

Typische Berechtigungen sind:

• Lesezugriff auf Repository-Metadaten und Prüfungen
• Lese- und Schreibzugriff auf Code, Probleme, Pull-Anfragen und Workflows

Klick auf „Installieren & Autorisieren“ und du kannst den Zugriff später direkt in den App-Einstellungen von GitHub ändern oder widerrufen. Dieser Schritt ist nötig, damit Claude Code Repositorys lesen, Pull-Anfragen öffnen und Commits pushen kann, wenn man in der Webumgebung arbeitet.

Schritt 3: Eine Cloud-Umgebung einrichten

Bevor du deine erste Sitzung startest, fordert Claude Code dich auf, eine Cloud-Umgebung zu erstellen. Diese Umgebung regelt Claudes Netzwerkzugriff und Ausführungsgrenzen.

Die Optionen, die du hast, sind:

• Keine: Diese Option hat keinen Internetzugang und ist vor allem für maximale Sicherheit nützlich.
• Vertrauenswürdig (empfohlen): Es bietet Zugriff auf geprüfte Paketquellen.
• Vollständig: Diese Einstellung gibt dir uneingeschränkten Internetzugang.

Für die meisten Fälle bietet die Option „ Trusted “ die beste Balance zwischen Sicherheit und Flexibilität.

Schritt 5: Eine Web-Sitzung starten

Sobald die Einrichtung fertig ist, kommst du zum Claude Code Web-Editor, wie auf dem Screenshot unten zu sehen ist.

Von hier aus kannst du:

• Such dir ein Repository und einen Branch aus
• Refactoring und Überprüfungen durchführen
• Neue Branches und Commits erstellen
• Frühere Sitzungen fortsetzen (falls vorhanden)
• Wechsel zwischen Repositorys, ohne die Umgebung zu ändern

Einrichten der Claude Code Terminal-basierten CLI-Erfahrung

Die CLI ist der direkteste Weg, um mit Claude Code 2.1 zu arbeiten. Es ist super für die lokale Entwicklung, schrittweise Refactorings und Situationen, in denen du genau kontrollieren willst, was Claude in deinem Repository macht.

Schritt 1: Installation

Claude Code kann direkt über das Terminal mit einem plattformspezifischen Installationsprogramm installiert werden.

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Sobald die Installation fertig ist, solltest du eine Bestätigungsmeldung sehen, die die Claude Code-Version und den Installationspfad anzeigt. Weitere Einrichtungsoptionen findest du in der offiziellen Einrichtungsanleitung.

Schritt 2: Los geht's

Nach der Installation gehst du zum Stammverzeichnis deines Projekts und startest Claude Code:

cd your-project-directory
Claude Code

Wenn Claude Code startet, checkt es sofort das Repository und macht sich ein erstes Bild von der Codebasis. 

Dieser erste Kontext hilft Claude Code, in den nächsten Schritten besser zu denken.

Mit Claude Code 2.1 rumprobieren

Für diese Demo habe ich eins meiner Projekte aus GPT 5.2 genommen. Hier ist ein kurzer Überblick über das Projekt.

Sobald Claude Code Zugriff auf alle Dateien und Ordner in diesem Ordner hat, können wir anfangen zu experimentieren.

Umgestalten mit Hilfe von verzweigten Kontextfähigkeiten 

Als Teil der Bewertung von Claude Code 2.1 habe ich eine Repository-weite Umgestaltung gemacht, um die Pipeline zu verbessern. Dieses Experiment zeigt, wie gut Claude mit mehreren Dateien gleichzeitig umgehen kann, anstatt nur eine einzelne Datei zu bearbeiten.

Prompt:

Refactor the CSV parsing and slide generation logic across the repository.
Improve readability, split responsibilities, and avoid duplicated logic.

Claude macht erst mal einen detaillierten Plan für die Umgestaltung, mit der vorgeschlagenen Modulstruktur, den Duplikaten und der Reihenfolge, in der alles umgesetzt werden soll, und fragt dann nach der Zustimmung, bevor irgendwas geändert wird. 

Sobald du zugestimmt hast, macht Claude die Umgestaltung Schritt für Schritt und zeigt dir dabei die Unterschiede und den Fortschritt.

Mit Claude Code habe ich folgende Verbesserungen geschafft:

• Verteil die Aufgaben auf die Module: Claude hat das Laden von CSV-Dateien, Transformationen, die Erstellung von Excel-Dateien, die Generierung von PowerPoint-Präsentationen und die LLM-Planung (im Grunde alle Module) in eigene Komponenten aufgeteilt.
• Weniger doppelte Logik: Es hat wiederkehrende Funktionen (wie Spaltenerkennung und Formatierung) zentralisiert und gemeinsame Konstanten in eine gemeinsame Konfigurationsebene verschoben.
• Bessere Wartbarkeit: Claude hat auch die Größe von „ app.py “ verkleinert, ohne das äußere Verhalten der Anwendung zu verändern.

Hier ist ein Vergleich der Projektstruktur und der Refactoring-Ergebnisse vor und nach den Änderungen.

Vorher:

Nachher:

Schließlich habe ich die gleiche Umgestaltung in Claude Code Web ausprobiert. Der Hauptunterschied ist der Arbeitsablauf:

• CLI geht Schritt für Schritt vor und braucht immer eine klare Zustimmung.
• Web kann die Refaktorisierung direkt in einen neuen Zweig verschieben, was für die Zusammenarbeit und PR-basierte Arbeitsabläufe praktisch ist.

Schließlich hat Claude den Code überarbeitet und in einen Zweig verschoben.

Validierungs-Hook vor der Bearbeitung

Datenpipelines hauen oft aus einem einfachen Grund nicht richtig, nämlich weil das CSV-Schema der Eingabe nicht mit dem übereinstimmt, was der Code erwartet. In Claude Code 2.1 kannst du diese Art von Fehlern mit Hilfe von Pre-Edit-Hooks reduzieren. Mit dieser neuen Funktion kann ein Agent Validierungsprüfungen durchführen, bevor Claude den Code ändern darf.

In diesem Beispiel habe ich Claude Code gebeten, einen Agenten zu erstellen, der die CSV-Struktur überprüft, bevor irgendwelche Änderungen gemacht werden.

Prompt:

Create a Claude Code agent that validates the CSV schema before modifying any code. The agent should reject edits if the CSV schema is unclear.

Claude Code hat zuerst einen CSV-Schema-Validierungsagenten erstellt und ihn in den Workflow eingebunden, damit er als Gatekeeper fungieren kann. Die CLI-Ausgabe zeigt, dass Claude nicht nur ein einzelnes Skript erstellt hat, sondern ein kleines Validierungssystem zusammengestellt hat, das Folgendes umfasst:

• Ein Kernschema-Validierungsmodul, das die erforderlichen Spalten, fehlende Werte und die grundlegende Konsistenz überprüft.
• Ein Pre-Edit-Gatekeeper-Hook führt automatisch eine Validierung durch, bevor die Bearbeitung weitergeht.
• Zum Schluss gibt's noch ein paar Testfälle und Anwendungsbeispiele, um den Validator bei guten und schlechten CSV-Fällen zu checken.

In der Praxis ist der Ablauf ganz einfach:

• Claude checkt automatisch das Schema, bevor irgendwelche Codeänderungen gemacht werden, und stellt so sicher, dass die Voraussetzungen erfüllt sind.
• Wenn das Schema unklar oder ungültig ist, blockiert der Agent die Änderungen komplett und gibt hilfreiche Fehlermeldungen, um bei der Behebung zu helfen.
• Sobald die Validierung durch ist, macht Claude mit den Änderungen weiter, wobei er darauf achtet, dass sie gut durchdacht und vorhersehbar sind.

Die Webausgabe zeigt ein ähnliches Ergebnis, aber mit einem wichtigen Unterschied. Claude Code Web kann die Änderungen direkt in einen neuen Zweig schieben, einschließlich Validierungsmodul, Hook-Integration, Dokumentation und Tests. 

Insgesamt sorgt Claude Code 2.1 dafür, dass Schutzmaßnahmen schon vor der Bearbeitung greifen, indem Hooks direkt in Agenten und Fähigkeiten eingebaut werden. Das macht Hooks besonders nützlich in Projekten mit vielen Daten, wo Fehler bei der Eingabe oft mehr Probleme verursachen als der Code selbst.

Slash-Befehl-Fähigkeiten für wiederholte Aufgaben

Claude Code 2.1 hat wiederverwendbare Slash-Befehlsfunktionen eingeführt. Das sind eigenständige Workflows, die man interaktiv in einer Claude-Sitzung aufrufen oder direkt über die Befehlszeile ausführen kann. 

In diesem Beispiel erstellen wir eine wiederverwendbare „ /generate-slides “-Funktion, die eine CSV-Datei in eine professionelle PowerPoint-Präsentation umwandelt.

Prompt:

Create a reusable skill called /generate-slides that converts a CSV into a PPT.

Tipp: Benutz „ /statusline “, um eine eigene Statuszeile einzurichten, die unter der Eingabeaufforderung angezeigt wird (praktisch, um Repo, Branch oder Modus anzuzeigen).

Claude Code macht eine komplette Skill-Definition unter .claude/skills/, inklusive Dokumentation, Validierungslogik und einem lauffähigen Python-Einstiegspunkt.

• Erstellung von Fähigkeiten: Claude schreibt eine komplett dokumentierte „ generate-slides “-Funktion und erklärt dabei ihren Zweck, die Eingaben, die Validierungsschritte und den Ablauf.
• Schema-Validierungs: Die Funktion überprüft das CSV-Schema vor jeder Verarbeitung, um die Datenqualität sicherzustellen und klare Fehlermeldungen zu garantieren.
• Ausführung: Die Funktion kann direkt vom Terminal aus gestartet werden und funktioniert wie ein eigenständiges Befehlszeilentool.
• Fehlerbehandlung: Fehlende Dateien, ungültige Schemata oder fehlende API-Schlüssel führen zu klaren, umsetzbaren Fehlern.
• Automatisierungs: Mit einem einzigen Befehl kannst du Excel-Dateien, Diagramme und eine PowerPoint-Präsentation erstellen.

Du kannst die Funktion lokal mit folgendem Befehl testen:

python .claude/skills/generate-slides.py --csv-file kpis.csv

Hey, schau mal: Vergewissere dich, dass du deinen API-Schlüssel hinzufügst, bevor du das hier ausführst. 

Slash-Befehlsfunktionen machen Claude Code zu einer Workflow-Engine und nicht nur zu einem Assistenten. Anstatt dieselbe Aufgabe immer wieder neu einzugeben, legst du sie einfach einmal fest und kannst sie dann in verschiedenen Projekten, Sitzungen und Umgebungen wiederverwenden. Unten siehst du die aktualisierte Repository-Struktur, die die Hinzufügung der neuen Funktion zeigt.

Dieses Beispiel zeigt, wie das geht:

• Fähigkeiten können interaktiv über die CLI aufgerufen werden.
• Von Claude erstellte Fähigkeiten lassen sich problemlos in bestehende Codebasen einbinden.

Sprachgesteuerte Ausgabe 

Claude Code 2.1 kann so eingestellt werden, dass es in einer bestimmten Sprache antwortet. Das ist super praktisch für Teams, die in mehreren Sprachen arbeiten, für lokalisierte Dokumentationen und für Code-Walkthroughs, die nicht auf Englisch sind. In diesem Beispiel haben wir Claude gebeten, die Pipeline zur Erstellung von Folien im Repository komplett auf Japanisch zu erklären.

Prompt:

Explain the slide generation logic in Japanese.

Claude hat auf Japanisch geantwortet und den gesamten Ablauf klar erklärt. Wie du in der Ausgabe sehen kannst, wurde nicht nur eine Zusammenfassung übersetzt, sondern die Pipeline auch in übersichtliche Phasen unterteilt und auf die relevanten Module verwiesen, die in jedem Schritt eine Rolle spielen. Die CLI-Ausgabe zeigt:

• Japanisch von Anfang bis Ende: Die Antwort bleibt komplett auf Japanisch, auch die Überschriften und Aufzählungspunkte.
• Schritt für Schritt: Claude teilt den Prozess in verschiedene Schritte auf (CSV-Validierung, Datenverarbeitung, Excel-Arbeitsmappe, LLM-Planung und Folienerstellung).
• Codebasis-bewusste Referenzen: Es zeigt dir die relevanten Dateien und Verzeichnisse und erklärt dir, was jede Komponente macht.
• Formatierung im Dokumentationsstil: Die Ausgabe sieht aus wie interne Dokumente, sodass sie einfach in einer README-Datei oder einem Onboarding-Leitfaden wiederverwendet werden kann.

Anmerkung: Ich habe dieses Verhalten für dieses Beispiel nur in der CLI getestet, aber die gleiche Sprachsteuerungsfunktion ist Teil von Claude Code 2.1 insgesamt.

Auf dem Papier ist das nur eine kleine Funktion, aber wenn man Dokumente und Bewertungen in anderen Sprachen als Englisch machen muss, ist das echt super praktisch.

Claude Code 2.1 Befehle

Hier sind ein paar Befehle, die du mit Claude Code ausprobieren kannst.

Fazit

In diesem Leitfaden haben wir Claude Code 2.1 durch praktische Experimente sowohl in CLI- als auch in Web-Workflows erkundet. Wir haben Claude Code benutzt, um ein bestehendes Repository mit Forked-Context-Skills umzugestalten, Datengarantien mit Validierungs-Hooks vor der Bearbeitung durchzusetzen, wiederverwendbare Slash-Command-Skills zu erstellen und sprachgesteuerte Erklärungen direkt aus der Codebasis zu generieren.

Diese Beispiele zeigen, wie Claude Code 2.1 über einfache KI-gestützte Bearbeitung hinausgeht und zu mehr agentenorientierten Entwicklungsabläufen führt. Auch wenn Claude Code 2.1 noch in der Forschungsphase ist, zeigt es schon jetzt einen hohen praktischen Wert in echten Projekten.