Claude Code: Ein Leitfaden mit praktischen Beispielen

Was ist Claude Code?

Claude Code ist ein Tool, das direkt in deinem Terminal läuft, deinen Code versteht und dir bei Entwicklungsaufgaben mit natürlichen Sprachbefehlen hilft. Es lässt sich mit minimalem Aufwand in deine Entwicklungsumgebung integrieren, sodass du dich ganz aufs Schreiben und Verbessern von Code konzentrieren kannst.

Hier sind ein paar wichtige Funktionen von Claude Code:

• Bearbeiten und Umgestalten: Deinen Code mit KI-basierten Vorschlägen anpassen, optimieren und verbessern.
• Fehlerbehebung: Finde und behebe Fehler, fehlende Abhängigkeiten und Leistungsengpässe.
• Verständnis des Codes: Frag nach der Architektur, Logik und Abhängigkeiten deines Codes.
• Automatisierte Tests & Linting: Führe fehlgeschlagene Tests aus und behebe Fehler, führe Linting-Befehle aus und verbessere die Codequalität.
• Git-Integration: Durchsuche die Git-Historie, löse Merge-Konflikte, erstelle Commits und generiere mühelos Pull-Anfragen.

Egal, ob du an einem Open-Source-Projekt arbeitest oder Codebasen auf Unternehmensebene verwaltest, Claude Code kann dir mit intelligenter Automatisierung helfen, die sich an deinen Programmierstil und deine Projektanforderungen anpasst. Das aktuelle Update auf Claude Code 2.1 macht die interaktive Nutzung besser, bietet optionale Einstellungen für die Antwortsprache und erweitert die Anpassungs- und Steuerungsmöglichkeiten für zuverlässigere automatisierte Agenten-Workflows.

Hier sind ein paar Leute, für die dieser Service super ist:

• Softwareentwickler: Verbesserung der Codequalität und Wartbarkeit.
• Open-Source-Mitwirkende: Unbekannte Codebasen verstehen und verbessern.
• DevOps Engineers: Automatisierung von Code-Review- und Linting-Aufgaben.

Claude Code nutzt jetzt Claude Sonnet 4.5. Das heißt, du kannst dasselbe Modell, das die Forscher und Ingenieure von Anthropic verwenden, direkt in deinem Terminal nutzen oder mit dem Claude Agents SDK KI-Agenten erstellen.

Anthropic hat auch Cowork eingeführt, das wie ein Assistent bei alltäglichen Datei- und Dokumentenaufgaben hilft, die über das Programmieren hinausgehen. Es ist als Forschungsvorschau für Max-Plan-Abonnenten verfügbar, die die Claude Desktop-App auf macOS nutzen. Leute mit anderen Tarifen können sich auf die Warteliste setzen lassen für einen späteren Zugang.

Lass uns mit unserem praktischen Projekt loslegen.

Schritt 1: Einrichten von Claude Code

Um mit Claude Code loszulegen, brauchst du ein Terminal, ein Code-Projekt, an dem du arbeiten kannst, und entweder ein Claude-Abonnement (Pro/Max/Teams/Enterprise) oder ein Claude Console-Konto mit aktiver Abrechnung.

Installier Claude Code einfach, indem du einen der folgenden Befehle auf deinem Terminal ausführst, je nach Betriebssystem und Terminal.

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

Anmerkung: Die Installation über npm install -g @anthropic-ai/claude-code ist immer noch möglich, wird aber nicht mehr empfohlen. Du solltest lieber den oben genannten nativen Installationsprozess nutzen. Wenn du vorher über npm installiert hast, kannst du mit „ claude install “ umziehen.

Nach der Installation gehst du in dein Projektverzeichnis und startest Claude mit folgendem Befehl:

cd your-project-directory
claude

Zur Authentifizierung wirst du gefragt, ob du Claude Code mit einem kostenpflichtigen Abonnement oder mit Abrechnung nach API-Nutzung nutzen möchtest.

Als Nächstes bekommst du einen Login-Link, über den du einen Bestätigungscode bekommst, den du in das Terminal eingeben musst, auf dem Claude Code läuft. Dann bist du fertig, und ein spezieller „Claude Code”-Arbeitsbereich für die Nutzungsüberwachung und Kostenverwaltung automatisch erstellt.

Jetzt ist Claude Code einsatzbereit.

Schritt 2: Entwicklungsumgebung einrichten

