Claude Code einrichten: Anleitung in 12 Schritten [2026]

Claude Code hat sich 2026 zu einem der meistgenutzten Terminal-Werkzeuge für KI-gestützte Softwareentwicklung entwickelt. Immer mehr Entwicklerinnen und Entwickler in Österreich suchen nach einer klaren Anleitung, wie sie Anthropics Kommandozeilen-Assistenten sicher installieren, einrichten und in den Arbeitsalltag einbauen. Das Tool liest Code, schreibt Patches, führt Tests aus und committet Änderungen direkt im Terminal, ohne dass du zwischen Editor und Chatfenster wechseln musst.

Diese Anleitung führt dich in 12 Schritten von der ersten Installation bis zu einem funktionierenden Beispielprojekt. Rechne mit rund 30 Minuten, einem aktuellen Betriebssystem und etwas Terminal-Erfahrung. Am Ende kennst du Berechtigungsmodi, CLAUDE.md-Dateien, Slash Commands, MCP-Server und Hooks, dazu die Fehler, die Einsteiger am häufigsten machen. Wer die Sicherheitsseite vertiefen will: unsere Analyse zum Claude-Code-Auto-Modus und den CVSS-9,8-Lücken zeigt, warum die Wahl des richtigen Berechtigungsmodus in Schritt 5 kein Nebendetail ist.

Anders als ein klassischer Autovervollständiger im Editor arbeitet Claude Code agentisch: Es plant mehrere Schritte selbst, ruft dafür Lese-, Schreib- und Terminalwerkzeuge auf und meldet sich erst wieder, wenn eine Rückfrage nötig ist oder das Ergebnis fertig ist. Für Entwicklerinnen und Entwickler, die bisher nur Autovervollständigung kennen, ist das eine andere Arbeitsweise, keine bloße Erweiterung der gewohnten Tastaturvorschläge. Genau dieser Unterschied erklärt, warum eine saubere Einrichtung der Berechtigungen und der Projektkonfiguration am Anfang mehr Zeit verdient als bei einem reinen Vervollständigungswerkzeug.

Warum jetzt: Claude Code im Vergleich zu Cursor und Copilot

Der Zeitpunkt für den Einstieg ist kein Zufall. Aktuelle deutschsprachige Vergleiche stufen Claude Code besonders für Power-User mit großen Codebasen als starke Wahl ein, während Cursor eher für ein klassisches IDE-Erlebnis mit Autovervollständigung und einem eigenen Composer-Modus punktet. GitHub Copilot wiederum gilt dank kostenloser Stufe und besonders einfacher Einrichtung weiterhin als das am breitesten genutzte KI-Coding-Werkzeug insgesamt. Die drei Tools schließen sich nicht gegenseitig aus, sie bedienen unterschiedliche Arbeitsweisen und tauchen in vielen Teams parallel im selben Projekt auf.

Tool	Besonders stark bei	Einstieg
Claude Code	Terminal-Workflows, große Codebasen, mehrstufige Aufgaben	Claude-Konto (Pro/Max) oder API-Key
Cursor	IDE-Erlebnis, Autovervollständigung, Composer-Modus	Ab rund 20 US-Dollar pro Monat
GitHub Copilot	Einfachster Einstieg für Anfänger	Kostenlose Stufe verfügbar

Bei einem aktuell vielzitierten SWE-bench-Verified-Test, einem Benchmark, der reale, offene GitHub-Issues automatisiert lösen lässt, werden für Claude Code Werte von rund 80 Prozent berichtet. Das stützt den Ruf als Werkzeug für anspruchsvolle, mehrstufige Aufgaben statt reiner Zeilenvervollständigung. Details zur Methodik hinter diesem Benchmark liefert die offizielle SWE-bench-Projektseite. Wer zusätzlich einen Blick auf die offizielle Produktbeschreibung werfen will, findet sie in der Claude-Code-Dokumentation von Anthropic.

Schritt 1 – Voraussetzungen prüfen: Node.js, Terminal und Konto

Bevor du Claude Code installierst, lohnt sich ein kurzer Check der Systemvoraussetzungen. Die Installation selbst dauert nur wenige Minuten, aber ein fehlendes Node.js oder eine zu alte Version sind der häufigste Grund, warum die Einrichtung beim ersten Versuch scheitert.

Komponente	Mindestanforderung	Empfehlung
Betriebssystem	macOS 12, Ubuntu 20.04 oder Windows 10/11	Aktuelle Version des jeweiligen Systems
Node.js	Version 18	Version 20 LTS oder neuer
Arbeitsspeicher	4 GB RAM	8 GB RAM oder mehr bei großen Repos
Terminal	Beliebiges Terminal oder PowerShell	VS-Code-Terminal, iTerm2 oder Windows Terminal
Konto	Kostenloses Claude-Konto	Claude Pro, Max oder Zugang zur Anthropic Console
Internetverbindung	Erforderlich für Login und Anfragen	Stabile Breitbandverbindung

Prüfe zuerst, ob Node.js bereits installiert ist und welche Version läuft. Öffne dazu ein Terminal und gib Folgendes ein:

node --version
npm --version

Erscheint eine Fehlermeldung wie “command not found” oder zeigt node eine Version unter 18 an, installierst du am besten über den Node Version Manager (nvm) statt über den Paketmanager deines Systems. So kannst du später problemlos zwischen Node-Versionen wechseln, ohne Systemdateien zu verändern:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
nvm install 20
nvm use 20

