# Kontextverwaltung (/de/docs/verdent-for-vscode/best-practices/context)

> Kontext effektiv verwalten für bessere Ergebnisse



***

Effektive Kontextverwaltung stellt sicher, dass Verdent zur richtigen Zeit die richtigen Informationen zur Verfügung hat, während eine Leistungsminderung durch Kontextüberlastung vermieden wird.

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

* Kontextfenster und ihre Grenzen verstehen
* Dateien strategisch für optimalen Kontext auswählen
* Kontextüberlastung erkennen und darauf reagieren
* Wann Sie den Kontext für bessere Leistung zurücksetzen sollten
* Wie sich die Organisation des Arbeitsbereichs auf den Kontext auswirkt

***

## Kontextfenster verstehen [#kontextfenster-verstehen]

Die Größe des Kontextfensters von Verdent for VS Code hängt vom verwendeten Modell ab.

<Tabs>
  <Tab title="Standardmodelle (200K)">
    Die meisten Modelle verwenden Standard-`200K`-Kontextfenster:

    * **Claude 4.5 Sonnet** – Ausgewogen für komplexe Aufgaben
    * **Claude 4.5 Haiku** – Schnell und effizient
    * **GPT-5** – Hervorragend für logisches Denken (Beta)
    * **GPT-5-Codex** – Optimiert für Coding (Beta)

    **Kapazität:**

    * \~`200,000` Tokens Gesamtspeicherkapazität
    * Ausreichend für die meisten Entwicklungsaufgaben und mittelgroße Projekte

    **Was enthalten ist:**

    * Alle Nachrichten im Gespräch
    * In den Kontext geladene Dateiinhalte
    * Werkzeugausgaben und Antworten
    * Systemprompts und Anweisungen
    * MCP-Server-Definitionen

    **Leistung:**

    * Nimmt bei Annäherung an die Grenzen deutlich ab
    * Achten Sie auf Anzeichen von Kontextüberlastung (langsamere Antworten, weniger präzise Ausgaben)
    * Setzen Sie den Kontext häufiger zurück, um optimale Leistung zu erhalten
  </Tab>

  <Tab title="Erweiterter Kontext (1M)">
    Claude Sonnet 4.5 bietet erweiterten Kontext (`1M` Tokens), wenn er explizit ausgewählt wird oder wenn die Eingabe `200K` Tokens überschreitet.

    **Kapazität:**

    * `1,000,000` Tokens Gesamtspeicher
    * 5-mal größer als Standardmodelle

    **Vorteile:**

    * Perfekt, um ganze große Codebasen ohne Aufteilung zu laden
    * Beseitigt die meisten Bedenken zur Kontextverwaltung bei großen Projekten
    * Länger arbeiten, bevor Kontextgrenzen erreicht werden
    * Weniger Sitzungs-Resets erforderlich

    **Wann verwenden:**

    * Große Codebasen mit `1000+` Dateien
    * Komplexes dateiübergreifendes Refactoring über ganze Projekte hinweg
    * Lange Entwicklungssitzungen, die mehrere zusammenhängende Aufgaben umfassen
    * Wenn Sie den Verwaltungsaufwand für den Kontext minimieren möchten
  </Tab>
</Tabs>

***

## Strategische Dateiauswahl [#strategische-dateiauswahl]

Gehen Sie bei der Dateiauswahl strategisch vor, um die Kontextnutzung zu optimieren und Grenzen zu vermeiden.

<Tip>
  Beginnen Sie mit weniger Dateien und fügen Sie nur bei Bedarf weitere hinzu – Verdent kann während des Gesprächs jederzeit zusätzliche Dateien lesen.
</Tip>

### @-Erwähnungen für explizites Einbeziehen verwenden [#-erwähnungen-für-explizites-einbeziehen-verwenden]

```
@filename.js
```

Verdent lädt verwandte Dateien automatisch, aber `@-mentions` stellt einen exakten Kontext sicher. Seien Sie selektiv – beziehen Sie nur Dateien ein, die direkt für die aktuelle Aufgabe relevant sind.

### Kontextnutzung überwachen [#kontextnutzung-überwachen]

