Claude Code über Nacht laufen lassen: ohne Überraschungen

Um Claude Code über Nacht laufen zu lassen, gib ihm kleine Aufgaben mit klaren Abnahmekriterien, ein Berechtigungs-Setup, das dich nicht braucht, Tests zur Kontrolle seiner eigenen Arbeit und einen eigenen Branch. Halte dann den Rechner wach und prüfe das Ergebnis am Morgen. Das Schwierige ist nicht, den Lauf zu starten. Es ist sicherzustellen, dass der Agent nicht sieben Stunden auf ein Ja wartet, um 2 Uhr nachts das Kontingent aufbraucht oder dir einen Branch hinterlässt, dem du nicht trauen kannst.

Diese Anleitung behandelt der Reihe nach jedes dieser Probleme: Planung, Berechtigungen, Limits, Leitplanken, Zeitplanung und das Morgen-Review. Der letzte Teil zeigt, wie die Nachtschicht von AgentVera dieselben Schritte erledigt.

Plane die Nacht, bevor du sie startest

Ein Agent kann nachts nichts bei dir nachfragen. Alles, was er braucht, muss in der Aufgabe stehen.

Schreibe Aufgaben, die der Agent allein beenden kann

Gute Nachtaufgaben sind klein, klar und überprüfbar:

• „Füge den drei Formularen in src/settings/ eine Eingabevalidierung hinzu. Fertig, wenn pnpm test besteht und jedes Formular eine leere E-Mail ablehnt.“
• „Migriere utils/date.ts von moment auf date-fns. Keine Verhaltensänderung. Alle bestehenden Tests müssen bestehen.“
• „Schreibe Tests für billing/invoice.ts, bis die Abdeckung dieser Datei über dem aktuellen Wert liegt. Ändere den Quellcode nicht.“

Schlechte Nachtaufgaben sind vage oder brauchen eine Entscheidung: „räum die API auf“, „verbessere die Performance“, „such eine State-Bibliothek aus“. Der Agent trifft eine Wahl, mit der du nicht einverstanden bist, oder bleibt stehen und wartet.

Schreibe die Abnahmekriterien

Halte für jede Aufgabe fest, wann sie als erledigt gilt:

1. Welche Tests oder Checks bestehen müssen.
2. Welche Dateien er anfassen darf und welche nicht.
3. Was er tun soll, wenn er nicht weiterkommt. Zum Beispiel: „Wenn du es nicht zum Bestehen bringst, committe, was du hast, und schreibe in NOTES.md, warum.“

Lege die Projektregeln dorthin, wo der Agent sie liest

Konventionen, Testbefehle und verbotene Bereiche gehören in CLAUDE.md, damit jede Sitzung sie sieht. Halte die Datei kurz. Über Nacht ist sie deine einzige Stimme im Raum.

Lieber mehrere kleine Aufgaben als eine große

Fünf unabhängige Aufgaben von je einer Stunde liefern dir fünf prüfbare Branches. Eine Aufgabe von fünf Stunden liefert einen großen Diff und eine Chance, dass etwas schiefgeht.

Entscheide, wie Berechtigungen funktionieren, während du schläfst

In einer interaktiven Sitzung wartet eine Berechtigungsabfrage einfach. Über Nacht heißt das: eine ganze Nacht verloren wegen einer einzigen Frage. Kläre das, bevor du ins Bett gehst.

Für nicht-interaktive Läufe (claude -p) bietet dir die CLI-Referenz diese Optionen:

Ein praktischer Standard für Nachtarbeit ist dontAsk mit einer engen Allow-Liste plus einer Deny-Regel für git push. Wenn du erwägst, Berechtigungen ganz zu überspringen, lies zuerst was —dangerously-skip-permissions wirklich überspringt.

Setze dem Lauf Grenzen

Zwei Print-Modus-Flags verhindern, dass ein Lauf ewig weitergeht:

