Auto Claude Setup

Name: Auto Claude Setup
Author: adaptationio

FSecurity

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.

3 stars

0 votes

0 copies

0 views

Added 2/8/2026

developmentpythonc++shellbashnodenodejsdebugginggitapifrontend

Works with

claude codeterminalcliapi

Security Analysis

F38/100

criticalPipes output to a shell interpreter

mediumUses curl or wget to download content

criticalModifies startup scripts or system services for persistence

criticalExfiltrates credentials via HTTP — exact pattern from Snyk ToxicSkills study

criticalDownloads and executes remote scripts — classic supply chain attack

mediumInstalls packages at runtime which could introduce malicious dependencies

Pro scans all 3 files and shows the line behind each finding

Scanned 2/12/2026

$npx -y skills add adaptationio/Skrillz --skill auto-claude-setup --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Auto Claude Setup?

Add the live security badge to your README — it updates automatically with every re-scan.

Security grade badge for Auto Claude Setup

[![Security: F — Skills Directory](https://www.skillsdirectory.com/api/skills/adaptationio-auto-claude-setup/badge)](https://www.skillsdirectory.com/skills/adaptationio-auto-claude-setup)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

Files

SKILL.md

---
name: auto-claude-setup
description: 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.
version: 1.0.0
auto-claude-version: 2.7.2
---

# Auto-Claude Setup

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](https://github.com/AndyMik90/Auto-Claude/releases/latest):

| 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)

```bash
# 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)

```bash
# 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)

```powershell
# 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)

```bash
# 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

```bash
# 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

```bash
# 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:

```bash
cd apps/backend
cp .env.example .env
```

**Required Configuration:**

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

**Optional Configuration:**

```bash
# 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

```bash
# 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

```bash
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:
1. Download [Visual Studio Build Tools 2022](https://visualstudio.microsoft.com/visual-cpp-build-tools/)
2. Select "Desktop development with C++" workload
3. Add "MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs"
4. Restart terminal and run `npm install` again

### Python Version Mismatch

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

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

### OAuth Token Issues

```bash
# 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

- [Official README](https://github.com/AndyMik90/Auto-Claude/blob/main/README.md)
- [Contributing Guide](https://github.com/AndyMik90/Auto-Claude/blob/main/CONTRIBUTING.md)
- [CLI Usage Guide](https://github.com/AndyMik90/Auto-Claude/blob/main/guides/CLI-USAGE.md)

Attribution

adaptationio

View source See grades on GitHub More from adaptationio →

SSkills DirectorySkills Directory

Ship a skill? Prove it's safe.

Free 120-pattern security scan, letter grade, and an embeddable README badge.

Submit a skill

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments (0)

No comments yet. Be the first to comment!

--- name: auto-claude-setup description: 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. version: 1.0.0 auto-claude-version: 2.7.2 --- # Auto-Claude Setup 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](https://github.com/AndyMik90/Auto-Claude/releases/latest): | 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) ```bash # 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) ```bash # 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) ```powershell # 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) ```bash # 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 ```bash # 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 ```bash # 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: ```bash cd apps/backend cp .env.example .env ``` **Required Configuration:** ```bash # OAuth token (if not using keychain) CLAUDE_CODE_OAUTH_TOKEN=your-oauth-token-here ``` **Optional Configuration:** ```bash # 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 ```bash # 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 ```bash 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: 1. Download [Visual Studio Build Tools 2022](https://visualstudio.microsoft.com/visual-cpp-build-tools/) 2. Select "Desktop development with C++" workload 3. Add "MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs" 4. Restart terminal and run `npm install` again ### Python Version Mismatch ```bash # Check which Python is being used which python3 python3 --version # Create venv with specific Python version python3.12 -m venv .venv ``` ### OAuth Token Issues ```bash # 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 - [Official README](https://github.com/AndyMik90/Auto-Claude/blob/main/README.md) - [Contributing Guide](https://github.com/AndyMik90/Auto-Claude/blob/main/CONTRIBUTING.md) - [CLI Usage Guide](https://github.com/AndyMik90/Auto-Claude/blob/main/guides/CLI-USAGE.md)