Unter Windows ist die Installation über die offizielle Node.js-Website oder über WSL2 der unkompliziertere Weg, da nvm in seiner ursprünglichen Form nicht nativ unter Windows läuft. Wer bereits mit WSL2 arbeitet, installiert Node.js einfach innerhalb der Linux-Umgebung, genau wie auf einem regulären Ubuntu-System. Eine feste Regel gibt es dabei nicht: Wer überwiegend mit Windows-eigenen Werkzeugen arbeitet, bleibt bei der nativen Installation, wer Docker, Datenbank-Container oder Linux-Build-Skripte im Alltag braucht, fährt mit WSL2 meist reibungsloser.

Schritt 2 – Claude Code installieren

Mit einer passenden Node.js-Version steht der eigentlichen Installation nichts mehr im Weg. Anthropic bietet zwei Wege an: die Installation über npm oder ein natives Installationsskript, das kein Node.js-Setup voraussetzt und Claude Code als eigenständige Binärdatei einrichtet.

Der npm-Weg funktioniert auf macOS, Linux und Windows gleichermaßen und ist die Variante, die in den meisten offiziellen Beispielen auftaucht:

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

Wer keinen globalen npm-Ordner mit Schreibrechten für den eigenen Benutzer eingerichtet hat, sieht an dieser Stelle oft einen EACCES-Fehler. Verzichte in diesem Fall auf sudo npm install, denn das führt später zu weiteren Rechteproblemen. Richte stattdessen einmalig einen benutzereigenen npm-Präfix ein oder nutze direkt nvm, das dieses Problem von vornherein vermeidet, weil Node und npm dann komplett im Benutzerverzeichnis liegen.

Alternativ installierst du Claude Code über das native Skript, das auf macOS und Linux direkt im Terminal läuft:

# macOS und Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

Claude Code läuft nativ unter macOS, Linux und Windows, inklusive PowerShell. Unter Windows hast du zusätzlich die Wahl, die Anwendung innerhalb von WSL2 zu betreiben, was sich anbietet, wenn dein restlicher Entwicklungs-Stack ohnehin unter Linux läuft. Nach der Installation prüfst du mit einem einfachen Befehl, ob alles korrekt eingerichtet wurde:

claude --version
claude doctor

claude doctor prüft PATH-Einträge, Node-Version und Berechtigungen und zeigt an, ob etwas nachjustiert werden muss, noch bevor du dich das erste Mal anmeldest. Eine unauffällige Ausgabe sieht in etwa so aus:

Claude Code Doctor
✓ Node.js Version: 20.11.0
✓ npm-Installation: global, Schreibrechte vorhanden
✓ PATH: claude korrekt verlinkt
✓ Konfigurationsordner: ~/.claude gefunden
Alles bereit für den ersten Start.

Erscheint stattdessen eine Warnung bei der Node-Version oder dem PATH-Eintrag, lohnt es sich, diese direkt zu beheben, statt sie zu ignorieren. Genau diese beiden Punkte sind später die häufigste Ursache für das “command not found”-Problem aus dem Troubleshooting-Abschnitt weiter unten.

Schritt 3 – Anmeldung: Konto, Console oder API-Key wählen

Claude Code lässt sich über zwei unterschiedliche Abrechnungswege nutzen, und die Wahl solltest du vor dem ersten Login treffen. Für die meisten Einzelentwickler ist ein reguläres Claude-Konto der einfachere Einstieg: Du meldest dich mit deinem Claude Pro- oder Max-Abo an, das nutzungsbasierte Limits in einem festen Monatspreis bündelt. Teams und Unternehmen greifen dagegen häufiger über die Anthropic Console mit einem API-Key zu, bei dem nach tatsächlichem Verbrauch abgerechnet wird.

Der Login läuft über den Terminal-Befehl claude, gefolgt vom Slash Command /login in der interaktiven Oberfläche:

claude
> /login

Claude Code öffnet daraufhin deinen Standardbrowser für den OAuth-Login. Arbeitest du auf einem entfernten Server ohne Browserzugriff, etwa über SSH, nutzt du stattdessen claude setup-token für einen Login-Flow ohne lokalen Browser. Willst du stattdessen über die Anthropic Console und einen API-Key abrechnen, legst du die Umgebungsvariable ANTHROPIC_API_KEY fest, bevor du Claude Code startest, statt dich über /login mit einem Konto zu verbinden. Beide Wege lassen sich später jederzeit wechseln, ein einmal gewählter Login-Weg ist also keine dauerhafte Festlegung.

Bei den Kontomodellen bewegt sich der Einstieg laut aktuellen Berichten bei rund 20 US-Dollar pro Monat für Pro-Tarife, während Max-Tarife mit höheren Nutzungslimits je nach Stufe bis in den Bereich von etwa 200 US-Dollar pro Monat reichen. Die Abrechnung erfolgt unabhängig vom Wohnsitz in US-Dollar, ein Umstand, den du bei der Budgetplanung berücksichtigen solltest, weil Wechselkursschwankungen den tatsächlichen Betrag in Euro leicht verschieben. Firmenkonten mit zentraler Abrechnung über die Console vermeiden dieses Problem, weil dort ein einzelnes Budget für das ganze Team verwaltet wird, statt jede Einzelperson mit einem eigenen Abo zu führen.

