SOP-001: Installation & Setup

DOCUMENT CONTROL

Field	Value
SOP ID	SOP-001
Version	1.0
Status	Active
Last Updated	December 2025

Purpose

This SOP provides step-by-step instructions for installing Happy Coder on your development machine and mobile devices to enable remote Claude Code control.

Prerequisites

• Node.js 18 or later installed on your computer
• Claude Code CLI installed and configured
• iOS or Android device (or web browser)
• Internet connection

Procedure Flowchart

┌─────────────────────┐
│   START             │
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│ Check Node.js       │
│ version >= 18       │
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│ Install happy-coder │
│ npm i -g happy-coder│
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│ Download mobile app │
│ iOS/Android/Web     │
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│ Run happy --auth    │
│ Display QR code     │
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│   COMPLETE          │
└─────────────────────┘

Step-by-Step Procedure

Step 1: Verify Node.js Version

Check that Node.js 18+ is installed:

node --version
# Should output v18.0.0 or higher

Node.js Requirements

Happy Coder requires Node.js 18+ for:

• Top-level await support
• Stable fetch API
• ES module compatibility
• Dependency requirements (@anthropic-ai/claude-code)

Step 2: Install Happy Coder CLI

Install the CLI globally:

npm install -g happy-coder

Verify installation:

happy --version

Step 3: Download Mobile App

Choose your platform:

Platform	Download Link
iOS	App Store
Android	Google Play
Web	app.happy.engineering

Step 4: Generate Pairing QR Code

Run the authentication command:

happy --auth

This displays:

• QR code for scanning
• Manual entry code (backup)

Step 5: Connect Mobile App

1. Open Happy Coder app on your phone
2. Tap "Scan QR Code"
3. Point camera at the QR code displayed in terminal
4. Connection established

Verification Checklist

• [ ] Node.js version is 18 or higher
• [ ] happy command is recognized in terminal
• [ ] Mobile app successfully installed
• [ ] QR code scanned and devices connected
• [ ] Test message sent from mobile to desktop

Common Issues

Issue	Solution
happy: command not found	Ensure npm global bin is in PATH
QR code not scanning	Increase screen brightness, try manual code
Connection timeout	Check firewall settings, try cellular data

Related Documents

• SOP-002: Device Pairing
• Troubleshooting Guide