Workbranch › Anleitungen

Erste Schritte mit Claude Code

Claude Code ist der Coding-Assistent von Anthropic, der Ihr Projekt liest, Dateien bearbeitet und Befehle in Ihrem Terminal ausführt. Diese Anleitung führt Sie von der Installation bis zur ersten funktionierenden Sitzung, dazu die eine Datei, die jede spätere Sitzung besser macht.

Aktualisiert am 30. Oktober 2026

Die Befehle unten wurden im Oktober 2026 mit der Dokumentation von Claude Code abgeglichen.

Welche Pläne Claude Code enthalten

Schritt 1: Installieren

1. Öffnen Sie ein Terminal. Unter Windows zeigt PowerShell PS C:\ am Anfang der Eingabezeile, CMD nur C:\.
2. Führen Sie den Befehl für Ihr System aus:
   • macOS, Linux, WSL: curl -fsSL https://claude.ai/install.sh | bash
   • Windows PowerShell: irm https://claude.ai/install.ps1 | iex
   • Windows CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
3. Warten Sie. Der Installer zeigt beim Herunterladen keinen Fortschrittsbalken.
4. Öffnen Sie ein neues Terminalfenster und führen Sie claude --version aus. Sie sollten eine Versionsnummer gefolgt von (Claude Code) sehen.

Lieber mit einem Paketmanager? brew install --cask claude-code auf dem Mac oder winget install Anthropic.ClaudeCode unter Windows funktionieren ebenfalls. Unter nativem Windows wird empfohlen, Git for Windows zu installieren, damit Claude Code Bash nutzen kann; ohne Git weicht es auf PowerShell aus.

Schritt 2: Die erste Sitzung in einem Projekt starten

1. Wechseln Sie in Ihr Projekt: cd /path/to/your/project.
2. Tippen Sie claude und drücken Sie die Eingabetaste.
3. Folgen Sie beim ersten Mal der Aufforderung, sich über den Browser anzumelden. Ihre Zugangsdaten werden gespeichert, Sie tun das also nur einmal. Mit /login wechseln Sie später das Konto.
4. Stellen Sie zur Orientierung eine Frage wie Was macht dieses Projekt? oder Wo ist der Haupteinstiegspunkt?. Claude liest die Dateien, die es braucht; Sie müssen keinen Code einfügen.
5. Probieren Sie eine kleine Änderung, etwa füge dem Anmeldeformular eine Eingabeprüfung hinzu. Claude zeigt die Änderung und fragt, bevor es sie anwendet; wählen Sie Yes (Ja), um zuzustimmen.

Claude Code erledigt auch Git in normaler Sprache: Welche Dateien habe ich geändert? oder Committe meine Änderungen mit einer aussagekräftigen Nachricht.

Schritt 3: Claude mit CLAUDE.md die Regeln Ihres Projekts geben

Jede Sitzung beginnt mit leerem Kontext. Eine Datei CLAUDE.md wird zu Beginn jeder Sitzung geladen, also gehört dorthin, was Claude immer wissen soll: Build- und Testbefehle, Konventionen, was zu vermeiden ist.

1. Führen Sie in einer Sitzung /init aus. Claude sieht sich Ihre Codebasis an und schreibt eine erste CLAUDE.md mit den Befehlen und Konventionen, die es findet. Gibt es die Datei schon, schlägt es Verbesserungen vor, statt sie zu überschreiben.
2. Öffnen Sie die Datei und ergänzen Sie, was Claude nicht selbst herausfinden konnte, etwa „vor dem Commit den Linter ausführen“.
3. Committen Sie sie, damit die Sitzungen Ihrer Teamkollegen dieselben Anweisungen bekommen.

Anthropic empfiehlt, jede Datei unter etwa 200 Zeilen zu halten: Längere Dateien verbrauchen mehr Kontext und werden weniger zuverlässig befolgt. Mit @path/to/file binden Sie andere Dateien ein.

Befehle, die sich zuerst lohnen

• claude "task" startet eine Sitzung mit Ihrer ersten Anweisung bereits ausgefüllt.
• claude -p "query" antwortet einmal und beendet sich.
• claude -c setzt die letzte Sitzung in diesem Ordner fort; claude -r wählt eine ältere. Mehr dazu in Claude-Code-Sitzung fortsetzen.
• /help listet Befehle auf, /clear beginnt neu, /exit (oder zweimal Ctrl+D) beendet.
• Tippen Sie /, um verfügbare Befehle und Skills zu sehen.

Gut zu wissen

• Nutzung: Bei Pro und Max teilen sich Claude Code und der Claude-Chat dieselben Fünf-Stunden- und Wochenlimits. Ist eine Umgebungsvariable ANTHROPIC_API_KEY gesetzt und freigegeben, nutzt Claude Code diesen Schlüssel und rechnet stattdessen zu API-Preisen ab; führen Sie /login aus, um zu Ihrem Abo zu wechseln.
• Berechtigungen: Der Berechtigungsmodus legt fest, was Claude ohne Rückfrage tun darf. Mit Shift+Tab wechseln Sie durch die Modi.
• CLAUDE.md ist eine Richtschnur, keine Sperre: Claude behandelt sie als Kontext. Konkrete, kurze Anweisungen werden am zuverlässigsten befolgt.

Wenn es nicht funktioniert

• claude wird nach der Installation nicht gefunden: Öffnen Sie ein neues Terminal. Klappt es dann immer noch nicht, liegt der Installationsordner noch nicht in Ihrem PATH; die Seite zur Fehlerbehebung von Anthropic erklärt die Lösung.
• The token '&&' is not a valid statement separator: Sie sind in PowerShell; verwenden Sie den PowerShell-Befehl. 'irm' is not recognized bedeutet, dass Sie in CMD sind.
• Der Installationsbefehl scheitert mit 403 oder einem Syntaxfehler: Auf der Seite zur Fehlerbehebung bei der Installation nennt Anthropic alternative Installationswege.
• Die Anmeldung dreht sich im Kreis oder nutzt das falsche Konto: Führen Sie in einer Sitzung /login aus, um sich neu anzumelden.

Workbranch für Claude Code

Wenn Sie Projektarbeit in Workbranch verfolgen, zeigt dessen Claude-Code-Plugin beim Start einer Sitzung in einem mit einem Projekt verknüpften Ordner, was noch offen ist, und mit „save this to Workbranch“ legen Sie die Aufgaben, Entscheidungen und offenen Fragen der Sitzung nach Thema ab. Details finden Sie auf der Seite Workbranch für Claude.

Quellen

• Use Claude Code with your Pro or Max plan (Claude Help Center, geprüft am 2026-10-30)
• Quickstart (Claude Code Docs, geprüft am 2026-10-30)
• How Claude remembers your project (Claude Code Docs, geprüft am 2026-10-30)

Häufige Fragen