Wo Claude Code sein Scratchpad ablegt, und warum es verschwindet

Jede Claude Code Sitzung beginnt mit einer Zeile, die du vermutlich überfliegst. Unsere, heute Abend, lautet so:

Scratchpad directory: /private/tmp/claude-501/-Users-jbchauvin-Projets-AgentsRoom/5a506305-…/scratchpad

Danach erwähnt das CLI sie nie wieder. Kein Befehl listet den Ordner auf, kein Panel öffnet ihn, und an dem Tag, an dem du die CSV suchst, die der Agent angeblich dort geschrieben hat, ist der Ordner vielleicht schon weg.

Wir lassen jede Nacht sieben geplante Agenten auf einem Mac mini laufen, und jeder von ihnen schreibt in diesen Ordner. Also haben wir nachgesehen, was er ist, wo er auf jedem System liegt, was ihn löscht, und was wir den Agenten dazu sagen. Alles Folgende wurde am 19. September 2026 mit Claude Code 2.1.278 geprüft, und anhand der GitHub-Issues, die Leute eröffnet haben, als sie darin Arbeit verloren hatten.

Was Claude Code dem Agenten sagt

Die Zeile ist Teil des System-Prompts. Die Anweisung dahinter sagt in der aktuellen Version, dass der Agent dieses Verzeichnis immer für temporäre Dateien nutzen soll, also für Zwischenergebnisse, Skripte und Ausgaben, die nicht ins Projekt gehören, statt /tmp oder eines anderen temporären Systemverzeichnisses; dass es sitzungsspezifisch und vom Projekt isoliert ist; dass es in der Regel ohne Berechtigungsabfragen genutzt werden kann; und dass /tmp nur dann verwendet werden soll, wenn du es ausdrücklich verlangst.

Der letzte Teil ist der, der für dich zählt. Dateien, die ins Scratchpad geschrieben werden, lösen den Schreibberechtigungsdialog nicht aus, und genau deshalb legt der Agent seine Hilfsskripte und seine Exporte dort ab, statt dich jedes Mal zu fragen. Und genau deshalb wirst du auch nie gefragt, und nie informiert, wohin sie gegangen sind.

Wenn du den Pfad in einer laufenden Sitzung willst, frag den Agenten. „Gib dein Scratchpad-Verzeichnis aus“ wird aus dem System-Prompt beantwortet, ohne dass etwas ausgeführt wird.

Der Pfad, System für System

Der Ordner liegt unter dem temporären Verzeichnis des Betriebssystems, und sein Name kodiert, wer du bist, in welchem Projekt du warst und welche Sitzung es war.

Unter macOS und Linux:

/tmp/claude-<uid>/<Projektpfad, Schrägstriche durch Bindestriche ersetzt>/<Sitzungs-ID>/scratchpad

Auf einem Mac ist /tmp ein Link auf /private/tmp, derselbe Ordner wird also als /private/tmp/claude-501/… angezeigt. Die Zahl ist deine Benutzer-ID, das, was id -u ausgibt: 501 für das erste Konto auf einem Mac, 1000 auf den meisten Linux-Distributionen, 0 für root. Der unten zitierte Linux-Bericht zeigt /tmp/claude-0/, weil die Pipeline in einem Container als root lief. Issues von Anfang 2026 zeigen /tmp/claude/<Projekt-Slug>/… ganz ohne uid, das Suffix kam also unterwegs dazu. Wenn du einen älteren Build hast, lass es weg.

Unter Windows, wie im Juli 2026 für Windows 11 gemeldet:

%TEMP%\claude\<Projekt-Slug>\<Sitzungs-ID>\scratchpad

was in der Regel zu C:\Users\<du>\AppData\Local\Temp\claude\… wird. Der Pfad wird aus der Variablen TEMP abgeleitet: Zeigt TEMP woandershin, folgt das Scratchpad.

Der Projekt-Slug ist dein Arbeitsverzeichnis, in dem jeder Schrägstrich durch einen Bindestrich ersetzt wurde. Unser Repository liegt unter /Users/jbchauvin/Projets/AgentsRoom, der Slug ist also -Users-jbchauvin-Projets-AgentsRoom. Ein Ordner pro Projekt, darin ein Ordner pro Sitzung.

Um alle Sitzungsordner aufzulisten, die du für den aktuellen Benutzer auf einem Mac oder einer Linux-Maschine noch hast:

ls /tmp/claude-$(id -u)/

Was daneben liegt

Der Sitzungsordner besteht nicht nur aus dem Scratchpad. Auf der Maschine, die unsere nächtlichen Agenten ausführt, enthalten sieben der neun Sitzungsordner des Tages zwei Einträge: scratchpad und tasks. Im Ordner tasks landet die Ausgabe von Hintergrundaufgaben, also der Befehle, die der Agent abgekoppelt startet und später liest.

