Zum Inhalt

Background Tasks

Claude Code kann langläufige Aufgaben im Hintergrund ausführen, während du weiterarbeitest.

Konzept

Background Tasks laufen asynchron:

  • Separater Prozess vom Haupt-Terminal
  • Output wird in Datei geschrieben
  • Automatische Cleanup bei Exit
  • Abrufbar über Task-ID

Aktivierung

Während der Ausführung

Wenn ein Befehl läuft, drücke Ctrl+B um ihn in den Hintergrund zu verschieben.

tmux-User

In tmux ist Ctrl+B der Prefix-Key. Drücke Ctrl+B zweimal.

Direkt als Background starten

claude --background "Run all tests and create coverage report"

Oder im interaktiven Modus:

Run the full test suite in the background

Task-Management

Aktive Tasks anzeigen

/status

Zeigt: - Task-ID - Status (running, completed, failed) - Laufzeit - Output-Größe

Task-Output abrufen

Claude kann den Output lesen:

Show me the output of background task abc123

Oder manuell:

cat ~/.claude/background-tasks/abc123/output.log

Tasks abbrechen

Cancel background task abc123

Typische Use Cases

Task Warum Background?
Full Test Suite Kann 5-30 Minuten dauern
Dependency Update npm/pip install braucht Zeit
Large Refactoring Viele Dateien, viele Writes
Code Generation Generierung von Boilerplate
Log-Analyse Große Logfiles parsen

Output-Handling

Automatisches Limit

Background Tasks werden automatisch terminiert wenn:

  • Output > 5GB erreicht
  • stderr enthält dann Erklärung

Output im Context

Claude kann Background-Output in den Context laden:

Read the background task output and summarize the test failures

Konfiguration

Background Tasks deaktivieren

export CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1

Output-Verzeichnis

Default: ~/.claude/background-tasks/

Struktur: 

~/.claude/background-tasks/
├── task-abc123/
│   ├── output.log
│   ├── stderr.log
│   └── metadata.json
└── task-def456/
    └── ...

Best Practices

  1. Klare Task-Beschreibung - "Run tests" ist schlechter als "Run pytest with coverage for auth module"

  2. Nicht für interaktive Tasks - Background funktioniert nicht wenn User-Input nötig ist

  3. Regelmäßig aufräumen - Alte Task-Outputs belegen Speicher

  4. Output-Size im Blick - Verbose Logging kann schnell GB produzieren

Zusammenspiel mit Sub-Agents

Background Tasks und Sub-Agents kombinieren:

In the background:
1. Spawn 3 sub-agents to analyze src/
2. Each agent writes findings to a file
3. Consolidate results when done

Das läuft komplett async - du kannst währenddessen andere Dinge tun.