# Cloud Session

> A Claude Code session that runs on a server and keeps going when you leave.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** Claude Code on the web, claude --cloud, Web session

## Think of it like

It is like baking a cake in a shop's oven, not your own. You can go out and it still bakes.

## Definition

A cloud session is a Claude Code session that runs on a server, not on your computer. It keeps going when you close your laptop. By default it runs on servers Anthropic manages. You can start one at claude.ai/code, from the Claude phone app, from the desktop app, or with claude --cloud. It starts from a fresh copy of your repository, so it does not see files only on your machine. The command /teleport pulls a cloud session back to your terminal.

## Example

Lucy starts a long upgrade from her phone on the train. It runs in the cloud, and when she gets home she pulls it into her terminal.

## Example code

```bash
claude --cloud "fix the flaky login test"
```

Send a task from your terminal to run in the cloud.

## Why it matters

Long jobs no longer tie up your own computer or need it to stay awake.

## Common mistake

Expecting it to see your local settings or secrets. It starts from a clean copy. So put what it needs in the code or in the cloud setup.

## Three principles

- **Runs on a server.** Not your laptop.
- **Keeps going.** When you leave.
- **Fresh copy.** Of your repository.

## Related terms

- [Claude Code Surface](https://learn.benibix.com/term/ai/claude-code-surface)
- [Remote Control](https://learn.benibix.com/term/ai/remote-control)
- [Claude Code Session](https://learn.benibix.com/term/ai/claude-code-session)
- [Git](https://learn.benibix.com/term/development/git)
- [Claude Code in Slack](https://learn.benibix.com/term/ai/claude-code-in-slack)

## Told apart from

- [Remote Control vs Cloud Session](https://learn.benibix.com/compare/remote-control-vs-cloud-session): People often think Remote Control runs Claude Code in the cloud. It does not. With Remote Control, the session runs on your own computer, and your phone only shows it. If the computer sleeps, the work stops. A cloud session runs on a server instead. It starts from a fresh copy of your code and keeps going when your laptop is closed.
- [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

![A local session runs on your laptop. A cloud session runs on a server and keeps going when the laptop closes.](https://learn.benibix.com/diagrams/cc-cloud-session.svg)

---

Source: https://learn.benibix.com/term/ai/cloud-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.
