# Installation (/de/docs/verdent-manager/getting-started/installation)

> Schritt-für-Schritt-Anleitung zur Installation und Einrichtung von Verdent



Diese Anleitung führt Sie durch das Herunterladen von Verdent, die plattformspezifische Installation und die Authentifizierung mit Ihrem Verdent-Konto.

***

## Voraussetzungen [#voraussetzungen]

Bevor Sie Verdent installieren, stellen Sie sicher, dass Ihr System diese Voraussetzungen erfüllt:

### Systemanforderungen [#systemanforderungen]

* **Betriebssystem**: macOS 11+ oder Windows 10+ (64-Bit). Ausführliche Kompatibilitätsdetails finden Sie unter [Unterstützte Betriebssysteme](/docs/verdent-manager/getting-started/supported-operating-systems).
* **Git**: Version 2.20 oder höher. Verdent verwendet Git-Worktrees zur Isolation von Arbeitsbereichen. Ihr Projektordner muss kein Git-Repository sein, aber einige Funktionen erfordern Git, und Verdent kann Sie bei Bedarf durch die Initialisierung eines Repos führen.
  * **macOS:** Git wird mit den Xcode Command Line Tools ausgeliefert. Installieren Sie es mit `xcode-select --install` oder nutzen Sie Homebrew: `brew install git`.
  * **Windows:** Laden Sie das offizielle Installationsprogramm von [git-scm.com/download/win](https://git-scm.com/download/win) herunter und übernehmen Sie die Standardoptionen.
  * Überprüfen Sie die Installation mit `git --version` in einem Terminal.
* **Internetverbindung**: Für die Kommunikation mit dem KI-Dienst ist eine aktive Verbindung erforderlich

### Optional, aber empfohlen [#optional-aber-empfohlen]

* **Speicherplatz**: Mindestens 2 GB frei (mehr empfohlen für große Repositories, Worktrees und Caching)

***

## Herunterladen [#herunterladen]

Laden Sie Verdent von der offiziellen Website herunter:

**[verdent.ai/download](https://verdent.ai/download)**

Wählen Sie Ihr Betriebssystem aus, um das passende Installationsprogramm herunterzuladen.

***

## Installation unter macOS [#installation-unter-macos]

<Steps>
  <Step title="Herunterladen">
    Laden Sie die Datei `.dmg` von [verdent.ai/download](https://verdent.ai/download) herunter
  </Step>

  <Step title="DMG öffnen">
    Doppelklicken Sie auf die heruntergeladene Datei `.dmg`, um sie einzubinden
  </Step>

  <Step title="Installieren">
    Ziehen Sie das Symbol Verdent in den Ordner „Programme“
  </Step>

  <Step title="Starten">
    Öffnen Sie „Programme“ und doppelklicken Sie auf Verdent
  </Step>

  <Step title="Sicherheitsfreigabe">
    Falls Sie dazu aufgefordert werden, öffnen Sie **Systemeinstellungen → Datenschutz & Sicherheit** (macOS 13+) oder **Systemeinstellungen → Sicherheit** (frühere macOS-Versionen) und klicken Sie auf **Trotzdem öffnen**
  </Step>
</Steps>

**Unterstützte macOS-Versionen:**

* macOS 11 (Big Sur) und höher
* Intel und Apple Silicon werden unterstützt

***

## Installation unter Windows [#installation-unter-windows]

<Steps>
  <Step title="Herunterladen">
    Laden Sie das Installationsprogramm `.exe` von [verdent.ai/download](https://verdent.ai/download) herunter
  </Step>

  <Step title="Installationsprogramm ausführen">
    Doppelklicken Sie auf die heruntergeladene Datei `.exe`
  </Step>

  <Step title="UAC-Eingabeaufforderung">
    Klicken Sie auf **Ja**, wenn Sie von der Benutzerkontensteuerung dazu aufgefordert werden
  </Step>

  <Step title="Installationsoptionen">
    Folgen Sie den Anweisungen des Installationsprogramms (bei manchen Builds ist möglicherweise kein benutzerdefiniertes Installationsverzeichnis wählbar)
  </Step>

  <Step title="Abschließen">
    Klicken Sie auf **Installieren** und warten Sie, bis der Vorgang abgeschlossen ist
  </Step>

  <Step title="Starten">
    Klicken Sie auf **Fertigstellen**, um Verdent zu starten, oder suchen Sie es im Startmenü
  </Step>
</Steps>

**Unterstützte Windows-Versionen:**

* Windows 10
* Windows 11
* Nur 64-Bit

***

## Authentifizierung & Einrichtung [#authentifizierung--einrichtung]

Nach der Installation müssen Sie sich mit Ihrem Verdent-Konto authentifizieren, um die Anwendung nutzen zu können.

### Erste Authentifizierung [#erste-authentifizierung]

<Steps>
  <Step title="Verdent starten">
    Öffnen Sie Verdent über „Programme“ (macOS) oder das Startmenü (Windows). Der Willkommensbildschirm wird angezeigt.
  </Step>

  <Step title="Anmelden">
    Klicken Sie auf **Anmelden**. Ihr Browser öffnet die Authentifizierungsseite von Verdent.
  </Step>

  <Step title="Authentifizierung im Browser">
    Melden Sie sich mit den Zugangsdaten Ihres Verdent-Kontos an (E-Mail/Passwort oder OAuth-Anbieter wie Google, GitHub usw.).
  </Step>

  <Step title="Zurück zur App">
    Kehren Sie nach Abschluss der Authentifizierung zu Verdent zurück. Die Hauptoberfläche wird angezeigt.
  </Step>

  <Step title="Projekt öffnen">
    Wählen Sie **Projekt öffnen**, um ein Verzeichnis auszuwählen, oder **Zuletzt verwendete Projekte**, wenn Sie zurückkehren.
  </Step>
</Steps>

***

## Installation überprüfen [#installation-überprüfen]

Bestätigen Sie mit diesen einfachen Prüfungen, dass Ihre Installation korrekt funktioniert:

### Visuelle Überprüfung [#visuelle-überprüfung]

1. **Anwendungssymbol** – Verdent erscheint in „Programme“ (macOS) oder im Startmenü (Windows)
2. **Angemeldet** – Nach der Authentifizierung sehen Sie Ihren Kontostatus in der App (z. B. Avatar/E-Mail)

### Funktionale Überprüfung [#funktionale-überprüfung]

<Steps>
  <Step title="Projekt öffnen">
    Öffnen Sie ein Verzeichnis in Verdent.
  </Step>

  <Step title="Test-Prompt senden">
    Probieren Sie eine einfache Anfrage wie „Erkläre, was dieses Projekt enthält“ im Eingabefeld aus.
  </Step>

  <Step title="Antwort erhalten">
    Verdent sollte Ihr Projekt analysieren und in Kürze eine Antwort liefern.
  </Step>
</Steps>

**Erfolgsindikatoren:**

* Verdent startet ohne Fehler
* Konto wurde erfolgreich authentifiziert
* Prompts können gesendet werden und Antworten werden empfangen

<Warning>
  Verdent benötigt für die KI-Funktionen eine aktive Internetverbindung. Wenn Prompts nicht beantwortet werden, überprüfen Sie Ihre Netzwerkverbindung und stellen Sie sicher, dass Ihre Firewall ausgehendes HTTPS zu den API-Endpunkten von Verdent zulässt.
</Warning>

***

## Fehlerbehebung bei der Installation [#fehlerbehebung-bei-der-installation]

<Tabs>
  <Tab title="macOS-Sicherheit">
    **Problem:** „Verdent kann nicht geöffnet werden, da es von einem nicht verifizierten Entwickler stammt“

    **Lösung:**

    1. Öffnen Sie **Systemeinstellungen → Datenschutz & Sicherheit** (macOS 13+) oder **Systemeinstellungen → Sicherheit** (frühere macOS-Versionen)
    2. Suchen Sie die Warnmeldung zu Verdent
    3. Klicken Sie auf **Trotzdem öffnen**
    4. Bestätigen Sie mit einem Klick auf **Öffnen**
  </Tab>

  <Tab title="Windows Defender">
    **Problem:** Windows Defender blockiert die Installation

    **Lösung:**

    1. Klicken Sie im SmartScreen-Popup auf **Weitere Informationen**
    2. Wenn Sie Verdent von der offiziellen Website heruntergeladen haben und der Quelle vertrauen, klicken Sie auf **Trotzdem ausführen**
    3. Setzen Sie die Installation fort
  </Tab>
</Tabs>

***

## Häufig gestellte Fragen [#häufig-gestellte-fragen]

<AccordionGroup>
  <Accordion title="Kann ich Verdent zusammen mit der Erweiterung VS Code installieren?">
    Ja. Verdent und die Erweiterung VS Code sind unabhängige Anwendungen. Sie können beide nutzen, sie teilen sich denselben Credit-Pool und dasselbe Konto.
  </Accordion>

  <Accordion title="Wie aktualisiere ich Verdent?">
    Verdent prüft beim Start automatisch auf Updates. Wenn ein Update verfügbar ist:

    1. Erscheint eine Benachrichtigung
    2. Klicken Sie auf **Aktualisieren**, um es herunterzuladen und zu installieren
    3. Starten Sie die Anwendung neu

    Sie können auch manuell über das App-Menü prüfen (zum Beispiel: **Hilfe → Nach Updates suchen**).
  </Accordion>

  <Accordion title="Wie deinstalliere ich Verdent?">
    **macOS:** Ziehen Sie Verdent aus „Programme“ in den Papierkorb

    **Windows:** Verwenden Sie **Einstellungen → Apps → Verdent → Deinstallieren** oder **Systemsteuerung → Programme und Funktionen**
  </Accordion>
</AccordionGroup>

***

## Nächste Schritte [#nächste-schritte]

<CardGroup cols="2">
  <Card title="Schnellstart" icon="rocket" href="/docs/verdent-manager/getting-started/quick-start">
    Fügen Sie Ihr erstes Projekt hinzu und weisen Sie eine Aufgabe zu
  </Card>

  <Card title="Manager" icon="user-tie" href="/docs/verdent-manager/core-features/manager">
    Erfahren Sie, wie Manager Arbeit plant, verteilt und nachverfolgt
  </Card>
</CardGroup>