Claude Code für Anfänger: In einer Stunde vom ersten Befehl zum ersten Feature

Claude Code lernen dauert keine Woche. Die meisten Entwickler sind nach einer Stunde produktiv — wenn sie wissen, womit sie anfangen sollen. Dieses Tutorial führt dich vom ersten Befehl bis zum ersten selbst geschriebenen Feature: ohne Vorkenntnisse, ohne Umwege.

1. Was ist Claude Code wirklich?

Der größte Irrtum beim Claude Code Einstieg: Es für einen besseren Chatbot zu halten. Es ist keiner.

ChatGPT gibt dir Ratschläge. Du stellst eine Frage, bekommst Text zurück, kopierst den Code in dein Projekt, merkst dass er nicht kompiliert, stellst die nächste Frage. Du bist der Vermittler zwischen dem Modell und deinem Code — und du machst die Arbeit.

Claude Code macht die Arbeit selbst. Es läuft direkt im Terminal, hat Zugriff auf dein Dateisystem und führt Befehle aus. Wenn du sagst „Schreibe einen Test für die Funktion in utils.py", öffnet Claude Code die Datei, liest sie, schreibt den Test, führt ihn aus und meldet ob er grün ist — alles ohne dass du auch nur die Datei selbst öffnen musst.

Der konkrete Unterschied in der Praxis:

• ChatGPT: „Hier ist ein Beispiel für eine E-Mail-Validierungs-Funktion in Python." Du: kopieren, einfügen, anpassen, testen, nochmal fragen.
• Claude Code: „Schreibe eine Funktion die eine Liste von E-Mails validiert und füge sie in utils.py ein." Claude Code: öffnet utils.py, schreibt die Funktion, fügt sie ein, schreibt einen Test dazu, führt ihn aus.

Claude Code ist kein Assistent, dem du erklärst was du tust. Es ist ein Entwickler, dem du sagst was er tun soll.

2. Erste Schritte ohne Vorkenntnisse

Wenn Claude Code noch nicht installiert ist: Die vollständige Installationsanleitung findest du unter Claude Code installieren. Kurzzusammenfassung für alle die schon Node.js haben:

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

Danach den API-Key einrichten:

claude login

Ein Browser-Tab öffnet sich. Nach der Anmeldung bei Anthropic ist Claude Code einsatzbereit.

Das erste Projekt öffnen

Navigiere in ein beliebiges Projektverzeichnis — es muss kein großes Projekt sein, ein leerer Ordner reicht für den Anfang:

mkdir mein-erstes-projekt
cd mein-erstes-projekt
claude

Claude Code startet im interaktiven Modus. Du siehst eine Eingabeaufforderung. Jetzt kannst du Claude Code direkt ansprechen, und es sieht alles was in diesem Verzeichnis liegt.

Der erste Befehl: ein echtes Beispiel

Kein „Hallo Welt". Direkt etwas Nützliches:

Schreibe eine Python-Funktion die eine Liste von E-Mail-Adressen validiert
und gibt zurück welche gültig und welche ungültig sind.
Speichere sie in email_utils.py und schreibe einen Test dazu.

Claude Code liest das Verzeichnis, erstellt email_utils.py mit der Funktion, erstellt test_email_utils.py mit Tests, führt die Tests aus und meldet dir das Ergebnis. Alles innerhalb von 30 Sekunden.

3. Die 5 wichtigsten Befehle für Anfänger

Diese fünf Aufgaben decken 80 % des Anfänger-Alltags ab. Lerne sie, und du bist sofort produktiv.

Befehl 1: Datei lesen und erklären lassen

Erkläre mir was die Datei config.py macht. Gehe auf jeden Abschnitt ein.

Claude Code öffnet die Datei, liest sie komplett und erklärt sie im Kontext deines Projekts — nicht abstrakt, sondern bezogen auf das was tatsächlich drinsteht. Nützlich wenn du in eine fremde Codebase einsteigst oder nach einer Pause wieder anfängst.

Befehl 2: Code erklären lassen

In database.py, Zeile 47: erkläre was diese Funktion macht und warum
sie so geschrieben ist.

Anders als ein Chatbot sieht Claude Code die echte Datei — du musst den Code nicht kopieren. Es erklärt nicht nur die Syntax, sondern den Zweck im Kontext der restlichen Codebase.

Befehl 3: Bug fixen lassen

Beim Ausführen von main.py bekomme ich diesen Fehler:
TypeError: unsupported operand type(s) for +: 'int' and 'str'
Fix den Bug.

Claude Code liest den Stack-Trace, sucht die Ursache in deinen Dateien, und fixt den Bug direkt. Du musst den Fehler nicht manuell suchen. Bei komplexeren Bugs: Claude Code erklärt auch warum der Bug entstanden ist, nicht nur wie er gefixt wird.

Befehl 4: Test schreiben lassen

Schreibe pytest-Tests für alle Funktionen in user_service.py.
Teste sowohl den Happy Path als auch Fehlerfälle.

Claude Code liest die Datei, identifiziert alle Funktionen, schreibt Tests für den normalen Ablauf und für Fehlerfälle, und führt sie aus. Wenn ein Test fehlschlägt, erklärt es warum — und fragt ob es den Test oder den Code korrigieren soll.

Befehl 5: Refactoring durchführen