Kosten im Überblick

Für eine erste Einschätzung hilft ein Blick auf die groben Stufen, bevor du dich für einen Weg entscheidest. Die genauen Limits ändern sich erfahrungsgemäß häufiger als die Grundstruktur, daher lohnt sich vor dem Kauf zusätzlich ein Blick auf die aktuelle Preisseite von Anthropic.

Zugang	Abrechnung	Typisches Einsatzgebiet
Kostenloses Claude-Konto	Begrenztes tägliches Kontingent	Erste Tests, kleine Skripte
Claude Pro	Fester Monatspreis ab rund 20 US-Dollar	Einzelentwickler mit regelmäßiger Nutzung
Claude Max	Höherer Fixpreis, gestaffelt bis rund 200 US-Dollar	Intensivnutzung, große Repos, lange Sitzungen
Anthropic Console (API-Key)	Nutzungsbasiert nach Token-Verbrauch	Teams, CI/CD-Pipelines, schwankende Last

Für den Einstieg reicht in der Regel ein Pro-Tarif. Erst wenn du regelmäßig an mehreren größeren Repositories gleichzeitig arbeitest oder Claude Code in automatisierte Pipelines einbindest, wird ein Wechsel zu Max oder zur nutzungsbasierten Abrechnung über die Console wirtschaftlich interessant. Ein Wechsel zwischen den Modellen ist jederzeit möglich, du bist also nicht dauerhaft an die beim Login gewählte Option gebunden und kannst mit dem günstigeren Tarif starten, um erst einmal ein Gefühl für den eigenen Verbrauch zu bekommen.

Schritt 4 – Erstes Projekt starten und die Oberfläche verstehen

Wechsle jetzt in ein bestehendes Projektverzeichnis oder lege einen neuen Ordner an. Claude Code arbeitet immer im Kontext des aktuellen Verzeichnisses, das es beim Start einliest:

mkdir mein-projekt && cd mein-projekt
claude

Nach dem Start siehst du eine interaktive Eingabezeile sowie eine Statusleiste mit aktivem Modell, verbrauchtem Kontext und aktuellem Verzeichnis. Ein guter erster Test ist eine einfache Frage zum Projekt:

> Erkläre mir kurz die Struktur dieses Projekts

⏺ Ich lese die Verzeichnisstruktur und package.json...
⏺ Dieses Projekt ist eine Node.js-Anwendung mit Express.
  Haupteinstieg: src/index.js
  Routen liegen in src/routes/, Tests in test/
  Es gibt noch keine README.md.

Läuft eine Antwort länger, als du erwartest, oder steuert Claude Code sichtbar in die falsche Richtung, unterbrichst du einfach mit Esc und formulierst den Auftrag genauer. Das ist kein Fehlerfall, sondern normaler Teil des Arbeitsablaufs: Ein präziserer zweiter Anlauf spart in der Praxis oft mehr Zeit, als eine ungenaue erste Anfrage bis zum Ende laufen zu lassen und das Ergebnis danach zu verwerfen.

Für einmalige Aufgaben ohne interaktive Sitzung eignet sich der Headless-Modus mit dem Flag -p, der eine einzelne Anfrage verarbeitet und sich gut in Skripte einbauen lässt, etwa für automatisierte Codeprüfungen in einer Pipeline.

Schritt 5 – Berechtigungsmodi und sichere Nutzung verstehen

Claude Code fragt in der Standardeinstellung vor jeder Dateiänderung und jedem Terminalbefehl um Erlaubnis. Genau dieser Mechanismus entscheidet darüber, wie sicher der Einsatz auf deinem System ist, und er ist auch der Punkt, an dem viele Einsteiger zu schnell auf “immer erlauben” klicken. Vier Modi stehen zur Auswahl, und jeder eignet sich für eine andere Situation.

Modus	Verhalten	Empfohlen für
Standardmodus	Fragt vor Dateiänderungen und Bash-Befehlen einzeln nach	Erste Wochen, unbekannte Projekte
Plan Mode	Liest nur, ändert nichts, präsentiert erst einen Plan	Code-Reviews, Recherche in fremdem Code
Accept Edits	Übernimmt Dateiänderungen automatisch, fragt bei Bash-Befehlen weiter	Vertraute Projekte, schnelle Iteration
Bypass-Modus	Führt Änderungen und Befehle ohne Rückfrage aus	Isolierte Container oder Sandboxes, nie auf produktiven Systemen

Für Teams lohnt sich eine feste Konfiguration in der Projektdatei .claude/settings.json, statt jede Erlaubnis einzeln im Kopf zu behalten. Dort legst du fest, welche Befehle automatisch erlaubt, welche blockiert und welche weiterhin abgefragt werden:

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

Der Bypass-Modus gehört nicht auf einen produktiven Server und nicht in ein Verzeichnis mit echten Zugangsdaten. Wer wissen will, was passieren kann, wenn Automatisierung und weitreichende Rechte zusammentreffen, findet in unserer Analyse zum Claude-Code-Auto-Modus ein konkretes Beispiel dafür, warum diese Entscheidung nie nebenbei getroffen werden sollte.

