---
title: "Coding-Agenten über Nacht: Sandbox, Git, Kostendeckel"
description: "Ein praktisches Setup für unbeaufsichtigte Läufe von Coding-Agenten: Sandbox, Git-Checkpoints, Task-Dateien, Schrittlimits, Review am Morgen und Flatrate-Sessions."
url: https://broadrouter.com/de/blog/overnight-coding-agent-runs/
lang: de
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Mit KI-Unterstützung aus dem Englischen übersetzt. [Englisches Original lesen](https://broadrouter.com/blog/overnight-coding-agent-runs/) (aktualisiert am 2026-11-16).

# Coding-Agenten sicher und unbeaufsichtigt über Nacht laufen lassen

Vom Team von BroadNet Inference · 5 Min. Lesezeit · Veröffentlicht 2026-11-14 · Aktualisiert 2026-11-16

Lassen Sie den Agenten in einem Container oder einer VM laufen, in die nur das Repository eingebunden ist, auf einem eigenen Git-Branch und mit einem Commit nach jedem abgeschlossenen Schritt. Geben Sie ihm eine schriftliche Task-Datei, ein Schrittlimit und eine feste Deadline, und prüfen Sie den Branch am Morgen. Eine Flatrate-Session wie Full Moon von BroadNet für $60 legt die Rechnung im schlimmsten Fall fest.

## Das Wichtigste in Kürze

-   Zuerst die Sandbox: ein Container oder eine VM, in die nur das Repo eingebunden ist, ohne Produktions-Zugangsdaten.
-   Ein Branch oder Git-Worktree pro Agent mit einem Commit nach jedem Schritt macht jede Änderung prüfbar und umkehrbar.
-   Eine Task-Datei mit einer klaren Definition of Done schlägt einen einzeiligen Prompt.
-   Schrittlimits, eine Deadline und ein Wiederholungsschutz stoppen festgefahrene Läufe vor dem Morgen.
-   Eine Plan-Session hat keinen Token-Zähler; eine Nacht Agentenarbeit kostet also den Planpreis, egal wie viele Tokens anfallen.

**Auf dieser Seite**

1.  1\. Wie steckt man einen unbeaufsichtigten Agenten in eine Sandbox?
2.  2\. Warum bekommt jeder Agent einen eigenen Branch?
3.  3\. Was gehört in die Task-Datei?
4.  4\. Welche Schutzmechanismen stoppen einen festgefahrenen Agenten?
5.  5\. Ist eine Plan-Session oder die Abrechnung pro Token über Nacht günstiger?
6.  6\. Wie prüft man den Lauf am Morgen?
7.  Wie probiert man es in der ersten Nacht sicher aus?

Coding-Agenten sind gut in langer, klar definierter, mühsamer Arbeit: Tests für fünfzig Module schreiben, jede Aufrufstelle auf eine neue API migrieren, tausend Lint-Warnungen beheben. Solche Arbeit braucht Sie nicht als Aufpasser. Sie braucht einen sicheren Ort zum Laufen, eine klare Aufgabe, Schutz gegen Festfahren und eine Möglichkeit, das Ergebnis beim Kaffee zu prüfen.

Dies ist eine Checkliste für genau dieses Setup.

## 1\. Wie steckt man einen unbeaufsichtigten Agenten in eine Sandbox?

Ein unbeaufsichtigter Agent führt Shell-Befehle aus, die niemand freigibt. Gehen Sie davon aus, dass er irgendwann etwas ausführt, was Sie nicht getan hätten: das falsche Verzeichnis löschen, ein Paket installieren, auf ein Remote pushen. Grenzen Sie ihn ein.

-   **Ein Container oder eine VM**, nicht das Hauptbenutzerkonto Ihres Laptops. Die [Sicherheitsdokumentation](https://docs.docker.com/engine/security/) von Docker beschreibt die Mechanismen; lassen Sie ihn mindestens als Nicht-Root-Benutzer laufen und entziehen Sie Capabilities, die Sie nicht brauchen.
-   **Binden Sie nur das Repository ein.** Kein Home-Verzeichnis, keine SSH-Schlüssel, keine Cloud-Zugangsdaten, kein `~/.config` voller Tokens.
-   **Keine Produktions-Secrets.** Verwenden Sie Testdatenbanken und Dummy-API-Schlüssel. Braucht der Agent einen echten Dienst, geben Sie ihm einen eingeschränkten, widerrufbaren Schlüssel.
-   **Beschränken Sie das Netzwerk.** Der Agent braucht die Modell-API und vielleicht eine Paket-Registry. Selten braucht er mehr.
-   **Keine Push-Rechte.** Lassen Sie ihn lokal committen. Gepusht wird von Ihnen, nach dem Review.

Der API-Schlüssel für das Modell ist die eine Zugangsberechtigung, die der Agent haben muss. Verwenden Sie einen eigens dafür angelegten Schlüssel und beschränken Sie ihn, wenn Ihr Anbieter das unterstützt, auf die Egress-IP der Sandbox. Schlüssel von BroadNet unterstützen [IP-Allowlists](https://broadrouter.com/de/guides/api-keys-ip-allow-lists/) mit bis zu 32 Einträgen, ein geleakter Schlüssel ist von anderswo also nutzlos.

## 2\. Warum bekommt jeder Agent einen eigenen Branch?

Arbeiten Sie auf einem eigenen Branch, nie auf `main`. Wenn Sie mehr als einen Agenten laufen lassen, geben Sie jedem mit [git worktree](https://git-scm.com/docs/git-worktree) ein eigenes Arbeitsverzeichnis:

```bash
git worktree add ../agent-tests-api -b agent/tests-api
git worktree add ../agent-lint-fixes -b agent/lint-fixes
```

Jeder Worktree ist ein separater Checkout desselben Repositorys; Agenten überschreiben sich also nicht gegenseitig die Dateien, und jeder Branch zeigt genau, was ein Agent getan hat.

**Committen Sie dann nach jedem abgeschlossenen Schritt.** Aider macht das standardmäßig. Bei anderen Agenten schreiben Sie es in die Anweisungen oder legen einen Wrapper um die Schleife, sodass ein Commit erfolgt, sobald die Tests grün sind. Eine Historie kleiner Commits macht aus „der Agent hat um 3 Uhr nachts etwas kaputt gemacht“ ein „Commit 14 hat es kaputt gemacht; 1 bis 13 behalten“.

## 3\. Was gehört in die Task-Datei?

Ein einzeiliger Prompt, der interaktiv funktioniert, scheitert über Nacht, weil niemand die erste Rückfrage des Agenten beantwortet. Schreiben Sie eine Task-Datei:

```markdown
# Task: add unit tests to src/billing/

## Goal
Every public function in src/billing/ has at least one unit test.

## Done when
- `pytest tests/billing` passes
- coverage for src/billing/ is reported (no target)
- no changes outside tests/billing/ except fixing obvious bugs, each in its own commit

## Rules
- Do not change public function signatures.
- If a function is untestable without a refactor, list it in NOTES.md and move on.
- Run `pytest tests/billing -x` after each new test file.

## Notes
Append decisions and skipped items to NOTES.md as you go.
```

Der Abschnitt „Done when“ ist der wichtige Teil. Er gibt dem Agenten eine Möglichkeit zu erkennen, dass er fertig ist, und Ihnen eine Möglichkeit, das zu prüfen. Die Notizdatei dient zugleich als Gedächtnis, falls der Lauf neu startet oder der Kontext komprimiert wird; siehe [Kontextmanagement für lang laufende Agenten](https://broadrouter.com/de/blog/long-running-agent-context-management/).

## 4\. Welche Schutzmechanismen stoppen einen festgefahrenen Agenten?

Unbeaufsichtigt heißt: Niemand bemerkt einen festgefahrenen Agenten vor dem Morgen. Vier Schutzmechanismen:

1.  **Schrittlimit.** Eine feste Höchstzahl an Modellaufrufen pro Aufgabe.
2.  **Deadline.** Zu einer festen Uhrzeit stoppen, zum Beispiel um 07:00, egal in welchem Zustand.
3.  **Wiederholungserkennung.** Stoppen, wenn derselbe Tool-Aufruf dreimal dasselbe Ergebnis liefert oder sich über eine festgelegte Zahl von Schritten keine Datei geändert hat.
4.  **Timeouts pro Tool.** Eine hängende Testsuite sollte nicht die ganze Nacht hängen lassen.

Greift ein Schutzmechanismus, sollte der Agent den Grund in die Notizdatei schreiben und sauber beenden. Warum Schritt- und Retry-Grenzen für die Kosten wichtig sind, steht unter [Schritte pro Aufgabe begrenzen](https://broadrouter.com/de/blog/cut-coding-agent-llm-costs/) im Kostenleitfaden für Coding-Agenten.

Aider lässt sich leicht so betreiben: Die [Doku zur Skriptsteuerung](https://aider.chat/docs/scripting.html) zeigt die Option `--message`, um eine Anweisung auszuführen und zu beenden, und `--yes-always`, um Rückfragen automatisch zu bestätigen. Packen Sie das in eine Shell-Schleife über eine Aufgabenliste, mit `timeout` um jeden Lauf, und Sie haben eine einfache Warteschlange für die Nacht.

## 5\. Ist eine Plan-Session oder die Abrechnung pro Token über Nacht günstiger?

Läufe über Nacht verändern die Kostenfrage. Niemand schaut auf den Zähler, und ein festgefahrener Agent kann stundenlang in einer Schleife hängen.

**Bei einem Schlüssel mit Abrechnung pro Token** hängen die Kosten davon ab, wie viel der Agent sendet. Agenten schicken bei jedem Schritt den Kontext erneut, ein achtstündiger Lauf summiert sich also. Prompt Caching hilft sehr (gecachter Input kostet bei [DeepSeek V4.1 Flash](https://broadrouter.com/de/models/deepseek-v4.1-flash/) $0.0055 pro 1 Mio. Tokens gegenüber $0.175 für neuen Input), aber Output- und Reasoning-Tokens werden voll berechnet. Sie brauchen ein Token-Budget pro Lauf und ein Ausgabenlimit für das Konto.

**Bei einer Plan-Session** gibt es keinen Token-Zähler. Eine Full-Moon-Session kostet $60 pro Monat für unbegrenztes DeepSeek V4.1 Flash, und das ist die Obergrenze, egal wie lange der Agent läuft oder wie oft er sich im Kreis dreht. Für Arbeit über Nacht ist das der Hauptreiz: Die Rechnung im schlimmsten Fall steht fest, bevor Sie ins Bett gehen.

|  | Schlüssel mit Abrechnung pro Token | Plan-Session |
| --- | --- | --- |
| Kosten einer festgefahrenen Nacht im schlimmsten Fall | Steigen mit den Tokens | Fest beim Planpreis |
| Parallele Agenten | Bis zu 4 gleichzeitige Anfragen pro Pay-as-you-go-Schlüssel | Eine Anfrage gleichzeitig pro Session |
| Modelle | Alle Chat-Modelle | Nur DeepSeek V4.1 Flash |
| Schutzmechanismen weiterhin nötig | Ja, für Kosten und Zeit | Ja, für Zeit |

Zwei praktische Hinweise zu Sessions. Eine Session verarbeitet jeweils eine Anfrage; zwei Agenten auf einer Session wechseln sich also ab, und Aufgaben auf einer Session laufen nacheinander, was über Nacht oft in Ordnung ist. Wenn Agenten nebeneinander laufen sollen, kaufen Sie eine Session pro Agent. [Parallele Agenten mit einer Flatrate-API](https://broadrouter.com/de/blog/run-parallel-coding-agents-flat-rate/) rechnet das durch.

Bei einer typischen Geschwindigkeit von etwa 100 Tokens pro Sekunde kann eine Session in einem Monat Dauerbetrieb etwa 259 Millionen Output-Tokens erzeugen. Ob das für Sie günstiger ist als die Abrechnung pro Token, hängt vom Volumen ab; das Rechenbeispiel von BroadNet für einen Coding-Agenten in Vollzeit kommt bei Pay-as-you-go auf etwa $65.40 pro Monat. Rechnen Sie Ihre Zahlen im [Rechner Flatrate vs. pro Token](https://broadrouter.com/tools/flat-rate-vs-per-token-calculator/) durch. Lange unbeaufsichtigte Läufe brauchen außerdem Disziplin beim Kontext und Wiederholungen, die einen Absturz überstehen: siehe [Timeouts, Retries und Checkpoints](https://broadrouter.com/de/blog/long-running-agents-timeouts-retries/).

## 6\. Wie prüft man den Lauf am Morgen?

Der Wert eines Laufs über Nacht entsteht erst beim Review. Machen Sie es schnell:

1.  **Lesen Sie zuerst NOTES.md.** Was hat der Agent erledigt, übersprungen, und wo ist er hängen geblieben?
2.  **Prüfen Sie den Stoppgrund.** Fertig, Schrittlimit, Deadline oder Wiederholung?
3.  **Führen Sie die Tests selbst aus.** Vertrauen Sie nicht dem Bericht des Agenten über grüne Tests.
4.  **Lesen Sie den Diff Commit für Commit.** Kleine Commits machen schlechte Änderungen leicht erkennbar und entfernbar.
5.  **Squashen oder rebasen Sie, was Sie behalten**, und öffnen Sie dann einen normalen Pull Request.

An den meisten Morgen behalten Sie den Großteil der Arbeit und korrigieren ein paar Commits von Hand. An schlechten Morgen löschen Sie einen Branch. So oder so hat nichts `main` ohne Sie berührt.

## Wie probiert man es in der ersten Nacht sicher aus?

Beginnen Sie mit einer gut spezifizierten Aufgabe, einem Agenten und einer Session. Eine Meteor-Stunde ($1) reicht, um zu prüfen, ob Sandbox, Branch und Schutzmechanismen funktionieren, bevor Sie etwas die ganze Nacht laufen lassen. Für den Agenten selbst enthält der [Aider-Leitfaden](https://broadrouter.com/de/guides/aider-unlimited-deepseek/) die genauen Verbindungseinstellungen, [das beste offene Modell für Coding-Agenten](https://broadrouter.com/de/blog/best-open-model-for-coding-agents/) hilft bei der Modellwahl, und [so funktionieren Plan-Sessions](https://broadrouter.com/de/guides/unlimited-llm-api-sessions/) erklärt Schlüssel und Sessions.

Kostenlose Tools zum Thema (auf Englisch)

-   [Agent run cost estimator](https://broadrouter.com/tools/agent-run-cost-estimator/) Context growth per step, total tokens and cost of one agent run, with a DeepSeek session comparison.
-   [LLM batch job planner](https://broadrouter.com/tools/llm-batch-job-planner/) Run time, binding limit, cost per model and the flat sessions needed to finish a big job by a deadline.
-   [Flat-rate vs per-token LLM cost calculator](https://broadrouter.com/tools/flat-rate-vs-per-token-calculator/) Break-even between an unlimited plan and paying per token, per agent.
-   [LLM rate limit and concurrency calculator](https://broadrouter.com/tools/llm-rate-limit-calculator/) Which limit binds first: RPM, TPM or concurrency, with Little's law.

[Kostenlose Tools (auf Englisch)](https://broadrouter.com/tools/)

## Begriffe in diesem Artikel

[Token](https://broadrouter.com/de/glossary/token/)

Ein Token ist die Texteinheit, die ein Sprachmodell liest und schreibt: ein Wort, ein Wortteil, ein Satzzeichen oder eine Bytefolge, die der Tokenizer des Modells erzeugt. LLM-APIs zählen, begrenzen und berechnen die Nutzung meist in Tokens.

[Pay-as-you-go](https://broadrouter.com/de/glossary/pay-as-you-go/)

Pay-as-you-go ist ein Preismodell, bei dem Sie nur für tatsächliche Nutzung zahlen, gemessen pro Einheit wie Tokens, Anfragen oder Audiominuten, ohne Abonnement oder Mindestabnahme. Die meisten LLM-APIs rechnen so ab, aus einem vorausbezahlten Guthaben oder per regelmäßiger Rechnung.

[Gecachte Input-Tokens (Cached Input Tokens)](https://broadrouter.com/de/glossary/cached-input-tokens/)

Gecachte Input-Tokens sind Prompt-Tokens, die ein LLM-Anbieter kürzlich verarbeitet hat und aus einem Cache wiederverwenden kann, statt sie neu zu berechnen, meist ein wiederholtes Präfix wie ein System-Prompt oder ein Dokument. Anbieter berechnen sie günstiger als neue Input-Tokens.

[Tool Calling (Function Calling)](https://broadrouter.com/de/glossary/tool-calling/)

Tool Calling, auch Function Calling genannt, ist eine Funktion von LLM-APIs, bei der das Modell eine strukturierte Anfrage zurückgibt, eine vom Entwickler definierte Funktion mit JSON-Argumenten auszuführen. Die Anwendung führt die Funktion aus und sendet das Ergebnis zurück; das Modell selbst führt nie Code aus.

[Concurrency (Parallelität)](https://broadrouter.com/de/glossary/concurrency/)

Concurrency (Parallelität) ist die Zahl der Anfragen, die ein Client gleichzeitig offen hat. LLM-APIs begrenzen sie oft pro Schlüssel oder Plan, getrennt von den Anfragen pro Minute, weil jede offene Anfrage GPU-Kapazität belegt, bis ihre Antwort fertig ist.

[Request-Timeout (Zeitüberschreitung)](https://broadrouter.com/de/glossary/request-timeout/)

Ein Request-Timeout ist die längste Zeit, die ein HTTP-Client auf einen Server wartet, bevor er die Anfrage aufgibt. Clients teilen ihn meist in einen Connect-Timeout für den Verbindungsaufbau und einen Read-Timeout für das Warten auf Daten. LLM-Aufrufe brauchen großzügige Read-Timeouts, weil lange Antworten Zeit kosten.

[Ausgabenlimit (Spend Limit)](https://broadrouter.com/de/glossary/spend-limit/)

Ein Ausgabenlimit (Spend Limit) ist eine Obergrenze dafür, wie viel ein API-Konto, Projekt oder Schlüssel in einem Zeitraum ausgeben darf, meist pro Monat. Ist sie erreicht, lehnt der Anbieter weitere Anfragen ab, oft mit HTTP 429 oder 400, bis der Zeitraum neu beginnt oder das Limit erhöht wird.

[Context Engineering](https://broadrouter.com/de/glossary/context-engineering/)

Context Engineering ist die Arbeit, die Menge an Tokens auszuwählen und zu pflegen, die ein Sprachmodell bei jeder Anfrage sieht, also System-Prompt, Tool-Definitionen, Verlauf, abgerufene Dokumente und Notizen, damit das Modell die kleinste Menge aussagekräftiger Informationen erhält, die es für die Aufgabe braucht.

## Häufige Fragen

### Ist es sicher, einen Agenten unbeaufsichtigt Shell-Befehle ausführen zu lassen?

Nur in einer Sandbox, die Sie bedenkenlos wegwerfen können. Binden Sie das Repository ein, halten Sie Secrets und Produktions-Zugangsdaten draußen und beschränken Sie den Netzwerkzugriff auf das, was die Aufgabe braucht.

### Wie viele Aufgaben über Nacht schafft eine Plan-Session?

Eine Session verarbeitet jeweils eine Anfrage, Aufgaben auf einer Session laufen also nacheinander. Reihen Sie sie auf einer Session hintereinander ein, oder kaufen Sie eine Session pro Agent, den Sie parallel laufen lassen wollen.

### Was, wenn der Agent über Nacht den Build kaputt macht?

Ohne Review erreicht nichts Ihren main-Branch. Mit einem Commit pro Schritt sehen Sie genau, wo es schiefging, und behalten die guten Commits davor.

### Welche Aufgaben eignen sich für Läufe über Nacht?

Gut spezifizierte, testbare Arbeit wie die Migration von Aufrufstellen auf eine neue API, Tests für ungetestete Module, Lint-Korrekturen in der ganzen Codebasis oder Dependency-Upgrades. Offene Designarbeit erledigen Sie besser mit einem Menschen in der Schleife.

## Weiterlesen

-   [Coding-Agent-Kosten senken: 10 Wege mit geschätzter Ersparnis](https://broadrouter.com/de/blog/cut-coding-agent-llm-costs/)
-   [Parallele Coding-Agenten mit einer LLM-API-Flatrate betreiben](https://broadrouter.com/de/blog/run-parallel-coding-agents-flat-rate/)
-   [Kontextmanagement für lang laufende Agenten mit 1M-Kontextfenster](https://broadrouter.com/de/blog/long-running-agent-context-management/)
-   [LLM-API: Flatrate oder Abrechnung pro Token? Die Break-even-Rechnung](https://broadrouter.com/de/blog/flat-rate-vs-pay-per-token-llm-api/)
-   [Prompt Injection bei Coding-Agenten: Schutzmaßnahmen, die halten](https://broadrouter.com/de/blog/prompt-injection-coding-agents/)
-   [Kosten eines KI-Coding-Agent-Laufs: Schritte, Kontext, Caching](https://broadrouter.com/de/blog/ai-coding-agent-run-cost/)
-   [Claude Code mit offenen Modellen: Proxys, native Endpoints, Grenzen](https://broadrouter.com/de/blog/claude-code-with-openai-compatible-models/)
-   [Anleitung: Aider mit unbegrenztem DeepSeek V4.1 Flash betreiben](https://broadrouter.com/de/guides/aider-unlimited-deepseek/)
-   [Anleitung: So funktionieren die unbegrenzten LLM-API-Pläne für Agenten](https://broadrouter.com/de/guides/unlimited-llm-api-sessions/)
-   [Anleitung: API-Schlüssel per IP-Allowlist an Ihre Server binden](https://broadrouter.com/de/guides/api-keys-ip-allow-lists/)

Testen Sie es mit Ihrem echten Workload. Neue Konten starten mit USD 5 Guthaben für Gemma und Transkription. DeepSeek, GLM und Qwen3.8 erfordern eine Aufladung.

[Loslegen](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-blog-overnight-coding-agent-runs&utm_content=page-cta) ·

**Quellen**

-   [Docker-Doku, Sicherheit der Docker Engine](https://docs.docker.com/engine/security/)
-   [Git-Dokumentation, git-worktree](https://git-scm.com/docs/git-worktree)
-   [Aider-Doku, Aider per Skript steuern](https://aider.chat/docs/scripting.html)
-   [Unbegrenzte Pläne von BroadNet Inference (auf Englisch)](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-blog-overnight-coding-agent-runs&utm_content=sources)
