Claude Code: Die Anleitung für Nicht-Programmierer

Vom „ich kenne den Unterschied zwischen Datei und Ordner" zum eigenen funktionierenden Tool

📌 In Kürze

Worum es geht: Claude Code ist ein KI-Werkzeug, das nicht nur Code-Schnipsel ausspuckt, sondern direkt auf deinem Rechner arbeitet – Dateien anlegt, bearbeitet, Befehle ausführt und Fehler selbst behebt. Du beschreibst auf Deutsch, was du willst. Claude tippt.

Für wen das funktioniert: Wer programmieren kann, profitiert. Aber auch wer es nicht kann, kommt mit ein bisschen Geduld zu Ergebnissen, die früher nur mit einem kleinen Entwicklerteam möglich waren.

Was du in diesem Artikel findest: Den offiziellen Setup-Weg in acht Schritten, die wichtigsten Befehle – und eine Sammlung Praxis-Tipps, die in der offiziellen Doku noch nicht stehen, aber den Alltag deutlich besser machen.

Was Claude Code von ChatGPT unterscheidet

Im normalen Chat – egal ob ChatGPT oder Claude im Browser – läuft das so ab:

1. Du stellst eine Frage.
2. Du bekommst Code zurück.
3. Du kopierst den Code in einen Editor.
4. Du speicherst die Datei.
5. Du führst sie aus, siehst den Fehler, kopierst die Fehlermeldung zurück in den Chat.
6. Goto 1.

Claude Code überspringt die Schritte 3–5. Es liest und schreibt Dateien direkt auf deiner Festplatte, führt Befehle aus, beobachtet die Ausgabe – und reagiert darauf.

🛡️ Sicherheitsnetz: Claude Code fragt vor jeder Änderung um Erlaubnis. Du siehst den geplanten Diff, bevor irgendetwas passiert. Bestätigen oder ablehnen.

Wo läuft Claude Code?

Claude Code begann als Terminal-Tool, ist heute aber an mehreren Stellen verfügbar:

💡 Hinweis zur Desktop-App: Die Desktop-Variante ist mittlerweile sehr ausgereift und für den Alltag oft die komfortabelste Lösung. Trotzdem lohnt es sich, die CLI-Befehle zu kennen – ohne sie schöpfst du das Tool nicht voll aus, weil viele Power-Features (z. B. /init, /hooks, /compact) genauso über die Desktop-Eingabe laufen.

Diese Anleitung folgt dem offiziellen Quickstart und nutzt das Terminal als Referenz – die Konzepte sind aber überall dieselben.

Voraussetzungen

Bevor's losgeht, brauchst du drei Dinge:

• Ein Terminal: Auf macOS heißt das einfach „Terminal", auf Windows „PowerShell", auf Linux meist über Ctrl + Alt + T erreichbar.
• Ein Code-Projekt zum Spielen: Auch ein leerer Ordner reicht für den Anfang.
• Ein Claude-Abonnement: Pro, Max, Teams oder Enterprise – oder alternativ ein Console-Konto mit Prepaid-Guthaben (für Cloud-Setups gibt es auch Bedrock, Vertex AI und Microsoft Foundry).

