# Schnellstart-Leitfaden (/de/docs/verdent-for-vscode/getting-started/quick-start)

> Machen Sie sich in wenigen Minuten mit Verdent vertraut



Dieser Schnellstart-Leitfaden führt Sie in unter 15 Minuten in den Plan-Verify-Code-Workflow von Verdent ein. Sie installieren die Erweiterung, schließen Ihre erste Aufgabe ab und verstehen den grundlegenden Workflow bei der Arbeit mit Verdent for VS Code.

### Was Sie lernen werden [#was-sie-lernen-werden]

* Verdent for VS Code aus dem Marketplace installieren
* Authentifizieren und Ihre Einrichtung überprüfen
* Ihre erste KI-gestützte Aufgabe abschließen
* Ausführungsmodi verstehen (Manuelle Bestätigung, Auto-Run, Plan Mode)
* Wesentliche Funktionen für den täglichen Code-Alltag nutzen

### Voraussetzungen [#voraussetzungen]

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

* Visual Studio Code auf Ihrem System installiert
* Eine aktive Internetverbindung
* Ein Abonnementkonto für Verdent (oder starten Sie mit der 7-tägigen kostenlosen Testphase)

***

## Schritt 1: Verdent installieren [#schritt-1-verdent-installieren]

<Tabs>
  <Tab title="Visual Studio Code Marketplace">
    Besuchen Sie die [Verdent-Erweiterungsseite](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) und wählen Sie **Installieren**.
  </Tab>

  <Tab title="Erweiterungen-Panel">
    1. Öffnen Sie Visual Studio Code
    2. Drücken Sie `Ctrl+Shift+X` (oder `Cmd+Shift+X` unter macOS)
    3. Suchen Sie nach „Verdent"
    4. Wählen Sie **Installieren**
  </Tab>

  <Tab title="Kommandozeile">
    ```bash
    code --install-extension verdentai.verdent
    ```
  </Tab>
</Tabs>

***

## Schritt 2: Verdent verwenden [#schritt-2-verdent-verwenden]

<Steps>
  <Step title="Visual Studio Code öffnen">
    Öffnen Sie Visual Studio Code in Ihrem Projektordner.
  </Step>

  <Step title="Auf Verdent zugreifen">
    Klicken Sie auf das Verdent-Symbol in der Seitenleiste oder drücken Sie `Ctrl+L` (Windows/Linux) / `Cmd+L` (macOS).
  </Step>

  <Step title="Anmelden">
    Melden Sie sich an, wenn Sie zur Authentifizierung mit Ihrem Verdent-Konto aufgefordert werden.
  </Step>
</Steps>

***

## Schritt 3: Ihre erste Aufgabe [#schritt-3-ihre-erste-aufgabe]

Beginnen wir mit einer einfachen, nicht destruktiven Aufgabe, die zeigt, wie Verdent Ihren Arbeitsbereich versteht.

**Öffnen Sie ein Projekt in VS Code** und probieren Sie dann einen dieser Prompts im Eingabefeld von Verdent aus:

```
What kind of project is this?
```

Verdent analysiert die Struktur Ihres Arbeitsbereichs, liest zentrale Dateien und erklärt, mit welcher Art von Anwendung Sie arbeiten. Dies zeigt Kontextbewusstsein, ohne dass Änderungen vorgenommen werden.

**Sie sollten Folgendes sehen:**

* Verdent analysiert Dateien in Ihrem Arbeitsbereich
* Eine Zusammenfassung Ihres Projekttyps, der Technologien und der Struktur
* Keine Dateiänderungen (rein lesende Analyse)

**Probieren Sie diese Folge-Prompts aus:**

```
Explain what this project does
```

```
What dependencies does this project have?
```

```
Show me the main entry point of this application
```

Jeder Prompt hilft Ihnen zu überprüfen, dass Verdent auf Ihren Arbeitsbereich zugreifen kann und Ihre Codebasis versteht.

<Tip>
  Diese explorativen Prompts sind ideal, um sich in unbekannten Codebasen zurechtzufinden. Verdent liest Dateien nach Bedarf, ohne dass Sie manuell Kontext hinzufügen müssen.
</Tip>

***

## Schritt 4: Ihre erste Codeänderung vornehmen [#schritt-4-ihre-erste-codeänderung-vornehmen]

Lassen Sie uns nun Verdent etwas erstellen. Probieren Sie diese einfache Aufgabe aus:

```
Create a hello_world.txt file with a greeting message
```

**Was passiert:**