• --max-turns 40 stoppt nach so vielen agentischen Turns und beendet sich mit einem Fehler. Standardmäßig gibt es kein Limit.
• --max-budget-usd 5.00 stoppt, sobald die geschätzten API-Ausgaben diesen Betrag erreichen. Es ist eine clientseitige Schätzung, und die Ausgaben können darüber hinausgehen, lass also etwas Spielraum. Es ist wichtig, wenn du pro API-Aufruf zahlst, nicht bei einem Abo.

Ein vollständiger Nachtbefehl könnte so aussehen:

git worktree add ../night-validate-forms -b night/validate-forms
cd ../night-validate-forms
claude -p "$(cat tasks/validate-forms.md)" \
  --permission-mode dontAsk \
  --allowedTools "Read" "Edit" "Bash(pnpm test *)" "Bash(git add *)" "Bash(git commit *)" \
  --max-turns 60 \
  --output-format json > ../logs/validate-forms.json

Der Lauf findet in einem eigenen Git-Worktree statt und berührt deine Arbeitskopie nie. Für interaktive Sitzungen legt claude -w <name> den Worktree für dich an.

Plane um die Nutzungslimits herum

Mit einem Abo hat Claude Code ein rollierendes 5-Stunden-Limit und ein Wochenlimit. Eine lange Nacht kann an eines von beiden stoßen, und der Lauf stoppt, bis das Fenster zurückgesetzt wird. Die Details behandeln wir in Nutzungslimits von Claude Code.

Ein paar Gewohnheiten helfen:

• Starte aufwendige Arbeit früh am Abend, damit ein Reset in die Nacht fallen kann.
• Nutze für einfache Aufgaben wie Tests, Doku und Umbenennungen ein günstigeres Modell.
• Halte den Kontext klein. Kurze Aufgaben und eine schlanke CLAUDE.md verbrennen weniger Tokens. Siehe Token-Verbrauch von Claude Code.
• Stapele nicht zehn Agenten auf ein Konto und erwarte, dass alle fertig werden.

Tests als Leitplanken nutzen

Ohne Tests heißt „fertig“ nur, dass der Agent aufgehört hat. Mit Tests hast du etwas zum Prüfen.

• Mache Tests zum Teil der Definition von „fertig“. „Fertig, wenn pnpm test und pnpm typecheck bestehen.“
• Verbiete, Tests zu ändern, damit sie bestehen, außer das ist die Aufgabe. Sag es in der Aufgabe und in CLAUDE.md.
• Committe nach jedem bestandenen Schritt. Kleine Commits sind leicht zu prüfen und leicht zurückzunehmen.
• Pushe oder deploye nie. Sperre git push und alles, was die Produktion berührt. Der Morgen ist dafür da zu entscheiden, was ausgeliefert wird.

Den Lauf planen

Wenn du Läufe um Mitternacht von Hand startest, hörst du nach einer Woche damit auf. Zwei Wege zur Zeitplanung:

• cron oder launchd. Eine Crontab-Zeile wie 0 23 * * 1-5 /path/to/night.sh startet an Wochentagabenden ein Skript. Das Skript führt pro Aufgabendatei ein claude -p aus und schreibt die Logs.
• Ein Orchestrator, der eine Queue führt, Aufgaben parallel ausführt, wiederholt und einen Bericht schreibt. Davon handelt der Rest dieses Beitrags.

In beiden Fällen muss der Rechner an sein und darf nicht schlafen. Auf einem Mac reicht caffeinate oder eine Keep-awake-Einstellung.

Am Morgen prüfen

Plane 20 bis 30 Minuten für das Review ein:

1. Lies zuerst die Zusammenfassung: was fertig wurde, was hängenblieb, was noch läuft.
2. Lies bei jedem fertigen Branch den Diff, nicht nur die Nachricht des Agenten. Prüfe, dass die Tests liefen.
3. Suche riskante Änderungen: Migrationen, Auth, Abhängigkeiten, CI-Konfiguration, .env.
4. Merge, was gut ist, schick zurück, was nicht, mit einer Notiz, und reihe Hängengebliebenes mit einer klareren Aufgabe neu ein.