* Achten Sie auf Leistungseinbußen, wenn Sitzungen länger werden
* Behalten Sie die Gesprächslänge und Dateianzahl im Blick
* Entfernen Sie unnötige Dateien aus dem Kontext, wenn möglich

### Kontextüberlastung vermeiden [#kontextüberlastung-vermeiden]

* Teilen Sie große Aufgaben in kleinere Teile mit weniger Dateien pro Aufgabe auf
* Konzentrieren Sie sich nur auf zusammenhängende Dateien – laden Sie nicht die gesamte Codebasis auf einmal
* Verwenden Sie die MCP-Serververwaltung, um nicht genutzte Integrationen zu deaktivieren

### Best Practices [#best-practices]

* Beziehen Sie nur Dateien ein, die geändert oder referenziert werden müssen
* Verweisen Sie auf vorhandene Muster, anstatt Beispieldateien zu laden
* Bearbeiten Sie bei großen Codebasen jeweils ein Modul
* Verwenden Sie Projektdokumentation (`AGENTS.md`), anstatt viele Dateien zu laden
* Vermeiden Sie das letzte Fünftel des Kontextfensters für speicherintensive Aufgaben

### Für erweiterten Kontext (1M Tokens) [#für-erweiterten-kontext-1m-tokens]

Die Dateiauswahl wird deutlich unkritischer – Sie können oft ganze Projekt-Repositories laden, ohne an Grenzen zu stoßen.

***

## Kontextüberlastung erkennen [#kontextüberlastung-erkennen]

<Tabs>
  <Tab title="Antwortqualität">
    **Anzeichen:**

    * Weniger präzise oder unvollständige Antworten
    * Fehlende wichtige Details aus früheren Teilen des Gesprächs
    * Schwierigkeiten, die Konsistenz über lange Sitzungen hinweg zu bewahren
    * Verwirrung über aktuelle Änderungen oder Kontext

    **Konkrete Beispiele:**

    * Schlägt Lösungen vor, die Sie bereits früher in der Sitzung abgelehnt haben
    * Ignoriert Coding-Konventionen, die Sie vor `20` Nachrichten festgelegt haben
    * Generiert Code, der mit Änderungen kollidiert, die früher im Gespräch vorgenommen wurden
    * Schlägt Implementierungen vor, die nicht zur zuvor besprochenen Projektarchitektur passen

    **Primäres Signal:** Die Antworten von Verdent werden weniger präzise oder inkonsistent
  </Tab>

  <Tab title="Geschwindigkeitsprobleme">
    **Anzeichen:**

    * Merklich langsamere Antwortzeiten
    * Längere Verarbeitungsverzögerungen vor Beginn der Antworten
    * Erhöhte Latenz zwischen Nachrichten

    **Konkrete Beispiele:**

    * Antworten, die normalerweise `5-10` Sekunden dauern, benötigen jetzt `30+` Sekunden
    * Sichtbare Verzögerung, bevor die Tippanzeige nach dem Senden einer Nachricht erscheint
    * Streaming-Antworten beginnen deutlich langsamer als gewohnt
    * Die Werkzeugausführung (Dateien lesen, Suchen) dauert merklich länger

    **Primäres Signal:** Antworten dauern deutlich länger als gewohnt
  </Tab>

  <Tab title="Verhaltensänderungen">
    **Anzeichen:**

    * Aufforderungen, bereits bereitgestellte Informationen zu klären
    * Vergessen von zuvor festgelegten Mustern oder Konventionen
    * Unfähigkeit, auf zuvor besprochene Dateien oder Code zu verweisen
    * Wiederholte Fragen zur Projektstruktur

    **Konkrete Beispiele:**

    * Fragt „Welches Framework verwenden Sie?“, obwohl Sie React vor `30` Nachrichten angegeben haben
    * Fragt nach Dateipfaden, die Sie bereits `@-mentioned` mehrfach genannt haben
    * Erinnert sich nicht an die Namenskonvention, die Sie zu Beginn der Sitzung festgelegt haben
    * Erklärt erneut Konzepte oder Ansätze, die Sie bereits mit Begründung abgelehnt haben

    **Primäres Signal:** Verdent fragt nach Dingen, die bereits besprochen wurden
  </Tab>

  <Tab title="Technische Indikatoren">
    **Anzeichen:**

    * Annäherung an das letzte Fünftel des `200K`-Token-Limits (\~`160K+` Tokens verwendet)
    * Lange Gespräche mit vielen Dateilesevorgängen und Werkzeugausgaben
    * Mehrere aktivierte MCP-Server mit umfangreichen Werkzeugdefinitionen
    * Große Dateien, die wiederholt in den Kontext geladen werden

    **Konkrete Beispiele:**

    * Die Sitzung läuft seit `2+` Stunden mit `100+` Nachrichten
    * Sie haben `20+` Dateien mit `@-mentions` im gesamten Gespräch geladen
    * Mehrere große Dateien (jeweils `>1000` Zeilen) befinden sich im Kontext
    * Sie haben `5+` MCP-Server mit umfangreichen Werkzeugdefinitionen aktiviert
    * Das Gespräch enthält viele Grep-/Suchergebnisse und Dateilesevorgänge

    **Primäres Signal:** Sehr lange Sitzungen mit umfangreicher Datei-/Werkzeugnutzung
  </Tab>