Für diese Demo benutze ich die Supabase Python-Bibliothek supabase-py, einen Open-Source-Python-Client für die Interaktion mit Supabase, einem Backend-as-a-Service, der auf PostgreSQLbasiert. Supabase hat 'ne Reihe von Tools, wie Authentifizierung, Echtzeit-Abonnements, Speicher und automatisch generierte APIs.

Fangen wir damit an, das Repository zu klonen und unsere Entwicklungsumgebung einzurichten.

1. Öffne dein Terminal, geh zu dem Verzeichnis, wo du das Supabase-py-Repository klonen willst (z. B. cd Desktop), und gib den folgenden Befehl ein:

git clone https://github.com/supabase/supabase-py.git
cd  supabase-py

2. Als Nächstes erstellst du eine virtuelle Umgebung und installierst die erforderlichen Abhängigkeiten, indem du die folgenden Befehle nacheinander in deinem Terminal ausführst

python3 -m venv env
source env/bin/activate  # On Windows, use ./env/Scripts/activate
pip install -e .

Deine Python-Umgebung ist jetzt mit allen notwendigen Abhängigkeiten eingerichtet, um die Supabase-Bibliothek auszuführen, und dein Repository kann jetzt erkundet werden. 

Schritt 3: Bereiche für Beiträge finden

Eine super Möglichkeit, mitzumachen, ist, den Tab„Issues“ (Probleme) auf GitHub unter zu checken . Im Supabase-Repository habe ich ein Problem in „ client.py “ entdeckt, das die Lesbarkeit und Struktur des Codes sowie das Fehlen aussagekräftiger Kommentare betrifft.

Hier ist, was wir mit Claude Code machen werden:

• Wir werden den Code überarbeiten, um die Lesbarkeit, Wartbarkeit und Struktur zu verbessern.
• Füge aussagekräftige Docstrings und Inline-Kommentare hinzu, um den Zweck der verschiedenen Komponenten zu erklären.
• Finde und behebe Fehler, indem du Probleme und andere mögliche Fehler analysierst.

Schritt 4: Mit Claude Code rumprobieren

Da wir uns schon im Ordner „supabase-py“ befinden, geh zum Verzeichnis „supabase“, wo die Datei „ client.py “ ist, und starte Claude Code:

cd supabase
claude

Claude Code hat jetzt Zugriff auf alle Dateien und Ordner im Ordner „Supabase-py“. Jetzt probieren wir's mal aus.

Code umschreiben

Um das Supabase Python SDK besser zu machen, wollen wir die Datei „ client.py ” überarbeiten, damit sie übersichtlicher, pflegeleichter und besser organisiert ist. Gib einfach die folgende Eingabeaufforderung in die Befehlszeile ein:

Prompt: Mach mal 'ne Umgestaltung des Codes in der Datei client.py, die im Ordner Supabase ist.

Claude wird dich um Bestätigung bitten, bevor er weitermacht. Drückauf „ “ (Änderungen speichern) und dann auf „ “ (Änderungen bestätigen), um die Änderungen zu bestätigen. Sobald das erledigt ist, aktualisiert Claude Code die Datei, zeigt die Änderungen im Terminal an und gibt dir eine Zusammenfassung der vorgenommenen Änderungen.

Mit Claude Code haben wir die folgenden Verbesserungen an „ client.py “ vorgenommen:

• Organisierte Importe:  Claude Code Ich hab zusammengehörige Importe in logische Abschnitte sortiert (Authentifizierungsfehler, API-Typen, Funktionsfehler), Importe umbenannt, damit alles klarer wird, und doppelte Aliase rausgeschmissen, damit alles einheitlich ist.
• Bessere Lesbarkeit: Es Es wurden Abschnittskommentare hinzugefügt, um Importe zu klassifizieren, und Duplikate in der Liste „ __all__ “ wurden entfernt, um die Organisation zu vereinfachen.
• Einfachere Kundenoptionen: Außerdem mehrere Zeilen reduziert, indem ähnliche Importe in einer einzigen Anweisung zusammengefasst wurden.

Hier ist ein direkter Vergleich zwischen dem ursprünglichen und dem überarbeiteten Code.

Code dokumentieren

