---
title: "Claude Code in the cloud: one machine per task · How-to · Consonance"
description: "A cloud session runs Claude Code on a machine of its own, one per task, with your repository on a new branch: several tasks run in parallel without getting in each other's way, and the work comes back as a branch or a pull request."
canonical: "https://consonance.fyi/en/mode-d-emploi/claude-code-in-the-cloud"
lang: "en"
published: "2026-10-07"
---

# Claude Code in the cloud: one machine per task

_Claude series · sheet no. 5_

## In one sentence

A cloud session runs Claude Code on a machine of its own, one per task, with your repository on a new branch: several tasks run in parallel without getting in each other's way, and the work comes back as a branch or a pull request.

## The situation: three tasks, three machines

| When you code | What to do |
| --- | --- |
| two sessions in one repository fight over files and the port | a fresh machine per task, the repository on a new branch |
| your computer goes to sleep | the cloud session keeps going |
| three problems in a small repository | three sessions started within 16 seconds, all done 87 seconds after the first started |
| a test that fails one run in four | the root cause fixed, then the suite run 40 times: 0 failures |
| a session runs into a bug outside its task | it reports it without touching it: split tasks along file boundaries |
| you want to finish the work on your machine | `claude --teleport` brings back the branch and the conversation |
| your GitHub token | stays outside the machine, behind a proxy |
| a private repository doesn't show up | install the Claude GitHub App on the account or organization that owns it |

## To try

1. Start a task in the cloud from the terminal (push your commits first).

   ```
   claude --cloud "Fix the flaky test in auth.spec.ts"
   ```
2. Bring a finished session into your terminal.

   ```
   claude --teleport
   ```
3. Or connect GitHub from the terminal with your gh token.

   ```
   /web-setup
   ```

> **The trap** Thinking that signing in with GitHub is enough. For private repositories you also need to install the Claude GitHub App on the account or organization that owns them, or they won't show up.

## Sources

- [claude.dev · Claude Code in the cloud: a field guide to cloud sessions](https://claude.dev/blog/claude-code-in-the-cloud/)

pace: [steady](https://consonance.fyi/media/lessons/claude-code-in-the-cloud/en-pose.mp4?v=14518184)

Independent summary, not affiliated with Anthropic. Claude is a trademark of Anthropic, PBC. The everyday comparisons are images to help understand, not quotes: every command and figure comes from the source.

## Next

- [How-to](https://consonance.fyi/en/mode-d-emploi.md)
- [previous sheet: Moving to Claude Sonnet 5.5, in three coding situations](https://consonance.fyi/en/mode-d-emploi/building-with-claude-sonnet-5-5.md)
- [archives](https://consonance.fyi/en/archives.md)
- [method](https://consonance.fyi/en/methode.md)
- [Consonance](https://consonance.fyi/en/index.md)
- Languages: [Français](https://consonance.fyi/mode-d-emploi/claude-code-in-the-cloud.md) · [Tiếng Việt](https://consonance.fyi/vi/mode-d-emploi/claude-code-in-the-cloud.md)
- For machines: [llms.txt](https://consonance.fyi/llms.txt) · [RSS](https://consonance.fyi/en/rss.xml) · [sitemap.xml](https://consonance.fyi/sitemap.xml)
- HTML version: https://consonance.fyi/en/mode-d-emploi/claude-code-in-the-cloud