So behalten Sie den Kontext über mehrere KI-Sessions hinweg

Jede Sitzung eines Coding-Agents beginnt leer. Claude Code sagt das in der eigenen Dokumentation: Jede Sitzung startet mit einem frischen Kontextfenster. Das Tool erinnert sich an nichts, was man ihm gestern gesagt hat – es sei denn, etwas außerhalb der Konversation hat es weitergetragen. Zu lernen, wie man Kontext über KI-Sitzungen hinweg erhält, ist deshalb kein einzelner Trick; es geht darum zu wissen, in welche von vier Schichten ein bestimmtes Stück Kontext gehört, und es dort abzulegen, bevor die Sitzung endet.

Dieser Leitfaden geht die vier Schichten der Reihe nach durch: Instruktionsdateien, die das Tool beim Start liest, Notizen, die das Tool für sich selbst schreibt, das Fortsetzen von Sitzungen (Session Resume) und der gemeinsame Arbeitsnachweis, den keine der ersten drei bietet. Die ersten drei sind Funktionen von Claude Code, Codex und Gemini CLI. Die vierte ist der Punkt, an dem Sharkly ins Spiel kommt, denn ein Task, der das Ziel, die Diskussion, die Runs und die Abnahme trägt, ist die einzige Schicht, die eine zweite Person lesen kann. Wenn Sie noch zwischen Chatten und Zuweisen schwanken, ist unser Leitfaden zum Chatten mit einem KI-Agenten oder Zuweisen eines Tasks die passende Ergänzung.

TL;DR

Kontext überlebt eine Sitzung an vier Stellen. Instruktionsdateien (CLAUDE.md, AGENTS.md, GEMINI.md) tragen Regeln, die das Tool jedes Mal einhalten soll. Das automatische Gedächtnis (Auto Memory) trägt Korrekturen und Präferenzen, die das Tool gelernt hat. Session Resume trägt eine Konversation für eine Person auf einem Rechner weiter. Der Arbeitsnachweis – ein Task mit Beschreibung, Kommentaren und Ausführungsprotokoll – trägt, was entschieden wurde, was gelaufen ist und was eine Person abgenommen hat, und er ist die einzige Schicht, die geteilt wird. Ordnen Sie jede Art von Kontext ihrer Schicht zu, und das frische Kontextfenster ist kein Verlust mehr.

Schicht 1: Instruktionsdateien, die das Tool beim Start liest

Instruktionsdateien sind Kontext, den man einmal schreibt und den das Tool in jeder Sitzung lädt. Jede große CLI hat eine, und sie werden auf ähnliche Weise aufgelöst.

Zwei Gewohnheiten halten diese Schicht nützlich. Halten Sie die Dateien kurz: Die Empfehlung von Claude Code liegt bei unter 200 Zeilen pro Datei, denn die Befolgung nimmt ab, je größer die Datei wird. Und schreiben Sie Fakten hinein, die Sie sonst erneut erklären müssten – etwa Build-Befehle, Konventionen und die Regel, die Sie letzte Sitzung in den Chat getippt haben. Wenn ein Repository bereits eine AGENTS.md hat, importiert eine CLAUDE.md, die nur @AGENTS.md enthält, diese, sodass beide Tools eine einzige Quelle lesen. Alles in dieser Schicht ist Kontext und keine Durchsetzung; die Dokumentation zum Gedächtnis von Claude Code stellt ausdrücklich klar, dass ein Hook und nicht eine Instruktion eine Aktion blockiert.

Schicht 2: Notizen, die das Tool für sich selbst schreibt

Das automatische Gedächtnis von Claude Code ist die Schicht, deren Existenz die Leute vergessen. Während der Arbeit speichert Claude Notizen über Ihre Rolle und Präferenzen, Korrekturen, die Sie ihm geben, Projektkontext, den es nicht aus dem Code ableiten kann, und wo Dinge außerhalb des Repositorys zu finden sind. Sie liegen unter ~/.claude/projects/<project>/memory/, indexiert durch eine MEMORY.md, deren erste 200 Zeilen bzw. 25 KB zu Beginn jeder Sitzung geladen werden. Themendateien werden bei Bedarf geladen.

Drei Grenzen sind wichtig. Das automatische Gedächtnis gilt pro Repository und wird über Worktrees hinweg geteilt. Es ist lokal an den Rechner gebunden, daher existieren Notizen auf Ihrem Desktop nicht auf Ihrem Laptop. Und es übersteht /compact, weil die Komprimierung die Konversation neu schreibt, nicht die Dateien auf der Festplatte. Um zu sehen, was gespeichert wurde, führen Sie /memory aus; um es abzuschalten, setzen Sie autoMemoryEnabled auf false oder exportieren Sie CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.

Nutzen Sie diese Schicht für Dinge, die Sie einmal sagen und die hängen bleiben sollen: „immer pnpm verwenden“, „die API-Tests brauchen ein lokales Redis“. Verlassen Sie sich damit nicht auf Entscheidungen, die ein Teammitglied braucht; es gehört nur Ihnen.

Schicht 3: Session Resume

Manchmal ist der Kontext, den Sie brauchen, die Konversation selbst. Claude Code speichert Sitzungen auf der Festplatte: claude --continue öffnet die jüngste Konversation im aktuellen Verzeichnis erneut, claude --resume <id-or-name> öffnet eine bestimmte, und --fork-session erzeugt eine neue Session-ID, sodass Sie von einem Checkpoint abzweigen können, ohne ihn zu überschreiben. Benennen Sie eine Sitzung mit /rename um, bevor Sie /clear ausführen, damit Sie sie wiederfinden. Codex bietet codex resume, um einen kürzlichen Chat aus dem aktuellen Repository erneut zu öffnen.