Claude Code ist nicht nur super zum Refactoring, sondern auch ein echt starkes Tool, um Code-Dokumentationen zu erstellen, zu verbessern und zu standardisieren. Es kann nicht dokumentierte Abschnitte finden, strukturierte Docstrings oder Kommentare erstellen und dafür sorgen, dass die Projektdokumentationsstandards eingehalten werden.

Wir haben Claude Code benutzt, um die Dokumentation in client.py zu verbessern, was zu folgendem Ergebnis geführt hat:

• Klare Modul-Dokumentationsstrings, die den Zweck der Datei erklären.
• Detaillierte Kommentare zu den Abschnitten, die Importe kategorisieren (Fehlertypen, Client-Implementierungen, Speicherdienste).
• Inline-Kommentare, um Fehlertypen, Client-Funktionen und wichtige Teile zu erklären.

Hier ist ein direkter Vergleich zwischen dem überarbeiteten und dem dokumentierten Code.

Prompt: Dokumentiere den Code in client.py, indem du Kommentare hinzufügst, um das Verständnis zu verbessern.

Sobald die Dokumentation hinzugefügt ist, kannst du überprüfen, ob sie deinen Projektstandards entspricht, indem du Claude dazu aufforderst:

Prompt: Schau mal, ob die Dokumentation unseren Projektstandards entspricht.

Fehler beheben

Debugging kann echt nervig sein, aber Claude Code macht's einfacher, indem es Fehlermeldungen analysiert, die Ursachen findet und Lösungen vorschlägt. Egal, ob du mit fehlenden Importen, Laufzeitfehlern oder Logikproblemen zu kämpfen hast – es hilft dir dabei, den Prozess zu optimieren, indem es dir umsetzbare Lösungen bietet.

So benutzt du Claude Code zum Debuggen:

1. Identifiziere das Problem:  Sag Claude mal, was für eine Fehlermeldung du kriegst.
2. Hol dir Empfehlungen zur Behebung: Frag Claude nach möglichen Lösungen.
3. Mach die Korrektur und schau nach, ob sie funktioniert:  Probier mal Claudes Vorschläge aus und schau, ob das Problem damit behoben ist.

Claude Code hat die folgenden Änderungen gemacht, um Probleme beim Importieren in der Datei „ client.py “ zu beheben: 

• Kommentare ignorieren: Kommentar „ # type: ignore ” hinzugefügt, um IDE- und Typüberprüfungswarnungen für ungelöste Importe zu unterdrücken.
• Konsequente Fehlerkategorisierung: Claude Code hat dafür gesorgt, dass Fehler bei Importen aus der Authentifizierung, der Datenbank, dem Speicher und den Funktionen übersichtlich gruppiert werden.
• Lesbarkeit des Codes beibehalten: Es wurden Kommentare hinzugefügt, um zu erklären, warum bestimmte Importe ignoriert wurden, anstatt sie zu löschen.

Hier ist ein direkter Vergleich zwischen dem ursprünglichen Code und dem korrigierten Code.

Prompt: Ich sehe ein paar Fehler, wie zum Beispiel „Import gotrue.errors”, die nicht behoben werden konnten. Hilf mir, alle Fehler in client.py zu beheben.

Claude-Code-Befehle

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

Ichempfehle auch,die Anthropic-Tutorials anzuschauen.

Erweiterte Funktionen von Claude Code

Sobald du mit den Grundlagen des Refactorings und Debuggens vertraut bist, kannst du durch die Anpassung des Verhaltens von Claude Code deutlich mehr Leistung freisetzen. Mit Hooks und Plugins kannst du sich wiederholende Aufgaben automatisieren und externe Systeme einbinden.

Claude Code Haken

Claude Code Hooks sind automatische Auslöser, die Shell-Befehle ausführen, wenn während deiner Claude Code-Sitzung bestimmte Ereignisse passieren. Sie machen sich wiederholende Aufgaben wie Code-Formatierung, Testläufe und Sicherheitschecks automatisch, die Claude sonst vielleicht überspringen würde.

Hooks nutzen ein Ereignis-Aktion-System, bei dem du drei Sachen festlegst:

• Die Veranstaltung: Wann wird der Haken ausgelöst?

• Der Matcher: Welche Aktionen sind davon betroffen?

• Der Befehl: Was passiert, wenn der Hook ausgelöst wird?

