Claude Code für Einsteiger: Installation, sichere Rechte und die ersten 30 Minuten

Claude Code ist ein KI-Coding-Agent für das Terminal. Es ist nicht nur ein Chat für Code-Schnipsel: Claude Code kann Projektdateien lesen, im Repository suchen, Änderungen vorschlagen, nach Freigabe Dateien bearbeiten und Befehle wie Tests oder Builds ausführen.

Viele Einsteiger scheitern nicht an der Installation, sondern am ersten zu großen Auftrag. “Verbessere diese ganze App” erzeugt meist einen Diff, den niemand sauber prüfen kann. Der bessere Start lautet: Projekt lesen, Struktur erklären lassen, eine kleine Aufgabe wählen, Änderung prüfen.

Dieser Artikel orientiert sich an den offiziellen Seiten zu Setup, Common workflows und CLI usage. Danach lohnt sich der Blick in CLAUDE.md Best Practices und Kontextmanagement.

Was Claude Code praktisch macht

Claude Code ist stark bei kleinen Aufgaben mit echtem Kontext: Codebasis verstehen, relevante Dateien finden, einen Bug eingrenzen, Tests ergänzen, README verbessern oder einen PR vorbereiten.

Für den Anfang ist diese Reihenfolge sinnvoll:

Schritt	Aktion	Zweck
1	Installieren und anmelden	Werkzeug prüfen
2	Nur lesen lassen	Projektkarte bauen
3	Kleine Aufgabe wählen	Risiko senken
4	Diff und Tests prüfen	Ergebnis belegen
5	Regeln dokumentieren	Nächste Sitzung stabilisieren

Das ist weniger spektakulär als Vollautomatisierung, aber deutlich belastbarer.

Vorbereitung

Starte nicht direkt im Produktionsbranch. Erstelle eine Übungsbranch:

git status
git switch -c try-claude-code

Für ältere Git-Versionen:

git checkout -b try-claude-code

Prüfe außerdem:

• Claude-Konto mit Claude-Code-Zugriff
• Internetverbindung
• Projektwurzel bekannt
• Git funktioniert
• Test- oder Build-Befehl ist bekannt
• .env, Schlüssel und Kundendaten bleiben geschützt

Unter Windows unterscheiden sich PowerShell und CMD. PS C:\ bedeutet PowerShell.

Installation

macOS, Linux oder WSL:

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

Windows PowerShell:

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

Danach:

claude --version
claude doctor

claude doctor ist am Anfang sehr hilfreich, weil es Installations- und Konfigurationsprobleme sichtbar macht.

Auch npm ist möglich:

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

Wenn du keinen besonderen Grund hast, nimm zuerst den offiziellen nativen Installer. Vermeide sudo npm install -g, weil dadurch Rechte- und Sicherheitsprobleme entstehen können.

Die ersten 30 Minuten

Im Projektverzeichnis:

cd my-project
claude

Nach dem Login bitte nicht sofort ein Feature verlangen. Beginne lesend:

Ich bin neu in diesem Projekt.
Bitte noch keine Dateien bearbeiten. Lies nur und erkläre:

- was das Projekt macht
- Hauptverzeichnisse und Aufgaben
- wahrscheinliche Befehle für dev, test und build
- Dateien, die riskant zu ändern wirken
- die ersten 5 Dateien, die ich lesen sollte

Nenne Dateipfade als Belege und rate nicht, wenn etwas unklar ist.

Danach:

Schlage 5 einsteigerfreundliche Aufgaben in diesem Repository vor.
Jede Aufgabe soll:

- etwa 30 Minuten dauern
- höchstens 2 Dateien ändern
- einen Test oder manuelle Prüfung haben
- Auth, Billing, Secrets und Produktionsdaten vermeiden

Gib Risiko und Prüfschritte an.

Damit wird Claude Code zu einem Onboarding-Helfer statt zu einer Blackbox.

Sichere Berechtigungen

Da Claude Code Befehle ausführen und Dateien ändern kann, sind Berechtigungen entscheidend. Ein vorsichtiger Start:

claude --permission-mode plan

In der Sitzung:

/permissions

Vorsicht mit bypassPermissions und --dangerously-skip-permissions. Nutze das nur in isolierten Containern oder VMs, nicht in echten Projekten am ersten Tag.

Ein konservatives Muster:

{
  "permissions": {
    "allow": [
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(npm run test *)",
      "Bash(npm run build *)"
    ],
    "deny": [
      "Bash(git push *)",
      "Bash(rm -rf *)",
      "Read(.env)",
      "Read(**/.env)"
    ]
  }
}