1. **Verdent schlägt die Änderung vor** Sie sehen eine Vorschau der zu erstellenden Datei und ihres Inhalts
2. **Berechtigungsanfrage**  Im Auto Run Mode (der Standardeinstellung) genehmigt Verdent das Erstellen der Datei automatisch
3. **Sie bestätigen** Klicken Sie auf „Akzeptieren" oder genehmigen Sie die Änderung
4. **Datei erstellt** Verdent erstellt die Datei und bestätigt den Abschluss

**Berechtigungen verstehen:**

Manual Accept Mode stellt sicher, dass ohne Ihre Zustimmung keine unerwünschten Änderungen erfolgen. Sie sehen Berechtigungsabfragen für:

* Dateibearbeitungen und -erstellungen
* Befehlsausführungen
* Werkzeugnutzung (bei erster Verwendung jedes Werkzeugtyps)

Dies gibt Ihnen volle Kontrolle und hilft Ihnen zu verstehen, welche Vorgänge Verdent für unterschiedliche Aufgaben durchführt.

<Note>
  Manual Accept Mode ist der empfohlene Einstiegspunkt für neue Nutzer. Sobald Sie sich vertraut gemacht haben, können Sie für andere Workflows zu Auto-Run Mode oder Plan Mode wechseln.
</Note>

***

## Schritt 5: Plan Mode für komplexe Aufgaben verwenden [#schritt-5-plan-mode-für-komplexe-aufgaben-verwenden]

Plan Mode ist der rein lesende Planungsmodus von Verdent, in dem Sie Vorgehensweisen vor der Ausführung überprüfen können. Probieren wir es aus:

**Zu Plan Mode wechseln:**

Klicken Sie auf die Schaltfläche **Modus wechseln** im Eingabefeld und wählen Sie **Plan Mode**

**Probieren Sie eine Planungsaufgabe aus:**

```
Suggest ways to build a website for my project
```

**Was passiert:**

1. **Verdent analysiert Ihr Projekt** Es liest Dateien und versteht die Struktur und Anforderungen Ihres Projekts
2. **Erstellt einen detaillierten Plan** Zeigt, welche Technologien verwendet werden, welche Seiten erstellt werden und wie die Website strukturiert werden soll
3. **Keine Änderungen** Plan Mode ist rein lesend. Verdent kann keine Dateien ändern, bis Sie dies ausdrücklich genehmigen
4. **Interaktive Klärung** Verdent stellt möglicherweise Fragen zu Designpräferenzen, Zielgruppe oder Funktionen, bevor der Plan finalisiert wird

**Warum Plan Mode verwenden:**

* **Sichere Erkundung** – Unbekannte Codebasen verstehen, ohne versehentliche Änderungen
* **Code-Review** – Qualität und Architektur analysieren, bevor Änderungen vorgenommen werden
* **Strategische Planung** – Komplexe Aufgaben in überprüfbare Schritte aufteilen
* **Reduzierung von Unsicherheit** – Verdent stellt klärende Fragen, um Ambiguität zu beseitigen

<Tip>
  Verwenden Sie Plan Mode für jede Aufgabe, bei der Sie die Vorgehensweise vor der Ausführung überprüfen möchten. Es ist besonders wertvoll, wenn Sie lernen möchten, wie Verdent über Ihre Codebasis denkt.
</Tip>

**So führen Sie den Plan aus:**

Nach der Überprüfung des Plans bietet Verdent zwei Optionen:

* Wählen Sie **Bearbeiten**, um Änderungen anzufordern oder klärende Fragen zu stellen
* Wählen Sie **Erstellung starten**, um zu Agent Mode zu wechseln und die Ausführung zu beginnen

***

## Schritt 6: Ausführungsmodi verstehen [#schritt-6-ausführungsmodi-verstehen]

Verdent bietet mehrere Ausführungsmodi für unterschiedliche Workflows:

**Berechtigungsmodi:**

| Modus                           | Beschreibung                                                                                                                                | Wann verwenden                                                        |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| **Manuelle Bestätigung**        | Fordert bei jeder ersten Verwendung eines Werkzeugs eine Berechtigung an                                                                    | Lernen und allgemeine Entwicklung mit maximaler Kontrolle             |
| **Auto-Run** (Standard)         | Akzeptiert sichere Vorgänge automatisch (Dateilesevorgänge, Websuchen); Dateibearbeitungen und Befehle erfordern weiterhin eine Genehmigung | Vertrauenswürdige Projekte und schnelles Prototyping                  |
| **Plan Mode**                   | Rein lesender Modus für Analyse und Planung ohne Dateiänderungen                                                                            | Komplexe Aufgaben und Code-Review                                     |
| **Berechtigungen überspringen** | Vollständig autonomer Betrieb ohne jegliche Abfragen                                                                                        | Isolierte, sichere Umgebungen wie automatisierte Tests oder Sandboxes |

