# Background Session

> Your Claude Code chat that keeps going when the terminal is shut.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** Background agent, Agent view, claude agents

## Think of it like

It is like a robot. It keeps on cleaning while you are out.

## Definition

A background session is a full Claude Code chat that runs with no terminal attached. A separate supervisor process keeps it going, so you can close the terminal and the work goes on. Agent view, opened with claude agents, lists them all. It shows which are working, which need you and which are done. You can attach to one to read and reply, then leave again. Shutting down the computer stops them.

## Example

Lucy starts three jobs before lunch: a bug fix, a review and a slow test hunt. She runs claude agents when she is back and sees two done and one waiting for an answer.

## Example code

```bash
claude agents
```

See all your background sessions.

## Why it matters

One person can run many tasks at once, and step in only when one needs a choice.

## Common mistake

Thinking it runs in the cloud. It runs on your own computer, so shutting the computer down stops it. A cloud session is the one that runs on a server.

## Three principles

- **No terminal needed.** A supervisor runs it.
- **Agent view.** Lists them all.
- **Attach and leave.** Whenever you want.

## Related terms

- [Claude Code Session](https://learn.benibix.com/term/ai/claude-code-session)
- [Cloud Session](https://learn.benibix.com/term/ai/cloud-session)
- [/background Command](https://learn.benibix.com/term/ai/background-command)
- [/fork Command](https://learn.benibix.com/term/ai/fork-command)
- [Long-Running Agent](https://learn.benibix.com/term/ai/long-running-agent)

## Told apart from

- [Background Session vs Cloud Session](https://learn.benibix.com/compare/background-session-vs-cloud-session): People think a background session runs in the cloud. It does not. A background session runs on your own computer, with no terminal open. A cloud session runs on Anthropic's servers from a fresh copy of your repo. It keeps going with your laptop shut, but it cannot see files that live only on your machine.

## Taught in

- [Claude Code Run Modes](https://learn.benibix.com/learn/ai-claude-code/claude-code-run-modes): Claude Code, 16/16

![Three background sessions in a list: one working, one waiting for you, one done. Your terminal can attach to any of them and leave again.](https://learn.benibix.com/diagrams/cmd-background-session.svg)

---

Source: https://learn.benibix.com/term/ai/background-session
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-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
