Home / Requirements

System Requirements

Ensure your system meets these requirements before installing Claude Code Alias

✅ Essential Requirements

Claude Code CLI

Required

The Claude Code command-line interface must be installed and accessible in your system PATH.

Installation Guide
Verify installation: claude --version

Node.js v22+

Required

Node.js version 22 or higher is required for Claude Code to function properly.

Download Node.js
Check version: node --version
Install with Homebrew: brew install node@22

macOS with zsh

Required

This script is designed specifically for macOS systems using the zsh shell (default since macOS Catalina).

Check your shell: echo $SHELL

Bash

Required

Bash is required for script execution (pre-installed on macOS).

Verify bash: bash --version

🔧 Optional Components

Docker Desktop

Optional

Required for running the OpenTelemetry collector container with Grafana dashboards.

Install Docker Desktop
Verify Docker: docker --version

Netcat (nc)

Optional

Used for testing connectivity to the OpenTelemetry collector endpoint.

Install with Homebrew: brew install netcat
Check if installed: which nc

Claude Code OTEL

Optional

Pre-configured Docker container with Grafana dashboards for visualizing Claude Code metrics.

View Project

💡 Quick Verification Script

Run this script to check all requirements at once:

#!/bin/bash

echo "Checking Claude Code Alias Requirements..."
echo "=========================================="

# Check Claude
if command -v claude &> /dev/null; then
    echo "✅ Claude Code: $(claude --version 2>&1 | head -n 1)"
else
    echo "❌ Claude Code: Not found"
fi

# Check Node.js
if command -v node &> /dev/null; then
    NODE_VERSION=$(node --version | sed 's/v//')
    NODE_MAJOR=$(echo $NODE_VERSION | cut -d'.' -f1)
    if [ "$NODE_MAJOR" -ge 22 ]; then
        echo "✅ Node.js: v$NODE_VERSION"
    else
        echo "⚠️  Node.js: v$NODE_VERSION (version 22+ required)"
    fi
else
    echo "❌ Node.js: Not found"
fi

# Check Docker
if command -v docker &> /dev/null; then
    echo "✅ Docker: $(docker --version | cut -d' ' -f3 | sed 's/,//')"
else
    echo "⚠️  Docker: Not found (optional)"
fi

# Check netcat
if command -v nc &> /dev/null; then
    echo "✅ Netcat: Found"
else
    echo "⚠️  Netcat: Not found (optional)"
fi

# Check shell
if [ "$SHELL" = "/bin/zsh" ]; then
    echo "✅ Shell: zsh"
else
    echo "⚠️  Shell: $SHELL (zsh recommended)"
fi

echo "=========================================="
Home Installation