← Back to daily report
+12 lines added
-8 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 processing¶
* **Shell**: Works best in Bash, Zsh or Fish¶
* **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¶
¶
To install Claude Code, use one of the following methods:¶
¶
<Tabs>¶
<Tab title="Native Install (Recommended)">¶
**macOS, Linux, WSL:**¶
¶
```bash theme={null} theme={null} theme={null}¶
curl -fsSL https://claude.ai/install.sh | bash¶
```¶
¶
**Windows PowerShell:**¶
¶
```powershell theme={null} theme={null} theme={null}¶
irm https://claude.ai/install.ps1 | iex¶
```¶
¶
**Windows CMD:**¶
¶
```batch theme={null} theme={null} theme={null}¶
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd¶
```¶
</Tab>¶
¶
<Tab title="Homebrew">¶
```sh theme={null} theme={null} theme={null}¶
brew install --cask claude-code¶
```¶
</Tab>¶
¶
<Tab title="NPM">¶
If you have [Node.js 18 or newer installed](https://nodejs.org/en/download/):¶
¶
```sh theme={null} theme={null} theme={null}¶
npm install -g @anthropic-ai/claude-code¶
```¶
</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¶
```¶
¶
Claude Code offers the following authentication options:¶
¶
1. **Claude Console**: The default option. Connect through the Claude Console and complete the OAuth process. Requires active billing in the [Anthropic console](https://console.anthropic.com). 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.¶
2. **Claude App (with Pro or Max plan)**: Subscribe to Claude's [Pro or Max plan](https://claude.com/pricing) for a unified subscription that includes both Claude Code and the web interface. Get more value at the same price point while managing your account in one place. Log in with your Claude.ai account. During launch, choose the option that matches your subscription type.¶
3. **Enterprise platforms**: Configure Claude Code to use [Amazon Bedrock, Google Vertex AI, or Microsoft Foundry](/en/third-party-integrations) for enterprise deployments with your existing cloud infrastructure.¶
¶
<Note>¶
Claude Code securely stores your credentials. See [Credential Management](/en/iam#credential-management) for details.¶
</Note>¶
¶
## 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"¶
```¶
¶
## 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¶
¶
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¶
¶
**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¶
```¶
¶
### 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
@@ -23,25 +23,25 @@
<Tab title="Native Install (Recommended)">
**macOS, Linux, WSL:**
- ```bash theme={null}
+ ```bash theme={null} theme={null} theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```
**Windows PowerShell:**
- ```powershell theme={null}
+ ```powershell theme={null} theme={null} theme={null}
irm https://claude.ai/install.ps1 | iex
```
**Windows CMD:**
- ```batch theme={null}
+ ```batch theme={null} theme={null} theme={null}
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```
</Tab>
<Tab title="Homebrew">
- ```sh theme={null}
+ ```sh theme={null} theme={null} theme={null}
brew install --cask claude-code
```
</Tab>
@@ -49,7 +49,7 @@
<Tab title="NPM">
If you have [Node.js 18 or newer installed](https://nodejs.org/en/download/):
- ```sh theme={null}
+ ```sh theme={null} theme={null} theme={null}
npm install -g @anthropic-ai/claude-code
```
</Tab>
@@ -65,16 +65,6 @@
cd your-awesome-project
claude
```
-
-Claude Code offers the following authentication options:
-
-1. **Claude Console**: The default option. Connect through the Claude Console and complete the OAuth process. Requires active billing in the [Anthropic console](https://console.anthropic.com). 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.
-2. **Claude App (with Pro or Max plan)**: Subscribe to Claude's [Pro or Max plan](https://claude.com/pricing) for a unified subscription that includes both Claude Code and the web interface. Get more value at the same price point while managing your account in one place. Log in with your Claude.ai account. During launch, choose the option that matches your subscription type.
-3. **Enterprise platforms**: Configure Claude Code to use [Amazon Bedrock, Google Vertex AI, or Microsoft Foundry](/en/third-party-integrations) for enterprise deployments with your existing cloud infrastructure.
-
-<Note>
- Claude Code securely stores your credentials. See [Credential Management](/en/iam#credential-management) for details.
-</Note>
## Windows setup
@@ -179,6 +169,23 @@
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.