⚠️ API-Falle am Anfang: Verlockend wirkt der direkte API-Zugang („zahl nur, was du verbrauchst"). In der Praxis ist das gerade in der Lernphase eine Kostenfalle, weil man viel ausprobiert. Mit dem Pro-Abo (~ 20 €/Monat) hast du eine planbare monatliche Pauschale.

Schritt 1 · Installation

Es gibt drei empfohlene Wege:

Variante A · Native Installation (Standard)

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell (als Administrator):

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

💡 Native Installationen aktualisieren sich automatisch im Hintergrund auf die neueste Version.

Variante B · Homebrew (macOS / Linux)

brew install --cask claude-code

Hinweis: Homebrew aktualisiert nicht automatisch. Mit brew upgrade claude-code regelmäßig nachziehen.

Variante C · WinGet (Windows)

winget install Anthropic.ClaudeCode

Ebenfalls ohne Auto-Update – mit winget upgrade Anthropic.ClaudeCode nachhalten.

❌ NPM-Installation ist veraltet. Wer den älteren Weg über npm install -g @anthropic-ai/claude-code kennt – Anthropic empfiehlt ihn nicht mehr.

Schritt 2 · Anmelden

Nach dem Installieren claude im Terminal aufrufen. Beim ersten Start wirst du automatisch durch den Login geführt. Möchtest du später das Konto wechseln, hilft /login.

claude       # erstmaliger Start, führt Login durch
/login       # innerhalb einer Session: Konto wechseln

Anmeldedaten werden gespeichert – einmalig genügt.

Schritt 3 · Erste Session starten

In den Projektordner wechseln und Claude Code starten:

cd ~/projekte/mein-projekt
claude

Der Willkommensbildschirm zeigt dir Sitzungsinfos, kürzliche Gespräche und Updates. /help listet alle verfügbaren Befehle, /resume setzt ein früheres Gespräch fort.

Schritt 4 · Lass Claude dein Projekt verstehen

Bevor du Änderungen vornehmen lässt, lass Claude zuerst lesen. Beispiele:

• „Was macht dieses Projekt?"
• „Welche Technologien werden hier verwendet?"
• „Wo ist der Einstiegspunkt?"
• „Erklär mir die Ordnerstruktur."

Du musst keinen Kontext manuell mitschicken – Claude liest die Dateien selbst, wenn nötig.

💡 Diese Erkundungs-Phase ist auch dann wertvoll, wenn du das Projekt selbst kennst. Dadurch hat Claude den Code im Arbeitsspeicher und arbeitet die ersten Aufgaben präziser ab.

Schritt 5 · Erste Codeänderung

Jetzt darf Claude tatsächlich tippen:

„Füge eine Hello-World-Funktion zur Hauptdatei hinzu."

Claude wird:

1. Die richtige Datei finden
2. Die geplanten Änderungen anzeigen
3. Um Bestätigung bitten
4. Die Änderung ausführen

Du kannst einzelne Änderungen genehmigen oder für die Session den Modus „Alle akzeptieren" aktivieren – Letzteres aber bitte nur, wenn du dich sicher fühlst.

Schritt 6 · Git im Gespräch

Git-Operationen werden in normaler Sprache ausgedrückt:

• „Welche Dateien habe ich geändert?"
• „Mach einen Commit mit aussagekräftiger Nachricht."
• „Erstell einen neuen Branch namens feature/quickstart."
• „Zeig mir die letzten fünf Commits."
• „Hilf mir, diesen Merge-Konflikt zu lösen."

Schritt 7 · Bugs fixen, Features bauen

Beschreibe einfach in eigenen Worten, was passieren soll:

• „Es gibt einen Bug: User können leere Formulare absenden – behebe das."
• „Füge dem Registrierungsformular eine Eingabe-Validierung hinzu."

Claude lokalisiert den relevanten Code, versteht den Kontext, implementiert eine Lösung und führt – falls vorhanden – die Tests aus.

Schritt 8 · Weitere typische Arbeitsabläufe

Was sonst noch gut funktioniert:

💡 Grundregel: Sprich mit Claude wie mit einem hilfsbereiten Kollegen. Beschreib, was du erreichen willst – Claude findet den Weg dorthin.

Die wesentlichen Befehle

CLI-Befehle (im Terminal)

Slash-Befehle (innerhalb einer Session)

Tastaturkürzel

🎯 Praxis-Tipps, die wirklich was bringen

Die offizielle Doku gibt dir das Gerüst – die folgenden Tipps sind das, was im Alltag den Unterschied macht.

1. Spezifisch sein

Das ist der wichtigste Hebel überhaupt:

❌ „Behebe den Fehler."

✅ „Behebe den Login-Fehler, bei dem User nach falschen Anmeldedaten einen leeren Bildschirm sehen statt einer Fehlermeldung."

Je präziser der Prompt, desto seltener muss Claude raten – und desto seltener tappst du in die Debugging-Schleife (siehe weiter unten).

2. Komplexe Aufgaben in Schritten denken

Statt einer riesigen Anweisung lieber eine nummerierte Liste:

„1. Lege eine neue Datenbank-Tabelle für User-Profile an. 2. Erstell einen API-Endpunkt zum Lesen und Aktualisieren. 3. Bau eine Webseite, auf der User ihre Daten sehen und bearbeiten können."

Claude arbeitet die Schritte einzeln ab und kann zwischendurch korrigiert werden.

3. Erst Konzept, dann Code

Der häufigste Anfängerfehler: Direkt in Claude Code reinhüpfen und drauflosprompten. Ergebnis nach drei Stunden: 2.000 Zeilen Code, die irgendwie funktionieren, aber niemand mehr versteht – auch Claude selbst nicht mehr.

Der bessere Ansatz – in drei Phasen:

Phase 1: BRIEFING        Phase 2: STRUKTUR        Phase 3: BAUEN
(im Browser-Chat)    →   (im Browser-Chat)    →   (in Claude Code)
Was soll das Tool        Welche Dateien soll      Konkrete Umsetzung,
können? Konzept klären   das Projekt haben?       Datei für Datei

Phase 1 – Briefing im Browser-Chat:

Vor der ersten Zeile Code wird im normalen Claude-Chat (auf claude.ai, nicht im Terminal) das Konzept geklärt:

„Ich beschreibe dir gleich eine Projektidee, möchte aber zuerst nur das Konzept besprechen, noch keine Implementierung. Stelle mir alle Rückfragen, die du brauchst, um sicher zu sein, dass du verstehst, was ich vorhabe."

Claude bohrt nach, klärt offene Punkte – am Ende steht ein sauberes Konzept-Dokument.

Phase 2 – Dateistruktur skizzieren lassen:

Im selben Chat: „Schlag mir eine Ordner- und Dateistruktur für dieses Projekt vor."

Beispiel-Ausgabe für ein kleines Newsletter-Tool:

newsletter-tool/
├── main.py                ← Einstiegspunkt
├── templates/
│   └── newsletter.md.j2   ← Layout
├── output/                ← generierte Dateien
└── README.md

Phase 3 – In Claude Code umsetzen:

Erst jetzt geht's ins Terminal. Briefing und Struktur einfügen, und sagen: „Bau die Grundstruktur nach diesem Briefing auf."

4. Logging einbauen lassen

Wenn ein Bug schwer zu finden ist, sag direkt am Anfang:

„Füge ausführliches Logging hinzu, das jeden wichtigen Schritt in der Konsole ausgibt."

So sieht Claude im Output, wo es klemmt, statt blind zu raten. Diese eine Zeile spart in der Praxis stundenlange Debugging-Sessions.

5. /clear regelmäßig nutzen

Bei jeder Nachricht sendet Claude den gesamten bisherigen Chat mit. Je länger der Verlauf, desto teurer wird jede neue Nachricht – und das exponentiell.

Faustregel: Nach Abschluss eines Features oder Bugfixes mit /clear einen Cut machen. Soll der Kontext erhalten bleiben, ist /compact die Mittellösung – der Verlauf wird zu einer Zusammenfassung verdichtet.

6. Sprich Deutsch

Du kannst durchgehend Deutsch verwenden – Dialog, Code-Kommentare, Commit-Messages. Claude versteht es einwandfrei. Schlüsselwörter im Code bleiben natürlich Englisch, weil das die jeweilige Programmiersprache so vorgibt.

⚙️ Modelle und Think-Modi

Sonnet vs. Opus: Welches Modell wann?

Claude Code unterstützt mehrere Modelle. Für die meisten Aufgaben sind zwei relevant:

💡 Faustregel: Im Zweifel mit Sonnet starten. Erst zu Opus wechseln, wenn Sonnet sich festfährt – per /model während der Session.

Think-Modi für komplizierte Aufgaben

Du kannst Claude vor der Implementierung intensiver nachdenken lassen, indem du ein Schlüsselwort vor deine Anweisung stellst:

Höhere Modi denken länger nach – und verbrauchen mehr Tokens. Klein anfangen, hochstufen wenn nötig.

🚀 Power-Features

CLAUDE.md – Das Projektgedächtnis

Eine Datei CLAUDE.md im Projektordner liest Claude zu Beginn jeder Session automatisch. Hier kommen die Dinge rein, die du nicht jedes Mal wiederholen willst:

# Newsletter-Tool

## Worum geht's
Python-Skript, das wöchentlich Blogposts aus einem RSS-Feed
holt und als Markdown-Newsletter zusammenfasst.

## Technische Vorgaben
- Python 3.11+
- requests, feedparser, jinja2 (sonst keine Libraries)
- API-Keys nie hardcoden – immer aus .env lesen

## Wichtige Dateien
- main.py = Einstiegspunkt
- templates/newsletter.md.j2 = Layout
- output/ = generierte Dateien (nicht committen)

💡 Mit /init legt Claude Code automatisch eine sinnvoll vorausgefüllte CLAUDE.md an, basierend auf einer kurzen Projektabfrage.

Hooks – Automatische Trigger

Hooks sind kleine Shell-Befehle, die Claude bei bestimmten Ereignissen ausführt:

• 🎨 Auto-Format: Nach jeder Python-Datei läuft Black oder Prettier.
• 🧪 Auto-Test: Bei jeder Code-Änderung startet die Test-Suite.
• 🛡️ Schutzwall: Änderungen an .env-Dateien werden blockiert oder zumindest mit Warnung versehen.

Eingerichtet werden Hooks über /hooks oder direkt in ~/.claude/settings.json.

MCP-Server – Brücken zur Außenwelt

Während Hooks lokal laufen, verbinden MCP-Server (Model Context Protocol) Claude mit externen Diensten:

• in GitHub Pull Requests erstellen, Issues aktualisieren
• direkt Datenbanken abfragen
• Slack oder Teams-Nachrichten senden
• Inhalte aus Google Drive oder der Search Console lesen

Die meisten populären MCP-Server lassen sich mit einem einzelnen Befehl installieren.

⚠️ Typische Stolperfallen

❌ Die Debugging-Schleife

Claude „behebt" einen Fehler, baut dabei aber einen neuen ein. Behebt den neuen, erzeugt den nächsten. Irgendwann steht dieselbe Funktion dreimal im Code.

Gegenmittel:

1. Logging einbauen (siehe oben).
2. Mitlesen. Nicht jede Zeile verstehen müssen – aber wenn Claude plötzlich neue Dateien anlegt oder Funktionen umbenennt, obwohl du nur einen kleinen Bug fixen wolltest: einhaken.
3. Im Zweifel /clear oder neue Session. Manchmal hilft ein frischer Start mehr als drei weitere Iterationen mit verbrauchtem Kontext.

❌ Das „immer mehr Features"-Problem

Ohne klare Vorgaben baut Claude gerne mehr ein, als gefragt war. Aus „füge einen Button hinzu" wird ein neues Modul mit eigenem Konfigurationsmenü.

Gegenmittel: In der CLAUDE.md klare Grenzen setzen.

❌ Die API-Kostenfalle

Die Versuchung, statt des Pro-Abos die API direkt zu nutzen, kostet beim Lernen schnell dreistellige Beträge in den ersten Tagen. Pro-Abo ist beim Einstieg die mit Abstand günstigere Variante.

🎯 Fazit

Claude Code ist kein Werkzeug, das Programmierer:innen überflüssig macht – es ist ein Werkzeug, das die Eintrittshürde drastisch senkt. Wer eine klare Vorstellung von dem hat, was er bauen will, die Geduld mitbringt, ein Briefing zu schreiben, und das Mitlesen nicht scheut, kann damit Dinge umsetzen, die vor zwei Jahren noch ein Entwicklerteam gebraucht hätten.

Drei Prinzipien, die in der Praxis fast immer den Unterschied machen:

• ✅ Erst Konzept, dann Code. Briefing im Browser-Chat klären, bevor Claude Code überhaupt startet.
• ✅ Spezifisch sein und in Schritten denken. Vage Prompts erzeugen vage Ergebnisse.
• ✅ CLAUDE.md pflegen und /clear nutzen. Das Projekt-Gedächtnis pflegen, das Sitzungs-Gedächtnis regelmäßig leeren.

🔗 Quellen & weiterführende Links

• Schnellstart – Offizielle Claude Code Doku (DE) – Hauptquelle dieser Anleitung
• Best Practices – Offizielle Doku – tiefer in effektives Prompting und Projekt-Setup
• Häufige Arbeitsabläufe – Offizielle Doku – Schritt-für-Schritt-Anleitungen für typische Aufgaben
• Anthropic Modellübersicht – aktuelle Modellfamilie und Empfehlungen
• Praxisbericht von Rafael Luge auf kopfundstift.de – Erfahrungsbericht aus 10+ Monaten Nutzung. Aus diesem Bericht stammen mehrere der Praxis-Tipps in diesem Artikel (Briefing-Phase, Logging-Strategie, Stolperfallen-Liste).

Stand: Mai 2026. Befehle, Modelle und Limits können sich ändern – im Zweifel die offizielle Dokumentation prüfen.