Erste Schritte mit Claude Code 2026: von der Einrichtung bis zum ersten Commit

Was Claude Code tatsächlich ist

Claude Code ist keine Chat-Oberfläche. Es ist ein Kommandozeilen-Agent, der Ihr Dateisystem liest, Bash-Befehle ausführt, Dateien bearbeitet und auf Basis der eigenen Ausgabe weiteriteriert, bis das von Ihnen beschriebene Ziel erreicht ist. Sie starten ihn in einem Projektverzeichnis, übergeben ihm eine Aufgabe und er arbeitet sie Schritt für Schritt ab – bestehenden Code lesen, Änderungen vornehmen, Tests ausführen und bei Fehlschlägen zurückspringen.

Die praktische Konsequenz daraus: Claude Code arbeitet am besten mit realen, klar abgegrenzten Problemen in echten Codebases. Die Bitte „Hilf mir mit meinem Projekt“ führt zu Drift. Die Bitte „Füge der Funktion createUser in src/api/users.ts eine Eingabevalidierung hinzu und aktualisiere die zugehörigen Tests“ liefert Ergebnisse.

Schritt 1 – Installation

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

Bestätigen Sie, dass die Installation erfolgreich war:

claude --version
# → claude-code 1.x.x

Erscheint unter macOS oder Linux ein Berechtigungsfehler, ist die übliche Lösung, die Eigentümerrechte des globalen npm-Verzeichnisses anzupassen, statt npm mit sudo auszuführen. Die Anthropic-Dokumentation behandelt dies im Voraussetzungs-Abschnitt. Unter Windows lassen sich die meisten Berechtigungsprobleme lösen, indem Sie das Terminal als Administrator starten; für intensive agentische Arbeit ist der Weg über WSL2 jedoch zuverlässiger.

Schritt 2 – Authentifizieren

claude login

Damit öffnet sich ein Browserfenster zur Durchführung des OAuth-Vorgangs. Nach Abschluss werden die Zugangsdaten in ~/.claude/ abgelegt, und Sie müssen diesen Schritt nur dann wiederholen, wenn Sie das Konto wechseln.

Wenn Sie direkt einen API-Schlüssel verwenden – etwa in einer CI-Umgebung oder auf einem Rechner ohne Browserzugriff –, setzen Sie stattdessen die Umgebungsvariable:

export ANTHROPIC_API_KEY="sk-ant-api03-..."

Das Claude-Pro-Abonnement enthält ein monatliches Token-Kontingent, das eine moderate Einzelnutzung abdeckt. Wenn Sie Claude Code auf großen Codebases laufen lassen, umfangreiche Tests schreiben oder es in Schleifen einsetzen, werden Sie das Pro-Limit voraussichtlich erreichen und mit API-Guthaben aufstocken müssen. Die Anthropic-Konsole zeigt Ihren Verbrauch in Echtzeit an – prüfen Sie sie nach den ersten Sitzungen, um Ihren Verbrauch einzuschätzen.

Schritt 3 – Schreiben Sie Ihre CLAUDE.md

Eine minimale, aber wirksame CLAUDE.md deckt fünf Dinge ab:

# Projekt: [Name]

## Stack
- Laufzeit: Node 20, TypeScript 5.3
- Framework: Next.js 14 (App Router)
- Datenbank: PostgreSQL über Prisma
- Tests: Vitest, ausgeführt mit `npm test`

## Befehle
- Dev-Server: `npm run dev`
- Build: `npm run build`
- Lint: `npm run lint` – vor dem Commit ausführen
- Migration: `npx prisma migrate dev`

## Regeln
- Alle neuen API-Routen unter src/app/api/
- Zod für jede Eingabevalidierung – kein direkter Zugriff auf req.body
- Das Verzeichnis /legacy/ niemals anrühren
- console.error-Aufrufe in Error-Handlern nicht entfernen

## Niemals
- npm-Pakete installieren ohne vorherige Rückfrage
- .env-Dateien verändern
- Datenbankmigrationen ohne Bestätigung ausführen