**Zusätzlicher Modus:**

* **Think Hard Mode** – Maximales Denkbudget für komplexe Überlegungen und architektonische Entscheidungen

<Warning>
  Skip Permissions Mode entfernt alle Sicherheitsprüfungen. Verwenden Sie diesen Modus nur in isolierten, entbehrlichen Umgebungen, in denen Fehler keine Konsequenzen haben.
</Warning>

***

## Wesentliche Aktionen [#wesentliche-aktionen]

Hier sind die wichtigsten Aktionen, die Sie täglich in Verdent for VS Code verwenden:

| Aktion                  | Zugriff                                                          | Beschreibung                                          |
| ----------------------- | ---------------------------------------------------------------- | ----------------------------------------------------- |
| Verdent öffnen          | `Cmd+L` / `Ctrl+L` oder Klick auf das Symbol in der Seitenleiste | Öffnet das Verdent-Panel                              |
| Neue Sitzung            | Klick auf „Neue Sitzung" in der oberen Leiste                    | Startet eine neue Konversation mit leerem Kontext     |
| Kontext hinzufügen      | Klick auf die Schaltfläche „Kontext hinzufügen"                  | Dateien mit @-Erwähnungen referenzieren               |
| Bilder hinzufügen       | Klick auf die Schaltfläche „Bilder oder Dateien hinzufügen"      | Screenshots, Mockups oder Diagramme hochladen         |
| Modus wechseln          | Klick auf die Schaltfläche „Modus wechseln"                      | Zwischen Agent-/Plan-/Chat-Modus wechseln             |
| Modell ändern           | Klick auf die Modellauswahl                                      | Voreinstellungen Performance/Balance/Effizienz wählen |
| Think Hard              | Klick auf die Schaltfläche „Think Hard Mode"                     | Erweitertes Denken für komplexe Aufgaben aktivieren   |
| Berechtigungen wechseln | Klick auf die Schaltfläche „Berechtigung wechseln"               | Berechtigungsmodus ändern                             |
| Verlauf anzeigen        | Klick auf „Projektverlauf" in der oberen Leiste                  | Frühere Sitzungen durchsuchen                         |
| Benutzerzentrum         | Klick auf „Benutzerzentrum" in der oberen Leiste                 | Credit-Guthaben und Kontoinformationen prüfen         |
| Einstellungen           | Klick auf „Einstellungen" in der oberen Leiste                   | MCP-Server, Subagenten, Regeln konfigurieren          |

***

## Profi-Tipps für Einsteiger [#profi-tipps-für-einsteiger]

<Accordion title="Mit explorativen Prompts beginnen">
  Lassen Sie Verdent Ihre Codebasis verstehen, bevor Sie Änderungen vornehmen:

  ```
  Analyze the database schema
  ```

  ```
  Explain the authentication flow
  ```

  Dies baut den Kontext von Verdent zu Ihrem Projekt auf und hilft ihm, bessere Vorschläge zu machen.
</Accordion>

<Accordion title="Seien Sie bei Ihren Anfragen konkret">
  Anstatt: „Behebe den Fehler"

  Versuchen Sie: „Behebe den Login-Fehler in `LoginForm.tsx`, bei dem Nutzer nach Eingabe falscher Zugangsdaten einen leeren Bildschirm sehen"

  Konkrete Prompts führen zu präziseren Lösungen und weniger Wiederholungen.
</Accordion>

<Accordion title="Plan Mode für unbekannten Code verwenden">
  Wenn Sie mit Code arbeiten, den Sie nicht vollständig verstehen, verwenden Sie zunächst Plan Mode:

  ```
  Refactor the authentication module to use async/await instead of callbacks
  ```

  Überprüfen Sie den Plan, wählen Sie **Bearbeiten**, um klärende Fragen zu stellen und ihn zu verfeinern, und wählen Sie dann **Erstellung starten**, sobald Sie sicher sind.
</Accordion>

<Accordion title="Komplexe Aufgaben in Schritte unterteilen">
  Arbeiten Sie bei mehrstufigen Funktionen schrittweise vor:

  ```
  1. Create a new database table for user profiles
  ```

  Danach, nach Abschluss:

  ```
  2. Create an API endpoint to get and update profiles
  ```

  Dies erhält die Übersichtlichkeit und ermöglicht es Ihnen, jeden Schritt zu überprüfen.
</Accordion>

<Accordion title="@-Erwähnungen für Kontext nutzen">
  Referenzieren Sie Dateien bei Bedarf ausdrücklich:

  ```
  @components/UserProfile.tsx refactor this component to use hooks
  ```

  Dies stellt sicher, dass sich Verdent auf den richtigen Kontext für Ihre Aufgabe konzentriert.
