Erste Schritte

Was ist Claude Code?

Claude Code ist ein KI-Coding-Assistent der in deinem Terminal — dem textbasierten Fenster, in dem Entwickler Befehle eingeben. Statt in einer App auf Buttons zu klicken, tippst du in normaler Sprache, was du möchtest, und Claude liest deinen Code, schlägt Korrekturen vor, schreibt neue Features, führt Tests aus und verwaltet sogar Dateien — und das alles, indem es dein Projekt direkt auf deinem Rechner versteht.

Bevor du einen Slash-Befehl nutzen oder einen Workflow aufbauen kannst, muss Claude Code auf deinem Rechner laufen. Dieses Modul führt dich durch Installation, Authentifizierung, die Wahl des passenden Terminal- und IDE-Setups und den Start deiner allerersten Session.

Voraussetzungen

Claude Code läuft auf macOS 13+, Ubuntu 20.04+ (und anderen modernen Linux-Distributionen) sowie Windows 10 1809+ (nativ oder WSL). Du brauchst mindestens 4 GB RAM — 8 GB werden für komfortables Arbeiten empfohlen. Eine aktive Internetverbindung ist jederzeit erforderlich.

Außerdem brauchst du ein berechtigtes Anthropic-Konto — ein Pro-, Max-, Team-, Enterprise- oder Console-Konto. Der kostenlose Claude.ai-Plan enthält keinen Zugriff auf Claude Code. Alternativ kannst du einen API-Schlüssel aus der Anthropic Console verwenden oder dich über Amazon Bedrock, Google Vertex AI oder Microsoft Foundry verbinden.

Unter nativem Windows ist Git for Windows optional, aber empfohlen: Wenn es installiert ist, nutzt Claude Code Git Bash für das Bash-Tool. Ohne Git Bash führt Claude Code Befehle stattdessen über das PowerShell-Tool aus. Wenn Git Bash vorhanden ist, wird das PowerShell-Tool schrittweise als zusätzliche Option neben Bash ausgerollt — setze CLAUDE_CODE_USE_POWERSHELL_TOOL=1 zum Aktivieren oder 0 zum Deaktivieren. Für Bedrock-, Vertex- und Foundry-Nutzer ist es standardmäßig aktiviert.

Die CLI installieren

Der empfohlene Weg, Claude Code zu installieren, ist der native Installer. Er aktualisiert sich im Hintergrund automatisch, sodass du immer die neueste Version hast.

Auf macOS oder Linux (einschließlich WSL):

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

Auf Windows via PowerShell:

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

Auf Windows via CMD:

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

Es gibt alternative Installationsmethoden, sie erfordern jedoch manuelle Updates. Homebrew: brew install --cask claude-code (Stable-Channel) oder brew install --cask claude-code@latest (Latest-Channel). WinGet: winget install Anthropic.ClaudeCode. npm: npm install -g @anthropic-ai/claude-code (erfordert Node.js 18+). Unter Linux kannst du auch System-Paketmanager verwenden: sudo apt install claude-code (Debian/Ubuntu), sudo dnf install claude-code (Fedora/RHEL) oder apk add claude-code (Alpine).

Nach der Installation prüfst du, ob alles geklappt hat:

claude --version

Für eine ausführlichere Prüfung von Installation und Konfiguration führe claude doctor aus — es validiert dein Setup, deine MCP-Server und Einstellungen.

Den Update-Channel steuerst du über /config — wähle zwischen latest (neueste Features) und stable (getestete Releases, etwa eine Woche hinterher).

Authentifizierung

Wenn du claude zum ersten Mal ausführst, öffnet sich automatisch dein Browser für die OAuth-Authentifizierung. Melde dich mit deinem Anthropic-Konto an, und schon kann es losgehen.

Wenn du stattdessen einen API-Schlüssel verwendest, setze die Umgebungsvariable vor dem Start:

export ANTHROPIC_API_KEY=sk-ant-...
claude

Für Enterprise- oder Cloud-Provider-Setups verwendest du die entsprechenden Umgebungsvariablen:

• Amazon Bedrock: CLAUDE_CODE_USE_BEDROCK=1
• Google Vertex AI: CLAUDE_CODE_USE_VERTEX=1
• Microsoft Foundry: CLAUDE_CODE_USE_FOUNDRY=1

Deine Zugangsdaten werden sicher gespeichert — im macOS-Keychain auf dem Mac oder in ~/.claude/.credentials.json (Modus 0600) unter Linux und Windows.

Um jederzeit das Konto zu wechseln oder dich neu zu authentifizieren, verwende /logout. Du kannst die Authentifizierung auch explizit auslösen mit claude auth login — das öffnet den OAuth-Flow im Browser, oder falls sich der Browser nicht öffnen lässt, wird eine URL ausgegeben, die du in einen beliebigen Browser einfügen kannst; anschließend fügst du den Autorisierungscode zurück ins Terminal ein. Weitere Optionen sind claude auth login --email zum Vorausfüllen deiner E-Mail-Adresse, claude auth login --sso für Organisationen mit SSO und claude auth login --console für die Authentifizierung per API-Schlüssel über die Anthropic Console.

