Verdent Docs
Best Practices

Kontextverwaltung

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

  • 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

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

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

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

Strategische Dateiauswahl

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

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.

@-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

  • 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

  • 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

  • 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)

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


Kontextüberlastung erkennen

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

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

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

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

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.

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.

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


Wann Sie den Kontext zurücksetzen sollten

  • 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

  • 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

  • Nach dem Committen abgeschlossener Funktionen in die Versionskontrolle
  • Zwischen logischen Checkpoints im Entwicklungsworkflow
  • Nach Test-Verify-Commit-Zyklen

Aktion: Commit → Test → neue Sitzung

  • 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

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

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

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

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

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.


Strategien zur Kontextoptimierung

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

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.

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

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.

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

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.


Häufig gestellte Fragen

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.

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.

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.

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.

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.


Siehe auch