So geht die Nachtschicht von AgentVera damit um

AgentVera bringt diese Schritte an einen Ort. Die Nachtschicht gibt es in den Plänen Pro und Team.

Eine Queue pro Projekt

Öffne die Details-Seite eines Projekts und geh zum Tab Night shift, oder nutze den Button „Night shift“ auf dem Startbildschirm. Jedes Projekt und jede Gruppe hat eine eigene Schicht. Du tippst eine Aufgabe unter Add a task for tonight und drückst Add to queue. Der Platzhalter fasst die Regel zusammen: „Write the acceptance criteria; the agent can’t ask questions at night.“

Für jede Aufgabe wählst du, wer sie erledigt:

• Ein offener Agent. Er arbeitet in seinem eigenen Ordner und seiner eigenen Unterhaltung und wird danach nicht geschlossen. Aufgaben, die demselben Agenten gegeben werden, laufen der Reihe nach.
• Open a new agent. Ein Claude-Code- oder Codex-Agent in einem eigenen Worktree auf einem Branch night/<date>-<slug>. Er wird geschlossen, wenn die Aufgabe erledigt ist.

Zu den Optionen gehören Run each task in its own worktree and branch (recommended), Open a GitHub PR for finished tasks und As a draft PR.

Das Zeitfenster und die Regeln

Das Standardfenster ist 23:00 bis 07:00. Mit Start automatically every night startet die Schicht von selbst. At most at once legt fest, wie viele Aufgaben parallel laufen: standardmäßig 2, bis zu 6. Du kannst auch Start now drücken oder die Schicht mit End the shift früher beenden. Beenden bedeutet: Nichts Neues startet, laufende Agenten werden fertig, und der Bericht wird geschrieben.

Nachtschicht-Agenten folgen festen Regeln:

• Ihnen wird gesagt, dass du schläfst, sodass sie keine Fragen stellen.
• Sie committen, pushen aber nicht.
• Sie führen die Tests aus.
• Sie enden mit einer Fertig- oder Hängt-Markierung. Fehlt sie, wird der Agent bis zu zweimal angestupst, dann wird die Aufgabe als hängend markiert.
• Anfragen, die eine Freigabe brauchen, werden über Nacht nicht freigegeben. Sie stehen im Morgenbericht.

Jede Aufgabe zeigt einen Status: Queued, Running, Done, Stuck, Error oder Cancelled. Eine hängende Aufgabe lässt sich mit Requeue zurücklegen.

Um Freigaben zu verringern, die bis zum Morgen warten, setze die Stufe Permissions des Agenten auf Auto. In Pro und Team kannst du außerdem die Auto-Freigabe unkritische Anfragen wie Lesezugriffe, Tests und Lint beantworten lassen.

Den Rechner wach halten

Die Nachtschicht läuft nicht bei ausgeschaltetem Rechner. Die App muss geöffnet und der Rechner wach sein. Schalte unter Settings → Notifications Keep the computer awake ein. Es funktioniert wie caffeinate: Der Mac schläft nicht, solange AgentVera geöffnet ist, auch wenn sich das Display ausschalten kann.

Geplante Aufgaben für wiederkehrende Arbeit

Für wiederkehrende Jobs wie eine nächtliche Abhängigkeitsprüfung oder eine wöchentliche Aufräumaktion nutzt du geplante Aufgaben. Sie liegen auf der Details-Seite des Projekts unter Scheduled und sind in jedem Plan enthalten.

• Wähle eine Voreinstellung oder schreibe einen Cron-Ausdruck. Eine Vorschau zeigt die nächsten Läufe.
• Ist der Agent zur Zeit beschäftigt, wähle, ob gewartet, trotzdem gesendet oder übersprungen wird.
• Der Agent kann gestartet werden, wenn er gestoppt ist, und Run now löst eine Aufgabe sofort aus.
• Fehlgeschlagene Läufe können an Telegram gemeldet werden.