</Tabs>

**Wann Sie handeln sollten:** Leistungseinbußen sind Ihr primäres Signal. Wenn die Antworten von Verdent weniger präzise, langsamer oder inkonsistent werden – starten Sie eine neue Sitzung oder nutzen Sie Strategien zur Kontextverwaltung.

<Warning>
  Wenn die Antworten von Verdent vage oder repetitiv werden, könnte eine Kontextüberlastung vorliegen. Setzen Sie das Gespräch zurück, um die volle Leistung wiederherzustellen.
</Warning>

**Hinweis:** Bei `1M`-Token-Kontext (Claude Sonnet 4.5) treten diese Probleme deutlich seltener auf.

***

## Wann Sie den Kontext zurücksetzen sollten [#wann-sie-den-kontext-zurücksetzen-sollten]

<Tabs>
  <Tab title="Leistungsindikatoren">
    * Merklich langsamere Antwortzeiten
    * Weniger präzise oder inkonsistente Antworten
    * Verdent vergisst früheren Kontext oder Muster
    * Annäherung an die Grenzen des Kontextfensters (achten Sie auf Anzeichen von Leistungseinbußen)

    **Aktion:** Starten Sie eine neue Sitzung, wenn die Qualität nachlässt
  </Tab>

  <Tab title="Aufgabenübergänge">
    * Wechsel zwischen nicht zusammenhängenden Funktionen oder Modulen
    * Abschluss einer Aufgabe und Übergang zur nächsten
    * Nach speicherintensiven Aufgaben (große Refactorings, Architekturarbeiten)
    * Übergang von der Recherchephase zur Implementierungsphase

    **Aktion:** Neue Sitzung für neue Hauptaufgabe
  </Tab>

  <Tab title="Nach Commits">
    * Nach dem Committen abgeschlossener Funktionen in die Versionskontrolle
    * Zwischen logischen Checkpoints im Entwicklungsworkflow
    * Nach Test-Verify-Commit-Zyklen

    **Aktion:** Commit → Test → neue Sitzung
  </Tab>

  <Tab title="Sitzungsverwaltung">
    * Vor Beginn größerer neuer Funktionen
    * Wenn der Gesprächsverlauf sehr lang wird
    * Nach Abschluss dateiübergreifender Änderungen
    * Zwischen verschiedenen Arten von Arbeit (Debugging → Feature-Entwicklung)

    **Aktion:** Proaktiv eine neue Sitzung starten, bevor der Kontext nachlässt
  </Tab>
</Tabs>

**Empfohlener Workflow:** Atomare Arbeitseinheit abschließen → testen → committen → Kontext löschen → neu starten für die nächste Aufgabe.

**Hinweis:** Starten Sie eine neue Sitzung, um den Kontext zurückzusetzen. Bei `1M`-Token-Kontexten ist ein Löschen deutlich seltener erforderlich.

***

## Auswirkung der Arbeitsbereichsorganisation [#auswirkung-der-arbeitsbereichsorganisation]

