# claude daemon Command

> It checks and stops the process that runs background jobs.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** claude daemon, claude daemon status, Background session supervisor

## Think of it like

It is like a teacher who keeps an eye on all the kids at play.

## Definition

claude daemon looks after the supervisor, the process behind your background sessions. It is the one process that runs them all. claude daemon status prints its state and how many sessions it holds, and ends with code 1 if it is not running. claude daemon logs follows its log, ~/.claude/daemon.log. claude daemon stop shuts it down. Add --keep-workers to leave the sessions running for the next one.

## Example

Emma's background sessions all stop at once. claude daemon status shows the supervisor is stuck. She stops it with --keep-workers, and the sessions come back.

## Example code

```bash
claude daemon status
```

Is the supervisor running?

## Why it matters

When every background session fails together, the cause is the supervisor. This is how you reach it.

## Common mistake

Stopping it with no --keep-workers when you just want a restart. That ends each background session it ran.

## Three principles

- **One supervisor.** Runs every session.
- **status and logs.** See what it does.
- **stop.** --keep-workers to keep them.

## Related terms

- [Background Session](https://learn.benibix.com/term/ai/background-session)
- [claude respawn Command](https://learn.benibix.com/term/ai/claude-respawn-command)
- [/debug Command](https://learn.benibix.com/term/ai/debug-command)

## Taught in

- [Background Session Commands](https://learn.benibix.com/learn/ai-claude-code-commands/background-session-commands): Claude Code Commands, 7/17

![A supervisor process runs the background sessions. claude attach, logs, respawn and rm act on one session. claude daemon acts on the supervisor.](https://learn.benibix.com/diagrams/cli-daemon.svg)

---

Source: https://learn.benibix.com/term/ai/claude-daemon-command
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
