One change
Troubleshoot installation and login
troubleshoot-install
Nearest release: v2.1.233, published under an hour before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
troubleshoot-install Changed · +1 / -38 lines
from line 501
### `Failed to fetch version from downloads.claude.ai` -The installer couldn't reach the download server. This typically means `downloads.claude.ai` is blocked on your network. +The 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). -**Solutions:** - -1. **Test connectivity directly**: - - ```bash theme={null} - curl -sI https://downloads.claude.ai/claude-code-releases/latest - ``` - - An `HTTP/2 200` line means the server is reachable. Other results point to the cause: - - * `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) - * `5xx`: usually a temporary service issue; wait a few minutes and retry - -2. **If behind a proxy**, set `HTTPS_PROXY` so the installer can route through it. See [proxy configuration](/docs/en/network-config#proxy-configuration) for details. - ```bash theme={null} - export HTTPS_PROXY=http://proxy.example.com:8080 - curl -fsSL https://claude.ai/install.sh | bash - ``` - -3. **If on a restricted network**, try a different network or VPN, or use an alternative install method: - - On macOS: - - ```bash theme={null} - brew install --cask claude-code - ``` - - On Windows: - - ```powershell theme={null} - winget install Anthropic.ClaudeCode - ``` - - Then run `claude --version` to confirm: the command prints a version number such as `2.1.211 (Claude Code)`. If the shell reports `claude` isn't found, open a new terminal window and retry: the session you installed from keeps its old `PATH`. - ### Wrong install command on Windows If you see `'irm' is not recognized`, `The token '&&' is not valid`, `A parameter cannot be found that matches parameter name 'fsSL'`, or `'bash' is not recognized as the name of a cmdlet`, you copied the install command for a different shell or operating system. If the command prints the script's text instead of installing anything, you ran only part of it.
from line 594
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory. Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again. ``` - -Before v2.1.200, the script exited with only the shell's bare `Killed` line and no explanation. Installing needs roughly 512 MB of free memory, and running Claude Code needs more. See the [system requirements](/docs/en/setup#system-requirements).