Troubleshoot Claude Science changedclaude-science/troubleshooting
Nearest release: v2.1.301, published 5 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 15 Oct 2026 20:17 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 15 Oct 2026 20:37 UTC.
Upstream edited
Recorded here
Lines+18added
Lines−2removed
From line
50
where the diff opens
First seen
29 Sep 2026
this site's first read of the page
Recorded edits8to this page, all time
### Couldn't check for updates
The whole hunk
from line 50, old and new numbered
/
from line 50
5050* If setup failed because of your organization's network, the dialog that **Details** opens links to settings for a package mirror, a CA bundle, or mirror credentials. When you save any of these settings, Claude Science retries the failed setups automatically. See also [Troubleshooting corporate network errors](/docs/claude-science/corporate-networks#troubleshooting-corporate-network-errors).
5151* To retry the environments that failed, select **Retry builds**.
5252
53If the notice reads "Analysis is unavailable" instead, no Python or R code can run until Claude Science restarts. Fix the cause the notice names, then quit and reopen Claude Science. On Windows, closing the window leaves Claude Science running, so right-click its icon in the notification area of the taskbar and choose **Quit Claude Science**.
53If the notice reads "Analysis is unavailable" instead, no Python or R code can run until Claude Science restarts. Fix the cause the notice names, then quit and reopen Claude Science. Closing the window or browser tab leaves Claude Science running, so quit it this way:
5454
55* **macOS**: Control-click **Claude Science** in the Dock and choose **Quit**.
56* **Windows**: right-click its icon in the notification area of the taskbar and choose **Quit Claude Science**.
57* **Started from a terminal with `claude-science serve`**: run `claude-science stop` in a terminal.
58
5559### failed to load 5 times in a row — automatic retries are paused
5660
5761This message appears in **Settings > Connectors** on a Featured connector marked **Failed** (hold the pointer over **Failed**) and on the connector's own page. The connector runs on your computer and failed to start five times in a row, so Claude Science stopped trying. Turn the connector off and on again in **Settings > Connectors**, or restart Claude Science.
from line 74
7074
7175## Updates
7276
73When an update is ready, Claude Science shows an "Update available" notice. If installing the update fails, that notice shows the error.
77Claude Science shows updates and their errors in these places:
7478
79* **In a browser tab and in the Windows app**: an "Update available" notice appears when an update is ready. If installing the update fails, that notice shows the error.
80* **In its own window on a Mac**: the **Updates** window shows the update and any error. Open it with **Claude Science > Check for App Updates…** in the menu bar.
81
7582### cannot reach the public release endpoint
7683
7784Claude Science couldn't reach the update server. Check your internet connection, then select **Restart to update** on the "Update available" notice to try again, or run `claude-science update` again. On a corporate network, see [Network requirements](/docs/claude-science/network-requirements#app-connections) for the domains Claude Science connects to.
from line 88
8188On the "Update available" notice, this means the new version was downloaded but didn't start. If Claude Science is still running, it's the version you had, and you can try again: select **Check for updates** under **Settings > General > About**, then select **Restart to update** there. If Claude Science has stopped, start it again.
8289
8390On Linux, an update to version 0.1.61 ends this way on a computer where bubblewrap or socat came from conda, Homebrew, or a folder in your home directory, because version 0.1.61 needs both installed for the whole system. Version 0.1.62 withdraws that requirement, so trying again as above now gets a version that starts. If Claude Science won't start at all, run `claude-science update` in a terminal, then start it again.
91
92### Couldn't check for updates
93
94On a Mac where Claude Science opens in its own window, the **Updates** window shows this message when Claude Science couldn't get update information from Anthropic's update server. The same steps apply when it says "Couldn't download the update":
95
96* If the window says to check your internet connection, check it, then select **Try again**.
97* If you cancelled a request from macOS for an administrator's password, select **Try again**.
98* Otherwise, such as when it says "Updates aren't available right now", wait a few minutes, then select **Try again**.
99* On a corporate network, ask your IT team to allow `storage.googleapis.com` (see [Proxy and certificates for updates in the Mac app window](/docs/claude-science/corporate-networks#proxy-and-certificates-for-updates-in-the-mac-app-window)).
84100
No line in this hunk matches that.