Den Abschnitt „Niemals“ überspringen die meisten Entwickler im ersten Anlauf – und genau er verhindert die teuersten Fehler. Wenn es Dateien gibt, die Claude nie anrühren darf, benennen Sie sie. Wenn es Befehle gibt, die Claude nie eigenständig ausführen darf, formulieren Sie das ausdrücklich.

Eine vertiefte Behandlung der CLAUDE.md-Struktur finden Sie in unserem Beitrag Eine CLAUDE.md schreiben, die wirklich funktioniert. Das Septim-Starter-Paket (9 USD) enthält erprobte Vorlagen für fünf häufige Projekttypen – Next.js, Python Flask, Rails, Go und reines Node –, sodass Sie nicht mit einer leeren Datei beginnen müssen.

Schritt 4 – Eine echte Aufgabe übergeben

cd ~/projects/my-app
claude

Geben Sie an der Eingabeaufforderung eine Aufgabe vor, die einen klaren Fertigstellungspunkt hat. Geeignete erste Aufgaben für Einsteiger:

• Fügen Sie der Route /api/login einen Rate Limiter hinzu – 5 Versuche pro Minute pro IP, bei Überschreitung 429.
• Schreiben Sie Unit-Tests für jede Funktion in src/lib/date-utils.ts – Ziel: 90 Prozent Branch-Coverage.
• Refaktorieren Sie src/components/UserTable.tsx so, dass anstelle direkter fetch-Aufrufe React Query verwendet wird.

Claude Code liest die relevanten Dateien, schlägt Änderungen vor und holt sich vor jedem Schreibvorgang oder Befehl Ihre Erlaubnis. In der Standardkonfiguration bestätigt es jede Schreiboperation – das ist der richtige Modus, um das Werkzeug kennenzulernen. Sie können diese Berechtigungen in ~/.claude/settings.json lockern oder verschärfen, sobald Sie das Verhalten des Werkzeugs verstanden haben.

Was während der agentischen Schleife passiert

Eine typische Claude-Code-Aufgabe durchläuft diesen Zyklus:

1. Lesen der relevanten Quelldateien zum Verständnis der aktuellen Struktur
2. Vorschlagen eines Implementierungsplans samt Liste der zu bearbeitenden Dateien
3. Schreiben der Änderungen Datei für Datei mit Erläuterung
4. Ausführen der Testsuite (sofern in der CLAUDE.md konfiguriert) und Iteration bei Fehlschlägen
5. Meldung über den Abschluss und Auflistung jeder geänderten Datei

Bei einfachen Aufgaben – einer Form ein Feld hinzufügen, eine kleine Hilfsfunktion schreiben, einen Typfehler beheben – läuft das in unter zwei Minuten ab. Bei größeren Aufgaben (Modul refaktorieren, Feature durchgehend ergänzen) sollten Sie 5 bis 15 Minuten und einige Iterationsrunden einkalkulieren.

Schritt 5 – Prüfen Sie Ihre Kosten

Die Anthropic-Konsole unter console.anthropic.com zeigt Ihren Token-Verbrauch nach Modell und Datum aufgeschlüsselt. Prüfen Sie nach den ersten zwei oder drei Sitzungen das Dashboard, um Ihre Verbrauchsrate zu verstehen, bevor Sie Claude Code für längere Aufgaben einsetzen.

Drei Muster führen erfahrungsgemäß zu unerwarteten Kosten:

• Große Dateien im Kontext. Wenn Claude Code eine Datei mit 10.000 Zeilen liest, um eine Frage zu einer Funktion zu beantworten, haben Sie 10.000 Zeilen Input-Token bezahlt. Lenken Sie das Werkzeug auf konkrete Dateien, statt breite Fragen zur gesamten Codebase zu stellen.
• Wiederholter Kontextaufbau. Jede neue Nachricht innerhalb einer Sitzung sendet die gesamte Konversationshistorie erneut. Lange Sitzungen werden teuer. Starten Sie für nicht zusammenhängende Aufgaben jeweils neue Sitzungen, statt eine Sitzung den ganzen Tag fortzuführen.
• Sub-Agenten-Spawning. Claude Code kann für parallele Arbeit Sub-Agenten erzeugen. Jeder Sub-Agent trägt seinen eigenen Kontext. Wenn Sie mehrere Agenten gleichzeitig laufen lassen, skalieren Ihre Kosten entsprechend. Der Tokenocalypse-Leitfaden geht im Detail darauf ein – siehe die Sub-Agenten-Kostenanalyse.