Es gibt einen dritten Ort, den du kennen solltest, und der liegt gar nicht unter dem temporären Verzeichnis: ~/.claude/projects/<Projekt-Slug>/<Sitzungs-ID>/tool-results/. Wenn ein Tool mehr zurückgibt, als der Kontext aufnehmen kann, speichert Claude Code die vollständige Ausgabe dort und gibt dem Agenten den Pfad. Heute Abend ist ein 68 KB großer Search Console Export dorthin gewandert statt ins Scratchpad. Dieser Ort ist dauerhaft, direkt neben dem Sitzungstranskript. Die Aufteilung ist also: Transkripte und zu große Tool-Ausgaben unter ~/.claude, das bleibt; Skripte, Zwischendateien und Ausgaben von Hintergrundaufgaben unter dem temporären Verzeichnis, das bleibt nicht.

Warum es verschwindet

Weil das temporäre Verzeichnis für jedes Betriebssystem „darf gelöscht werden“ bedeutet, und nichts in Claude Code dem widerspricht.

Unter Linux wendet systemd-tmpfiles an, was /usr/lib/tmpfiles.d/tmp.conf vorgibt. Ein Nutzer hat die gesamte Ausgabe einer 24-Stunden-Pipeline zur Datengenerierung verloren, Review-Urteile, Skripte und ein Python-Virtualenv inklusive, als der Host neu gestartet wurde: Die Regel auf diesem Debian-Container lautete D /tmp 1777 root root 30d, was /tmp bei jedem Start leer neu anlegt. Das war Claude Code 2.1.260, und der System-Prompt hatte nichts zur Flüchtigkeit gesagt. Prüfe deine eigene Regel mit cat /usr/lib/tmpfiles.d/tmp.conf: Eine D-Zeile leert beim Start, ein Alter wie 10d räumt nach Zeit auf.

Unter Windows liegt der Ordner unter %TEMP%, das die Speicheroptimierung und die Datenträgerbereinigung aufräumen. Im Juli 2026 hat jemand eine Datenträgerbereinigung laufen lassen, während zwei Sitzungen aktiv waren, und die git worktrees verloren, in denen beide Agenten arbeiteten, nicht committete Änderungen inklusive. Die Änderungen konnten nur wiederhergestellt werden, weil sie noch im Kontext der Unterhaltung existierten.

Unter macOS wird /private/tmp beim Neustart geleert und alte Dateien werden vom System entfernt. Auf unserem Mac mini enthält /private/tmp/claude-501 heute Abend neun Sitzungsordner für dieses Projekt, 452 Dateien und 25 MB, und nichts, was älter als der Tag ist. Was die Agenten der vorherigen Nächte dort hinterlassen haben, ist weg.

Nichts davon ist ein Bug in dem Sinne, dass sich etwas falsch verhalten hätte. Der Ordner ist genau dort, wo das CLI es sagt, und das Betriebssystem hat genau das getan, was es mit temporären Ordnern tut. Die Lücke ist, dass der Prompt ihn Scratchpad nennt, und ein Scratchpad klingt nach etwas, das man behält.

Was du konfigurieren kannst, und was nicht

Stand 2.1.278 gibt es keine Einstellung für den Ort des Scratchpads. Der Ordner folgt dem temporären Verzeichnis, TEMP unter Windows und TMPDIR unter Unix verschieben ihn also. CLAUDE_CODE_TMPDIR, das für andere temporäre Dateien existiert, verschiebt das Scratchpad laut Berichten nicht, und diese Anfrage wurde als nicht geplant geschlossen. Genauso die Anfragen nach einer Variablen CLAUDE_CODE_SCRATCHPAD_DIR und nach einem Standardort unter ~/.claude/scratchpad/. Ein sichtbarer Scratchpad-Ordner in der Desktop-App ist ein offener Feature-Wunsch.

Zwei Dinge funktionieren heute. Eine fortgesetzte Sitzung (claude --resume) behält ihre Sitzungs-ID, sucht also denselben Ordner, und findet ihn, wenn ihn in der Zwischenzeit nichts gelöscht hat. Und du kannst den Agenten in klaren Worten bitten, eine bestimmte Datei an einen dauerhaften Ort zu schreiben. Das ist unsere ganze Lösung.

Die Regel, die wir unseren nächtlichen Agenten gegeben haben

Sieben Agenten starten um 20:00 Uhr auf derselben Maschine: SEO, Produkt, Social, ein Fixer, ein Dokumentar, ein CEO-Bericht und ein Rapporteur, der um 22:00 Uhr die Zusammenfassung der Nacht per E-Mail verschickt. Jeder produziert viel Zwischenmaterial: Search Console Exporte, gefiltertes JSON, Skripte, die Strings über zwanzig Locales zählen. All das geht ins Scratchpad, mit Absicht, denn nichts davon gehört ins Repository, und nichts davon soll um zwei Uhr nachts eine Berechtigungsabfrage auslösen.

Die Regel in jedem Prompt ist ein Satz: Das Scratchpad enthält, was der nächste Befehl braucht, das Repository enthält, was die nächste Nacht braucht. Alles, was ein Agent morgen lesen will, sein Bericht, seine Run-Markierung, die Datei, die er gerade bearbeitet hat, wird unter reports/nuit/<Datum>/ geschrieben und committet, sobald es fertig ist, nicht am Ende des Runs. Ein Agent, der mitten in der Aufgabe abgebrochen wird, hinterlässt einen Teilbericht in git und 25 MB Scratch-Dateien, die niemand vermissen wird.

