Troubleshoot installation and login changedtroubleshoot-install
Nearest release: v2.1.322, published 15 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 10 Nov 2026 17:21 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 10 Nov 2026 17:37 UTC.
Upstream edited
Recorded here
Lines+12added
Lines−8removed
From line
25
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits29to this page, all time
The whole hunk
from line 25, old and new numbered
/
from line 25
2525| `EACCES: permission denied` during install | [Fix the install directory's permissions](#permission-errors-during-installation) |
2626| `TLS connect error` or `SSL/TLS secure channel` | [Update CA certificates](#tls-or-ssl-connection-errors) |
2727| `CRYPT_E_NO_REVOCATION_CHECK` or `CRYPT_E_REVOCATION_OFFLINE` | [Work around blocked revocation checks](#tls-or-ssl-connection-errors) |
28| `Failed to fetch version` or can't reach download server | [Check network and proxy settings](#check-network-connectivity) |
28| `Failed to fetch version` or can't reach download server | [Check network and proxy settings](#check-network-connectivity), or for a certificate error, [configure corporate CA certificates](#tls-or-ssl-connection-errors) |
2929| `The connection dropped while downloading the update` or `Download timed out: exceeded the total deadline` | [Run the update again or set your proxy](#the-connection-dropped-while-downloading-the-update) |
3030| `Release verification failed for Claude Code` | [Run `claude update` or `claude install` again](#release-verification-failed) |
3131| `Auto-update failed · Run claude doctor` in red in the session footer | [Run `claude update` from your shell](#auto-update-failed) |
from line 90
9090* `403`: usually a proxy or network filter blocking the host, or Claude Code is [not available in your region](https://www.anthropic.com/supported-countries)
9191* `5xx`: usually a temporary service issue; wait a few minutes and retry
9292
93If you see no output, `Could not resolve host`, or a connection timeout, your network is blocking the connection. Common causes:
93If you see no output, or the installer shows `Could not resolve host` or a connection timeout, the connection failed, so check for these causes:
9494
9595* Corporate firewalls or proxies blocking `downloads.claude.ai`
9696* Regional network restrictions: try a VPN or alternative network
97* TLS/SSL issues: update your system's CA certificates, or check if `HTTPS_PROXY` is configured
97* TLS/SSL issues: see [TLS or SSL connection errors](#tls-or-ssl-connection-errors)
9898
9999If you're behind a corporate proxy, set `HTTPS_PROXY` and `HTTP_PROXY` to your proxy's address before installing. Ask your IT team for the proxy URL if you don't know it, or check your browser's proxy settings.
100100
from line 562
562562 irm https://claude.ai/install.ps1 | iex
563563 ```
564564
5653. **Check for proxy or firewall interference**: corporate proxies that perform TLS inspection can cause these errors, including `unable to get local issuer certificate` and `SELF_SIGNED_CERT_IN_CHAIN`. For the install step, make the install download trust your corporate proxy's CA:
5653. **Check for proxy or firewall interference**: corporate proxies that perform TLS inspection can cause these errors, including `unable to get local issuer certificate`, `unable to verify the first certificate`, and `SELF_SIGNED_CERT_IN_CHAIN`. Make the install download trust your corporate proxy's CA:
566566
567567 > [tab] macOS/Linux
568568 >
569 > Set `CURL_CA_BUNDLE` for the install script's `curl` downloads, and [`NODE_EXTRA_CA_CERTS`](https://code.claude.com/docs/en/network-config#custom-ca-certificates) for the `claude install` command the script then runs. Ask your IT team for a PEM file with your proxy's root CA certificate if you don't have it. This example sets both to your proxy's CA file and runs the script in the same terminal:
570 >
569571 > ```bash theme={null}
570 > curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash
572 > export CURL_CA_BUNDLE=/path/to/corporate-ca.pem
573 > export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
574 > curl -fsSL https://claude.ai/install.sh | bash
571575 > ```
576 >
577 > If the install still fails with one of those certificate errors, ask your IT team for a file with both the public root certificates and your proxy's full CA chain. Then set both variables to that file.
572578
573579 > [tab] Windows PowerShell
574580 >
from line 598
592598 > $env:NODE_EXTRA_CA_CERTS = 'C:\path\to\corporate-ca.pem'
593599 > ```
594600
595 Ask your IT team for the certificate file if you don't have it. You can also try on a direct connection to confirm the proxy is the cause.
596
5976014. **On Windows, work around blocked revocation checks**. The errors `CRYPT_E_NO_REVOCATION_CHECK (0x80092012)` and `CRYPT_E_REVOCATION_OFFLINE (0x80092013)` mean curl reached the server but your network blocks the certificate revocation lookup, which is common behind corporate firewalls. If the failing command is the `curl` that downloads `install.cmd`, rerun it from a Command Prompt with `--ssl-revoke-best-effort` added:
598602 ```batch theme={null}
599603 curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
from line 610
606610
607611### `Failed to fetch version from downloads.claude.ai`
608612
609The installer couldn't reach the download server. This typically means `downloads.claude.ai` is blocked on your network. See [Check network connectivity](#check-network-connectivity).
613The end of the message gives the reason. If it's a certificate error such as `unable to verify the first certificate`, see [TLS or SSL connection errors](#tls-or-ssl-connection-errors). For any other reason, see [Check network connectivity](#check-network-connectivity).
610614
611615### The connection dropped while downloading the update
612616
No line in this hunk matches that.