Die Organisation des Arbeitsbereichs wirkt sich direkt darauf aus, wie effizient der Kontext genutzt wird und wie leicht sich Verdent in Ihrer Codebasis zurechtfindet.

<Tabs>
  <Tab title="Gut organisiert">
    **Kleinere, fokussierte Dateien:**

    * Viele kleine Dateien nutzen den Kontext effizienter als wenige große Dateien
    * Einfacher, nur relevante Module zu laden
    * Bessere granulare Kontrolle darüber, was im Kontext enthalten ist
    * Reduziert die Notwendigkeit, ganze große Dateien zu laden

    **Klare Verzeichnisstruktur:**

    * Logische Organisation hilft Verdent, zusammenhängende Dateien zu finden
    * Feature- oder modulbasierte Organisation verbessert die Kontextausrichtung
    * Reduziert die Notwendigkeit, nicht zusammenhängenden Code zu laden

    **`Documentation in AGENTS.md:`**

    * Projektdokumentation ersetzt die Notwendigkeit, viele Beispieldateien zu laden
    * Architekturmuster werden einmal beschrieben und wiederholt referenziert
    * Coding-Standards werden zentral dokumentiert
    * Reduziert den Kontextaufwand durch exploratives Dateilesen

    **Vorteile:**

    * Arbeiten an isolierten Modulen, ohne die gesamte Codebasis zu laden
    * Klare Grenzen ermöglichen fokussierte Sitzungen
    * Aufteilung der Arbeit entlang von Modulgrenzen wird natürlich
  </Tab>

  <Tab title="Schlecht organisiert">
    **Probleme:**

    * Monolithische Dateien erzwingen das Laden ganzer großer Kontexte
    * Unklare Struktur erfordert das Laden vieler Dateien, um die Architektur zu verstehen
    * Vermischte Zuständigkeiten in denselben Dateien verschwenden Kontext für irrelevanten Code

    **Auswirkung:**

    * Häufige Probleme mit Kontextgrenzen
    * Verschwendete Tokens für irrelevanten Code
    * Schwierigkeiten, die Arbeit auf bestimmte Module zu beschränken
    * Häufigerer Bedarf an Sitzungs-Resets

    **Häufige Anti-Patterns:**

    * Einzelne Dateien mit `5000+` Zeilen und mehreren Zuständigkeiten
    * Flache Verzeichnisstruktur mit `100+` Dateien im Root
    * Keine klare Trennung zwischen Funktionen/Modulen
    * Fehlende zentrale Dokumentation
  </Tab>

  <Tab title="Verbesserungsstrategien">
    **Refactoring-Ansätze:**

    * Große Dateien in kleinere, fokussierte Module aufteilen
    * Nach Feature oder Domäne organisieren (nicht nach Dateityp)
    * Klare Verzeichnishierarchie erstellen
    * Gemeinsam genutzten Code in separate Module extrahieren

    **Dokumentation:**

    * `AGENTS.md` mit Architekturmustern erstellen
    * Coding-Standards zentral dokumentieren
    * `README`-Dateien pro Modul pflegen
    * Designentscheidungen dokumentiert halten

    **Auswirkung auf den Kontext:** Bei Standard-`200K`-Token-Kontexten machen organisierte Arbeitsbereiche den Unterschied zwischen häufigem und seltenem Erreichen der Grenzen. Bei `1M`-Token-Kontexten ist die Organisation weniger wichtig, verbessert aber weiterhin die Effizienz.
  </Tab>
</Tabs>

***

## Strategien zur Kontextoptimierung [#strategien-zur-kontextoptimierung]

Effektive Kontextoptimierung kombiniert Überwachung, strategische Planung und technische Konfiguration.