Ein Hook könnte zum Beispiel losgehen, nachdem Claude eine Python-Datei geschrieben hat, und automatisch „ black “ ausführen, um den Code zu formatieren. Hooks kriegen JSON-Infos darüber, was passiert ist, und können so kluge Entscheidungen basierend auf Dateitypen oder Pfaden treffen. Sie können in Claudes Protokoll ausgegeben werden oder Fehlermeldungen direkt an Claude senden, um Vorgänge zu blockieren.

Häufige Anwendungsfälle für Hooks sind unter anderem die folgenden

• Code-Formatierung: Linter und Formatierer automatisch nach dem Schreiben von Code ausführen

• Testen: Führ Testsuiten nach Änderungen durch, um Fehler frühzeitig zu erkennen.

• Sicherheit: Verhindere Änderungen an sensiblen Dateien wie Produktionskonfigurationen oder API-Schlüsseln.

• Dokumentation: API-Dokumentation automatisch erstellen, wenn sich Quelldateien ändern

• Git-Automatisierung: Erstell kluge Commits und überprüf die Richtlinien zum Schutz von Branches.

• Benachrichtigungen: Sag deinem Team über Slack Bescheid, wenn sich wichtige Dateien ändern.

• Compliance: Vergewissere dich, dass alle Lizenz-Header oder Codierungsstandards eingehalten werden, bevor du Änderungen machst.

Richte Hooks mit dem /hooks in Claude Code oder bearbeite ~/.claude/settings.json direkt.

Claude Code-Plugins

Plugins sind Erweiterungen, die Claude Code mit externen Tools, Diensten und APIs verbinden. Während Hooks lokale Shell-Befehle automatisch machen, lassen sich Plugins in dein größeres Entwicklungsumfeld wie CI/CD-Pipelines, Projektmanagement-Tools und Teamkommunikationsplattformen einbinden.

Plugins können mehrere Teile, wie Subagenten (spezielle Claude-Assistenten für bestimmte Aufgaben), MCP-Server (standardisierte Tool-Integrationen) und Hooks, in einem einzigen Paket zusammenfassen, das alles nahtlos koordiniert.

Ein Plugin kann Code-Änderungen checken und automatisch Probleme in Jira melden oder sich mit deiner internen Test-Infrastruktur verbinden. Plugins reagieren auf die gleichen Ereignisse wie Hooks, schicken aber Daten an externe Dienste und verarbeiten Antworten, um Claudes Arbeitsablauf zu beeinflussen.

Hier sind ein paar Aufgaben, für die Claude Code-Plugins super sind:

• CI/CD-Integration: Löst Builds, Tests und Bereitstellungen aus, wenn sich Dateien ändern.

• Projektmanagement: Erstelle oder aktualisiere Probleme automatisch in Jira, GitHub oder Linear.

• Teamkommunikation: Schreib Updates auf Slack oder Teams, wenn sich was ändert.

• Code-Überprüfung: Pull-Anfragen automatisch erstellen und Überprüfungen auf GitHub/GitLab verwalten

• Externe Analyse: Nutze SonarQube, CodeClimate oder Snyk für das Scannen von Unternehmenscode.

• Benutzerdefinierte Tools: Integration in firmeneigene Systeme und Arbeitsabläufe

• IDE-Erweiterungen: Füge benutzerdefinierte Befehle und Navigationshilfen hinzu

Installier Plugins aus einer Registrierung oder entwickle sie intern für deine Organisation und leg dann fest, auf welche Ereignisse sie reagieren sollen. Hooks und Plugins bilden zusammen eine erweiterbare Plattform, die Claude Code an deine bestehende Infrastruktur anpasst.

Fazit

In diesem Tutorial haben wir Claude Code benutzt, um eine Datei im Supabase Python SDK zu überarbeiten, zu dokumentieren und zu debuggen. Wir haben die Lesbarkeit des Codes verbessert, strukturierte Dokumentation hinzugefügt und Importprobleme behoben. Wenn du Claude Code in deinen Arbeitsablauf einbaust, kannst du die Entwicklung optimieren und die Codequalität verbessern. Im Laufe seiner Weiterentwicklung wird es noch präzisere Lösungen bieten – probier es bei deinen eigenen Projekten aus und sieh selbst, wie es wirkt!

Um über die neuesten KI-News auf dem Laufenden zu bleiben, empfehle ich diese Blogs:

• Claude Code 2.1 
• Claude Cowork 
• Claude Fähigkeiten
• Claude Opus 4.5
• Claude Sonnet 4.5