Claude Code für Anfänger: Dein erstes Projekt in 15 Minuten

TL;DR

Claude Code ist ein KI-Agent, der direkt im Terminal läuft. Installation dauert 2 Minuten. In 15 Minuten baust du dein erstes Projekt: eine funktionierende Web-App mit HTML, CSS und JavaScript. Alles, was du brauchst, ist Node.js und einen Anthropic-Account.

---

Was ist Claude Code?

Claude Code ist ein Terminal-Tool von Anthropic. Du tippst in natürlicher Sprache, was du willst. Claude liest deine Dateien, schreibt Code, führt Befehle aus und bearbeitet bestehende Projekte.

Im Gegensatz zu Chat-Interfaces wie claude.ai arbeitet Claude Code direkt im Dateisystem. Es sieht deinen Projektordner, kennt die Dateistruktur und kann Änderungen an mehreren Dateien gleichzeitig vornehmen.

4% aller GitHub Commits werden heute von Claude Code erstellt. Anthropic erreicht mit dem Tool über 2,5 Milliarden Dollar Jahresumsatz. Es ist kein Experiment mehr, sondern ein Produktionswerkzeug. Einen tieferen Einblick in die Funktionsweise gibt unser kompletter Guide: Was ist Claude Code?

Voraussetzungen

Du brauchst drei Dinge:

1. Node.js (Version 18+)

Prüfe, ob Node.js installiert ist:

node --version

Falls nicht installiert, lade es von nodejs.org herunter. Die LTS-Version reicht.

2. Anthropic-Account

Erstelle einen Account auf console.anthropic.com. Du brauchst den API-Zugang, nicht den Pro Plan.

3. API Key

Nach der Registrierung erstellst du einen API Key unter "API Keys". Kopiere den Key. Du brauchst ihn gleich.

Kosten: Du zahlst pro Nutzung. Ein typischer Nachmittag mit Claude Code kostet zwischen 2 und 10 Dollar. Es gibt kein Abo, keine Mindestlaufzeit.

Installation in 2 Minuten

Öffne dein Terminal und führe aus:

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

Das installiert Claude Code global. Prüfe die Installation:

claude --version

Beim ersten Start fragt Claude Code nach deinem API Key. Gib den Key ein, den du von der Anthropic Console kopiert hast.

Alternativ setzt du den Key als Umgebungsvariable:

export ANTHROPIC_API_KEY=dein-key-hier

Das war die Installation. Kein Docker, kein Build-Prozess, keine Config-Dateien. Falls du auf Probleme stößt, hilft unsere ausführliche Installations-Anleitung mit Troubleshooting.

Dein erstes Projekt: Eine Aufgaben-App

Erstelle einen neuen Ordner und starte Claude Code:

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

Claude Code startet und wartet auf deine Eingabe.

Schritt 1: Projekt beschreiben

Tippe:

Erstelle eine einfache Aufgaben-App (Todo App) als Single-Page-App.
Verwende HTML, CSS und JavaScript. Keine Frameworks.
Features: Aufgaben hinzufügen, als erledigt markieren, löschen.
Das Design soll modern und minimalistisch sein mit dunklem Theme.

Claude Code erstellt jetzt die Dateien. Du siehst im Terminal, welche Dateien angelegt werden und was drin steht.

Schritt 2: Ergebnis ansehen

Claude wird die Dateien erstellen und dir anbieten, einen lokalen Server zu starten. Wenn nicht, frage:

Starte einen lokalen Server, damit ich die App im Browser sehen kann.

