Claude Code: Ein Leitfaden mit praktischen Beispielen

Was ist der Claude Code?

Claude Code ist ein Tool, das direkt in deinem Terminal arbeitet, deine Codebasis versteht und dich bei Entwicklungsaufgaben mit natürlichsprachlichen Befehlen unterstützt. Durch die Integration in deine Entwicklungsumgebung macht Claude Code zusätzliche Server oder komplexe Einstellungen überflüssig, sodass sich die Entwickler auf das Schreiben und Verbessern des Codes konzentrieren können. 

Hier sind ein paar wichtige Funktionen von Claude Code:

• Editieren und Refactoring: Verändere, optimiere und verbessere deine Codebasis mit KI-gestützten Vorschlägen.
• Fehlerbehebung: Identifiziere und behebe Fehler, fehlende Abhängigkeiten und Leistungsengpässe.
• Code verstehen: Stelle Fragen zur Architektur, Logik und den Abhängigkeiten deines Codes.
• Automatisiertes Testen und Linting: Führe fehlgeschlagene Tests aus und korrigiere sie, führe Linting-Befehle aus und verbessere die Codequalität.
• Git-Integration: Durchsuche den Git-Verlauf, löse Merge-Konflikte, erstelle Commits und generiere mühelos Pull Requests.

Egal, ob du an einem Open-Source-Projekt arbeitest oder Codebasen auf Unternehmensebene verwaltest, Claude Code hilft dir mit intelligenter Automatisierung, die sich an deinen Codierungsstil und deine Projektanforderungen anpasst. Hier sind einige ideale Nutzer für diesen Dienst:

• Software-Entwickler: Verbesserung der Codequalität und Wartbarkeit.
• Open Source Contributors: Verstehen und Verbessern unbekannter Codebasen.
• DevOps-Ingenieure: Automatisierung von Code-Review- und Linting-Aufgaben.

Im Moment ist Claude Code nur als Vorschau verfügbar, und Entwickler sind aufgefordert, ihn zu testen und Feedback zu geben - wenn du dich noch nicht angemeldet hast, kannst du dich auf die Warteliste hier.

Lasst uns mit unserem praktischen Projekt beginnen.

Schritt 1: Claude Code einrichten

Sobald du von der Warteliste gestrichen bist, stellt dir das Anthropic-Team einen Link zur Verfügung, über den du dich authentifizieren und Claude Code lokal ausführen kannst. 

Dadurch wirst du umgeleitet, um dein Anthropic-Konto mit Claude Code zu verbinden. Autorisiere die Verbindung und du bist fertig. Stellen Sie sicher, dass Ihr Konto eine aktive Rechnungsstellung eingerichtet ist.

Als nächstes führst du einfach den folgenden Befehl in deinem Terminal aus.

npm install -g @anthropic-ai/claude-code

Mit diesem Befehl installierst du Claude Code auf deinem Rechner. Nach der Installation navigierst du zu deinem Projektverzeichnis und startest Claude, indem du ihn ausführst:

cd your-project-directory
claude

Jetzt ist der Claude Code einsatzbereit.

Schritt 2: Entwicklungsumgebung einrichten

Für diese Demo verwende ich die Supabase Python-Bibliothek supabase-pyeinen Open-Source-Python-Client für die Interaktion mit Supabase, einem Backend-as-a-Service, der auf PostgreSQL. Supabase bietet eine Reihe von Tools, darunter Authentifizierung, Echtzeit-Abonnements, Speicherung und automatisch generierte APIs.

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

1. Öffne dein Terminal, navigiere zu dem Verzeichnis, in das du das Supabase-py-Repository klonen möchtest (z.B. cd Desktop), und führe den folgenden Befehl aus:

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 nun mit allen notwendigen Abhängigkeiten ausgestattet, um die Supabase-Bibliothek auszuführen, und dein Repository kann erkundet werden. 

Schritt 3: Identifiziere Bereiche für Beiträge

Eine gute Möglichkeit, etwas beizutragen, ist die RegisterkarteIssues auf GitHub. Im Supabase-Repository habe ich unter client.py ein Problem mit der Lesbarkeit des Codes, der Struktur und dem Fehlen von sinnvollen Kommentaren festgestellt.

Hier ist, was wir mit Claude Code machen werden:

• Wir werden den Code refaktorisieren, um die Lesbarkeit, Wartbarkeit und Struktur zu verbessern.
• Füge aussagekräftige Docstrings und Inline-Kommentare hinzu, um den Zweck der verschiedenen Komponenten zu verdeutlichen.
• Identifiziere und behebe Bugs, indem du Probleme und andere potenzielle Fehler analysierst.

Schritt 4: Experimentieren mit Claude Code

Da wir uns bereits im Ordner supabase-py befinden, navigiere zum supabase-Verzeichnis, das die Datei client.py enthält, und führe Claude Code aus:

cd supabase
claude

Claude Code hat jetzt Zugriff auf alle Dateien und Ordner im Ordner Supabase-py. Jetzt lass uns experimentieren.

Refactoring von Code

Im Rahmen der Verbesserung des Supabase Python SDK wird die Datei client.py überarbeitet, um die Lesbarkeit, Wartbarkeit und Organisation zu verbessern. Gib einfach die folgende Eingabeaufforderung in die Befehlszeile ein:

Prompt: Überarbeite den Code in der Datei client.py, die sich im Ordner Supabase befindet.