Mit dem Befehl /permissions siehst du jederzeit, welche Regel aktuell gilt und woher sie stammt, ob aus der Projektdatei, aus deinen persönlichen Einstellungen oder aus einer einmaligen Freigabe während der laufenden Sitzung. Gerade bei geliehenen oder gemeinsam genutzten Rechnern lohnt sich dieser Check vor dem ersten produktiven Einsatz, damit keine großzügige Freigabe aus einem alten Projekt unbemerkt weiterwirkt.

Schritt 6 – CLAUDE.md als Projektgedächtnis anlegen

Ohne zusätzlichen Kontext muss Claude Code bei jeder neuen Sitzung die Projektstruktur, Coding-Konventionen und Build-Befehle neu erschließen. Eine Datei namens CLAUDE.md im Projektstamm löst dieses Problem: Sie wird bei jedem Start automatisch eingelesen und wirkt wie ein Gedächtnis, das über einzelne Sitzungen hinweg bestehen bleibt.

Am schnellsten entsteht eine erste Version über den eingebauten Befehl, der den Code scannt und einen Entwurf vorschlägt:

> /init

Das Ergebnis lässt sich danach frei anpassen. Eine schlanke, nützliche CLAUDE.md sieht in der Praxis oft so aus:

# Projektübersicht
Node.js/Express-API mit PostgreSQL. Tests laufen mit Vitest.

## Befehle
- npm run dev – Entwicklungsserver starten
- npm test – Testsuite ausführen
- npm run lint – ESLint prüfen

## Konventionen
- Kein any in TypeScript-Dateien
- Fehler immer über den zentralen errorHandler leiten
- Commits auf Deutsch, im Imperativ

Für persönliche Vorlieben, die projektübergreifend gelten sollen, etwa eine bevorzugte Antwortsprache oder ein bestimmter Commit-Stil, legst du zusätzlich eine globale CLAUDE.md im Verzeichnis ~/.claude/ an. Projekt- und globale Datei ergänzen sich, sie überschreiben sich nicht gegenseitig. Welche weiteren Importe und Vererbungsregeln dabei möglich sind, beschreibt die offizielle Dokumentation zum Speicher-System im Detail.

Schritt 7 – Slash Commands und Kontextverwaltung

Slash Commands steuern Claude Code während einer laufenden Sitzung, ohne dass du das Gespräch unterbrechen musst. Die wichtigsten für den Alltag lassen sich schnell verinnerlichen.

Befehl	Funktion
/help	Zeigt alle verfügbaren Befehle
/clear	Löscht die aktuelle Konversation, startet den Kontext neu
/compact	Fasst die bisherige Sitzung zusammen, um Kontextplatz freizugeben
/init	Erstellt oder aktualisiert die CLAUDE.md
/model	Wechselt zwischen Modellen, etwa für einfachere oder komplexere Aufgaben
/permissions	Zeigt und verwaltet die aktuellen Berechtigungsregeln
/mcp	Listet verbundene MCP-Server und deren Status
/resume	Setzt eine frühere Sitzung fort

Das Kontextfenster ist trotz aller Fortschritte immer noch begrenzt. Bei langen Sitzungen in großen Repos lohnt sich /compact, sobald die Statusleiste einen hohen Füllstand anzeigt. So bleibt der relevante Verlauf erhalten, während alter Ballast wegfällt und die Antwortqualität nicht durch einen überfüllten Kontext leidet.

Über die eingebauten Befehle hinaus lassen sich eigene Slash Commands definieren, etwa für einen wiederkehrenden Review-Auftrag. Dazu legst du eine Markdown-Datei im Ordner .claude/commands/ an:

# Datei: .claude/commands/review.md
Prüfe den aktuellen Diff auf:
1. Fehlende Tests für neue Funktionen
2. Unbehandelte Fehlerfälle
3. Verstöße gegen die Konventionen in CLAUDE.md
Fasse die Ergebnisse in Stichpunkten zusammen.

Ab diesem Zeitpunkt reicht /review in jeder Sitzung innerhalb des Projekts, um denselben Prüfauftrag auszulösen, ohne den vollständigen Text jedes Mal neu zu tippen. Persönliche Commands, die projektübergreifend gelten sollen, legst du stattdessen in ~/.claude/commands/ ab.

Schritt 8 – Code bearbeiten, Git-Workflows und Tests automatisieren

Der eigentliche Alltag mit Claude Code läuft über natürlichsprachliche Aufträge. Du beschreibst, was du erreichen willst, und Claude Code liest die relevanten Dateien, schlägt eine Änderung als Diff vor und wartet je nach Berechtigungsmodus auf deine Bestätigung. Je genauer der Auftrag, desto treffsicherer das Ergebnis: Ein Hinweis auf die betroffene Datei oder Funktion spart oft einen ganzen Korrekturzyklus.

> Füge der /users-Route eine Validierung für die E-Mail-Adresse hinzu und schreibe dafür einen Test

⏺ Lese src/routes/users.js
⏺ Lese test/users.test.js
⏺ Ändere src/routes/users.js
    + const isValidEmail = (s) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(s);
    + if (!isValidEmail(req.body.email)) return res.status(400).json({error: "invalid email"});
⏺ Ergänze test/users.test.js um zwei neue Fälle
⏺ npm test
  ✓ 14 Tests bestanden
  Änderungen übernehmen? (y/n)