Eine sauber zugeschnittene Coding-Aufgabe kostet typischerweise 0,05 bis 0,40 USD an API-Guthaben, abhängig von Dateigröße und Komplexität. Eine Sitzung, in der Sie Claude Code bitten, Ihre gesamte Codebase zu verstehen, bevor es überhaupt etwas tut, kann mehrere Dollar kosten. Die in Schritt 3 angelegte CLAUDE.md reduziert genau dieses zweite Muster spürbar – vorab gegebener Kontext ersetzt Token, die sonst für Erkundung verbraucht würden.

Häufige Fehler in der ersten Sitzung

Claude Code zu bitten: „Schau dir mein Projekt an und sag mir, was nicht stimmt“

Damit verbrennt das Werkzeug das Kontextfenster auf einer Erkundungstour. Die Ausgabe ist ein allgemeines Code-Review, das durchaus reale Probleme finden kann, jedoch zu erheblichen Token-Kosten. Nutzen Sie für strukturierte Code-Review-Übungen Septim Drills (29 USD), oder lenken Sie Claude Code auf eine konkrete Datei mit einer konkreten Frage.

Den Plan nicht zu lesen, bevor man ihn freigibt

Claude Code schlägt vor jeder Ausführung einen Plan vor. Lesen Sie ihn. Bei komplexen Aufgaben enthält der Plan zuweilen Schritte, die Sie nicht autorisiert hätten – eine Tabelle löschen, einen Cache-Layer entfernen, eine Datei anrühren, die Sie ausdrücklich ausgeschlossen hatten. Das in der Planungsphase abzufangen, kostet nichts. Es nach den Schreibvorgängen abzufangen, kostet einen git revert.

Ohne Versionskontrolle zu arbeiten

Claude Code schreibt auf die Festplatte. Lassen Sie es ausschließlich in Repositories mit sauberem Working Tree laufen, damit Sie jede Änderung mit git diff prüfen und alles Unerwünschte mit git checkout . verwerfen können. Wenn Sie Git noch nicht nutzen, initialisieren Sie ein Repository, bevor Sie die erste Sitzung starten.

Die CLAUDE.md zu überspringen

Ohne CLAUDE.md leitet Claude Code den Projektkontext aus eigener Datei-Erkundung her. Diese Herleitung kostet Token und liegt häufig falsch – bei Konventionen, verbotenen Befehlen und Test-Runnern. Die 20 Minuten, die Sie in Schritt 3 in die CLAUDE.md investieren, sparen Sie in der ersten Nutzungswoche um ein Vielfaches wieder ein.

Wo es weitergeht

Sobald Sie ein paar Aufgaben erfolgreich abgeschlossen haben, ist der natürliche nächste Schritt, Claude Code mit MCP-Servern zu erweitern – Integrationen, die ihm Zugriff auf externe Werkzeuge wie Ihre Datenbank, GitHub oder einen Browser geben. Eine praktische Anleitung finden Sie im MCP-Server-Tutorial.

Wenn Sie Claude Code in einem Team einsetzen und automatisierte PR-Reviews einrichten möchten, behandelt der Leitfaden zur PR-Review-Einrichtung die GitHub-Action-Konfiguration durchgehend.

Für Kostenmanagement im größeren Maßstab – wenn Sie die Anfängerphase hinter sich gelassen haben und Claude Code täglich nutzen – siehe den Leitfaden zur Kostenüberwachung sowie den Beitrag zum Kontextmanagement.