← Back to daily report
+21 lines added
-29 lines removed
# Set up Claude Code¶
¶
> Install, authenticate, and start using Claude Code on your development machine.¶
¶
## System requirements¶
¶
* **Operating Systems**: macOS 10.15+, Ubuntu 20.04+/Debian 10+, or Windows 10+ (with WSL 1, WSL 2, or Git for Windows)¶
* **Hardware**: 4 GB+ RAM¶
* **Software**: [Node.js 18+](https://nodejs.org/en/download) (only required for npm installation)¶
* **Network**: Internet connection required for authentication and AI processingNetwork**: Internet connection required (see [network configuration](/en/network-config#network-access-requirements))¶
* **Shell**: Works best in Bash, Zsh or FiZsh¶
* **Location**: [Anthropic supported countries](https://www.anthropic.com/supported-countries)¶
¶
### Additional dependencies¶
¶
* **ripgrep**: Usually included with Claude Code. If search fails, see [search troubleshooting](/en/troubleshooting#search-and-discovery-issues).¶
¶
## Standard i* **[Node.js 18+](https://nodejs.org/en/download)**: Only required for [deprecated npm installation](#npm-installation-deprecated)¶
¶
## Installation¶
¶
To install Claude Code, use one of the following methods:¶
¶
<Tabs>¶
<Tab title="Native Install (Recommended)">¶
**macOS, Linux, WSL:**¶
¶
```bash theme={null}¶
curl -fsSL https://claude.ai/install.sh | bash¶
```¶
¶
**Windows PowerShell:**¶
¶
```powershell theme={null}¶
irm https://claude.ai/install.ps1 | iex¶
```¶
¶
**Windows CMD:**¶
¶
```batch theme={null}¶
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd¶
```¶
</Tab>¶
¶
<Tab title="Homebrew">¶
```sh theme={null}¶
brew install --cask claude-code¶
```¶
</Tab>¶
¶
<Tab title="NPMWinGet">¶
If you have [Node.js 18 or newer installed](https://nodejs.org/en/download/):¶
¶
```sh```powershell theme={null}¶
npmwinget install -g @aAnthropic-ai/c.Claude-cCode¶
```¶
</Tab>¶
</Tabs>¶
¶
<Note>¶
Some users may be automatically migrated to an improved installation method.¶
</Note>¶
¶
After the installation process completes, navigate to your project and start Claude Code:¶
¶
```bash theme={null}¶
cd your-awesome-project¶
claude¶
```¶
¶
## Windows setup¶
¶
**Option 1: Claude Code within WSL**¶
¶
* Both WSL 1 and WSL 2 are supported¶
¶
**Option 2: Claude Code on native Windows with Git Bash**¶
¶
* Requires [Git foIf you encounter any issues during installation, consult the [troubleshooting guide](/en/troubleshooting).¶
¶
<Tip>¶
Run `claude doctor` after installation to check your Windows](https://git-scm.com/downloads/win)¶
* For portable Git installations, specify tstallation type and version.¶
</Tip>¶
¶
<Note>¶
**Alpine Linux and other musl/uClibc-based distributions**: The pnath to your `bash.exe`:¶
```powershell theme={null}¶
$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"¶
```¶
¶
## Alternative installation methods¶
¶
Claude Code offers multiple installation methods to suit different environments.¶
¶
If you encounter any issues during installation, consult the [troubleshooting guide](/en/troubleshooting#linux-permission-issues).¶
¶
<Tip>¶
Run `claude doctor` after installation to check your installation type and version.¶
</Tip>¶
¶
### Native installation options¶
¶
The native installation is the recommended method and offers several benefits:¶
¶
* One self-contained executable¶
* No Node.js dependency¶
* Improved auto-updater staive installer requires `libgcc`, `libstdc++`, and `ripgrep`. For Alpine: `apk add libgcc libstdc++ ripgrep`. Set `USE_BUILTIN_RIPGREP=0`.¶
</Note>¶
¶
### Authentication¶
¶
#### For individuals¶
¶
1. **Claude Pro or Max plan** (recommended): Subscribe to Claude's [Pro or Max plan](https://claude.ai/pricing) for a unified subscription that includes both Claude Code and Claude on the web. Manage your account in one place and log in with your Claude.ai account.¶
2. **Claude Console**: Connect through the [Claude Console](https://console.anthropic.com) and complete the OAuth process. Requires active billing in the Anthropic Console. A "Claude Code" workspace is automatically created for usage tracking and cost management. You can't create API keys for the Claude Code workspace; it's dedicated exclusively for Claude Code usage.¶
¶
#### For teams and organizations¶
¶
1. **Claude for Teams or Enterprise** (recommended): Subscribe to [Claude for Teams](https://claude.com/pricing#team-&-enterprise) or [Claude for Enterprise](https://anthropic.com/contact-sales) for centralized billing, team management, and access to both Claude Code and Claude on the web. Team members log in with their Claude.ai accounts.¶
2. **Claude Console with team billity¶
¶
If you have an existing installation ofng**: Set up a shared [Claude Console](https://console.anthropic.com) organization with team billing. Invite team members and assign roles for usage tracking.¶
3. **Cloud providers**: Configure Claude Code, to use `claude install` to migrate to the native binary installat[Amazon Bedrock, Google Vertex AI, or Microsoft Foundry](/en/third-party-integrations) for deployments with your existing cloud infrastructure.¶
¶
### Install a specific version.¶
¶
For advanced installation optionsTo install a specific version of Claude Code with the native installer:¶
¶
**macOS, Linux, WSL:**¶
¶
```bash theme={null}¶
# Install stable version (default)¶
curl -fsSL https://claude.ai/install.sh | bash¶
¶
# Install latest version¶
curl -fsSL https://claude.ai/install.sh | bash -s latest¶
¶
# Install specific version number¶
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58¶
```¶
¶
<Note>¶
**Alpine Linux and other musl/uClibc-based distributions**: The native build requires `libgcc`, `libstdc++`, and `ripgrep`. For Alpine: `apk add libgcc libstdc++ ripgrep`. Set `USE_BUILTIN_RIPGREP=0`.¶
</Note>¶
¶
**Windows PowerShell:**¶
¶
```powershell theme={null}¶
# Install stable version (default)¶
irm https://claude.ai/install.ps1 | iex¶
¶
# Install latest version¶
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest¶
¶
# Install specific version number¶
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58¶
```¶
¶
**Windows CMD:**¶
¶
```batch theme={null}¶
REM Install stable version (default)¶
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd¶
¶
REM Install latest version¶
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd¶
¶
REM Install specific version number¶
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd¶
```¶
¶
<Tip>¶
Make sure that you remove any outdated aliases or symlinks before installing.¶
</Tip>¶
¶
**### Binary integrity and code signing**¶
¶
* SHA256 checksums for all platforms are published in the release manifests, currently located at `https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/{VERSION}/manifest.json` (example: replace `{VERSION}` with `2.0.30`)¶
* Signed binaries are distributed for the following platforms:¶
* macOS: Signed by "Anthropic PBC" and notarized by Apple¶
* Windows: Signed by "Anthropic, PBC"¶
¶
### NPM installation¶
¶
For environments where NPM is preferred or required: (deprecated)¶
¶
NPM installation is deprecated. Use the [native installation](#installation) method when possible. To migrate an existing npm installation to native, run `claude install`.¶
¶
**Global npm installation**¶
¶
```sh theme={null}¶
npm install -g @anthropic-ai/claude-code¶
```¶
¶
<Warning>¶
Do NOT use `sudo npm install -g` as this can lead to permission issues and security risks.¶
If you encounter permission errors, see [configure Claude Code](/en/troubleshooting#linux-permission-issues) for recommended solutions.¶
</Warning>¶
¶
## Authentication options¶
¶
### For individuals¶
¶
1. **Claude Pro or Max plan** (recommended): Subscribe to Claude's [Pro or Max plan](https://claude.ai/pricing) for a unified subscription that includes both Claude Code and Claude on the web. Manage your account in one place and log in with your Claude.ai account.¶
2. **Claude Console**: Connect through the [Claude Console](https://console.anthropic.com) and complete the OAuth process. Requires active billing in the Anthropic Console. A "Claude Code" workspace is automatically created for usage tracking and cost management. You can't create API keys for the Claude Code workspace; it's dedicated exclusively for Claude Code usage.¶
¶
### For teams and organizations¶
¶
1. **Claude for Teams or Enterprise** (recommended): Subscribe to [Claude for Teams](https://claude.com/pricing#team-&-enterprise) or [Claude for Enterprise](https://anthropic.com/contact-sales) for centralized billing, team management, and access to both Claude Code and Claude on the web. Team members log in with their Claude.ai accounts.¶
2. **Claude Console with team billing**: Set up a shared [Claude Console](https://console.anthropic.com) organization with team billing. Invite team members and assign roles for usage tracking.¶
3. **Cloud providers**: Configure Claude Code to use [Amazon Bedrock, Google Vertex AI, or Microsoft Foundry](/en/third-party-integrations) for deployments with your existing cloud infrastructure.¶
¶
<Note>¶
Claude Code securely stores your credentials. See [Credential Management](/en/iam#credential-management) for details.¶
</Note>¶
¶
## Running on AWS or GCP¶
¶
By default, Claude Code uses the Claude API.¶
¶
For details on running Claude Code on AWS or GCP, see [third-party integrations](/en/third-party-integrations).Windows setup¶
¶
**Option 1: Claude Code within WSL**¶
¶
* Both WSL 1 and WSL 2 are supported¶
¶
**Option 2: Claude Code on native Windows with Git Bash**¶
¶
* Requires [Git for Windows](https://git-scm.com/downloads/win)¶
* For portable Git installations, specify the path to your `bash.exe`:¶
```powershell theme={null}¶
$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"¶
```¶
¶
## Update Claude Code¶
¶
### Auto updates¶
¶
Claude Code automatically keeps itself up to date to ensure you have the latest features and security fixes.¶
¶
* **Update checks**: Performed on startup and periodically while running¶
* **Update process**: Downloads and installs automatically in the background¶
* **Notifications**: You'll see a notification when updates are installed¶
* **Applying updates**: Updates take effect the next time you start Claude Code¶
¶
<Note>¶
Homebrew and WinGet installations do not auto-update. Use `brew upgrade claude-code` or `winget upgrade Anthropic.ClaudeCode` to update manually.¶
¶
**Known issue:** Claude Code may notify you of updates before the new version is available in these package managers. If an upgrade fails, wait and try again later.¶
</Note>¶
¶
**Disable auto-updates:**¶
¶
Set the `DISABLE_AUTOUPDATER` environment variable in your shell or [settings.json file](/en/settings):¶
¶
```bash theme={null}¶
export DISABLE_AUTOUPDATER=1¶
```¶
¶
### Update manually¶
¶
```bash theme={null}¶
claude update¶
```¶
¶
## Uninstall Claude Code¶
¶
If you need to uninstall Claude Code, follow the instructions for your installation method.¶
¶
### Native installation¶
¶
Remove the Claude Code binary and version files:¶
¶
**macOS, Linux, WSL:**¶
¶
```bash theme={null}¶
rm -f ~/.local/bin/claude¶
rm -rf ~/.local/share/claude¶
```¶
¶
**Windows PowerShell:**¶
¶
```powershell theme={null}¶
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force¶
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force¶
```¶
¶
**Windows CMD:**¶
¶
```batch theme={null}¶
del "%USERPROFILE%\.local\bin\claude.exe"¶
rmdir /s /q "%USERPROFILE%\.local\share\claude"¶
```¶
¶
### Homebrew installation¶
¶
```bash theme={null}¶
brew uninstall --cask claude-code¶
```¶
¶
### WinGet installation¶
¶
```powershell theme={null}¶
winget uninstall Anthropic.ClaudeCode¶
```¶
¶
### NPM installation¶
¶
```bash theme={null}¶
npm uninstall -g @anthropic-ai/claude-code¶
```¶
¶
### Clean up configuration files (optional)¶
¶
<Warning>¶
Removing configuration files will delete all your settings, allowed tools, MCP server configurations, and session history.¶
</Warning>¶
¶
To remove Claude Code settings and cached data:¶
¶
**macOS, Linux, WSL:**¶
¶
```bash theme={null}¶
# Remove user settings and state¶
rm -rf ~/.claude¶
rm ~/.claude.json¶
¶
# Remove project-specific settings (run from your project directory)¶
rm -rf .claude¶
rm -f .mcp.json¶
```¶
¶
**Windows PowerShell:**¶
¶
```powershell theme={null}¶
# Remove user settings and state¶
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force¶
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force¶
¶
# Remove project-specific settings (run from your project directory)¶
Remove-Item -Path ".claude" -Recurse -Force¶
Remove-Item -Path ".mcp.json" -Force¶
```¶
¶
**Windows CMD:**¶
¶
```batch theme={null}¶
REM Remove user settings and state¶
rmdir /s /q "%USERPROFILE%\.claude"¶
del "%USERPROFILE%\.claude.json"¶
¶
REM Remove project-specific settings (run from your project directory)¶
rmdir /s /q ".claude"¶
del ".mcp.json"¶
```¶
¶
¶
---¶
¶
> To find navigation and other pages in this documentation, fetch the llms.txt file at: https://code.claude.com/docs/llms.txt
Unified Diff
--- a/setup.md
+++ b/setup.md
@@ -6,16 +6,16 @@
* **Operating Systems**: macOS 10.15+, Ubuntu 20.04+/Debian 10+, or Windows 10+ (with WSL 1, WSL 2, or Git for Windows)
* **Hardware**: 4 GB+ RAM
-* **Software**: [Node.js 18+](https://nodejs.org/en/download) (only required for npm installation)
-* **Network**: Internet connection required for authentication and AI processing
-* **Shell**: Works best in Bash, Zsh or Fish
+* **Network**: Internet connection required (see [network configuration](/en/network-config#network-access-requirements))
+* **Shell**: Works best in Bash or Zsh
* **Location**: [Anthropic supported countries](https://www.anthropic.com/supported-countries)
### Additional dependencies
* **ripgrep**: Usually included with Claude Code. If search fails, see [search troubleshooting](/en/troubleshooting#search-and-discovery-issues).
-
-## Standard installation
+* **[Node.js 18+](https://nodejs.org/en/download)**: Only required for [deprecated npm installation](#npm-installation-deprecated)
+
+## Installation
To install Claude Code, use one of the following methods:
@@ -46,25 +46,107 @@
```
</Tab>
- <Tab title="NPM">
- If you have [Node.js 18 or newer installed](https://nodejs.org/en/download/):
-
- ```sh theme={null}
- npm install -g @anthropic-ai/claude-code
+ <Tab title="WinGet">
+ ```powershell theme={null}
+ winget install Anthropic.ClaudeCode
```
</Tab>
</Tabs>
-<Note>
- Some users may be automatically migrated to an improved installation method.
-</Note>
-
After the installation process completes, navigate to your project and start Claude Code:
```bash theme={null}
cd your-awesome-project
claude
```
+
+If you encounter any issues during installation, consult the [troubleshooting guide](/en/troubleshooting).
+
+<Tip>
+ Run `claude doctor` after installation to check your installation type and version.
+</Tip>
+
+<Note>
+ **Alpine Linux and other musl/uClibc-based distributions**: The native installer requires `libgcc`, `libstdc++`, and `ripgrep`. For Alpine: `apk add libgcc libstdc++ ripgrep`. Set `USE_BUILTIN_RIPGREP=0`.
+</Note>
+
+### Authentication
+
+#### For individuals
+
+1. **Claude Pro or Max plan** (recommended): Subscribe to Claude's [Pro or Max plan](https://claude.ai/pricing) for a unified subscription that includes both Claude Code and Claude on the web. Manage your account in one place and log in with your Claude.ai account.
+2. **Claude Console**: Connect through the [Claude Console](https://console.anthropic.com) and complete the OAuth process. Requires active billing in the Anthropic Console. A "Claude Code" workspace is automatically created for usage tracking and cost management. You can't create API keys for the Claude Code workspace; it's dedicated exclusively for Claude Code usage.
+
+#### For teams and organizations
+
+1. **Claude for Teams or Enterprise** (recommended): Subscribe to [Claude for Teams](https://claude.com/pricing#team-&-enterprise) or [Claude for Enterprise](https://anthropic.com/contact-sales) for centralized billing, team management, and access to both Claude Code and Claude on the web. Team members log in with their Claude.ai accounts.
+2. **Claude Console with team billing**: Set up a shared [Claude Console](https://console.anthropic.com) organization with team billing. Invite team members and assign roles for usage tracking.
+3. **Cloud providers**: Configure Claude Code to use [Amazon Bedrock, Google Vertex AI, or Microsoft Foundry](/en/third-party-integrations) for deployments with your existing cloud infrastructure.
+
+### Install a specific version
+
+To install a specific version of Claude Code with the native installer:
+
+**macOS, Linux, WSL:**
+
+```bash theme={null}
+# Install stable version (default)
+curl -fsSL https://claude.ai/install.sh | bash
+
+# Install latest version
+curl -fsSL https://claude.ai/install.sh | bash -s latest
+
+# Install specific version number
+curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
+```
+
+**Windows PowerShell:**
+
+```powershell theme={null}
+# Install stable version (default)
+irm https://claude.ai/install.ps1 | iex
+
+# Install latest version
+& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest
+
+# Install specific version number
+& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58
+```
+
+**Windows CMD:**
+
+```batch theme={null}
+REM Install stable version (default)
+curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
+
+REM Install latest version
+curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd
+
+REM Install specific version number
+curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd
+```
+
+### Binary integrity and code signing
+
+* SHA256 checksums for all platforms are published in the release manifests, currently located at `https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/{VERSION}/manifest.json` (example: replace `{VERSION}` with `2.0.30`)
+* Signed binaries are distributed for the following platforms:
+ * macOS: Signed by "Anthropic PBC" and notarized by Apple
+ * Windows: Signed by "Anthropic, PBC"
+
+## NPM installation (deprecated)
+
+NPM installation is deprecated. Use the [native installation](#installation) method when possible. To migrate an existing npm installation to native, run `claude install`.
+
+**Global npm installation**
+
+```sh theme={null}
+npm install -g @anthropic-ai/claude-code
+```
+
+<Warning>
+ Do NOT use `sudo npm install -g` as this can lead to permission issues and security risks.
+ If you encounter permission errors, see [configure Claude Code](/en/troubleshooting#linux-permission-issues) for recommended solutions.
+</Warning>
## Windows setup
@@ -80,118 +162,6 @@
$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
```
-## Alternative installation methods
-
-Claude Code offers multiple installation methods to suit different environments.
-
-If you encounter any issues during installation, consult the [troubleshooting guide](/en/troubleshooting#linux-permission-issues).
-
-<Tip>
- Run `claude doctor` after installation to check your installation type and version.
-</Tip>
-
-### Native installation options
-
-The native installation is the recommended method and offers several benefits:
-
-* One self-contained executable
-* No Node.js dependency
-* Improved auto-updater stability
-
-If you have an existing installation of Claude Code, use `claude install` to migrate to the native binary installation.
-
-For advanced installation options with the native installer:
-
-**macOS, Linux, WSL:**
-
-```bash theme={null}
-# Install stable version (default)
-curl -fsSL https://claude.ai/install.sh | bash
-
-# Install latest version
-curl -fsSL https://claude.ai/install.sh | bash -s latest
-
-# Install specific version number
-curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
-```
-
-<Note>
- **Alpine Linux and other musl/uClibc-based distributions**: The native build requires `libgcc`, `libstdc++`, and `ripgrep`. For Alpine: `apk add libgcc libstdc++ ripgrep`. Set `USE_BUILTIN_RIPGREP=0`.
-</Note>
-
-**Windows PowerShell:**
-
-```powershell theme={null}
-# Install stable version (default)
-irm https://claude.ai/install.ps1 | iex
-
-# Install latest version
-& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest
-
-# Install specific version number
-& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58
-```
-
-**Windows CMD:**
-
-```batch theme={null}
-REM Install stable version (default)
-curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
-
-REM Install latest version
-curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd
-
-REM Install specific version number
-curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd
-```
-
-<Tip>
- Make sure that you remove any outdated aliases or symlinks before installing.
-</Tip>
-
-**Binary integrity and code signing**
-
-* SHA256 checksums for all platforms are published in the release manifests, currently located at `https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/{VERSION}/manifest.json` (example: replace `{VERSION}` with `2.0.30`)
-* Signed binaries are distributed for the following platforms:
- * macOS: Signed by "Anthropic PBC" and notarized by Apple
- * Windows: Signed by "Anthropic, PBC"
-
-### NPM installation
-
-For environments where NPM is preferred or required:
-
-```sh theme={null}
-npm install -g @anthropic-ai/claude-code
-```
-
-<Warning>
- Do NOT use `sudo npm install -g` as this can lead to permission issues and security risks.
- If you encounter permission errors, see [configure Claude Code](/en/troubleshooting#linux-permission-issues) for recommended solutions.
-</Warning>
-
-## Authentication options
-
-### For individuals
-
-1. **Claude Pro or Max plan** (recommended): Subscribe to Claude's [Pro or Max plan](https://claude.ai/pricing) for a unified subscription that includes both Claude Code and Claude on the web. Manage your account in one place and log in with your Claude.ai account.
-2. **Claude Console**: Connect through the [Claude Console](https://console.anthropic.com) and complete the OAuth process. Requires active billing in the Anthropic Console. A "Claude Code" workspace is automatically created for usage tracking and cost management. You can't create API keys for the Claude Code workspace; it's dedicated exclusively for Claude Code usage.
-
-### For teams and organizations
-
-1. **Claude for Teams or Enterprise** (recommended): Subscribe to [Claude for Teams](https://claude.com/pricing#team-&-enterprise) or [Claude for Enterprise](https://anthropic.com/contact-sales) for centralized billing, team management, and access to both Claude Code and Claude on the web. Team members log in with their Claude.ai accounts.
-2. **Claude Console with team billing**: Set up a shared [Claude Console](https://console.anthropic.com) organization with team billing. Invite team members and assign roles for usage tracking.
-3. **Cloud providers**: Configure Claude Code to use [Amazon Bedrock, Google Vertex AI, or Microsoft Foundry](/en/third-party-integrations) for deployments with your existing cloud infrastructure.
-
-<Note>
- Claude Code securely stores your credentials. See [Credential Management](/en/iam#credential-management) for details.
-</Note>
-
-## Running on AWS or GCP
-
-By default, Claude Code uses the Claude API.
-
-For details on running Claude Code on AWS or GCP, see [third-party integrations](/en/third-party-integrations).
-
## Update Claude Code
### Auto updates
@@ -203,6 +173,12 @@
* **Notifications**: You'll see a notification when updates are installed
* **Applying updates**: Updates take effect the next time you start Claude Code
+<Note>
+ Homebrew and WinGet installations do not auto-update. Use `brew upgrade claude-code` or `winget upgrade Anthropic.ClaudeCode` to update manually.
+
+ **Known issue:** Claude Code may notify you of updates before the new version is available in these package managers. If an upgrade fails, wait and try again later.
+</Note>
+
**Disable auto-updates:**
Set the `DISABLE_AUTOUPDATER` environment variable in your shell or [settings.json file](/en/settings):
@@ -250,6 +226,12 @@
```bash theme={null}
brew uninstall --cask claude-code
+```
+
+### WinGet installation
+
+```powershell theme={null}
+winget uninstall Anthropic.ClaudeCode
```
### NPM installation