auto-claude-setup

Complete Auto-Claude installation and setup guide for all platforms. Use when installing Auto-Claude on WSL, Windows, Linux, or macOS, setting up development environment, or troubleshooting installation issues.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

The canonical home for this skill is auto-claude-setup in fernandezbaptiste/Skrillz

Auto-Claude Setup

Name: auto-claude-setup
Rating: 69.6 (1 reviews)
Author: fernandezbaptiste

Complete installation and environment setup for the Auto-Claude autonomous coding framework.

Quick Start

Prerequisites

Requirement	Version	Notes
Python	3.12+	Required for backend and Memory Layer
Node.js	24+	Required for frontend
npm	10+	Package manager
Git	Latest	Version control
Claude Pro/Max	Active	Subscription required
Claude Code CLI	Latest	`npm install -g @anthropic-ai/claude-code`

Installation Methods

Method 1: Pre-built Release (Recommended)

Download from GitHub Releases:

Platform	Download
Windows	Auto-Claude-2.7.2.exe
macOS (Apple Silicon)	Auto-Claude-2.7.2-arm64.dmg
macOS (Intel)	Auto-Claude-2.7.2-x64.dmg
Linux (Universal)	Auto-Claude-2.7.2.AppImage
Linux (Debian)	Auto-Claude-2.7.2.deb

Method 2: From Source (Development)

# Clone repository
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude

# Install all dependencies
npm run install:all

# Run in development mode
npm run dev

# Or build and run
npm start

Platform-Specific Setup

WSL2 (Windows Subsystem for Linux)

# 1. Ensure WSL2 is updated
wsl --update

# 2. Install Python 3.12
sudo apt update && sudo apt install -y python3.12 python3.12-venv python3.12-dev

# 3. Install Node.js 24+ via nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 24
nvm use 24

# 4. Clone and setup
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude
npm run install:all

# 5. Setup OAuth token
claude setup-token

Windows (Native)

# 1. Install Python 3.12
winget install Python.Python.3.12

# 2. Install Node.js 24
winget install OpenJS.NodeJS.LTS

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

# 4. Clone and setup
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude
npm run install:all

Linux (Ubuntu/Debian)

# 1. Install Python 3.12
sudo apt update
sudo apt install -y python3.12 python3.12-venv python3.12-dev

# 2. Install Node.js 24 via NodeSource
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

# 3. Install Claude Code CLI
sudo npm install -g @anthropic-ai/claude-code

# 4. Clone and setup
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude
npm run install:all

macOS

# 1. Install Homebrew (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. Install Python 3.12 and Node.js
brew install python@3.12 node@24

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

# 4. Clone and setup
git clone https://github.com/AndyMik90/Auto-Claude.git
cd Auto-Claude
npm run install:all

Authentication Setup

OAuth Token Configuration

# Generate OAuth token (opens browser for authentication)
claude setup-token

# Token is saved to:
# - macOS: Keychain
# - Windows: Credential Manager
# - Linux: ~/.config/claude/credentials

Environment Configuration

Create apps/backend/.env from the example:

cd apps/backend
cp .env.example .env

Required Configuration:

# OAuth token (if not using keychain)
CLAUDE_CODE_OAUTH_TOKEN=your-oauth-token-here

Optional Configuration:

# Model override (default: claude-opus-4-5-20251101)
AUTO_BUILD_MODEL=claude-opus-4-5-20251101

# Default git branch
DEFAULT_BRANCH=main

# Debug mode
DEBUG=true
DEBUG_LEVEL=2

# Linear integration
LINEAR_API_KEY=lin_api_xxxxx

# Memory system (Graphiti)
GRAPHITI_ENABLED=true
GRAPHITI_LLM_PROVIDER=openai
OPENAI_API_KEY=sk-xxxxx

Verification

Test Installation

# Check Python version
python3 --version  # Should be 3.12+

# Check Node.js version
node --version  # Should be 24+

# Check Claude Code CLI
claude --version

# Test backend
cd apps/backend
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
python run.py --help

# Test frontend
cd apps/frontend
npm run dev

Run First Task

cd apps/backend
source .venv/bin/activate

# Create a spec interactively
python spec_runner.py --interactive

# Or with a task description
python spec_runner.py --task "Add a hello world endpoint"

Project Structure

Auto-Claude/
├── apps/
│   ├── backend/           # Python CLI and agents
│   │   ├── agents/        # Agent implementations
│   │   ├── core/          # Client, auth, security
│   │   ├── prompts/       # Agent system prompts
│   │   ├── spec/          # Spec creation pipeline
│   │   ├── .env           # Your configuration
│   │   └── run.py         # Main entry point
│   └── frontend/          # Electron desktop UI
├── guides/                # Documentation
├── tests/                 # Test suite
└── scripts/               # Build utilities

Common Issues

Windows: node-gyp Errors

Install Visual Studio Build Tools:

Download Visual Studio Build Tools 2022
Select "Desktop development with C++" workload
Add "MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs"
Restart terminal and run npm install again

Python Version Mismatch

# Check which Python is being used
which python3
python3 --version

# Create venv with specific Python version
python3.12 -m venv .venv

OAuth Token Issues

# Re-run token setup
claude setup-token

# Verify token is set
echo $CLAUDE_CODE_OAUTH_TOKEN

# Check Claude Code is working
claude --version

Related Skills

auto-claude-cli: Core CLI operations
auto-claude-spec: Spec creation workflow
auto-claude-memory: Memory system configuration
auto-claude-troubleshooting: Debugging guide

References

Repository: fernandezbaptiste/Skrillz
Path: .claude/skills/auto-claude-setup/SKILL.md
Commit: 93ed392

Last updated: 1 day ago
First committed: 8 months ago

Canonical home

fernandezbaptiste/Skrillz

In sync

since Sep 12, 2026

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.