Für Git-Aufgaben gilt derselbe Ablauf: Ein Auftrag wie “committe die Änderungen mit einer passenden Nachricht” liest zuerst git diff und git log, um sich am bestehenden Commit-Stil zu orientieren, und schlägt danach eine Nachricht vor, bevor irgendetwas ausgeführt wird. Claude Code legt nie eigenständig Commits an, ohne dass du das vorher angefragt hast, und pusht nichts ohne ausdrückliche Aufforderung.

Für Codeänderungen aus fremder Hand, etwa nach einem Pull Request, lohnt sich zusätzlich ein gezielter Prüfauftrag: “Lies den Diff dieses Branches gegen main und liste alle sicherheitsrelevanten Änderungen auf.” Claude Code beantwortet solche Aufträge rein lesend, ganz ohne dass dafür ein schreibender Berechtigungsmodus nötig wäre, und eignet sich damit auch als zusätzlicher Blick vor einem Merge.

Schritt 9 – VS Code- und JetBrains-Integration einrichten

Claude Code funktioniert als reines Terminal-Tool, spielt seine Stärken aber erst richtig aus, wenn es mit dem Editor verbunden ist. Für Visual Studio Code gibt es eine offizielle Erweiterung im Marketplace, die Diffs direkt im Editor anzeigt, geänderte Dateien markiert und einen Sidebar-Chat neben dem Code einblendet, statt alles nur im Terminalfenster darzustellen.

Die Installation läuft wie bei jeder anderen VS-Code-Erweiterung über die Extensions-Ansicht, in der du nach “Claude Code” suchst und installierst. Startest du Claude Code danach im integrierten Terminal von VS Code, erkennt es die laufende IDE automatisch und aktiviert die tiefere Integration ohne zusätzliche Konfiguration:

# Im integrierten Terminal von VS Code
cd mein-projekt
claude

Für JetBrains-IDEs wie IntelliJ IDEA, WebStorm oder PyCharm steht ein vergleichbares Plugin über den JetBrains-Marketplace bereit. Auch hier gilt: Nach der Installation reicht der Start von Claude Code im eingebauten Terminal der IDE, der Rest läuft automatisch. Das Plugin zeigt vorgeschlagene Änderungen ebenfalls als Inline-Diff direkt neben dem betroffenen Code und ergänzt einen eigenen Tool-Reiter, über den sich laufende Sitzungen und offene Rückfragen auf einen Blick verfolgen lassen.

Wer lieber komplett im Terminal bleibt, verliert dabei keine Funktion. Die IDE-Integration ist eine Ergänzung und keine Voraussetzung für die Arbeit mit Claude Code, alle Berechtigungen, Hooks und CLAUDE.md-Dateien wirken in beiden Varianten identisch.

Schritt 10 – MCP-Server einbinden

Das Model Context Protocol, kurz MCP, verbindet Claude Code mit externen Werkzeugen und Datenquellen, etwa Datenbanken, Ticketsystemen oder internen APIs. Ein MCP-Server übersetzt zwischen Claude Code und dem jeweiligen Dienst, sodass das Modell gezielt Werkzeuge aufrufen kann, statt nur mit Text zu arbeiten. Der Standard stammt ursprünglich von Anthropic, wurde aber offengelegt und mittlerweile auch von anderen Anbietern übernommen, wodurch inzwischen ein größeres Ökosystem an fertigen Servern für gängige Dienste existiert. Details zum offenen Standard dahinter liefert die offizielle MCP-Dokumentation.

Einen Server fügst du über die Kommandozeile hinzu, ohne dafür eine Konfigurationsdatei von Hand anlegen zu müssen:

claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres "postgresql://localhost/meinedb"

Alternativ legst du eine Projektdatei .mcp.json an, die sich im Team teilen lässt, weil sie zusammen mit dem restlichen Code versioniert wird:

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/meinedb"]
    }
  }
}

Mit /mcp siehst du danach in der Sitzung, welche Server verbunden sind und ob die Verbindung steht. Gerade bei Datenbank- oder API-Zugängen gilt: Zugangsdaten gehören in Umgebungsvariablen, nicht direkt in die .mcp.json, wenn diese Datei mit ins Repository wandert.

In der Praxis häufig genutzt wird außerdem ein MCP-Server für GitHub, der Issues, Pull Requests und Reviews direkt zugänglich macht, ohne den Umweg über die Weboberfläche:

claude mcp add github -- npx -y @modelcontextprotocol/server-github

Danach lassen sich Aufträge wie “fasse alle offenen Pull Requests mit dem Label bug zusammen” direkt im Terminal erledigen. Für den Einstieg reicht ein einzelner MCP-Server völlig aus, weitere kommen am besten erst dazu, wenn ein konkreter Bedarf entsteht, statt vorsorglich gleich mehrere gleichzeitig einzurichten.

Schritt 11 – Hooks, Subagents und Automatisierung

Hooks lösen bei bestimmten Ereignissen automatisch ein Shell-Kommando aus, etwa direkt nachdem Claude Code eine Datei geändert hat. Das eignet sich, um Formatierung, Linting oder eigene Prüfungen zu erzwingen, ohne dass du jedes Mal daran denken musst. Konfiguriert wird das im selben settings.json, in dem auch die Berechtigungen liegen. Eine vollständige Liste aller verfügbaren Ereignisse, etwa vor oder nach einem Werkzeugaufruf, führt die Hooks-Dokumentation von Anthropic:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "npx prettier --write ." }]
      }
    ]
  }
}