Öffne die angezeigte URL (typischerweise http://localhost:3000 oder http://localhost:8080) im Browser.

Schritt 3: Iterieren

Die App funktioniert, aber du möchtest etwas ändern:

Füge eine Filterfunktion hinzu: Alle, Offen, Erledigt.
Die Aufgaben sollen im LocalStorage gespeichert werden,
damit sie nach dem Neuladen noch da sind.

Claude Code ändert die bestehenden Dateien. Du siehst die Änderungen sofort im Browser.

Schritt 4: Erweitern

Füge ein Fälligkeitsdatum hinzu. Überfällige Aufgaben sollen
rot markiert werden. Sortiere die Liste nach Fälligkeitsdatum.

In 15 Minuten hast du eine funktionierende App mit Persistenz, Filtern und Datumslogik.

Plan Mode: Erst denken, dann coden

Claude Code hat einen Plan Mode. Statt direkt Code zu schreiben, erstellt Claude zuerst einen Plan und wartet auf deine Bestätigung.

Aktiviere den Plan Mode mit Shift+Tab oder tippe:

Plane zuerst: Wie würdest du ein Kontaktformular mit E-Mail-Versand umsetzen?

Claude zeigt dir:

• Welche Dateien erstellt oder geändert werden
• Welche Technologien zum Einsatz kommen
• Welche Schritte in welcher Reihenfolge nötig sind

Du kannst den Plan anpassen, bevor Claude mit der Umsetzung beginnt. Für größere Features ist der Plan Mode sinnvoll, weil du Fehlentscheidungen früh erkennst.

Die wichtigsten Befehle

Befehl	Funktion
claude	Claude Code starten
/init	CLAUDE.md generieren (Projekt-Kontext)
/clear	Konversation zurücksetzen
/cost	Bisherige Kosten der Session anzeigen
/help	Hilfe anzeigen
Shift+Tab	Zwischen Plan Mode und Code Mode wechseln
Escape	Laufende Aktion abbrechen
/quit	Claude Code beenden

Alle Befehle, Shortcuts und CLI-Flags im Detail findest du in unserem Claude Code Befehle Cheatsheet.

Nützliche Prompts für den Alltag

Erkläre mir die Dateistruktur dieses Projekts.

Welche Dependencies hat dieses Projekt und wofür sind sie?

Finde und behebe Bugs in der Datei app.js.

Schreibe Tests für die Funktion calculateTotal.

Refactore die Datei utils.js - zu viele Verantwortlichkeiten.

Was kann schiefgehen? Häufige Anfängerfehler

Fehler 1: Zu große Projekte auf einmal

Problem: "Baue mir ein komplettes SaaS mit Auth, Payments, Dashboard und Admin-Panel."

Lösung: Starte klein. Eine Seite. Eine Funktion. Erweitere schrittweise. Claude arbeitet besser, wenn es klare, begrenzte Aufgaben bekommt.

Fehler 2: Unklare Beschreibungen

Problem: "Mach es schöner."

Lösung: "Ändere den Hintergrund zu #1a1a2e, die Buttons zu abgerundeten Ecken (8px) mit einem Hover-Effekt, der die Helligkeit um 10% erhöht." Spezifisch schlägt vage.

Fehler 3: Fehlermeldungen ignorieren

Problem: Claude zeigt eine Warnung oder Fehlermeldung, du ignorierst sie und machst weiter.

Lösung: Lies die Fehlermeldung. Kopiere sie in den Chat. Claude kann die meisten Fehler selbst beheben, wenn es sie kennt.

Fehler 4: Kontext verlieren

Problem: Nach vielen Änderungen weiß Claude nicht mehr, was das Projektziel ist.

Lösung: Erstelle eine CLAUDE.md mit /init. Diese Datei gibt Claude bei jedem Start den nötigen Kontext. Für größere Projekte ist sie unverzichtbar. Wie du sie optimal aufbaust, zeigt unser CLAUDE.md Guide.

Fehler 5: Alles akzeptieren

Problem: Claude schreibt Code, du klickst immer auf "Accept" ohne zu lesen.

Lösung: 95% der Entwickler müssen KI-generierten Code prüfen und nacharbeiten. Das gilt auch für Anfänger. Lies zumindest die Zusammenfassung, die Claude zu jeder Änderung liefert.

Fehler 6: API-Kosten nicht im Blick

Problem: Du experimentierst stundenlang und die Kosten summieren sich.

Lösung: Nutze /cost regelmäßig. Setze ein monatliches Limit in der Anthropic Console. Ein typischer Tag kostet 2-10 Dollar, aber große Projekte mit vielen Dateien können mehr verbrauchen.

Nächste Schritte

Nach deinem ersten Projekt:

1. CLAUDE.md einrichten: Führe /init aus und passe die generierte Datei an dein Projekt an.
2. Git nutzen: Claude Code arbeitet hervorragend mit Git. Es kann Commits erstellen, Branches wechseln und Diffs anzeigen.
3. Frameworks ausprobieren: Lass Claude ein Next.js- oder React-Projekt aufsetzen.
4. Bestehende Projekte öffnen: Navigiere in ein bestehendes Projekt und frage Claude: "Erkläre mir dieses Projekt."
5. Best Practices lernen: Unsere Claude Code Best Practices helfen dir, typische Fehler zu vermeiden und das Beste aus dem Tool herauszuholen.

Cowork: Claude Code für Nicht-Entwickler

Seit Januar 2026 bietet Anthropic "Cowork" an. Das ist Claude Code mit einer grafischen Oberfläche, optimiert für Nicht-Entwickler. Statt Terminal-Befehle zu tippen, arbeitest du in einer visuellen Umgebung.

Für den Einstieg empfehlen wir trotzdem das Terminal. Du verstehst besser, was passiert, und hast mehr Kontrolle. Cowork ist eine Option, wenn du dich im Terminal unwohl fühlst.

---

FAQ

Was kostet Claude Code?

Du zahlst pro API-Nutzung. Es gibt kein Abo. Ein typischer Tag kostet 2-10 Dollar. Sonnet 4.5 kostet $3 pro Million Input-Tokens und $15 pro Million Output-Tokens. Opus 4.5 kostet $5/$25.

Brauche ich Programmierkenntnisse?

Nein, nicht zwingend. Claude Code schreibt den Code für dich. Aber: Je mehr du über Programmierung verstehst, desto bessere Anweisungen kannst du geben und desto besser kannst du den Output beurteilen.

Läuft Claude Code auf Windows?

Ja. Claude Code unterstützt macOS, Linux und Windows (über WSL2). Auf Windows brauchst du das Windows Subsystem for Linux.

Wie viel Speicherplatz braucht Claude Code?

Die Installation über npm ist klein (unter 100 MB). Claude Code selbst verbraucht wenig Ressourcen. Die Arbeit passiert auf Anthropics Servern.

Kann Claude Code bestehende Projekte bearbeiten?

Ja. Navigiere im Terminal zum Projektordner und starte claude. Das Tool liest die bestehende Dateistruktur und kann Änderungen an vorhandenen Dateien vornehmen.

Was ist der Unterschied zwischen Claude Code und claude.ai?

Claude.ai ist ein Chat-Interface im Browser. Claude Code ist ein Terminal-Tool, das direkt im Dateisystem arbeitet. Claude Code kann Dateien lesen, erstellen, ändern und Befehle ausführen. Das Chat-Interface kann das nicht.

Kann ich Claude Code offline nutzen?

Nein. Claude Code braucht eine Internetverbindung, weil die KI-Modelle auf Anthropics Servern laufen. Ohne Internet funktioniert das Tool nicht.

Wie breche ich eine laufende Aktion ab?

Drücke Escape. Claude Code stoppt die aktuelle Aktion. Deine Dateien bleiben im letzten gespeicherten Zustand.