Windows Installation Guide

Follow this tutorial to easily install and use Claude Code on your Windows PC.

We offer two installation methods:

Method 1: One-click Script Installation (Recommended)

Use our one-click installation script to quickly complete all configuration.

Run the Installation Script

1. Run PowerShell as Administrator
2. Execute the following command:

irm https://academy.claude-code.club/assets/getting-started/installation/claude-code-installation-by-cc-club.ps1 | iex

The script will automatically perform the following actions:

• Detect and install Git Bash (if not installed)
• Detect and install Node.js (if not installed)
• Install Claude Code
• Configure environment variables

Method 2: Manual Installation

If you prefer full control over the installation process, follow the steps below to install manually.

1. Install Node.js

Claude Code requires a Node.js environment to run.

Windows Installation Methods

Method 1: Download from the official website (Recommended)

1. Open a browser and go to https://nodejs.org/
2. Click the “LTS” version to download (the long-term support version is recommended)
3. After downloading, double-click the .msi file
4. Follow the installation wizard to complete the installation, keeping the default settings

Method 2: Use a package manager

If you have Chocolatey or Scoop installed, you can install via the command line:

# Using Chocolatey
choco install nodejs
 
# Or using Scoop
scoop install nodejs

Verify the Installation

After installation, open PowerShell or CMD and enter the following commands:

node --version
npm --version

If version numbers are displayed, the installation was successful!

2. Install Claude Code

Install Claude Code

Open PowerShell or CMD and run the following command:

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

This command downloads and installs the latest version of Claude Code from the official npm registry.

Verify the Claude Code Installation

After installation, enter the following command to check if it was installed successfully:

claude --version

If a version number is displayed, congratulations! Claude Code has been successfully installed.

3. Set Environment Variables

Configure Claude Code Environment Variables

To connect Claude Code to your relay service, you need to set two environment variables.

Run the following commands in PowerShell to set user-level environment variables (execute one at a time):

# Set user-level environment variables (permanent)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://claude-code.club/api", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-api-key", "User")
[System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")

After setting, use the following commands to verify the environment variables were set successfully (execute one at a time):

# View the set environment variables
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")
[System.Environment]::GetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "User")

VSCode Claude Extension Configuration

If you use the Claude extension for VSCode, you need to configure the settings file:

Config file location: C:\Users\<your-username>\.claude\config.json

{
  "primaryApiKey": "crs"
}

cat ~\.claude\config.json

Verify Environment Variables

After setting the environment variables, you can verify them with the following commands:

Verify in PowerShell:

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

Verify in CMD:

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%

Expected output example:

https://claude-code.club/api
cr_xxxxxxxxxxxxxxxxxx

Verify and Use

Verify the Installation

After installation is complete, reopen PowerShell and run:

claude --version

If a version number is displayed, the installation was successful!

Start Using Claude Code

Now you can start using Claude Code!

Launch Claude Code

claude

Use in a Specific Project

# Navigate to your project directory
cd C:\path\to\your\project
 
# Launch Claude Code
claude

🎉 Congratulations! You have successfully installed and configured Claude Code. You can now start enjoying the convenience of an AI coding assistant.

Next Steps

Windows FAQ

SyntaxError: Unexpected token ’{’ Error

If you see an error like the following when running claude:

SyntaxError: Unexpected token '{'
    at Loader.moduleStrategy (node:internal/modules/esm/translators:147:18)

Cause: Node.js version is too old. Claude Code requires Node.js 18.x or higher.

Solution:

1. Check the current version: node --version
2. If the version is below v18, upgrade Node.js:
   • Visit https://nodejs.org/ to download the latest LTS version
   • Or use winget: winget install OpenJS.NodeJS
3. After upgrading, reopen PowerShell and verify: node --version
4. Re-run the installation script or npm install -g @anthropic-ai/claude-code

For detailed instructions, see: SyntaxError Fix

”permission denied” Error During Installation

Run PowerShell or CMD as Administrator.

PowerShell Execution Policy Error

If you encounter an execution policy restriction, run:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Environment Variables Not Taking Effect After Setting

After setting permanent environment variables, you need to:

• Restart PowerShell or CMD
• Or log out and log back in to Windows
• Verify the setting: echo $env:ANTHROPIC_BASE_URL

Need Help?

If you run into any tricky installation issues, scan the QR code below to join the Claude Code Club community group. There you can:

• Exchange AI programming experience and get answers from 3000+ excellent developers
• Get the latest Claude Code tips and tricks