Subagents gehen einen Schritt weiter: Sie sind eigene, spezialisierte Assistenten mit einer festgelegten Rolle, etwa ein Test-Schreiber oder ein Code-Reviewer, die eigenständig arbeiten und nur das Ergebnis zurückmelden. Definiert werden sie als Markdown-Dateien im Ordner .claude/agents/:

---
name: test-writer
description: Schreibt Tests für neue oder geänderte Funktionen
tools: Read, Write, Bash
---
Du schreibst ausschließlich Tests im Vitest-Format.
Halte dich an die bestehenden Testmuster im Projekt.

Sowohl Hooks als auch Subagents lohnen sich erst, wenn die Grundroutine aus den Schritten 1 bis 10 sitzt. Wer sie zu früh einbaut, verliert eher den Überblick, als dass die Automatisierung Zeit spart.

Schritt 12 – Komplettes Beispielprojekt: REST-API von Null aufsetzen

Die folgenden Schritte fassen die gesamte Anleitung in einem durchgehenden Beispiel zusammen: eine kleine REST-API mit Express, inklusive Tests, von einem leeren Ordner bis zum ersten Commit. Wer bis hierher jeden Schritt einzeln nachvollzogen hat, sieht jetzt, wie Installation, CLAUDE.md, Berechtigungen und Slash Commands im Zusammenspiel tatsächlich aussehen, statt jede Funktion isoliert zu betrachten.

mkdir claude-demo-api && cd claude-demo-api
git init
claude

Im laufenden Chat genügt ein einziger, klar formulierter Auftrag, um das Grundgerüst zu erzeugen:

> Erstelle eine Express-REST-API mit einem /health-Endpoint und einer
  /users-Ressource (In-Memory-Array, GET und POST). Richte package.json
  und Tests mit Vitest ein. Lege danach eine CLAUDE.md an.

⏺ Erstelle package.json
⏺ Erstelle src/index.js, src/routes/users.js
⏺ Erstelle test/users.test.js, test/health.test.js
⏺ npm install
⏺ npm test
  ✓ 6 Tests bestanden
⏺ Erstelle CLAUDE.md

Nach diesem einen Auftrag steht ein lauffähiges Projekt mit folgender Struktur:

claude-demo-api/
├── CLAUDE.md
├── package.json
├── src/
│   ├── index.js
│   └── routes/users.js
└── test/
    ├── health.test.js
    └── users.test.js

Von hier aus iterierst du in kleinen Schritten weiter: neue Endpunkte, eine echte Datenbank über einen MCP-Server, zusätzliche Validierung. Nach jeder Änderung lässt du die Tests laufen und bittest um einen Commit, sobald das Ergebnis passt. Genau dieser kurze Zyklus aus Auftrag, Diff, Test und Commit ist die Arbeitsweise, die den ersten 11 Schritten dieser Anleitung zugrunde liegt.

Claude Code bekommt sehr häufig neue Versionen, teils mehrmals pro Woche. Ein Update lohnt sich deshalb regelmäßig einzuplanen, statt monatelang auf einer alten Version zu bleiben:

npm update -g @anthropic-ai/claude-code
claude --version

Änderungen zwischen Versionen, offene Probleme und Diskussionen rund um neue Funktionen sammelt das öffentliche GitHub-Repository von Claude Code. Ein kurzer Blick hinein lohnt sich vor allem dann, wenn nach einem Update ein zuvor bekannter Befehl plötzlich anders reagiert.

Die häufigsten Fehler und wie du sie behebst

Die meisten Probleme mit Claude Code entstehen nicht durch das Werkzeug selbst, sondern durch die Art, wie es eingerichtet und eingesetzt wird. Wer die Schritte 1 bis 12 dieser Anleitung befolgt hat, ist bereits gegen die meisten davon abgesichert. Die folgende Übersicht zeigt zuerst die Fehler, die den Einstieg unnötig erschweren, danach eine Tabelle mit konkreten Lösungen für die häufigsten technischen Probleme.

Häufige Einsteigerfehler

Installation mit sudo statt nvm: Wer sudo npm install -g nutzt, statt Node über nvm zu verwalten, handelt sich spätere Rechteprobleme bei jedem Update ein. Jedes weitere globale Paket landet dann wieder im root-geschützten Ordner, und der Fehler wiederholt sich bei der nächsten Installation.
Bypass-Modus aus Bequemlichkeit: Der schnellste Weg zu einer echten Sicherheitslücke ist, Rückfragen dauerhaft abzuschalten, statt gezielte allow-Regeln in settings.json zu pflegen. Der Zeitgewinn in der ersten Woche steht in keinem Verhältnis zum Risiko, sobald ein Projekt echte Zugangsdaten enthält.
Keine CLAUDE.md anlegen: Ohne Projektgedächtnis erklärst du Struktur und Konventionen bei jeder neuen Sitzung erneut, was Zeit kostet und zu inkonsistenten Antworten führt. Ein einziger Lauf von /init zu Beginn spart diesen Aufwand über die gesamte Projektlaufzeit.
.env-Dateien ungeschützt lassen: Fehlt eine Deny-Regel für Read(./.env), kann der Inhalt versehentlich in eine Antwort oder einen Log geraten. Das lässt sich mit einer einzigen Zeile in der Berechtigungskonfiguration dauerhaft ausschließen.
Nie kompaktieren: Wer bei sehr langen Sitzungen nie /compact oder /clear nutzt, bemerkt oft erst spät, dass die Antwortqualität mit vollem Kontext nachlässt. Ein voller Kontext äußert sich meist zuerst durch langsamere, ungenauere Antworten, nicht durch eine klare Fehlermeldung.
Veraltetes Node.js beibehalten: Eine Node-Version unter 18 führt zu kryptischen Fehlermeldungen, die auf den ersten Blick nichts mit der eigentlichen Ursache zu tun haben. Ein Blick auf node --version gehört deshalb an den Anfang jeder Fehlersuche.
MCP-Zugangsdaten im Klartext committen: Landet ein API-Key direkt in .mcp.json statt in einer Umgebungsvariable, liegt er nach dem nächsten Push offen im Repository. Selbst ein rückwirkendes Löschen entfernt den Key nicht mehr zuverlässig aus der Git-Historie.

