# Claude Code Installer for Windows

A colorized, interactive PowerShell installer script that automates the installation of [Claude Code](https://docs.anthropic.com/en/docs/claude-code) on Windows systems.

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Platform](https://img.shields.io/badge/platform-Windows-0078D6.svg)
![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-green.svg)
![PowerShell](https://img.shields.io/badge/PowerShell-%3E%3D5.1-blue.svg)

---

## Quick Install

**One-line installation (Run in PowerShell as Administrator):**

```powershell
irm https://git.bitmaster.cc/BitMaster/claude/raw/branch/main/claude-code-installer.ps1 | iex
```

**Or with full command:**

```powershell
Invoke-RestMethod https://git.bitmaster.cc/BitMaster/claude/raw/branch/main/claude-code-installer.ps1 | Invoke-Expression
```

> ⚠️ **Note:** You may need to run PowerShell as Administrator for the installation to complete successfully.

---

## Manual Installation

**Step 1:** Download the installer script

```powershell
Invoke-WebRequest -Uri "https://git.bitmaster.cc/BitMaster/claude/raw/branch/main/claude-code-installer.ps1" -OutFile "claude-code-installer.ps1"
```

**Step 2:** Allow script execution (if needed)

```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

**Step 3:** Run the installer

```powershell
.\claude-code-installer.ps1
```

---

## Features

### 🔍 System Detection

| Feature | Description |
|---------|-------------|
| **Windows Detection** | Identifies Windows version and build number |
| **Architecture** | Detects x64, x86, or ARM64 for correct Node.js download |
| **System Info** | Shows computer name, RAM, and PowerShell version |
| **Admin Check** | Verifies if running with Administrator privileges |

### 📦 Node.js Management

| Feature | Description |
|---------|-------------|
| **Version Check** | Checks if Node.js/npm are installed and their versions |
| **Compatibility** | Detects if the version is compatible (v18+ required) |
| **Clean Removal** | Uninstalls existing Node.js via Windows installer |
| **Fresh Install** | Downloads and installs Node.js 20 LTS from nodejs.org |
| **Verification** | Verifies installation after completion |

### 🛡️ Permission Modes

When the installation completes, you'll be prompted to choose how Claude Code runs:

| Mode | Flag | Description |
|------|------|-------------|
| **1. Normal Mode** | *(default)* | Asks before each operation — **safest option** |
| **2. Auto-Accept Edits** | `--auto-accept-edits` | Auto-accepts file changes, confirms commands |
| **3. Full Auto Mode** | `--dangerously-skip-permissions` | Skips all prompts — **use with caution!** |
| **4. Exit** | — | Don't start Claude, just complete installation |

---

## System Requirements

| Requirement | Minimum |
|-------------|---------|
| **Operating System** | Windows 10 / Windows 11 / Windows Server 2016+ |
| **PowerShell** | Version 5.1 or later |
| **Architecture** | x64, x86, or ARM64 |
| **Permissions** | Administrator recommended |
| **Internet** | Required for downloading packages |

---

## What Gets Installed

1. **Node.js 20 LTS** — JavaScript runtime (if not already installed or outdated)
2. **npm** — Node package manager (comes with Node.js)
3. **Claude Code** — Anthropic's CLI tool for AI-assisted coding

### Installation Paths

| Component | Default Location |
|-----------|------------------|
| Node.js | `C:\Program Files\nodejs\` |
| npm global packages | `%APPDATA%\npm\` |
| npm cache | `%APPDATA%\npm-cache\` |
| Claude Code | `%APPDATA%\npm\claude.cmd` |

---

## Post-Installation

After installation, you can start Claude Code anytime:

**Command Prompt or PowerShell:**

```cmd
# Normal mode (recommended)
claude

# Auto-accept file edits
claude --auto-accept-edits

# Full auto mode (dangerous)
claude --dangerously-skip-permissions
```

If the `claude` command is not recognized, restart your terminal or open a new PowerShell/Command Prompt window.

---

## Troubleshooting

### "claude" is not recognized

**Solution 1:** Restart your terminal (PowerShell/Command Prompt)

**Solution 2:** Refresh environment variables

```powershell
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
```

**Solution 3:** Manually add npm to PATH

```powershell
$env:Path += ";$env:APPDATA\npm"
```

### Execution Policy Error

If you see "cannot be loaded because running scripts is disabled":

```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

### Permission Denied / Access Denied

Run PowerShell as Administrator:

1. Right-click on PowerShell
2. Select "Run as administrator"
3. Run the installer again

### Node.js Installation Fails

**Option 1:** Download and install manually from [nodejs.org](https://nodejs.org/)

**Option 2:** Use winget (Windows Package Manager):

```powershell
winget install OpenJS.NodeJS.LTS
```

**Option 3:** Use Chocolatey:

```powershell
choco install nodejs-lts
```

### npm Install Fails

Clear npm cache and retry:

```powershell
npm cache clean --force
npm install -g @anthropic-ai/claude-code
```

---

## Uninstallation

### Remove Claude Code

```powershell
npm uninstall -g @anthropic-ai/claude-code
```

### Remove Node.js

**Option 1:** Via Windows Settings
1. Open Settings → Apps → Installed apps
2. Search for "Node.js"
3. Click Uninstall

**Option 2:** Via Control Panel
1. Open Control Panel → Programs → Uninstall a program
2. Find "Node.js"
3. Click Uninstall

**Option 3:** Via PowerShell

```powershell
# Find and uninstall Node.js
Get-Package -Name "*Node*" | Uninstall-Package
```

### Clean Up Remaining Files

```powershell
# Remove npm cache and global packages
Remove-Item -Recurse -Force "$env:APPDATA\npm" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:APPDATA\npm-cache" -ErrorAction SilentlyContinue
```

---

## Alternative Installation Methods

### Using winget (Windows Package Manager)

```powershell
# Install Node.js
winget install OpenJS.NodeJS.LTS

# Install Claude Code
npm install -g @anthropic-ai/claude-code
```

### Using Chocolatey

```powershell
# Install Chocolatey (if not installed)
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

# Install Node.js
choco install nodejs-lts

# Install Claude Code
npm install -g @anthropic-ai/claude-code
```

### Using Scoop

```powershell
# Install Scoop (if not installed)
irm get.scoop.sh | iex

# Install Node.js
scoop install nodejs-lts

# Install Claude Code
npm install -g @anthropic-ai/claude-code
```

---

## License

This installer script is provided under the MIT License.

Claude Code is a product of [Anthropic](https://www.anthropic.com/).

---

## Links

- [Claude Code Documentation](https://docs.anthropic.com/en/docs/claude-code)
- [Anthropic](https://www.anthropic.com/)
- [Node.js](https://nodejs.org/)
- [Node.js Downloads](https://nodejs.org/en/download/)

---

## Contributing

Issues and pull requests are welcome at:

**https://git.bitmaster.cc/BitMaster/claude**

---

<p align="center">
  <sub>Made with ❤️ for the Claude community</sub>
</p>