Claude Code Complete Installation Guide¶

# Via Homebrew (recommended)
brew install node

# Or official installer
# Download from https://nodejs.org

# Verify versions
node --version  # v18.0.0 or later
npm --version   # 9.0.0 or later

# Global installation
npm install -g @anthropic-ai/claude-code

# Verify installation
claude --version

# Navigate to project directory
cd /path/to/your/project

# Launch Claude Code
claude

# Verify Xcode command line tools
xcode-select --install

# Fix Homebrew permissions (if needed)
sudo chown -R $(whoami) $(brew --prefix)/*

# Install Node.js 18.x
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# Install dependencies
sudo apt-get update
sudo apt-get install -y build-essential curl git

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

# Install Node.js
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo yum install -y nodejs npm

# Install development tools
sudo yum groupinstall -y "Development Tools"

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

# Configure npm permissions (avoid sudo)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# Increase file watch limits (for large projects)
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

# Run PowerShell as Administrator
wsl --install

# Install Ubuntu
wsl --install -d Ubuntu

# After restart, launch Ubuntu
wsl

# Follow Linux instructions within WSL2
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

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

# Configure WSL2 memory limits
# Create %USERPROFILE%\.wslconfig file
echo "[wsl2]
memory=8GB
processors=4" > /mnt/c/Users/$(whoami)/.wslconfig

# Work in Linux filesystem (recommended)
cd ~  # Use Linux home instead of Windows /mnt/c/

# Method 1: Environment variable (recommended)
export ANTHROPIC_API_KEY="your-api-key-here"
echo 'export ANTHROPIC_API_KEY="your-key"' >> ~/.bashrc

# Method 2: Set during Claude startup
claude auth login

# Method 3: Configuration file
mkdir -p ~/.config/claude
echo "api_key: your-api-key-here" > ~/.config/claude/config.yaml

# Launch Claude Code
claude

# Test with prompt
"Hello, Claude! Tell me about the system information"

# Test file operations
claude "Check the contents of package.json"

# Test with large project
cd /path/to/large/project
claude "Analyze project structure and report issues"

# Measure response time (expected: 2-5 seconds)
time claude "Create a simple Hello World script"

# Permission errors
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

# Network errors
npm config set registry https://registry.npmjs.org/
npm cache clean --force

# Node.js version errors
nvm install 18  # if using nvm
nvm use 18

# Check PATH configuration
echo $PATH | grep npm

# Check config file permissions
ls -la ~/.config/claude/

# Check log files
cat ~/.claude/logs/debug.log

# Test connection
curl -H "x-api-key: your-key" https://api.anthropic.com/v1/models

# Proxy configuration (corporate environments)
export HTTPS_PROXY=http://proxy.company.com:8080
export HTTP_PROXY=http://proxy.company.com:8080

# Create CLAUDE.md file
cat > CLAUDE.md << 'EOF'
# Project Configuration

## Development Environment
- Node.js 18+
- TypeScript
- React

## Coding Standards
- ESLint/Prettier compliant
- Tests required
- Security-focused

## Common Commands
- Development: npm run dev
- Testing: npm test
- Build: npm run build
EOF

# Enable cloud caching
claude config set cache.enabled true

# Adjust parallel processing
claude config set max_concurrent_requests 3

# Optimize response time
claude config set timeout 30