Troubleshooting-Tabelle

Problem	Wahrscheinliche Ursache	Lösung
“command not found: claude”	PATH wurde nach der Installation nicht aktualisiert	Terminal neu starten oder npm-Pfad manuell zu PATH hinzufügen
npm-Installation bricht mit EACCES ab	Globaler npm-Ordner gehört root, nicht dem eigenen Benutzer	nvm verwenden oder npm-Präfix auf ein Benutzerverzeichnis umstellen
Browser öffnet sich beim Login nicht	Kein Browserzugriff auf einem Remote-Server via SSH	`claude setup-token` für einen Login ohne lokalen Browser nutzen
Sitzung bricht mit “context low” ab	Kontextfenster durch lange Historie ausgelastet	`/compact` zur Zusammenfassung oder `/clear` für einen Neustart nutzen
Claude Code hängt bei einem Bash-Befehl	Langlaufender Befehl ohne Hintergrundausführung	Befehl im Hintergrund laufen lassen oder ein Timeout setzen
MCP-Server verbindet nicht	Falscher Pfad, Port oder fehlende Zugangsdaten in .mcp.json	Konfiguration mit `/mcp` beziehungsweise `claude mcp list` prüfen
Erlaubnis-Abfrage erscheint bei jedem Schritt erneut	Keine passende allow-Regel in settings.json hinterlegt	Wiederkehrende, sichere Befehle gezielt in den allow-Block eintragen
VS-Code-Erweiterung erkennt die CLI nicht	Veraltete Extension oder Claude Code nicht im PATH der IDE	Erweiterung und CLI aktualisieren, VS Code neu starten
Native Installation unter Windows schlägt fehl	PowerShell-Ausführungsrichtlinie blockiert das Skript	Execution Policy anpassen oder alternativ WSL2 verwenden
Hohe Kosten trotz laufendem Pro-Abo	Sitzung läuft über einen aktiven API-Key statt über den Konto-Login	Mit `/login` prüfen, welches Konto beziehungsweise welcher Zugang aktiv ist

Fortgeschrittene Tipps für Power-User

Sobald die Grundroutine sitzt, lohnen sich ein paar Anpassungen, die im Alltag spürbar Zeit sparen, ohne dass du Sicherheit oder Kontrolle aufgibst. Die folgenden Punkte bauen alle auf den Schritten 1 bis 12 auf und lassen sich einzeln und in beliebiger Reihenfolge einführen.

Modell nach Aufgabe wählen: Für einfache, repetitive Aufgaben ein kleineres, schnelleres Modell einsetzen und für komplexe Refactorings gezielt auf ein leistungsfähigeres wechseln, statt durchgehend dasselbe Modell zu nutzen. Das senkt die Kosten spürbar, ohne die Qualität bei anspruchsvollen Aufgaben zu opfern.
Eigene Slash Commands anlegen: Wiederkehrende Prompts, etwa für Code-Reviews oder Release-Notes, als Markdown-Datei in .claude/commands/ ablegen und per /review-pr oder ähnlichem Kürzel direkt aufrufen.
Headless-Modus für CI/CD nutzen: Mit claude -p "Prüfe den Diff auf offensichtliche Bugs" --output-format json lässt sich Claude Code in Build-Pipelines einbinden und maschinenlesbar auswerten.
Worktrees für Parallelarbeit: Über git worktree mehrere Branches in getrennten Ordnern auschecken und in jedem eine eigene Claude-Code-Sitzung laufen lassen, etwa um an einem Feature zu arbeiten, während im Hintergrund ein Hotfix getestet wird.
Plan Mode vor riskanten Änderungen: Bei größeren Refactorings zuerst im lesenden Plan Mode einen Vorschlag erarbeiten lassen und erst nach Prüfung in den Modus wechseln, der tatsächlich schreibt.
Output Styles anpassen: Die Standardantworten lassen sich auf einen knapperen oder ausführlicheren Stil umstellen, was besonders bei Pair-Programming-Sitzungen mit mehreren Personen am Bildschirm hilft.
Sitzungen gezielt fortsetzen: Mit /resume knüpfst du an eine frühere Sitzung an, statt Kontext und Verlauf erneut aufzubauen. Praktisch bei Aufgaben, die sich über mehrere Tage ziehen, etwa ein größeres Refactoring.
Team-Einstellungen versionieren: Lege .claude/settings.json mit den gemeinsamen Berechtigungsregeln und Hooks ins Repository, während persönliche Ausnahmen in der lokal ignorierten .claude/settings.local.json bleiben. So bekommt jedes Teammitglied dieselbe Grundkonfiguration, ohne persönliche Anpassungen zu verlieren.

