Workspace folder allowlist
SetallowedWorkspaceFolders in the managed configuration to restrict which paths users may attach as workspace folders. The Configuration reference covers where the managed configuration lives on each platform and how to deploy it.
A leading
~ expands to the user’s home directory, so a single profile can express per-user roots like ~/Documents/Claude across the fleet. A path may also reference one of a fixed set of environment-variable tokens, such as %OneDrive% or %USERNAME%, listed in the configuration reference. An entry that references any other %VAR%, or one that is unset on the device, is ignored.
Each entry is either a plain path string or an object with these fields:
For example,
[{"path": "~/Documents/Claude"}, {"path": "/Volumes/Shared/Reference", "mode": "ro"}] lets users work in their own folder and consult the shared reference folder without changing it.
The check is enforced against the resolved path, so symlinks and .. traversal can’t be used to escape an allowed root.
The allowlist controls what users can attach. Within an attached read/write folder, the agent can read and write every file the user’s OS account can reach. To keep data out of reach entirely, leave it outside the allowed roots. To let the agent read data in Cowork without changing it, list the folder with
mode set to ro.Network drives on Windows
Users can attach a mapped network drive (for example,Z:\) as a workspace folder through the folder picker. Raw UNC paths (\\server\share) are not supported; map the share to a drive letter first.
What the agent can do on the network drive depends on whether the drive was mapped and reachable when the sandbox started:
- Mapped and reachable at sandbox start: the sandbox mounts the attached folder alongside local folders. File tools and shell commands both work.
- Mapped later, or unreachable at sandbox start: file tools still work, but shell commands cannot reach the drive. Copy the relevant files to a local folder before running a script or build against them.
/Volumes/ are currently treated as local folders.
WSL
You do not need Windows Subsystem for Linux (WSL) to run Claude Desktop or Cowork. On Windows, Cowork’s sandbox runs on the operating system’s built-in virtualization, which the readiness check verifies. Install the macOS or Windows package (see System requirements); there is no installation path inside WSL. Run the Windows app and work with WSL files from there. Windows exposes a WSL distribution’s filesystem as a UNC path (\\wsl$\<distro> or \\wsl.localhost\<distro>). Like any other raw UNC path, these cannot be attached as workspace folders directly. To attach files that live inside WSL as a workspace folder, map the share to a drive letter and attach the mapped drive, or copy the files to a local Windows folder. Network drives on Windows describes what the agent can do on a mapped drive.