<Tabs>
  <Tab title="Überwachung">
    **Auf Leistungsanzeichen achten:**

    * Überwachen Sie die Antwortqualität und -geschwindigkeit während der gesamten Sitzung
    * Achten Sie darauf, wenn Antworten langsamer oder weniger präzise werden
    * Verfolgen Sie die Gesprächslänge und Dateianzahl manuell
    * Seien Sie proaktiv beim Starten neuer Sitzungen

    **Was Sie überwachen sollten:**

    * Genauigkeit und Konsistenz der Antworten
    * Zeit bis zur ersten Antwort (Verzögerung der Tippanzeige)
    * Gesamte Antwortabschlusszeit
    * Erinnerung an frühere Gesprächsdetails

    **Subagent-Verwaltung:**

    * Deaktivieren Sie nicht genutzte benutzerdefinierte Subagenten, wenn sie nicht benötigt werden
    * Jeder aktivierte Subagent fügt Definitionen zum Systemoverhead hinzu
    * Behalten Sie nur aktiv genutzte Subagenten aktiviert
    * Bei Bedarf für bestimmte Aufgaben wieder aktivieren

    **Aktionsschwelle:** Wenn Sie `2-3` Leistungssignale bemerken, ist es Zeit, eine neue Sitzung zu starten.

    <Tip>
      Überwachen Sie die Antwortqualität als Frühindikator für die Kontextgesundheit – verschlechterte Antworten signalisieren, dass ein Reset fällig ist.
    </Tip>
  </Tab>

  <Tab title="Aufgabenplanung">
    **Aufteilungsansatz:**

    * Teilen Sie große Aufgaben in kleinere Teile auf
    * Erledigen Sie zusammenhängende Arbeit in fokussierten Sitzungen
    * Vermeiden Sie das Mischen verschiedener Aufgabentypen in langen Gesprächen
    * Vermeiden Sie das letzte Fünftel des Kontextfensters für speicherintensive Arbeit

    **Sitzungsverwaltung:**

    * Starten Sie neue Sitzungen zwischen Hauptaufgaben
    * Löschen Sie den Kontext nach Commits: testen → verifizieren → committen → neue Sitzung
    * Verwenden Sie To-dos für mehrstufige Planung
    * Arbeiten Sie To-do-Punkte in separaten fokussierten Sitzungen ab

    **Bewährtes Muster:**

    1. Aufgabe im Plan Mode planen
    2. Fokussierte Umsetzung in einer neuen Sitzung durchführen
    3. Änderungen testen und verifizieren
    4. In die Versionskontrolle committen
    5. Neue Sitzung für die nächste Aufgabe starten

    **Aufgabenisolierung:** Halten Sie Debugging getrennt von Feature-Entwicklung, Recherche getrennt von Implementierung.
  </Tab>

  <Tab title="Dateiverwaltung">
    **Strategisches Einbeziehen:**

    * Verwenden Sie `@-mentions` nur bei Bedarf für das explizite Einbeziehen von Dateien
    * Nutzen Sie `AGENTS.md`-Dokumentation, anstatt viele Dateien zu laden
    * Bearbeiten Sie bei großen Projekten jeweils ein Modul
    * Teilen Sie große Dateien in kleinere, fokussierte Komponenten auf

    **Prinzipien der Dateiauswahl:**

    * Beziehen Sie nur Dateien ein, die geändert oder direkt referenziert werden müssen
    * Bevorzugen Sie Dokumentation gegenüber dem Laden von Beispieldateien
    * Entfernen Sie Dateien aus dem Kontext, wenn sie nicht mehr benötigt werden
    * Laden Sie Dateien bedarfsgerecht, nicht vorab

    **Umgang mit großen Dateien:**

    * Erwägen Sie eine Aufteilung von Dateien mit mehr als `500` Zeilen
    * Extrahieren Sie Hilfsprogramme und Helfer in separate Dateien
    * Verwenden Sie klare Modulgrenzen
    * Dokumentieren Sie Dateibeziehungen in `AGENTS.md`
  </Tab>

  <Tab title="Workflow">
    **Optimierungsworkflow:**

    Leistung überwachen → Sitzungsüberlastung erkennen → nicht genutzte Subagenten deaktivieren → proaktiv neue Sitzungen starten → Fokus auf Aufgabenqualität

    **Tägliche Praxis:**

    * Starten Sie jede Hauptfunktion mit einem neuen Kontext
    * Committen Sie häufig und setzen Sie zwischen den Commits zurück
    * Halten Sie Sitzungen auf einzelne Ziele fokussiert
    * Überprüfen Sie die Kontextnutzung an natürlichen Haltepunkten

    **`For Extended Context (1M tokens):`** Mit dem größeren Kontextfenster von Claude Sonnet 4.5 wird die Optimierung weniger kritisch – konzentrieren Sie sich auf die Aufgabenqualität statt auf aggressive Kontextverwaltung. Gute Praktiken verbessern jedoch weiterhin Effizienz und Organisation.
  </Tab>