Erlaube risikoarme Prüfungen, blockiere Secrets und lasse destruktive Aktionen manuell bestätigen.

Beispiel 1: README verbessern

README ist eine gute erste Aufgabe.

Ich möchte README.md verbessern.
Lies zuerst README.md und package.json.
Liste fehlende Informationen, aber bearbeite nichts.
Nach meiner Freigabe ändere nur README.md.

Dann begrenzen:

Füge README.md nur zwei Abschnitte hinzu:

- lokale Entwicklung
- Testbefehl

Nutze nur Befehle, die in package.json sichtbar sind.
Erfinde keine Tools oder Deployment-Schritte.

Beispiel 2: Kleinen Bug beheben

Gib eine klare Reproduktion:

Untersuche diesen Bug.

Problem:
- Wenn die Suche nur Leerzeichen enthält, zeigt die App alle Ergebnisse.

Erwartung:
- Nur Leerzeichen sollen wie eine leere Suche behandelt werden.

Vorgaben:
- Erkläre zuerst die wahrscheinliche Ursache.
- Ändere höchstens 1 Datei.
- Nenne Tests oder manuelle Prüfungen.

Nach der Änderung:

git diff

Dann prüfen lassen:

Prüfe den aktuellen git diff.
Achte auf unbeabsichtigte Änderungen, Overengineering, fehlende Tests und Randfälle.
Wenn es passt, nenne 3 manuelle Prüfschritte.

Beispiel 3: CTA zu PDF, Produkt oder Beratung

Für Content- oder Dokumentationsseiten kann Claude Code den nächsten Schritt für Leser verbessern.

Lies diesen Artikel und schlage 3 CTAs für Einsteiger vor.

Ziele:
- Unsicherheit beim ersten Einsatz senken
- natürlich zu Gratis-PDF, Produkt oder Beratung führen
- jeweils unter 80 Zeichen
- kein harter Verkaufston

Implementiere dann nach bestehendem Muster:

Finde das bestehende CTA-Muster auf Artikelseiten.
Füge am Ende dieses Artikels einen passenden CTA hinzu.
Erstelle keine neue Komponente und ändere keine globalen Styles.

Häufige Fehler

Erster Fehler: zu groß fragen. “Verbessere die App” ist keine Aufgabe. “Behandle Leerzeichen in der Suche” ist eine Aufgabe.

Zweiter Fehler: die Lesephase überspringen. Wenn Claude Code die Architektur nicht erklären kann, sollte es noch nicht editieren.

Dritter Fehler: Rechte zu früh erweitern. Ein verständlicher Diff ist wichtiger als Geschwindigkeit.

Vierter Fehler: der Abschlussmeldung glauben. Prüfe Tests, Build, Browser oder git diff.

Fünfter Fehler: eine endlose Sitzung weiterführen. Wenn das Thema wechselt, zusammenfassen und neu starten. Mehr dazu im Kontextmanagement.

Checkliste bei Problemen

• Funktioniert claude --version?
• Was meldet claude doctor?
• Bist du in der Projektwurzel?
• Ist git status verständlich?
• Wurden PowerShell und CMD gemischt?
• Nutzt du WSL, SSH oder Container mit besonderem Login?
• Versucht die Aufgabe .env oder Schlüssel zu lesen?
• Ist ein gefährlicher Berechtigungsmodus aktiv?
• Existiert der Testbefehl wirklich?

Diagnose-Prompt:

Claude Code verhält sich nicht wie erwartet.
Bitte keine Dateien bearbeiten. Hilf nur bei der Diagnose.

Umgebung:
- OS:
- Shell:
- Befehl:
- Fehlermeldung:
- erwartetes Verhalten:

Sortiere die Prüfungen von sicher nach riskanter.

Masas Prüfnotiz

In ClaudeCodeLab war der zuverlässigste Ablauf: lesen, planen, klein ändern, prüfen. Das galt für Artikel, Übersetzungen, CSS und Deployment-Skripte. Kleine Aufgaben ergeben Diffs, die man versteht. Zu lange Automatisierung macht die Absicht später schwer nachvollziehbar.

Meine Empfehlung: In der ersten Woche Berechtigungsfragen sichtbar lassen, jeden git diff lesen und funktionierende Prompts notieren. Danach mit Produktivitätstipps weitermachen.

Nächster Schritt

Öffne heute ein unkritisches Repository, lasse eine Projektkarte erstellen, wähle eine 30-Minuten-Verbesserung und lies den Diff.

Für eine kompakte Erinnerung lade das kostenlose Claude Code Quick Reference Cheatsheet. Für Team-Einführung, Training oder echte Projektbegleitung nutze die Ressourcen und Beratungslinks auf dieser Website.