Schnelle Zusammenfassung: Claude Code ist ein terminalbasierter KI-Coding-Assistent, der nativ unter macOS und Linux läuft oder unter Windows über WSL2. Die Einrichtung erfordert die Erstellung eines Anthropic API-Schlüssels, die Ausführung eines plattformspezifischen Installers, die Authentifizierung mit dem Schlüssel und die Verifizierung der Installation mit einem Testbefehl.
Claude Code repräsentiert Anthropic’s offiziellen terminalbasierten Coding-Assistenten. Er lebt direkt in der Kommandozeile und erledigt alles, von der Code-Generierung bis zur Fehlerbehebung, über Befehle in natürlicher Sprache.
Aber der Einrichtungsprozess ist nicht immer einfach. Windows-Benutzer benötigen WSL2. API-Authentifizierung kann Erstbenutzer stolpern lassen. Versionskonflikte treten auf.
Diese Anleitung führt Sie durch den vollständigen Einrichtungsprozess für alle Plattformen, von den Systemanforderungen bis zu Ihrer ersten Coding-Sitzung.
Was Claude Code tatsächlich ist
Claude Code ist eine agentenbasierte Terminalanwendung, die sich in Entwicklungsumgebungen integriert. Sie versteht Codebasen, führt Routineaufgaben aus und verwaltet Git-Workflows durch konversationelle Befehle.
Im Gegensatz zu browserbasierten Tools läuft Claude Code lokal im Terminal. Es greift direkt auf Projektdateien zu, behält den Kontext über Sitzungen hinweg bei und integriert sich in bestehende Entwicklungs-Workflows. Laut der offiziellen Claude Code-Dokumentation verbindet sich das Tool mit der API von Anthropic und unterstützt die Integration mit Amazon Bedrock, Google Cloud Vertex AI und Azure AI.
Das Tool funktioniert anders als herkömmliche Coding-Assistenten. Mal ehrlich: Es ist eher wie ein Paarprogrammierer im Terminal als ein Codevervollständigungstool.
Systemanforderungen für Claude Code
Vor der Installation müssen die Systeme bestimmte Anforderungen erfüllen. Hier ist, was jede Plattform benötigt:
| Plattform | Anforderungen | Hinweise |
|---|---|---|
| macOS | macOS 13.0 oder neuer | Native Unterstützung, unkomplizierte Installation |
| Linux | 64-Bit-Distribution mit glibc 2.28+ | Native Unterstützung für die meisten modernen Distributionen |
| Windows | Windows 10 Build 19041+ oder Windows 11 | Erfordert zuerst die WSL2-Installation |
Alle Plattformen benötigen eine stabile Internetverbindung für API-Aufrufe. Claude Code-Downloads erfordern typischerweise etwa 50 MB, wobei WSL2 unter Windows etwa 500 MB für das Linux-Subsystem hinzufügt.
Speicherplatzmäßig rechnen Sie mit mindestens 4 GB freiem Speicherplatz. Die Anwendung selbst ist klein, aber Platz für Abhängigkeiten und Projektdateien ist wichtig.
Windows-spezifische Anforderungen
Claude Code kann unter Windows über PowerShell oder die Eingabeaufforderung ausgeführt werden, wenn Node.js installiert ist. Das Tool benötigt das Windows-Subsystem für Linux 2, um eine Linux-Umgebung zu erstellen.
Gemäß den Installationsleitfäden von claude.ai benötigen Windows 10-Systeme Version 1903 oder neuer mit Build 19041 oder höher. Windows 11-Benutzer haben WSL2-Unterstützung integriert. Administratorrechte sind für die anfängliche WSL2-Einrichtung erforderlich.
Der Prozess umfasst die Aktivierung der Virtualisierung im BIOS, die Aktivierung von Windows-Funktionen und die Installation einer Linux-Distribution. Ubuntu 22.04 LTS ist die empfohlene Distribution für die Kompatibilität.
Installation von Claude Code: Schritt-für-Schritt-Prozess
Der Installationsprozess variiert je nach Plattform. Hier erfahren Sie, wie Sie Claude Code auf jedem Betriebssystem zum Laufen bringen.
Installation unter macOS und Linux
macOS- und Linux-Installationen folgen demselben Muster. Beide Plattformen unterstützen die native Installation ohne zusätzliche Einrichtung.
Der Prozess beginnt mit dem Herunterladen des Installers. Öffnen Sie ein Terminal und führen Sie aus:
curl -fsSL claude.ai/install.sh | sh
Das Skript erkennt das Betriebssystem, lädt die entsprechende Binärdatei herunter und installiert Claude Code im lokalen Binärverzeichnis. Die Installation dauert normalerweise unter zwei Minuten mit einer stabilen Verbindung.
Für Systeme ohne curl funktioniert wget als Alternative. Der Installer fügt Claude Code automatisch zum System-PATH hinzu.
Installation unter Windows über WSL2
Die Windows-Installation erfordert zuerst die Einrichtung von WSL2. Hier ist der vollständige Prozess:
Öffnen Sie PowerShell als Administrator und aktivieren Sie WSL:
wsl –install
Dieser Befehl aktiviert erforderliche Windows-Funktionen, lädt den WSL2-Kernel herunter und installiert standardmäßig Ubuntu. Das System fordert zu einem Neustart auf. Nach dem Neustart wird Ubuntu automatisch gestartet, um die Benutzereinrichtung abzuschließen.
Erstellen Sie einen Benutzernamen und ein Passwort, wenn Sie dazu aufgefordert werden. Diese Anmeldedaten sind für die Linux-Umgebung bestimmt, getrennt von den Windows-Anmeldedaten.
Sobald WSL2 läuft, gilt der Installationsprozess für Linux. Führen Sie im Ubuntu-Terminal den curl-Befehl aus dem macOS/Linux-Abschnitt oben aus.
Der Installer erledigt den Rest. Claude Code wird innerhalb der WSL2-Umgebung installiert und über das Ubuntu-Terminal ausgeführt.
Einen Anthropic API-Schlüssel erhalten
Claude Code benötigt einen Anthropic API-Schlüssel zur Authentifizierung. Der Schlüssel verbindet die lokale Installation mit den Servern von Anthropic.
Besuchen Sie die Anthropic Console unter console.anthropic.com. Erstellen Sie ein Konto oder melden Sie sich mit vorhandenen Anmeldedaten an. Navigieren Sie im Bereich Kontoeinstellungen zu API Keys.
Klicken Sie auf "Key erstellen", um einen neuen API-Schlüssel zu generieren. Der Schlüssel wird einmal angezeigt – kopieren Sie ihn sofort. Anthropic zeigt den vollständigen Schlüssel nach Verlassen der Seite nicht mehr an.
Speichern Sie den Schlüssel sicher. Er bietet vollen Zugriff auf die Anthropic API und alle damit verbundenen Kosten.
API-Kosten verstehen
Claude Code arbeitet auf Basis eines Pay-per-Use-Modells über die Anthropic API. Basierend auf Daten aus den Installationsanleitungen von claude.ai variieren die Kosten je nach Modell:
| Modell | Input-Kosten | Output-Kosten |
|---|---|---|
| Claude Opus 4.6 | 5 $ pro Million Tokens | 25 $ pro Million Tokens |
| Claude Sonnet 4.6 | 3 $ pro Million Tokens | 15 $ pro Million Tokens |
Der Mindestbetrag zur Aktivierung der Abrechnung beträgt 5 $, obwohl Diskussionen in der Community darauf hindeuten, dass 20-30 $ mehr Spielraum für Tests bieten. Alternative Abonnementoptionen sind Claude Pro für 20 $ pro Monat oder Claude Max für 100 $ pro Monat für intensive Nutzung.
Das Standardverhalten verwendet Opus, bis 50 % der Nutzungsgrenzen erreicht sind, und wechselt dann zu Sonnet aus Kostengründen.
Authentifizierung und erster Start
Nach der Installation benötigt Claude Code vor der ersten Verwendung eine Authentifizierung. Starten Sie Claude Code mit folgendem Befehl:
claude
Der erste Start fordert zur Eingabe des API-Schlüssels auf. Fügen Sie den Schlüssel aus der Anthropic Console ein und drücken Sie Enter. Claude Code validiert den Schlüssel und speichert ihn sicher in lokalen Konfigurationsdateien.
Die Authentifizierung bleibt über Sitzungen hinweg bestehen. Der API-Schlüssel muss nicht erneut eingegeben werden, es sei denn, er wird explizit entfernt oder wenn Sie Konten wechseln.
Um zu überprüfen, ob die Authentifizierung erfolgreich war, zeigt Claude Code eine Willkommensnachricht und eine Eingabeaufforderung an. Die Benutzeroberfläche zeigt verfügbare Befehle an und bestätigt die Verbindung zur API von Anthropic.
Modellpräferenzen konfigurieren
Claude Code wählt standardmäßig automatisch ein Modell aus, eine manuelle Konfiguration ist jedoch möglich. Laut offizieller Dokumentation können Benutzer die Modellauswahl über den Befehl /model oder durch Setzen der Umgebungsvariable CLAUDE_CODE_EFFORT_LEVEL anpassen.
Die Anstrengungsstufe steuert die Denkentiefe für die Modelle Opus 4.6 und Sonnet 4.6: niedrig, mittel oder hoch. Höhere Anstrengungsstufen erhöhen die Denkentiefe, aber auch die Kosten und die Reaktionszeit.
Für Projekte, die eine tiefgehende Analyse erfordern, setzt die Eingabe von "ultrathink" in Prompts vorübergehend die Anstrengung für diese spezielle Runde auf hoch.
Erfolgreiche Installation überprüfen
Überprüfen Sie nach der Authentifizierung, ob Claude Code korrekt funktioniert. Führen Sie diese grundlegenden Tests durch:
claude –help
claude –version
Der Hilfebefehl zeigt verfügbare Optionen und Befehle an. Die Versionsausgabe bestätigt, welche Version installiert ist. Beide Befehle sollten ohne Fehler ausgeführt werden.
Testen Sie als Nächstes Claude Code in einem Projektverzeichnis. Erstellen Sie einen Testordner:
mkdir test-project
cd test-project
echo “# Test Project” > README.md
claude
Versuchen Sie innerhalb der Claude Code-Sitzung grundlegende Interaktionen:
- Geben Sie "help" ein, um verfügbare Befehle anzuzeigen
- Fragen Sie "explain what you can do" (erkläre, was du tun kannst)
- Fordern Sie "summarize this project" (fasse dieses Projekt zusammen) an
- Testen Sie den Befehl /help
Diese Interaktionen bestätigen, dass Claude Code Projektdateien lesen und auf Prompts reagieren kann. Erfolgreiche Antworten bedeuten, dass die Installation funktionsfähig ist.
Claude Code für Projekte konfigurieren
Claude Code speichert projektspezifische Einstellungen in Konfigurationsdateien. Diese Dateien passen das Verhalten an, definieren den Speicher und legen Workflows fest.
Die primäre Konfigurationsdatei ist CLAUDE.md im Stammverzeichnis des Projekts. Diese Datei enthält Anweisungen, Kontext und projektspezifische Richtlinien, auf die Claude Code während der Sitzungen verweist.
Erstellen Sie eine einfache CLAUDE.md-Datei:
# Projektkontext
Dies ist ein [Projekttyp], erstellt mit [Technologien].
## Wichtige Richtlinien
– [Wichtige Regel 1]
– [Wichtige Regel 2]
## Projektstruktur
[Kurze Erklärung der Ordnerorganisation]
Die Datei akzeptiert Markdown-Formatierung. Claude Code liest diesen Kontext zu Beginn der Sitzung und behält ihn während der gesamten Konversation bei.
Erweiterte Konfigurationsoptionen
Über den grundlegenden Kontext hinaus unterstützt Claude Code erweiterte Konfigurationen über das Verzeichnis .claude. Dieses Verzeichnis kann enthalten:
- Skills: Spezialisierte Fähigkeiten, definiert in .claude/skills/SKILL.md
- Commands: Benutzerdefinierte Slash-Befehle in .claude/commands/*.md
- Hooks: Automatisierte Workflows, die durch Ereignisse ausgelöst werden
- Plugins: Erweiterte Funktionalität durch programmatische Integration
Laut der offiziellen Dokumentation des Agent SDK ermöglichen diese Funktionen eine anspruchsvolle Anpassung. Skills definieren wiederverwendbare Fähigkeiten. Commands erstellen Verknüpfungen für gängige Aufgaben. Hooks automatisieren Antworten auf Dateiänderungen oder Tool-Nutzung.
Claude Code verwenden: Grundlegende Workflows
Nach Abschluss der Installation erledigt Claude Code gängige Entwicklungsaufgaben mithilfe natürlicher Sprache.
Starten Sie eine Sitzung, indem Sie zu einem Projektverzeichnis navigieren und ausführen:
claude
Die Eingabeaufforderung akzeptiert Anfragen in einfacher Sprache. Einige gängige Workflows:
- Code-Generierung: "Erstelle eine Python-Funktion, die E-Mail-Adressen mit ordnungsgemäßer Fehlerbehandlung validiert."
- Fehlerbehebung: "Diese Funktion wirft eine Null-Pointer-Ausnahme. Können Sie das Problem identifizieren und beheben?"
- Refactoring: "Refaktorieren Sie diese Komponente, um Dependency Injection anstelle direkter Instanziierung zu verwenden."
- Git-Operationen: "Erstellen Sie einen neuen Branch, committen Sie diese Änderungen mit einer aussagekräftigen Nachricht und pushen Sie sie an Origin."
Claude Code behält den Kontext über die Sitzung hinweg bei. Es erinnert sich an frühere Interaktionen, verfolgt Dateiänderungen und versteht die allgemeine Projektstruktur.
Planmodus verstehen
Für komplexe Änderungen bietet Claude Code den Planmodus. Dieser Modus erstellt einen detaillierten Ausführungsplan, bevor Änderungen vorgenommen werden.
Aktivieren Sie den Planmodus, indem Sie Anfragen mit "plan:" voranstellen oder den Befehl /plan verwenden. Claude Code skizziert dann die vorgeschlagenen Änderungen, erklärt die Begründung und wartet auf Genehmigung vor der Ausführung.
Der Planmodus ist besonders nützlich für Refactoring, architektonische Änderungen oder Änderungen, die mehrere Dateien betreffen. Er bietet Transparenz darüber, was Claude Code tun möchte, bevor Änderungen vorgenommen werden.
Integration mit VS Code und IDEs
Obwohl Claude Code im Terminal läuft, verbessert die Integration mit Code-Editoren den Workflow. Die offizielle VS Code-Erweiterung bringt die Funktionalität von Claude Code direkt in den Editor.
Installieren Sie die Erweiterung aus dem VS Code Marketplace. Suchen Sie nach "Claude Code" und klicken Sie auf "Installieren". Die Erweiterung fügt ein Claude Code-Panel zur Seitenleiste hinzu.
Laut der offiziellen VS Code-Dokumentation unterstützt die Erweiterung:
| Funktion | Tastenkombination | Beschreibung |
|---|---|---|
| Fokus-Eingabe | Cmd+Esc / Strg+Esc | Umschalten zwischen Editor und Claude |
| In neuem Tab öffnen | Cmd+Shift+Esc / Strg+Shift+Esc | Neue Konversation als Tab starten |
| Im Terminal öffnen | – | Terminalmodus aus VS Code starten |
Die Erweiterung behält die Funktionsgleichheit mit der Terminalversion bei und fügt IDE-spezifische Annehmlichkeiten wie Inline-Diffs und @-Erwähnungen von Dateireferenzen hinzu.
Claude Code aktualisieren und verwalten
Claude Code aktualisiert sich standardmäßig automatisch. Die Anwendung prüft periodisch auf neue Versionen und installiert Updates im Hintergrund.
Um manuell zu aktualisieren, führen Sie aus:
claude –update
Dies erzwingt eine sofortige Überprüfung und Installation der neuesten Version. Der Update-Prozess behält Konfigurationsdateien und Authentifizierungsdaten bei.
Für Organisationen, die eine Versionskontrolle benötigen, können automatische Updates deaktiviert werden. Setzen Sie die Umgebungsvariable CLAUDE_CODE_AUTO_UPDATE auf false oder konfigurieren Sie über serververwaltete Einstellungen.
Um eine bestimmte Version zu installieren, verwenden Sie:
curl -fsSL claude.ai/install.sh | sh -s — –version=X.Y.Z
Ersetzen Sie X.Y.Z durch die Zielversionsnummer.
Häufige Einrichtungsprobleme und Lösungen
Bei der Einrichtung treten häufig mehrere Probleme auf. Hier erfahren Sie, wie Sie diese beheben können:
- API-Schlüssel abgelehnt: Wenn Claude Code den API-Schlüssel ablehnt, stellen Sie sicher, dass keine zusätzlichen Leerzeichen oder Zeichen vorhanden sind. Kopieren Sie den Schlüssel erneut aus der Anthropic Console. Überprüfen Sie, ob die Abrechnung aktiviert ist – Schlüssel funktionieren ohne hinterlegte Zahlungsmethode nicht.
- WSL2-Installationsfehler: Windows-Systeme schlagen manchmal bei der WSL2-Installation fehl, da die Virtualisierungseinstellungen nicht korrekt sind. Rufen Sie das BIOS auf und aktivieren Sie die Virtualisierung (Intel VT-x oder AMD-V). Stellen Sie sicher, dass die Windows-Version die Mindestanforderungen erfüllt.
- Befehl nicht gefunden: Wenn das Terminal den Befehl "claude" nicht erkennt, wurde der PATH nicht korrekt aktualisiert. Schließen und öffnen Sie das Terminal erneut. Bei anhaltenden Problemen fügen Sie das Installationsverzeichnis manuell zum PATH hinzu.
- Verbindungstimeouts: Netzwerkbeschränkungen oder Firewalls können API-Aufrufe blockieren. Claude Code benötigt HTTPS-Zugriff auf api.anthropic.com. Unternehmensnetzwerke benötigen möglicherweise eine Proxy-Konfiguration.
- Berechtigungsfehler: Linux- und macOS-Installationen stoßen gelegentlich auf Berechtigungsprobleme. Führen Sie das Installationsprogramm mit entsprechenden Berechtigungen aus oder installieren Sie es in einem Benutzerverzeichnis anstelle von systemweiten Speicherorten.
Überprüfen Sie verfügbare KI-Credits, bevor Sie Claude Code einrichten
Die Einrichtung von Claude Code beinhaltet normalerweise Experimentieren – Ausführen von Prompts, Testen von Integrationen und Erstellen kleiner Prototypen, bevor etwas in die Produktion geht. Diese frühe Phase führt oft zu viel API-Nutzung. Anstatt jede Anfrage sofort zu bezahlen, suchen viele Entwickler zuerst nach verfügbaren Credits oder Startup-Programmen, die helfen, diese anfänglichen Kosten zu senken.
Get AI Perks sammelt diese Möglichkeiten an einem Ort. Die Plattform listet KI-Credits, Rabatte und Partnerprogramme von KI-Anbietern, Cloud-Plattformen und Entwicklertools auf, mit Schritt-für-Schritt-Anleitungen zur beanspruchung. Insgesamt umfasst die Datenbank Vergünstigungen von über 200 Tools und Millionen von Dollar an verfügbaren Credits, für die sich Start-ups und Entwickler bewerben können.
Bevor Sie die Einrichtung von Claude Code abschließen, überprüfen Sie Get AI Perks und beanspruchen Sie die KI-Credits, die Ihre ersten Experimente abdecken können.
Häufig gestellte Fragen
Muss ich für Claude Code bezahlen?
Claude Code selbst ist kostenlose Software, erfordert jedoch einen Anthropic API-Schlüssel, der nach dem Pay-per-Use-Modell funktioniert. Die minimale Kontoaktivierung beträgt 5 $, obwohl die praktische Nutzung typischerweise 20-30 $ an Credits erfordert. Alternative Abonnementpläne wie Claude Pro (20 $/Monat) oder Claude Max (100 $/Monat) bieten unterschiedliche Preisstrukturen für Vielnutzer.
Kann Claude Code vollständig offline laufen?
Nein. Claude Code benötigt eine aktive Internetverbindung, um mit den API-Servern von Anthropic zu kommunizieren. Die Anwendung verarbeitet Anfragen lokal, sendet aber Prompts an Claude-Modelle, die auf der Infrastruktur von Anthropic laufen. Es gibt keinen Offline-Modus oder lokale Modelloption.
Was ist der Unterschied zwischen Claude Code und Claude.ai?
Claude.ai ist eine webbasierte Chat-Oberfläche für allgemeine Claude-Interaktionen. Claude Code ist eine spezialisierte Terminalanwendung, die speziell für die Softwareentwicklung entwickelt wurde. Claude Code integriert sich mit Git, liest Projektdateien direkt, behält einen längeren Entwicklungskontext bei und enthält code-spezifische Funktionen wie den Planmodus und Dateibearbeitungsfunktionen.
Wie wechsle ich zwischen Claude-Modellen?
Verwenden Sie den Befehl /model innerhalb einer Claude Code-Sitzung, um zwischen den verfügbaren Modellen zu wechseln. Die Standardkonfiguration verwendet Opus, bis 50 % der Nutzung erreicht sind, und wechselt dann zu Sonnet. Manuelle Auswahl ermöglicht die Wahl spezifischer Modelle basierend auf den Aufgabenanforderungen – Opus für komplexe Schlussfolgerungen, Sonnet für schnellere, kostengünstigere Antworten.
Kann ich Claude Code in VS Code verwenden?
Ja. Eine offizielle VS Code-Erweiterung bringt die Funktionalität von Claude Code in den Editor. Installieren Sie sie aus dem VS Code Marketplace. Die Erweiterung bietet die gleichen Funktionen wie die Terminalversion mit zusätzlichen IDE-Integrationen wie Inline-Diffs, Seitenleisten und Tastenkombinationen für schnellen Zugriff.
Speichert Claude Code meinen Code oder meine Konversationen?
Gemäß den Nutzungsrichtlinien für Daten von Anthropic werden API-Interaktionen nicht zum Trainieren von Modellen verwendet. Organisationen können durch Enterprise-Einstellungen Richtlinien zur vollständigen Datenlöschung konfigurieren. Code und Prompts werden zur Verarbeitung an die Server von Anthropic übertragen, die Handhabung hängt jedoch von der Kontokonfiguration und den Einstellungen zur Datenspeicherung ab.
Was passiert, wenn Claude Code einen Fehler macht?
Claude Code verfügt über Sicherheitsfunktionen wie Git-Integration und Planmodus, um Fehler zu minimieren. Bei Fehlern gelten die üblichen Verfahren der Versionskontrolle – die Git-Historie bietet die Möglichkeit zum Rollback. Das Berechtigungssystem erfordert die Zustimmung für sensible Operationen. Einige Community-Diskussionen deuten auf Erfolgsraten im Bereich von 80-90 % für Routineaufgaben hin, wobei eine Überwachung bei kritischen Änderungen empfohlen wird.
Mit Claude Code weiterarbeiten
Claude Code transformiert die terminalbasierte Entwicklung, indem KI-Unterstützung direkt in die Kommandozeile integriert wird. Die Einrichtung erfordert plattformspezifische Installation, API-Authentifizierung und grundlegende Konfiguration, aber der Prozess ist einfach, wenn man die richtigen Schritte befolgt.
Das Tool eignet sich hervorragend für Routineentwicklungsaufgaben, Code-Generierung und die Verwaltung von Git-Workflows. Der Planmodus bietet Sicherheit für komplexe Operationen. Die IDE-Integration erweitert die Fähigkeiten über das Terminal hinaus.
Beginnen Sie mit einfachen Aufgaben, um zu verstehen, wie Claude Code Anfragen interpretiert. Steigern Sie sich zu komplexeren Workflows, wenn Sie vertrauter werden. Verwenden Sie den Befehl /clear zwischen verschiedenen Aufgaben, um einen sauberen Kontext zu erhalten. Konfigurieren Sie CLAUDE.md-Dateien für projektspezifische Anleitungen.
Teams können sich mit serververwalteten Einstellungen und Plugin-Marktplätzen befassen. Einzelentwickler können von Skills und benutzerdefinierten Befehlen profitieren, die auf häufige Muster zugeschnitten sind.
Das GitHub-Repository unter anthropics/claude-code enthält zusätzliche Beispiele, Community-Plugins und Ressourcen zur Fehlerbehebung. Die offizielle Dokumentation unter docs.anthropic.com bietet umfassende technische Referenzen.
Nun ist es Zeit, mit dem Coden zu beginnen. Navigieren Sie zu einem Projekt, starten Sie Claude Code und sehen Sie, wie die KI-gestützte Entwicklung Ihren Workflow verändert.