</Accordion>

<Accordion title="Subagenten für spezialisierte Aufgaben nutzen">
  Verdent enthält drei integrierte Subagenten:

  * `@Explorer` – Schnelle Erkundung der Codebasis und Dateisuche
  * `@Verifier` – Schnelle Codevalidierung und Prüfungen
  * `@Code-reviewer` – Umfassende Sicherheits- und Qualitätsprüfung

  Beispiel:

  ```
  @Explorer find all API endpoints in this project
  ```
</Accordion>

***

## Häufige Probleme [#häufige-probleme]

<Tabs>
  <Tab title="Erweiterung in der Seitenleiste nicht sichtbar">
    **Lösung:** Starten Sie VS Code neu. Falls sie weiterhin fehlt, überprüfen Sie die Installation im Erweiterungen-Panel (`Cmd+Shift+X` / `Ctrl+Shift+X`) und stellen Sie sicher, dass „Verdent" in der Liste erscheint.
  </Tab>

  <Tab title="Prompts erhalten keine Antworten">
    **Lösung:**

    1. Überprüfen Sie, ob die Internetverbindung aktiv ist
    2. Prüfen Sie, ob Firewall-/Proxy-Einstellungen HTTPS-Verbindungen zu Verdent-Diensten zulassen
    3. Bestätigen Sie, dass Sie noch Credits im Benutzerzentrum haben
    4. Probieren Sie einen einfacheren Prompt aus, um die Verbindung zu testen
  </Tab>

  <Tab title="Berechtigungsabfragen erscheinen zu häufig">
    **Lösung:** Wechseln Sie über die Schaltfläche „Berechtigung wechseln" zu Auto-Run Mode. Dies genehmigt sichere Lesevorgänge automatisch, während bei Dateibearbeitungen und Befehlen weiterhin eine Genehmigung angefordert wird.
  </Tab>
</Tabs>

***

## Hilfe erhalten [#hilfe-erhalten]

* **Discord-Community**: [https://discord.com/invite/NGjXEZcbJq](https://discord.com/invite/NGjXEZcbJq) – Aktive Community mit Echtzeit-Support
* **Dokumentation**: Durchsuchen Sie weitere Leitfäden in dieser Dokumentation
* **Feedback**: Verwenden Sie die Feedback-Schaltfläche in der oberen Leiste von Verdent, um Probleme zu melden oder Verbesserungen vorzuschlagen

***

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

<Accordion title="Wie erkenne ich, in welchem Ausführungsmodus ich mich aktuell befinde?">
  Schauen Sie auf das Eingabefeld am unteren Rand des Verdent-Panels. Die Schaltfläche „Berechtigung wechseln" zeigt Ihren aktuellen Modus an (z. B. „Manuell", „Auto", „Plan"). Sie können darauf klicken, um den Modus zu wechseln.
</Accordion>

<Accordion title="Was passiert, wenn mir die Credits ausgehen?">
  Standard-credit-basierte Anfragen werden gestoppt, wenn Ihr Guthaben null erreicht. Warten Sie auf die Aktualisierung im nächsten Abrechnungszeitraum oder erwerben Sie eine einmalige Credit-Aufladung, um fortzufahren.
</Accordion>

<Accordion title="Kann ich Verdent in mehreren Projekten gleichzeitig verwenden?">
  Ja, jedes VS Code-Fenster arbeitet unabhängig. Sie können Verdent in mehreren Projekten gleichzeitig geöffnet haben, und jedes behält seinen eigenen, separaten Konversationskontext.
</Accordion>

<Accordion title="Wie starte ich eine neue Konversation mit leerem Kontext?">
  Klicken Sie auf die Schaltfläche „Neue Sitzung" in der oberen Leiste. Dies löscht den aktuellen Konversationsverlauf und gibt Verdent ein frisches Kontextfenster für Ihre nächste Aufgabe.
</Accordion>

***

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

Sie haben Verdent installiert, Ihre erste Aufgabe abgeschlossen und den grundlegenden Workflow kennengelernt. So geht es weiter:

<CardGroup cols="2">
  <Card title="Grundkonzepte" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    Verstehen Sie Subagenten, Multi-Agenten-Architektur und Kontextverwaltung
  </Card>

  <Card title="Gängige Workflows" icon="code" href="/docs/verdent-for-vscode/common-workflows/multi-step-tasks">
    Schritt-für-Schritt-Anleitungen für mehrstufige Aufgaben, große Codebasen und Versionskontrolle
  </Card>
</CardGroup>