Wie die Nachtschicht laufen sie nur, solange die App geöffnet ist. Läufe, die bei geschlossener App verpasst wurden, werden nicht nachgeholt.

Wenn ein Konto sein Limit erreicht

Mit dem Kontenwechsel (Pro und Team) richtest du eine Kette aus mindestens zwei Claude- oder Codex-Konten ein. Hat eines nur noch 3 % oder weniger von seinem 5-Stunden- oder Wochenlimit übrig, wechseln Agenten zum nächsten Konto, und die Unterhaltung kann mitziehen. Abgelaufene Anmeldungen werden übersprungen. Wenn du eine Kette eingerichtet hast, macht ein Agent, der über Nacht sein Limit erreicht, auf dem nächsten Konto weiter, statt zu stoppen. Prüfe die Bedingungen deines Anbieters, bevor du mehrere Konten nutzt.

Von Problemen erfahren, nicht von allem

Telegram kann Fehler, Freigabeanfragen, Limit-Warnungen, fehlgeschlagene geplante Aufgaben und den Morgenbericht der Nachtschicht senden. /night zeigt die Queue, fügt eine Aufgabe hinzu oder startet die Schicht von deinem Smartphone aus. Die vollständige Liste steht unter Benachrichtigungen und Freigaben.

Der Morgenbericht und der Review-Posteingang

Wenn die Schicht endet, bekommst du eine Desktop-Benachrichtigung und einen Markdown-Bericht, der auf der Platte gespeichert wird. Frühere Berichte stehen unter Morning reports. Die Telegram-Version enthält nur Zahlen: erledigt, geöffnete PRs, hängend und noch in Arbeit.

Fertige Arbeit landet außerdem im Review-Posteingang, einem Tab im rechten Panel, der alle Agenten und Projekte abdeckt. Jede Karte zeigt:

• die geänderten Dateien,
• Risikohinweise zu Migrationen, Auth, Abhängigkeiten, CI und .env,
• Größenhinweise, etwa 800 oder mehr geänderte Zeilen, 300 oder mehr gelöschte oder keine Tests,
• das Verify-Ergebnis und die letzte Antwort des Agenten.

Von jeder Karte aus kannst du Approve, mit Send to queue den Branch in die Merge-Queue legen oder mit Send back samt Notiz an den Agenten zurückgeben.

Checkliste für die Nacht

• Jede Aufgabe ist klein, unabhängig und hat schriftliche Abnahmekriterien.
• CLAUDE.md nennt die Testbefehle und die Dateien, die tabu sind.
• Die Berechtigungen sind geklärt: Allow-Liste, dontAsk oder Auto, und git push gesperrt.
• Jede Aufgabe läuft auf einem eigenen Branch oder Worktree.
• Für Skript-Läufe sind Turn- oder Budget-Limits gesetzt.
• Aufwendige Arbeit passt in deine Nutzungslimits, oder ein zweites Konto steht bereit.
• Der Rechner bleibt an und wach.
• Du erfährst von Fehlern, ohne für jeden Turn geweckt zu werden.
• Für den Morgen ist Zeit zum Prüfen eingeplant.

Zum Schluss

Claude Code über Nacht laufen zu lassen funktioniert, wenn die Nacht geplant ist. Das heißt: kleine Aufgaben mit klaren Fertig-Bedingungen, Berechtigungen, die nicht auf dich warten, Tests, die die Arbeit prüfen, Branches, die main schützen, und ein Morgen-Review, das entscheidet, was ausgeliefert wird. All das geht mit claude -p, cron und ein paar Flags. Die Nachtschicht von AgentVera bringt Queue, Regeln, Limits und Morgenbericht an einen Ort, sodass du den Morgen mit dem Prüfen verbringst statt mit dem Einrichten.

Mehr dazu:

• Nachtschicht
• Geplante Aufgaben
• Review-Posteingang
• Parallele Coding-Agenten
• Merge-Queue für KI-Agenten

Um AgentVera auszuprobieren, starte auf der Startseite.