Follow Discord
Sweep 06 Nov 2026 · 01:32Z Build v2.1.319 537 read Stable v2.1.311 Latest v2.1.319 Next v2.1.319 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeDocsClaude Documentation 6 Nov 2026
One change · claude-docs

Installation and setup changedthird-party/claude-desktop/installation

Nearest release: v2.1.319, published 18 hours before upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

Upstream edited this page at 6 Nov 2026 19:19 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 6 Nov 2026 19:37 UTC.

Upstream edited
Recorded here
Lines+17added
Lines−4removed
From line 130 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits39to this page, all time

The whole hunk

from line 130, old and new numbered
/
lines
from line 130
130130 
131131### Cowork workspace or Claude CLI fails to download
132132 
133Claude Desktop downloads the VM workspace bundle that Cowork uses and the Claude CLI binary (the agent helper described under [Endpoint security software](#endpoint-security-software)) from `downloads.claude.ai` whenever a device does not have the versions the app needs. When the workspace download fails or the downloaded file does not pass verification, the app shows **Couldn't download Claude's workspace** or **Failed to start Claude's workspace**, with the download error under it, for example a message that begins "Claude's workspace download was not the expected file", "Claude's workspace download could not be unpacked on this computer", "Checksum mismatch", "Download failed", or "Request error". When the Claude CLI download fails on a device that has no earlier copy, Chat conversations and Cowork tasks fail to start with "Host Claude Code binary not available. Check that the download completed."
133Claude Desktop downloads the VM workspace bundle that Cowork uses and the Claude CLI binary (the agent helper described under [Endpoint security software](#endpoint-security-software)) from `downloads.claude.ai` whenever a device does not have the versions the app needs. A failed download has these signs:
134134 
135Restarting the app tries the download again, which is enough when an earlier attempt was only interrupted. When the same message returns on every attempt, the usual cause is a proxy, secure web gateway, or web filter between the device and `downloads.claude.ai`. Such equipment can block the app's requests, cut off the transfer partway (the workspace bundle is more than 1 GB), or return its own page in place of the file. Less often, security software on the device locks or quarantines the downloaded files.
135* **Workspace**: when the download fails or the downloaded file does not pass verification, the app shows **Couldn't download Claude's workspace** or **Failed to start Claude's workspace**, with the download error under it, for example a message that begins "Claude's workspace download was not the expected file", "Claude's workspace download could not be unpacked on this computer", "Checksum mismatch", "Download failed", or "Request error".
136* **Claude CLI binary, no earlier version on the device**: Chat conversations and Cowork tasks fail to start with "Host Claude Code binary not available. Check that the download completed."
137* **Claude CLI binary, earlier version on the device**: Chat conversations and Cowork tasks still run on that version. The first sign of the failure can be a message in the [claude.ai import wizard](https://claude.com/docs/third-party/claude-desktop/import.md#troubleshoot-an-import-or-export). Don't remove that version. Conversations and tasks need it until the download succeeds.
136138 
139If an earlier attempt was only interrupted, another attempt is enough. To start another attempt, have the user do one of these for the download that failed:
140 
141* **Workspace**: start or open a Cowork task, or click **Retry** on the **Couldn't download Claude's workspace** message. Where Cowork is on, the app also tries this download after a restart, unless [`disableAutoUpdates`](https://claude.com/docs/third-party/claude-desktop/configuration#disableautoupdates) is `true`.
142* **Claude CLI binary**: start a new conversation or task. The app also tries this download after a restart, unless [`isClaudeCodeForDesktopEnabled`](https://claude.com/docs/third-party/claude-desktop/configuration#isclaudecodefordesktopenabled) is `false`, which turns Code off. Claude Desktop 4.23118.0 or later also tries this download when the user clicks **Import** in the import wizard.
143 
144When the same message returns on every attempt, the usual cause is a proxy, secure web gateway, or web filter between the device and `downloads.claude.ai`. Such equipment can block the app's requests, cut off the transfer partway (the workspace bundle is more than 1 GB), or return its own page in place of the file. Less often, security software on the device locks or quarantines the downloaded files.
145 
146To see whether the app reaches `downloads.claude.ai`, generate the [diagnostic report](#troubleshooting) on the device and open `reachability.txt` in the `.zip` file. The line for `downloads.claude.ai` starts with `✗` when the app's request failed and with `✓` when the app got any answer. That answer can come from a proxy. A `✓` doesn't show that files arrive complete.
147 
148Make the change that fits your network:
149 
137150* Allow Claude Desktop itself, not only browsers, to reach `downloads.claude.ai`, as listed under [Required egress paths](https://claude.com/docs/third-party/claude-desktop/telemetry.md#required-egress-paths). The download follows the app's proxy settings, described under [Network proxy](https://claude.com/docs/third-party/claude-desktop/network-proxy.md).
138151* If a proxy or secure web gateway inspects this traffic, make sure files from `downloads.claude.ai` reach the device complete and unchanged.
139152* On a network that cannot allow these downloads, deploy the [offline installer](#offline-installation), which includes both components.
140153 
141Once the device can download from `downloads.claude.ai`, have the user restart Claude Desktop and start a new conversation or task, so that the app downloads what is missing. If the messages persist, generate the diagnostic report described under [Troubleshooting](#troubleshooting) and send it to your Anthropic representative. It includes the errors the app logged for these downloads.
154Once the device can download from `downloads.claude.ai`, have the user restart Claude Desktop and then start another attempt at each download that failed. If the messages persist, generate the diagnostic report described under [Troubleshooting](#troubleshooting) and send it to your Anthropic representative. It includes the errors the app logged for these downloads.
142155 
143156### Windows security policy blocks the Cowork workspace
144157 
Feedback