Häufig gestellte Fragen

Ist Claude Code kostenlos nutzbar?

Die Installation selbst kostet nichts. Für die Nutzung brauchst du entweder ein Claude-Konto mit Pro- oder Max-Abo, das ab rund 20 US-Dollar pro Monat startet, oder einen API-Key über die Anthropic Console mit Abrechnung nach Verbrauch. Ein kostenloser Claude-Account reicht für erste Tests, stößt bei intensiverer Nutzung aber schnell an Limits.

Welche Node.js-Version brauche ich mindestens?

Mindestens Node.js 18. Empfehlenswert ist Node.js 20 LTS oder neuer, weil aktuelle Long-Term-Support-Versionen langfristig Sicherheitsupdates erhalten und die meisten modernen npm-Pakete darauf ausgelegt sind.

Läuft Claude Code nativ unter Windows oder nur über WSL2?

Beides ist möglich. Claude Code lässt sich direkt unter Windows inklusive PowerShell installieren. WSL2 bleibt trotzdem eine sinnvolle Alternative, vor allem wenn der restliche Entwicklungs-Stack, etwa Docker oder ein Linux-Build-System, ohnehin dort läuft.

Wie gefährlich ist der Bypass-Modus wirklich?

Im Bypass-Modus führt Claude Code Dateiänderungen und Terminalbefehle ohne Rückfrage aus. Auf einem isolierten Container für einen klar abgegrenzten Test ist das vertretbar. Auf einem System mit echten Zugangsdaten oder produktiven Diensten ist das Risiko unnötig hoch, wie die Berichte zu automatisierten Sitzungen mit weitreichenden Rechten zeigen.

Was unterscheidet Claude Code von GitHub Copilot?

GitHub Copilot ist in erster Linie ein Autovervollständiger im Editor und gilt wegen seiner einfachen Einrichtung und der kostenlosen Stufe als guter Einstieg für Anfänger. Claude Code setzt eine Ebene höher an: Es agiert im Terminal, liest ganze Projekte, führt selbstständig mehrere Schritte aus und eignet sich besonders für Power-User und große Codebasen. In der Praxis schließen sich beide Werkzeuge nicht aus, manche Teams nutzen Copilot für schnelle Vervollständigung beim Tippen und greifen für größere, mehrstufige Aufgaben zusätzlich zu Claude Code.

Kann ich Claude Code ohne Internetverbindung nutzen?

Nein. Sowohl der Login als auch jede einzelne Anfrage laufen über die Server von Anthropic. Ohne stabile Internetverbindung startet Claude Code entweder gar nicht oder bricht mitten in einer Anfrage ab. Lokale Modelle sind mit Claude Code nicht vorgesehen, das Werkzeug ist bewusst als Cloud-Dienst mit Terminal-Anbindung konzipiert und nicht als Offline-Assistent.

Wie deinstalliere ich Claude Code wieder vollständig?

Bei der npm-Installation genügt npm uninstall -g @anthropic-ai/claude-code, bei der nativen Installation bringt das Installationsskript ein passendes Deinstallationskommando mit. Zusätzlich lohnt sich ein Blick in ~/.claude/, wo Konfiguration, globale CLAUDE.md und Anmeldedaten liegen. Diesen Ordner löschst du von Hand, falls du auch alle lokalen Einstellungen entfernen willst. Projektbezogene Dateien wie .claude/ und CLAUDE.md im jeweiligen Repository bleiben davon unberührt und müssen bei Bedarf separat entfernt werden.

Was passiert mit meinem Code, wenn ich Claude Code nutze?

Relevante Dateiausschnitte werden zur Verarbeitung an die Anthropic-Server übertragen, ähnlich wie bei jedem anderen KI-gestützten Coding-Werkzeug. Wer mit vertraulichem Code arbeitet, sollte vorab die aktuellen Nutzungs- und Datenschutzbedingungen von Anthropic prüfen und über die Berechtigungsregeln steuern, welche Verzeichnisse und Dateien überhaupt zugänglich sind.

Unterstützt Claude Code auch andere Sprachen als JavaScript?

Ja. Claude Code ist nicht auf eine Sprache oder ein Framework beschränkt und wird unter anderem für Python, Go, Rust, Java und TypeScript eingesetzt. Die Beispiele in dieser Anleitung nutzen Node.js, weil es sich als Grundlage besonders leicht nachvollziehen lässt, das zugrunde liegende Vorgehen bleibt sprachübergreifend gleich.

Was ist der Unterschied zwischen der CLI und der VS-Code-Erweiterung?

Die Kommandozeile ist die Grundlage und funktioniert unabhängig von jedem Editor. Die VS-Code-Erweiterung baut darauf auf und ergänzt eine grafische Oberfläche mit Inline-Diffs und einer Seitenleiste. Beide greifen auf dieselbe Installation und dieselbe Konfiguration zurück, du kannst also je nach Aufgabe zwischen Terminal und Editor-Ansicht wechseln, ohne etwas doppelt einzurichten.

Weiterführende Artikel

Wer nach dieser Anleitung tiefer in verwandte Themen einsteigen will, findet auf shattered.io passende Anschlussartikel:

Claude Code einrichten: 12 Schritte, 30 Minuten [2026]