> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Terminal-Anleitung für neue Benutzer

> Eine Schritt-für-Schritt-Anleitung zur Installation von Claude Code für Anfänger im Terminal auf macOS und Windows.

Sie können Claude Code verwenden, auch wenn Sie noch nie ein Terminal verwendet haben. Diese Anleitung führt Sie durch das Öffnen eines Terminals, die Installation von Claude Code und Ihre ersten Interaktionen.

* [macOS und Linux](#macos-and-linux)
* [Windows](#windows)

<Note>
  Möchten Sie das Terminal nicht verwenden? Die Claude Code Desktop-App ermöglicht es Ihnen, das Terminal vollständig zu umgehen. Laden Sie sie für [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) oder [Linux](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) herunter und lesen Sie dann den [Desktop-Schnellstart](/de/desktop-quickstart), um zu beginnen.
</Note>

<h2 id="macos-and-linux">
  macOS und Linux
</h2>

Folgen Sie diesen Schritten, um Claude Code von einem macOS- oder Linux-Terminal aus zu installieren und zu starten. Claude Code erfordert macOS 13.0 oder später. Siehe die [Systemanforderungen](/de/setup#system-requirements) für unterstützte Linux-Distributionen.

<Steps>
  <Step title="Öffnen Sie ein Terminal">
    **macOS**: Drücken Sie `Cmd + Space`, um die Spotlight-Suche zu öffnen, geben Sie `Terminal` ein und drücken Sie `Enter`.

    **Linux**: Öffnen Sie Ihre Terminal-App. Bei den meisten Distributionen drücken Sie `Ctrl + Alt + T` oder suchen Sie nach 'Terminal" in Ihrem Anwendungsmenü.

    Ein Fenster mit einem blinkenden Cursor wird angezeigt. Dies ist Ihr Terminal, in dem Sie Befehle eingeben.
  </Step>

  <Step title="Installieren Sie Claude Code">
    Kopieren Sie diese Zeile, fügen Sie sie in Ihr Terminal ein (`Cmd + V` auf macOS, `Ctrl + Shift + V` auf Linux) und drücken Sie `Enter`:

    ```bash theme={null}
    curl -fsSL https://claude.ai/install.sh | bash
    ```

    Dies lädt das Claude Code-Installationsprogramm von claude.ai herunter und führt es aus. Sie sehen Text, der während der Arbeit scrollt. Wenn es fertig ist, sehen Sie 'Claude Code erfolgreich installiert!". Wenn Sie stattdessen einen Fehler sehen, lesen Sie den [Abschnitt zur Fehlerbehebung](#macos-and-linux-troubleshooting) unten.
  </Step>

  <Step title="Starten Sie Claude Code">
    Geben Sie `claude` ein und drücken Sie `Enter`:

    ```bash theme={null}
    claude
    ```

    Sie werden aufgefordert, sich mit Ihrem Claude-Konto [anzumelden](/de/authentication). Folgen Sie den Anweisungen auf dem Bildschirm. Ein Browser-Fenster wird geöffnet, damit Sie sich anmelden können.
  </Step>

  <Step title="Beginnen Sie mit der Verwendung von Claude Code">
    Nach der Anmeldung können Sie Claude Fragen zu Ihrem Code oder zu anderen Dingen stellen. Claude Code läuft vollständig in Text. Sie geben Nachrichten ein und drücken `Enter`, um sie zu senden. Ein paar Dinge, die Sie wissen sollten:

    * Sie können nicht auf Dinge im Terminal klicken. Verwenden Sie die Pfeiltasten, um sich zu bewegen.
    * Drücken Sie `Esc`, um Claude zu unterbrechen, wenn es läuft.
    * Geben Sie `exit` ein oder drücken Sie `Ctrl + D`, um Claude Code zu beenden.
    * Geben Sie `/help` ein, um verfügbare Befehle anzuzeigen.
  </Step>
</Steps>

***

<h2 id="windows">
  Windows
</h2>

Folgen Sie diesen Schritten, um optional Git für Windows zu installieren, PowerShell einzurichten und Claude Code unter Windows zu starten. Claude Code erfordert Windows 10 Version 1809 oder später. Siehe die [Systemanforderungen](/de/setup#system-requirements) für vollständige Details.

<Steps>
  <Step title="Git für Windows installieren (optional)">
    Git für Windows bietet Git Bash, das das Bash-Tool ermöglicht. Ohne es verwendet Claude Code stattdessen PowerShell. Sie müssen Git selbst nicht erlernen.

    Falls Sie es noch nicht haben:

    1. Gehen Sie zu [git-scm.com/downloads/win](https://git-scm.com/downloads/win) und laden Sie das Installationsprogramm herunter
    2. Führen Sie das Installationsprogramm aus. Klicken Sie auf jedem Bildschirm auf Weiter, um die Standardeinstellungen zu akzeptieren. Das Installationsprogramm hat viele Bildschirme, aber Sie müssen nichts ändern.
    3. Wenn Sie aufgefordert werden, einen Editor auszuwählen, behalten Sie den Standard bei und klicken Sie auf Weiter.
    4. Wenn Sie 'Adjusting your PATH environment" sehen, behalten Sie die empfohlene Option ausgewählt.

    <Note>
      Haben Sie bereits Git? Sie können diesen Schritt überspringen. Wenn Sie sich nicht sicher sind, installieren Sie es trotzdem. Eine Neuinstallation verursacht keine Probleme.
    </Note>
  </Step>

  <Step title="PowerShell öffnen">
    PowerShell ist das integrierte Terminal von Windows zum Eingeben von Befehlen. Es ist auf jedem Windows-Computer vorinstalliert.

    Drücken Sie `Win + X` und wählen Sie **Windows PowerShell** (oder **Terminal**) aus dem Menü. Ein Fenster mit einem blinkenden Cursor wird angezeigt. Hier geben Sie Befehle ein.

    <Note>
      Windows hat zwei Befehlszeilenprogramme: PowerShell und CMD. Sie sehen ähnlich aus, verwenden aber unterschiedliche Befehle. Stellen Sie sicher, dass Sie sich in PowerShell für den nächsten Schritt befinden.

      So erkennen Sie, in welchem Sie sich befinden:

      * **PowerShell**: zeigt `PS C:\Users\YourName>` am Anfang jeder Zeile
      * **CMD**: zeigt `C:\Users\YourName>` ohne das `PS`
    </Note>
  </Step>

  <Step title="Claude Code installieren">
    Kopieren Sie diese Zeile, fügen Sie sie mit `Ctrl + V` in PowerShell ein oder klicken Sie mit der rechten Maustaste, und drücken Sie `Enter`:

    ```powershell theme={null}
    irm https://claude.ai/install.ps1 | iex
    ```

    Dies lädt das Claude Code-Installationsprogramm herunter und führt es aus. `irm` ruft die Datei ab und `iex` führt sie aus. Sie sehen Text, der während der Arbeit scrollt. Wenn es fertig ist, sehen Sie „Claude Code successfully installed!" (Claude Code erfolgreich installiert!). Wenn Sie stattdessen einen Fehler sehen, lesen Sie den [Abschnitt zur Fehlerbehebung](#windows-troubleshooting) unten.

    <Note>
      Wenn Sie sich in CMD statt PowerShell befinden, verwenden Sie diesen Befehl:

      ```batch theme={null}
      curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
      ```
    </Note>
  </Step>

  <Step title="Claude Code starten">
    Führen Sie `claude` aus. Wenn PowerShell sagt `'claude' is not recognized`, ist das Installationsverzeichnis noch nicht in Ihrem PATH. Folgen Sie der Behebung ['claude is not recognized"](#windows-troubleshooting) unten, öffnen Sie dann ein neues PowerShell-Fenster und versuchen Sie es erneut.

    ```powershell theme={null}
    claude
    ```

    Sie werden aufgefordert, sich mit Ihrem Claude-Konto [anzumelden](/de/authentication). Folgen Sie den Anweisungen auf dem Bildschirm. Ein Browser-Fenster wird geöffnet, damit Sie sich anmelden können.
  </Step>

  <Step title="Beginnen Sie mit der Verwendung von Claude Code">
    Nach der Anmeldung können Sie Claude Fragen zu Ihrem Code oder zu anderen Dingen stellen. Claude Code läuft vollständig in Text. Sie geben Nachrichten ein und drücken `Enter`, um sie zu senden. Ein paar Dinge, die Sie wissen sollten:

    * Sie können nicht auf Dinge im Terminal klicken. Verwenden Sie die Pfeiltasten, um sich zu bewegen.
    * Drücken Sie `Esc`, um Claude zu unterbrechen, wenn es läuft.
    * Geben Sie `exit` ein oder drücken Sie `Ctrl + D`, um Claude Code zu beenden.
    * Geben Sie `/help` ein, um verfügbare Befehle anzuzeigen.
  </Step>
</Steps>

***

<h2 id="what’s-next">
  Was kommt als Nächstes?
</h2>

Sobald Sie den Claude Code-Willkommensbildschirm sehen, können Sie loslegen. Sie müssen nicht wissen, wie man programmiert. Beschreiben Sie, was Sie möchten, in einfachem Englisch, und Claude schreibt den Code für Sie.

<h3 id="build-something">
  Erstellen Sie etwas
</h3>

Claude kann Projekte aus einer Beschreibung erstellen:

```text theme={null}
make me a simple webpage that says hello world
```

Claude erstellt die Dateien für Sie. Doppelklicken Sie auf die HTML-Datei, um sie in Ihrem Browser zu öffnen.

<h3 id="work-with-files-on-your-computer">
  Arbeiten Sie mit Dateien auf Ihrem Computer
</h3>

Claude kann Dateien, die Sie bereits haben, lesen und organisieren:

```text theme={null}
look at the screenshots on my Desktop and rename them based on what's in each image
```

<h3 id="ask-questions">
  Stellen Sie Fragen
</h3>

Claude kann Dinge erklären, Ihnen beim Lernen helfen oder ein Projekt planen:

```text theme={null}
I want to build a personal budget tracker. What would I need?
```

Wenn Sie noch kein Projekt haben, ist das in Ordnung. Claude kann Ihnen helfen, ein neues zu starten.

<h3 id="other-ways-to-use-claude-code">
  Andere Möglichkeiten, Claude Code zu verwenden
</h3>

Sie müssen das Terminal nicht verwenden. Claude Code ist auch verfügbar in:

* [VS Code](/de/vs-code) und [JetBrains IDEs](/de/jetbrains) als Editor-Erweiterungen
* Der [Desktop-App](/de/desktop-quickstart), ohne Terminal erforderlich
* Dem [Web](/de/claude-code-on-the-web) unter claude.ai/code für Remote-Sitzungen
* [GitHub Actions](/de/github-actions) und [GitLab CI/CD](/de/gitlab-ci-cd) für Automatisierung

<h3 id="learn-more">
  Weitere Informationen
</h3>

* [Schnellstart](/de/quickstart): eine geführte Anleitung für Ihr erstes Projekt mit Claude Code
* [Wie Claude Code funktioniert](/de/how-claude-code-works): verstehen Sie, wie Claude Ihre Dateien liest, Befehle ausführt und Änderungen vornimmt
* [Best Practices](/de/best-practices): erhalten Sie bessere Ergebnisse mit effektiver Eingabeaufforderung und Projekteinrichtung
* [Häufige Workflows](/de/common-workflows): Schritt-für-Schritt-Anleitungen zum Debuggen, Testen, Refaktorieren und mehr
* [Terminal-Konfiguration](/de/terminal-config): passen Sie Ihr Terminal für die beste Claude Code-Erfahrung an

***

<h2 id="troubleshooting">
  Fehlerbehebung
</h2>

<h3 id="macos-and-linux-troubleshooting">
  macOS und Linux Fehlerbehebung
</h3>

Wenn Sie Probleme bei der Installation auf macOS oder Linux haben, überprüfen Sie diese häufigen Probleme:

<Accordion title="'command not found: claude'">
  Wenn Sie nach der Installation `command not found: claude` sehen, befindet sich der Ordner, in dem das Installationsprogramm `claude` abgelegt hat, nicht in Ihrem PATH. Das Installationsprogramm gibt die genaue Lösung unter `Setup notes` am Ende der Installation aus. Führen Sie diesen Befehl aus, oder verwenden Sie den unten für Ihre Shell aufgeführten Befehl.

  Für Zsh, die macOS-Standard-Shell:

  ```bash theme={null}
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc
  ```

  Für Bash, die Linux-Standard-Shell:

  ```bash theme={null}
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
  source ~/.bashrc
  ```

  Öffnen Sie dann ein neues Terminal und versuchen Sie erneut `claude`. Wenn es immer noch nicht gefunden wird, überprüfen Sie, dass die Datei `~/.local/bin/claude` vorhanden ist. Wenn nicht, wurde die Installation nicht abgeschlossen. Weitere Details finden Sie unter [PATH reparieren](/de/troubleshoot-install#verify-your-path).
</Accordion>

<Accordion title="Fehler mit HTML-Code oder 'syntax error near unexpected token'">
  Wenn Sie `bash: line 1: syntax error near unexpected token '<'` oder HTML-Code wie `<!DOCTYPE html>` in Ihrem Terminal sehen, hat die Installations-URL eine Webseite statt des Installationsskripts zurückgegeben.

  Wenn die Seite 'App in dieser Region nicht verfügbar" sagt, ist Claude Code in Ihrem Land nicht verfügbar. Siehe [unterstützte Länder](https://www.anthropic.com/supported-countries).

  Versuchen Sie andernfalls, den Befehl erneut auszuführen. Wenn es weiterhin passiert, installieren Sie stattdessen mit [Homebrew](https://brew.sh):

  ```bash theme={null}
  brew install --cask claude-code
  ```
</Accordion>

<Accordion title="'dyld' Fehler oder 'built for Mac OS X 13.0'">
  Wenn Sie `dyld: cannot load`, `dyld: Symbol not found` oder `built for Mac OS X 13.0` sehen, ist Ihre macOS-Version wahrscheinlich älter als das, was Claude Code unterstützt.

  Öffnen Sie das Apple-Menü und wählen Sie 'Über diesen Mac", um Ihre Version zu überprüfen. Wenn sie älter als 13.0 ist, aktualisieren Sie macOS über Software Update. Weitere Details finden Sie im [macOS-Fehlerbehebungsleitfaden](/de/troubleshoot-install#dyld-cannot-load-on-macos).
</Accordion>

Für andere Fehler siehe den vollständigen [Installationsfehlerbehebungsleitfaden](/de/troubleshoot-install).

<h3 id="windows-troubleshooting">
  Windows Fehlerbehebung
</h3>

Wenn Sie Probleme bei der Installation unter Windows haben, überprüfen Sie diese häufigen Probleme:

<Accordion title="'irm is not recognized'">
  Sie befinden sich in CMD, nicht in PowerShell. Schließen Sie dieses Fenster und öffnen Sie stattdessen PowerShell (`Win + X` und dann Windows PowerShell auswählen).

  Alternativ verwenden Sie den CMD-Installationsbefehl:

  ```batch theme={null}
  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  ```
</Accordion>

<Accordion title="SSL/TLS Fehler oder 'Could not create SSL/TLS secure channel'">
  Dies geschieht normalerweise auf älteren Windows 10-Systemen. Führen Sie diese Zeile zuerst aus und versuchen Sie dann die Installation erneut:

  ```powershell theme={null}
  [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  irm https://claude.ai/install.ps1 | iex
  ```
</Accordion>

<Accordion title="'Claude Code on Windows requires either Git for Windows (for bash) or PowerShell'">
  Weder PowerShell noch Git Bash wurde gefunden. Claude Code benötigt mindestens eine Shell.

  1. Stellen Sie sicher, dass `powershell.exe` auf Ihrem `PATH` ist. Der Standardort ist `C:\Windows\System32\WindowsPowerShell\v1.0\`. Alternativ installieren Sie [PowerShell 7](https://aka.ms/powershell), das `pwsh` bereitstellt.
  2. Wenn Sie lieber Git Bash verwenden möchten, installieren Sie [Git für Windows](https://git-scm.com/downloads/win) gemäß dem [ersten Schritt im Windows-Abschnitt](#windows).
  3. Wenn Git installiert ist, aber Claude Code es nicht finden kann, teilen Sie ihm mit, wo es zu suchen ist:
     ```powershell theme={null}
     $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
     ```
     Führen Sie dann `claude` erneut aus. Wenn Ihr Git an einem anderen Ort installiert ist, finden Sie den Pfad durch Ausführung:
     ```powershell theme={null}
     Get-Command git | Select-Object Source
     ```
     Suchen Sie nach dem `Git\bin`-Ordner in diesem Pfad und verwenden Sie ihn stattdessen.

  Um dies dauerhaft zu machen, damit Sie es nicht jedes Mal einstellen müssen, siehe [Git Bash-Pfad konfigurieren](/de/troubleshoot-install#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell).
</Accordion>

<Accordion title="'claude is not recognized'">
  Dieser Fehler bedeutet, dass das Installationsverzeichnis nicht in Ihrem PATH ist. Führen Sie diese Befehle in PowerShell aus, um es hinzuzufügen:

  ```powershell theme={null}
  $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
  [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
  ```

  Schließen Sie PowerShell, öffnen Sie ein neues Fenster und versuchen Sie erneut `claude`. Weitere Details finden Sie unter [PATH überprüfen](/de/troubleshoot-install#verify-your-path).
</Accordion>

Für andere Fehler siehe den vollständigen [Installationsfehlerbehebungsleitfaden](/de/troubleshoot-install).