Die Funktion process_order in orders.py ist zu lang und macht zu viel.
Teile sie in kleinere Funktionen auf, ohne das Verhalten zu ändern.

Claude Code liest die Funktion, plant das Refactoring, macht die Änderungen und führt anschließend die vorhandenen Tests aus um sicherzustellen dass nichts gebrochen ist. Wenn es keine Tests gibt: es fragt ob es vorher welche schreiben soll.

4. Häufige Anfänger-Fehler vermeiden

Diese Fehler passieren fast jedem — und sie kosten Zeit, die man nicht verschwenden muss.

Fehler 1: Zu vage Prompts

Schlecht: „Mach das besser."

Gut: „Die Funktion calculate_discount in pricing.py ist schwer zu lesen. Benenne die Variablen aussagekräftiger und füge Kommentare für die Geschäftslogik ein."

Je konkreter du bist, desto besser das Ergebnis. Claude Code kann keine Gedanken lesen. Was für dich offensichtlich ist, muss im Prompt stehen.

Fehler 2: Zu große Aufgaben auf einmal

Schlecht: „Baue mir ein komplettes Authentifizierungssystem mit OAuth, JWT, Passwort-Reset und Rate-Limiting."

Gut: „Implementiere zuerst die einfache Passwort-Authentifizierung mit bcrypt. Dann gehen wir zum nächsten Schritt."

Große Aufgaben führen zu großen Commits ohne Überblick. Kleine Schritte erlauben dir zu prüfen ob Claude Code in die richtige Richtung geht — und bei Bedarf früh zu korrigieren.

Fehler 3: Ergebnisse nicht prüfen

Claude Code macht selten grobe Fehler, aber es macht Annahmen. Wenn es eine Funktion implementiert, hat es eine Vorstellung vom erwarteten Verhalten — die mit deiner übereinstimmen kann oder nicht.

Prüfroutine für Anfänger: Bevor du mit Claude Code weitermachst, schau kurz in die geänderten Dateien. Nicht alles lesen, nur ob die Struktur stimmt. Bei Unsicherheit: „Erkläre welche Entscheidungen du getroffen hast und warum."

Fehler 4: Den interaktiven Modus ignorieren

Der interaktive Modus (einfach claude starten) ist mächtiger als Einzelbefehle. Claude Code baut Kontext auf: Es weiß nach zehn Nachrichten mehr über dein Projekt als nach einer. Für komplexere Aufgaben immer den interaktiven Modus nutzen und den Kontext aufbauen lassen.

5. Fortschritt messen: Woche 1 vs. Woche 4

Claude Code wird effizienter je besser du es kennst. Das ist kein Zufall — es liegt daran, dass du lernst wie du Aufgaben formulierst, und Claude Code lernt den Kontext deines Projekts innerhalb einer Session.

Woche 1: Die Orientierungsphase

In der ersten Woche sparst du etwa 30 Minuten pro Tag. Du fragst noch viel nach, formulierst Prompts ungenau und schaust dir jede Änderung genau an — was richtig ist, aber Zeit kostet. Der größte Gewinn in Woche 1: Du hörst auf, Stack-Traces selbst zu debuggen.

Woche 2–3: Die Gewöhnungsphase

Du weißt jetzt was Claude Code gut kann (Boilerplate, Tests, Refactoring, Debugging) und was du selbst besser machst (Architekturentscheidungen, Domänenlogik). Die Zeitersparnis steigt auf 1–2 Stunden täglich. Du gibst größere Blöcke ab und prüfst das Ergebnis statt jeden Schritt.

Woche 4: Der Produktivitätssprung

In Woche 4 sparst du 3 Stunden täglich — und das ist eine konservative Schätzung. Du nutzt Claude Code nicht mehr für einzelne Funktionen, sondern für ganze Features. Du beschreibst was du willst, Claude Code baut es, du reviewst und verfeinert. Die meiste Zeit verbringst du mit Entscheidungen, nicht mit Implementierung.

Der Unterschied zwischen Woche 1 und Woche 4 ist nicht das Werkzeug. Es ist das Wissen darüber, welche Aufgaben du abgeben kannst — und das Vertrauen, sie wirklich abzugeben.

Mehr dazu, wie sich die Produktivitätskurve langfristig entwickelt: Claude Code Produktivität steigern.

6. Nächste Schritte

Du kennst jetzt die Grundlagen: Was Claude Code ist, wie du es installierst, die fünf wichtigsten Befehle, und welche Fehler du vermeidest. Was kommt danach?

Als nächstes lernen:

• CLAUDE.md — die Projektdatei, mit der du Claude Code dauerhafte Anweisungen gibst: Coding Standards, Architekturregeln, Konventionen. Einmal schreiben, immer aktiv.
• Slash Commands — eigene Befehle definieren die du immer wieder benutzt. /fix, /test, /review — angepasst an deinen Workflow.
• MCP-Server — Claude Code mit externen Tools verbinden: Datenbanken, APIs, Browser. Damit wird aus dem Code-Helfer ein vollständiger Entwicklungs-Agent.

Artikel die direkt auf diesem Einstieg aufbauen:

• Claude Code installieren — wenn du das Setup noch nicht abgeschlossen hast oder auf Fehler gestoßen bist
• Claude Code Produktivität steigern — wie du nach dem Einstieg systematisch mehr aus Claude Code herausholst