Resume hat einen Preis. Jede Anfrage trägt die vollständige Konversation mit, daher verbraucht eine langlebige Sitzung für eine einzeilige Frage mehr Nutzung als eine frische. /compact mit einer Fokus-Anweisung wie /compact Focus on the migration plan tauscht Detail gegen Platz. Was die Komprimierung übersteht, ist die Zusammenfassung plus das, was die Instruktionsdateien neu laden; alles, was nur in der Konversation gegeben und nicht zusammengefasst wurde, ist verschwunden. Betrachten Sie Resume als Brücke über eine Mittagspause, nicht als das Gedächtnis des Teams.

Schicht 4: Der Arbeitsnachweis

Keine der ersten drei Schichten beantwortet die Frage, die ein Teammitglied am Donnerstag stellt: Was hat der Agent am Dienstag getan, warum, und wer hat es abgenommen? Instruktionsdateien enthalten Regeln. Das automatische Gedächtnis enthält die Präferenzen einer Person. Eine fortgesetzte Sitzung enthält die Konversation einer Person auf einem Rechner. Die Entscheidung, der Run und die Abnahme brauchen einen gemeinsamen Nachweis, und dieser Nachweis ist ein Task.

In Sharkly umfasst ein Task-gestützter Run den Titel und die Beschreibung des Tasks, die jüngsten Kommentare und den Kommentar, der den Run ausgelöst hat, die Instruktionen und Skills des Agents sowie die für den Task konfigurierten Repositories. Das ist die Kontextübergabe: Der nächste Run startet vom Task aus, nicht aus dem Gedächtnis der vorherigen Sitzung. Fortschritt, Trace-Events und das Ergebnis fließen zurück in den Task, und das Ausführungsprotokoll hält fest, warum ein Run in die Warteschlange gestellt wurde, wann er begonnen und geendet hat, Tool-Aufrufe, die Auslösequelle und Fehlerdetails.

Zwei Regeln aus der Produktdokumentation entscheiden, wohin die Dinge gehören, und beide sind Abgrenzungsregeln statt Funktionen. Eigenständige Agent-Chat-Sitzungen gehören der Person, die sie erstellt hat, und andere Mitglieder erhalten keinen Zugriff; wenn das Team eine Schlussfolgerung braucht, kopieren Sie sie in die Task-Beschreibung oder einen Kommentar. Und der Agent-Chat zu einem Task ist kein Kommentar: Er erscheint nicht in Activity, daher ist eine dort getroffene Entscheidung unsichtbar, sofern sie niemand aufschreibt. Unser Walkthrough zum Projektmanagement mit Claude Code zeigt, wie der Task eine Änderung vom Issue bis zum Review begleitet.

Eine weitere Unterscheidung ist es wert, zitiert zu werden, denn sie ist genau die Falle, um die es in diesem Artikel geht. Eine Crew kann die gemeinsame Wiederverwendung des Task-Verzeichnisses aktivieren, sodass der Run eines späteren Agent-Mitglieds die lokalen Änderungen des früheren Mitglieds auf demselben Computer erbt. Diese Einstellung teilt den Dateisystemzustand, nicht die Provider-Sitzung des vorherigen Agents. Dateien werden weitergetragen; die Konversation des Modells nicht. Wenn der zweite Agent die Überlegungen des ersten Agents braucht, müssen sie im Task stehen.

Jede Art von Kontext in ihre Schicht einordnen

Skills bekommen ihre eigene Zeile. Ein Skill bündelt wiederverwendbare Instruktionen und unterstützende Dateien für eine Anleitung, die wiederholt gelten soll, und ein im lokalen Runtime-Verzeichnis entdeckter Skill kann in die Organisation importiert werden, damit er nicht länger auf einem einzigen Laptop lebt. Unser Leitfaden zu Skills in Sharkly behandelt Geltungsbereich und Bindung, und was ein Coding-Agent-Skill ist behandelt das Dateiformat.

Nutzen Sie Instruktionsdateien und das automatische Gedächtnis, wenn der Kontext betrifft, wie Sie arbeiten. Nutzen Sie einen Task, wenn der Kontext betrifft, was das Team baut und was möglicherweise jemand anderes lesen muss. Sharkly ist kein Ersatz für Claude Code, Codex oder andere Ausführungstools; es ergänzt den gemeinsamen Nachweis, den diese Tools nicht führen.

FAQ

Verliert /compact meine CLAUDE.md? Nein. Die CLAUDE.md im Projektstamm wird nach der Komprimierung erneut von der Festplatte gelesen. Instruktionen, die nur in der Konversation gegeben wurden, können verloren gehen; verschieben Sie diese in die Datei.

Wird das automatische Gedächtnis mit meinem Team geteilt? Nein. Es wird pro Repository unter Ihrem Home-Verzeichnis gespeichert und nie synchronisiert. Für das Team sichtbarer Kontext gehört in eine eingecheckte Instruktionsdatei oder in einen Task.

Kann sich ein Agent in Sharkly an einen vorherigen Run erinnern? Er erhält bei jedem Run den Task, seine jüngsten Kommentare und den auslösenden Kommentar – die dauerhafte Form des Erinnerns. Die private Konversation des vorherigen Runs erhält er nicht. Unter Agents in Sharkly erfahren Sie, was ein Run umfasst.

Was ist mit MCP-Memory-Servern? Sie fügen einen fünften Speicher hinzu, den das Modell abfragen kann – nützlich für die strukturelle Erinnerung an eine Codebasis. Sie halten nach wie vor nicht fest, wer eine Änderung abgenommen hat, also kombinieren Sie sie mit einem Arbeitsnachweis, statt einen zu ersetzen.