Skip to main content
Each session picks a run mode when it starts, and the mode cannot be changed later:
  • On your device (shown in the interface as Run on your device): the agent in the cloud remotely controls your computer. Reading and writing files and running commands happen on your computer, using your local environment and files, with the same result as running locally. You can choose any computer that is signed in to the desktop app and allows execution.
  • Cloud server: the session runs from start to finish on your cloud server (the Linux cloud server included with Plus), without going through your computer. The session runs to completion even if you close your laptop.

Availability

Comparison

Entry points

  • New session: the run environment button next to Project above the input box.
  • Existing session: the run environment pill next to the title in the top bar.
  • Settings › Workspace › Machines, or Execution log and Machines & access at the bottom of the run environment menu.

Choose a run environment for a new session

Click the run environment button to open the Run environment menu: Cloud server is at the top; the Run on your device group below lists each device (the current computer is tagged This device, and the second line shows its access scope and permission limit); Execution log and Machines & access are at the bottom.

Default selection

  • A local project defaults to the computer where the project lives; other projects and sessions with no project default to the cloud server.
  • A manual selection applies only to this new session. If the selected device becomes unusable, the selection falls back to the cloud server.

When an option cannot be selected

Device permission limit

Each device can have a Permission limit. When you select that device, levels above the limit in the session permission menu are grayed out (Above this device’s permission limit). If the selected permission is above the limit, it is lowered to the limit automatically. For permission levels, see Input box.

Run environment of an existing session

The pill next to the session title in the top bar shows Cloud server or the name of the execution device. When the device is offline, it shows Device offline.
  • The execution machine is chosen when the session is created and cannot be changed later. To use a different machine, create a new session.
  • Execution log and Machines & access at the bottom of the menu open the execution device’s log and details.

Devices and the machine list

A device is a computer where you are signed in to the desktop app. After you sign in, it joins the workspace automatically and appears in the machine list and the run environment menu. The web app does not add devices. Settings › Workspace › Machines lists all machines in the workspace (the cloud server first). Each row shows the name, OS and app version, and a status: Online, Offline, Stopped (retained), or Removed. Offline records with the same name left behind after reinstalling the app are collapsed into one line; open one to remove it if you no longer use it. Click a row to open the machine details.

Machine details and execution access

Computers and servers can be renamed with the pencil next to the name (up to 64 characters).
  • Saved changes apply to new sessions immediately.
  • The cloud server’s details show only Allow execution (read-only), the execution log, and the plugins entry. It cannot be renamed or removed.

System confirmation

When you widen this computer’s execution access in the desktop app (turning on Allow execution, widening the access scope, opening sensitive locations, raising the permission limit, and so on), a confirmation dialog lists what is being widened. Once Allow execution is on, it applies to every future session that runs on this computer. Narrowing access needs no confirmation; when you turn off Allow execution, sessions using this device pause.

Who can make changes

Execution access can be changed only in this computer’s own desktop app. When viewed on another device or in the web app, it is read-only, with Execution access can only be changed on this device. The cloud server’s settings are also read-only.

First run on this computer

When a session is set to run on this computer but this computer does not yet meet the requirements, this computer’s app shows a prompt when it opens the session:
  • Allow execution is not on yet: click Open Machines & access, turn on Allow execution, then come back. Commands run with your account’s permissions.
  • The project has no folder on this computer yet: click Allow and choose the project’s folder on this computer; you will not be asked again for this project. Click Don’t allow and this project will not run on this computer. The folder is not synced to the cloud.
Sessions with no project use the session’s own temporary folder. When applicable, the dialog notes that your ~/.claude/CLAUDE.md is also sent to the Agent.

Sensitive location confirmation

When a device’s Sensitive locations setting is Ask each time and the agent needs to access a location such as the SSH configuration, the execution device’s app first shows an Access request card with the reason and the path to be accessed:
  • Allow once: grants access this one time, without changing machine access.
  • Deny: access is not granted.
  • If you do not respond within a set time, it is treated as denied.
  • You can click Later to collapse it; the session in the sidebar then shows Needs your input.

Execution log

Open it from Execution log in the run environment menu (this session) or View log in machine details (all sessions on this machine). It lists the agent’s operations on this machine one per row, with the target and result. In the execution device’s own app, you can also use Stop processes (ends operations in progress and background processes), Disconnect, and Reconnect. In the web app or on other devices, you can only view the log.

Disconnects and reconnecting

When a session is running on a computer and that computer disconnects (shut down, asleep, offline, app closed, and so on):
  • The turn pauses, and the execution device’s app shows This computer disconnected. This turn is paused. at the end of the session, with the reason for the disconnect.
  • After the connection recovers, it continues automatically from where it was interrupted, and completed operations do not run again. You can also click Reconnect. If the reason is that execution is not allowed or the project folder is not linked, you are guided to fix it.
  • On other devices and the web app, the session pill shows Device offline.
A session does not switch to the cloud server automatically when its device goes offline.

Remove a device

At the bottom of machine details, click Remove device and confirm. The device disconnects immediately, and sessions using it are interrupted. To use it again later, sign in again on that device.
  • The cloud server cannot be removed.
  • The current computer cannot be removed here. Sign out to remove it.

Cloud server mode

When you choose Cloud server, the session runs entirely on your cloud server, and the project uses the copy on the cloud server and the project environment. The cloud server requires Plus; without it, Cloud server in the menu shows Available with Plus. For getting a cloud server, its status, and the remote desktop, see Cloud server.

FAQ

With Run on your device, does my computer need to stay on?

Yes. If the computer disconnects, the turn pauses and continues automatically after it reconnects. If you need the session to keep running after you close your laptop, choose the cloud server.

Can an existing session move from my computer to the cloud server?

No. The execution machine is set when the session is created. To change it, create a new session.

Why can’t I change my computer’s access in the web app?

Execution access can be changed only in that computer’s own desktop app.

How do I add a new device?

Install the desktop app on that computer and sign in with the same account. It appears in the machine list automatically. Then turn on Allow execution in that computer’s app.