Dein Terminal: Warp empfohlen

Claude Code funktioniert in jedem Terminal — Terminal.app, iTerm2, Windows Terminal, Alacritty, Kitty, Ghostty und mehr. Für die beste Erfahrung empfehlen wir jedoch Warp.

Warp hat ein offizielles Claude-Code-Plugin, das native Desktop-Benachrichtigungen liefert, wenn Claude eine Aufgabe abschließt, deine Eingabe braucht oder Berechtigungen anfordert. Das ist besonders nützlich bei lang laufenden Vorgängen, bei denen du in ein anderes Fenster wechselst.

Um das Warp-Plugin einzurichten, führe nach der Installation diese Befehle in Claude Code aus:

/plugin marketplace add warpdotdev/claude-code-warp
/plugin install warp@claude-code-warp

Starte Claude Code nach der Installation neu, um das Plugin zu aktivieren. Du erhältst native Betriebssystem-Benachrichtigungen für abgeschlossene Aufgaben, Leerlaufzustände und Berechtigungsanfragen — kein manuelles Nachschauen mehr.

Standardmäßig sendet Claude Code nur in Ghostty, Kitty und iTerm2 Desktop-Benachrichtigungen. In jedem anderen Terminal setze preferredNotifChannel zu "terminal_bell" damit stattdessen die Terminal-Glocke ertönt, oder konfiguriere einen Notification-Hook für einen eigenen Ton. Shift+Enter für einen Zeilenumbruch funktioniert in den meisten Terminals auch ohne Einrichtung; in VS Code, Cursor, Devin Desktop, Alacritty und Zed führe /terminal-setup einmal aus, um diese Tastenbelegung zu schreiben.

Standardmäßig nutzt Claude Code den Alternate-Screen des Terminals für eine Vollbild-Darstellung. Wenn du die Konversation lieber im nativen Scrollback deines Terminals behalten möchtest (nützlich für Screenreader, Terminal-Multiplexer oder das Weiterleiten von Ausgaben), setze CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 vor dem Start.

IDE-Erweiterungen

Claude Code begann als CLI-Tool, hat inzwischen aber offizielle Erweiterungen für die großen Editoren. Du kannst beides nutzen — die CLI für intensive Terminal-Arbeit und die Erweiterung für Komfort direkt im Editor.

VS Code ist die ausgereifteste Integration. Installiere sie über den VS Code Marketplace oder per code --install-extension Anthropic.claude-code. Sie bietet dir eine native grafische Oberfläche, visuelle Diff-Prüfung, Datei-Referenzen, Konversationsverlauf und die Möglichkeit, mehrere Konversationen in Tabs auszuführen.

JetBrains hat ein offizielles Plugin in der Beta, verfügbar im JetBrains Marketplace für IntelliJ IDEA, WebStorm, PyCharm und andere JetBrains-IDEs. Es orchestriert die CLI mit dem Diff-Viewer der IDE für ein nahtloses Erlebnis.

Cursor, Devin Desktop (in v2.1.162 von Windsurf umbenannt) und Kiro sind VS-Code-Forks, die die VS-Code-Erweiterung und das integrierte Terminal unterstützen. In VS Code, Cursor und Devin Desktop /terminal-setup deaktiviert die GPU-Beschleunigung des integrierten Terminals (um verstümmelten Text zu verhindern) und passt die Scroll-Empfindlichkeit für flüssigeres Vollbild-Scrollen an, und /ide und /scroll-speed verwenden ebenfalls die neue Bezeichnung Devin Desktop.

Über IDE-Erweiterungen hinaus gibt es auch eine Desktop App für macOS und Windows (nicht für Linux verfügbar — nutze dort stattdessen die CLI), die visuelle Diffs, eine Live-App-Vorschau und autonome Hintergrund-Agents bietet — ganz ohne Terminal. Und Claude Code on the Web (claude.ai/code) ist eine Research Preview, die auf Cloud-VMs läuft, sodass du von jedem Browser aus arbeiten kannst — ganz ohne lokales Setup.

Deine erste Session

Navigiere in ein beliebiges Projektverzeichnis und starte Claude Code:

cd my-project
claude

Du siehst eine Willkommensnachricht und einen Prompt. Tippe einfach in normaler Sprache, was Claude tun soll. Du kannst auch Bilder einfügen mit Ctrl+V — während das Bild aus der Zwischenablage gelesen wird, erscheint in der Fußzeile ein „Pasting…“-Hinweis:

What files are in this project and what does it do?

Claude liest deine Dateien, analysiert die Struktur und gibt dir eine Zusammenfassung. Von hier aus kannst du es bitten, Änderungen vorzunehmen, Bugs zu beheben, Tests auszuführen oder Code zu erklären. Wenn Claude Aktionen wie das Bearbeiten von Dateien oder das Ausführen von Befehlen durchführen muss, fragt es zuerst nach deiner Erlaubnis.

Das war's — du bist startklar. Weiter geht's zum nächsten Modul, in dem du die Slash-Befehle kennenlernst, die Claude Code richtig mächtig machen.