</Tabs>

***

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

<Accordion title="Was ist der Unterschied zwischen 200K- und 1M-Kontextfenstern?">
  Standardmodelle (Claude 4.5 Sonnet, Haiku, GPT-5, GPT-5-Codex, MiniMax-M2) haben `200K`-Token-Kontextfenster, die für die meisten Aufgaben ausreichen. Claude Sonnet 4.5 bietet erweiterten `1M`-Token-Kontext (5-mal größer) für große Codebasen mit `1000+` Dateien, komplexes dateiübergreifendes Refactoring oder lange Entwicklungssitzungen. Der `1M`-Kontext aktiviert sich automatisch, wenn die Eingabe `200K` Tokens überschreitet, oder kann explizit ausgewählt werden.
</Accordion>

<Accordion title="Sollte ich den Kontext manuell zurücksetzen, oder erledigt Verdent das automatisch?">
  Sie müssen manuell eine neue Sitzung starten, um den Kontext zurückzusetzen – Verdent löscht den Kontext nicht automatisch. Best Practice: Zurücksetzen nach Abschluss einer atomaren Arbeitseinheit, Testen und Committen in die Versionskontrolle. Bei `1M`-Token-Kontexten sind Resets deutlich seltener erforderlich.
</Accordion>

<Accordion title="Wie viele Dateien kann ich sicher in den Kontext laden?">
  Es gibt kein festes Dateilimit – es hängt von den Dateigrößen und der Gesamtzahl der Tokens ab. Vermeiden Sie bei `200K`-Kontexten das Laden von `20+` großen Dateien (jeweils `>1000` Zeilen). Konzentrieren Sie sich auf Dateien, die direkt für Ihre aktuelle Aufgabe relevant sind. Verwenden Sie `@-mentions` selektiv und nutzen Sie `AGENTS.md`-Dokumentation, anstatt viele Beispieldateien zu laden. Mit `1M`-Kontext wird die Dateiauswahl deutlich unkritischer.
</Accordion>

<Accordion title="Was zählt zu meinem Kontextfenster?">
  Alles in Ihrer Sitzung: alle Nachrichten im Gespräch, in den Kontext geladene Dateiinhalte, Werkzeugausgaben (Grep-/Suchergebnisse, Dateilesevorgänge), Systemprompts und Anweisungen sowie MCP-Server-Definitionen. Jedes davon verbraucht Tokens aus Ihrer gesamten Kontextkapazität.
</Accordion>

<Accordion title="Geht meine Arbeit beim Zurücksetzen des Kontexts verloren?">
  Nein – das Zurücksetzen des Kontexts löscht nur den Gesprächsverlauf und die geladenen Dateien aus dem Speicher. Ihre tatsächlichen Codeänderungen, Commits und Dateiänderungen bleiben erhalten. Committen Sie Ihre Arbeit vor dem Zurücksetzen des Kontexts zur Sicherheit immer in die Versionskontrolle. Zurücksetzen → neue Sitzung starten → Arbeit an der nächsten Aufgabe fortsetzen.
</Accordion>

***

## Siehe auch [#siehe-auch]

<CardGroup cols="3">
  <Card title="Prompt-Engineering" icon="message" href="/docs/verdent-for-vscode/best-practices/prompts">
    Best Practices für das Schreiben effektiver Prompts
  </Card>

  <Card title="Ausführungsmodi" icon="toggle-on" href="/docs/verdent-for-vscode/execution-modes/overview">
    Ausführungsmodi und ihre Auswirkungen auf Ressourcen verstehen
  </Card>

  <Card title="Ressourcenverwaltung" icon="chart-line" href="/docs/verdent-for-vscode/resource-management/monitoring">
    Token-Nutzung, Credits und Leistung überwachen
  </Card>
</CardGroup>