Claude bittet um Bestätigung, bevor er fortfährt. Drücke Enter um die Änderungen zu bestätigen. Sobald der Vorgang abgeschlossen ist, aktualisiert Claude Code die Datei, zeigt die Änderungen im Terminal an und gibt eine Zusammenfassung der vorgenommenen Änderungen aus.

Mit Hilfe von Claude Code haben wir die folgenden Verbesserungen an client.py vorgenommen:

• Organisierte Importe:  Claude Code gruppierte zusammenhängende Importe in logische Abschnitte (Auth-Fehler, API-Typen, Funktionsfehler), benannte Importe zur besseren Übersichtlichkeit um und entfernte überflüssige Aliase, um die Konsistenz zu gewährleisten.
• Verbesserte Lesbarkeit: Es fügte Abschnittskommentare hinzu, um Importe zu klassifizieren, und entfernte Duplikate in der Liste __all__, um die Organisation zu verbessern.
• Vereinfachte Kundenoptionen: Außerdem wurden mehrere Zeilen reduziert, indem ähnliche Importe in einer einzigen Anweisung zusammengefasst werden.

Hier siehst du einen Vergleich zwischen dem ursprünglichen und dem umgestalteten Code.

Code dokumentieren

Zusätzlich zum Refactoring ist Claude Code ein leistungsfähiges Werkzeug zum Erstellen, Verbessern und Standardisieren der Codedokumentation. Es kann undokumentierte Abschnitte identifizieren, strukturierte Dokumentationsstrings oder Kommentare erstellen und die Einhaltung von Projektdokumentationsstandards sicherstellen.

Wir haben Claude Code benutzt, um die Dokumentation in client.py zu verbessern:

• Klare Docstrings auf Modulebene, die den Zweck der Datei erklären.
• Detaillierte Abschnittskommentare, die die Importe kategorisieren (Fehlertypen, Client-Implementierungen, Speicherdienste).
• Inline-Kommentare zur Beschreibung von Fehlertypen, Client-Funktionen und wichtigen Komponenten.

Hier ist ein direkter Vergleich zwischen refaktorisiertem und dokumentiertem Code.

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

Sobald die Dokumentation hinzugefügt wurde, kannst du ihre Übereinstimmung mit deinen Projektstandards überprüfen, indem du Claude aufforderst:

Prompt: Prüfe, ob die Dokumentation unseren Projektstandards entspricht.

Fehler beheben

Die Fehlersuche kann zeitaufwändig sein, aber Claude Code macht sie einfacher, indem es Fehlermeldungen analysiert, die Ursachen identifiziert und Korrekturen vorschlägt. Ganz gleich, ob du mit fehlenden Importen, Laufzeitfehlern oder Logikproblemen zu kämpfen hast, es hilft dir, den Prozess zu optimieren, indem es umsetzbare Lösungen bietet.

Hier erfährst du, wie du Claude Code zum Debuggen verwenden kannst:

1. Identifiziere das Problem:  Teile die Fehlermeldung mit Claude.
2. Hol dir Empfehlungen für Reparaturen: Frage Claude nach möglichen Lösungen.
3. Wende die Korrektur an und überprüfe sie:  Setze die Vorschläge von Claude um und überprüfe, ob das Problem gelöst ist.

Claude Code hat die folgenden Vorkehrungen getroffen, um importbezogene Probleme in der Datei client.py zu lösen: 

• Tippe Kommentare ignorieren: # type: ignore Kommentar hinzugefügt, um IDE- und Typprüfungswarnungen für nicht aufgelöste Importe zu unterdrücken.
• Konsistente Fehlerkategorisierung: Claude Code hat dafür gesorgt, dass die Fehlerimporte von Authentifizierung, Datenbank, Speicher und Funktionen klar gruppiert sind.
• Die Lesbarkeit des Codes wurde beibehalten: Es wurden Kommentare hinzugefügt, um anzugeben, warum bestimmte Importe ignoriert wurden, anstatt sie zu entfernen.

Hier siehst du einen Vergleich zwischen dem ursprünglichen Code und dem korrigierten Code.

Aufforderung: Ich sehe einige Fehler, wie z.B. "Import gotrue.errors" konnte nicht behoben werden. Hilf mir, alle Fehler in der client.py zu beheben.

Hinweis: Claude Code befindet sich noch in der Vorschau. Anstatt einen Importbefehl vorzuschlagen, um das Problem zu lösen, wurde ein Ignorierkommentar hinzugefügt, um den Fehler zu unterdrücken. Wenn sie weiter verbessert wird, wird sie noch präzisere Lösungen bieten.

Claude Code Befehle

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

Ichempfehle auchdie Tutorials, die Antrophic hier.

Fazit

In diesem Lernprogramm haben wir Claude Code verwendet, um eine Datei im Supabase Python SDK zu refaktorieren, zu dokumentieren und zu debuggen. Wir haben die Lesbarkeit des Codes verbessert, eine strukturierte Dokumentation hinzugefügt und Importprobleme behoben. Indem du Claude Code in deinen Arbeitsablauf integrierst, kannst du die Entwicklung rationalisieren und die Codequalität verbessern. Mit seiner Weiterentwicklung wird es noch präzisere Lösungen bieten - probiere es bei deinen eigenen Projekten aus und sieh die Auswirkungen!

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

• Claude 3.7 Sonett: Funktionen, Zugang, Benchmarks & mehr
• ChatGPT 4.5: Funktionen, Zugang, GPT-4o Vergleich & mehr
• Claude 3.7 Sonnet API: Ein Leitfaden mit Demo-Projekt