- 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.
~/.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.
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.