Das Spiegelbild dieser Regel ist die, die der Linux-Nutzer auf die harte Tour gelernt hat: Lass einen langen Job nie seine einzige Kopie im Scratchpad ansammeln. Wenn eine Pipeline einen Tag lang läuft, gehen ihre Ausgaben an einen Pfad, den du gewählt hast, und das Scratchpad behält die Hilfsdateien.

Den Ordner öffnen, ohne die App zu verlassen

Wenn du Claude Code in AgentsRoom laufen lässt, öffnet File > Open File (Cmd/Ctrl+O) jede Datei dieses Ordners in der Vorschau, markiert als „Außerhalb des Projekts“, damit du sie nicht für etwas Versioniertes hältst. Es ist der schnellste Weg, den wir gefunden haben, um einen Export zu lesen, den der Agent gerade erzeugt hat, ohne einen /private/tmp-Pfad in ein Terminal zu kopieren.

Und um den Kreis beim Namen zu schließen: Das AgentsRoom Scratchpad ist etwas anderes. Es ist der Prompt-Editor im Agenten-Composer, in dem ein langer Prompt geschrieben und zwischen Sitzungen als Entwurf pro Agent behalten wird. Gleiches Wort, gewählt, bevor Claude Code es für einen Ordner benutzt hat. Das eine ist der Ort, an dem du an den Agenten schreibst; das andere der Ort, an dem der Agent für sich selbst schreibt.

Häufig gestellte Fragen

Wo ist das Scratchpad von Claude Code unter macOS und Linux?

Unter dem temporären Verzeichnis des Systems: /tmp/claude-<deine uid>/<Projektpfad, Schrägstriche durch Bindestriche ersetzt>/<Sitzungs-ID>/scratchpad. Unter macOS erscheint derselbe Ordner als /private/tmp/claude-501/…, weil /tmp ein Link auf /private/tmp ist. Deine uid ist das, was id -u ausgibt: 501 für den ersten Benutzer auf einem Mac, 1000 auf den meisten Linux-Distributionen, 0 für root. Ältere Versionen nutzten /tmp/claude/ ohne das uid-Suffix.

Wo ist das Scratchpad von Claude Code unter Windows?

Unter dem TEMP-Ordner: %TEMP%\claude\<Projekt-Slug>\<Sitzungs-ID>\scratchpad, was in der Regel zu C:\Users\<du>\AppData\Local\Temp\claude\… wird. Wer die Umgebungsvariable TEMP ändert, verschiebt ihn mit, weil der Pfad aus TEMP abgeleitet wird und nicht aus einer Einstellung von Claude Code.

Warum ist mein Claude Code Scratchpad verschwunden?

Weil es unter dem temporären Verzeichnis liegt, und jedes Betriebssystem das temporäre Verzeichnis als löschbar betrachtet. Unter Linux wendet systemd-tmpfiles die Regel aus /usr/lib/tmpfiles.d/tmp.conf an, oft ein Leeren beim Start oder nach einer Anzahl von Tagen. macOS leert /private/tmp beim Neustart und löscht alte Dateien. Unter Windows räumen die Speicheroptimierung und die Datenträgerbereinigung %TEMP% auf. Nichts in Claude Code schützt den Ordner vor alledem.

Kann ich ändern, wo Claude Code sein Scratchpad ablegt?

Nicht über eine eigene Einstellung, Stand Claude Code 2.1.278. Der Ordner folgt dem temporären Verzeichnis des Betriebssystems: TEMP unter Windows oder TMPDIR unter Unix zu verschieben verschiebt ihn mit. Anfragen nach einer separaten Variablen oder einem dauerhaften Ort unter ~/.claude wurden als nicht geplant geschlossen. Die verlässliche Option ist, dem Agenten zu sagen, dass er alles Wichtige stattdessen ins Projekt schreibt.

Ist das Scratchpad dasselbe wie ~/.claude/projects?

Nein. ~/.claude/projects/<Projekt-Slug>/ enthält die Sitzungstranskripte und, pro Sitzung, einen Ordner tool-results, in dem zu große Tool-Ausgaben gespeichert werden. Dieser Ort ist dauerhaft. Das Scratchpad unter dem temporären Verzeichnis ist der Arbeitsbereich, den der Agent für Skripte und Zwischendateien nutzt, und der ist flüchtig.

Ist das das AgentsRoom Scratchpad?

Gleiches Wort, andere Sache. Das AgentsRoom Scratchpad ist der Prompt-Editor im Agenten-Composer, in dem du pro Agent einen Entwurf schreibst und behältst. Das Scratchpad von Claude Code ist ein Ordner, den das CLI für jede Sitzung anlegt. AgentsRoom kann jede Datei dieses Ordners mit File > Open File öffnen, markiert als „Außerhalb des Projekts“.