ECC auf Mac mini installieren 2026: Everything Claude Code

Warum ECC auf einem Mac mini installieren?

Claude Code läuft auf macOS am besten mit stabilem SSH, schnellem NVMe und durchgehender Verfügbarkeit. Viele Teams mieten einen dedizierten Mac mini M4, statt ECC an einen schlafenden Laptop zu binden.

• Persistenter ~/.claude-Status — Skills, Hooks und Regeln bleiben erhalten, wenn der Harness auf dem Server liegt, auch wenn Ihr lokales Gerät neu startet
• Geringe Latenz zur Anthropic-API — bei passender Region oft ~24 ms RTT gegenüber 180+ ms bei falscher Region (Regionsmatrix). Regionen, Preise und Hilfe auf den KuzCloud-Seiten.
• 16 GB reichen für ECC + Claude-Code-CLI; 24 GB, wenn Sie zusätzlich OpenClaw oder schwere Docker-Sidecars betreiben

ECC ersetzt Claude Code nicht — es ist eine Konfigurations- und Workflow-Schicht darüber. Wenn Sie nur einen schlanken Terminal-Agenten ohne 246 Skills brauchen, lesen Sie zuerst kostenlose Claude-Code-Alternativen.

ECC-Architektur: Was wird installiert?

ECC (Repo affaan-m/ECC, npm: ecc-universal) installiert sich in harness-spezifische Verzeichnisse. Für Claude Code unter macOS:

Drei öffentliche Kennungen (nicht verwechseln):

1. GitHub: affaan-m/ECC
2. Claude-Marketplace-Plugin: ecc@ecc
3. npm-CLI: ecc-universal / npx ecc-install

Der Upstream warnt ausdrücklich: /plugin install + ./install.sh --profile full = doppelte Skills und defekte Hooks. Wählen Sie unten nur einen Pfad.

Externe Referenz: Anthropic Claude Code Dokumentation.

Voraussetzungen auf dem Mac mini

Vor der Installation prüfen:

# macOS 14+ empfohlen (Sequoia auf M4 getestet) sw_vers # Node.js 20 LTS (18+ Minimum für ECC-Skripte) node -v # erwarten Sie v20.x oder v22.x npm -v # Git git --version # Claude-Code-CLI (falls fehlend separat installieren) claude --version

Auf einem frischen KuzCloud-Knoten Node per Homebrew installieren:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" brew install node git

Planen Sie ~2 GB Festplatte für ECC-Klon + node_modules, ~500 MB RAM im Leerlauf für Hooks plus den Footprint von Claude Code. Für Mietfristen reicht oft ein 3–7-Tage-Burst für Ersteinrichtung und Evaluation.

ECC auf dem Mac mini installieren: 8-Schritte-Runbook

Schritt 1 — Per SSH einloggen und Workspace anlegen

ssh -i ~/.ssh/kuzcloud.pem user@YOUR_NODE_IP mkdir -p ~/ecc-lab && cd ~/ecc-lab

Zugangsdaten kommen typischerweise innerhalb von ~5 Minuten nach Bestellung — gleicher Ablauf wie in anderen Remote-Mac-Leitfäden.

Schritt 2 — ECC-Repository klonen

git clone https://github.com/affaan-m/ECC.git cd ECC git checkout main # oder Release-Tag z. B. v2.0.0-rc.1 pinnen

Schritt 3 — Node-Abhängigkeiten installieren

npm install # Alternativen: pnpm install | yarn install | bun install

Dieser Schritt lädt Hook-Adapter und Installer-Skripte. Erster Lauf: 3–8 Minuten je nach Region.

Schritt 4 — Genau einen Installationspfad wählen

Pfad A — Claude-Code-Plugin (für die meisten empfohlen)

In einer interaktiven Claude-Code-Sitzung auf dem Mac mini:

/plugin marketplace add https://github.com/affaan-m/ECC /plugin install ecc@ecc

Dann nur benötigte Regelpakete kopieren (Plugin verteilt Regeln nicht automatisch):

mkdir -p ~/.claude/rules/ecc cp -R rules/common ~/.claude/rules/ecc/ cp -R rules/typescript ~/.claude/rules/ecc/ # weglassen ohne TS

Nicht ./install.sh --profile full nach Pfad A ausführen.

Pfad B — Manuelles Minimalprofil (keine Hooks, geringste Last)

./install.sh --profile minimal --target claude

Äquivalent:

npx ecc-install --profile minimal --target claude

Pfad B auf 16-GB-Knoten, wenn Hooks zu aggressiv sind oder nur Regeln + Agenten gewünscht sind.

Pfad C — Vollständige manuelle Installation (nur Power-User)

./install.sh --profile full --target claude

Nicht zusätzlich /plugin install ecc@ecc bei Pfad C.

Schritt 5 — Optional: consult vor Zusatzmodulen

npx ecc consult "security reviews typescript" --target claude

Plan prüfen, dann gezielt installieren:

npx ecc install --profile minimal --target claude --with capability:machine-learning

Schritt 6 — Installationszustand prüfen

node scripts/ecc.js list-installed node scripts/ecc.js doctor node scripts/ecc.js repair # sicherer erster Reparaturversuch bei Doctor-Hinweisen

Erwartung: doctor meldet Profile ohne doppelte Hook-Registrierungen.

Schritt 7 — Hook-Profil setzen (nur Pfad A oder Full-Install)

export ECC_HOOK_PROFILE=standard # oder minimal | strict export ECC_DISABLED_HOOKS= # kommagetrennt einzelne Hooks deaktivieren

In ~/.zshrc auf dem Mac mini eintragen, damit es über SSH-Sitzungen hinweg bleibt.

Schritt 8 — Rauchtest von Claude Code mit ECC

cd ~/ecc-lab/sample-project # Ihr Repo claude

In der Sitzung z. B.:

/harness-audit

Oder: „Nutze ECC-Skills, um dieses README auf tokenlastige Abschnitte zu prüfen.“

Pfadvergleichstabelle

Empfehlung: Mieten Sie einen KuzCloud-Mac-mini nur für ECC + Claude Code, starten Sie mit Pfad A + nur rules/common, ergänzen Sie Sprachpakete schrittweise. Hooks zuerst mit ECC_HOOK_PROFILE=minimal; nach einer stabilen Woche optional standard.

Fehlerbehebung

Fehler: doppelte Skills / Befehle feuern zweimal

Symptom: derselbe Slash-Befehl erscheint doppelt; Hook-Logs zeigen doppeltes SessionStart.

Ursache: Plugin-Installation + vollständiges install.sh kombiniert.

Fix:

node scripts/ecc.js doctor # Reset-Anweisungen im ECC-README „Reset / Uninstall ECC“ befolgen # Dann mit genau einem Pfad neu installieren

Fehler: claude: command not found auf Remote-Mac

Symptom: Plugin-Befehle schlagen fehl; claude --version fehlt.

Fix:

npm install -g @anthropic-ai/claude-code # Oder https://docs.anthropic.com/en/docs/claude-code/setup export ANTHROPIC_API_KEY=sk-ant-...

Erneut per SSH verbinden und Schritt 4 wiederholen.

Fehler: Marketplace-Plugin ecc@ecc nicht gefunden

Symptom: /plugin install ecc@ecc scheitert bei der Marketplace-Auflösung.

Fix: Pfad A überspringen; Pfad B nutzen:

cd ~/ecc-lab/ECC && ./install.sh --profile minimal --target claude

Fehler: Node-OOM während npm install

Symptom: Killed: 9 bei Installation auf 16-GB-Mac-mini.

Fix: temporär Swap erhöhen oder auf 24-GB-Knoten wechseln; alternativ npm install --omit=dev, falls upstream dokumentiert.

ECC auf dem Mac mini: Mieten vs. Kaufen

ECC benötigt keine Apple-Silicon-GPU — jeder M4-Mac-mini mit Node 20 und ~10 GB freiem Speicher reicht. Nutzen Sie ECC seltener als 22 volle Tage pro Monat, schlägt Mieten oft einen Kauf ab 599 $+ (Mieten-vs.-Kaufen-Leitfaden). Details: Preise und Hilfe.

FAQ

Ist ECC dasselbe wie Claude Code?

Nein. Claude Code ist Anthropics agentische Coding-CLI. ECC ist ein von der Community gepflegtes Harness-Erweiterungspaket (Skills, Regeln, Hooks) unter github.com/affaan-m/ECC. Zuerst Claude Code (oder einen anderen unterstützten Harness) installieren.

Kann ich ECC auf Cursor ohne Claude Code installieren?

Ja. ECC unterstützt Cursor, Codex, OpenCode u. a. via --target cursor oder harness-spezifische Installer. Dieser Leitfaden fokussiert Claude Code auf dem Mac mini — der häufigste KuzCloud-Workload.

Sendet ECC meinen Code an zusätzliche Dritte?

ECC fügt lokale Regeln, Hooks und Skills hinzu. LLM-Aufrufe laufen weiterhin über den Modellanbieter Ihres Harness (Anthropic, OpenAI usw.). Lesen Sie ECCs Security Guide und führen Sie /security-scan (AgentShield) vor Produktions-Repos aus.

Wie deinstalliere ich ECC vollständig?

Folgen Sie dem Upstream-Abschnitt Reset / Uninstall ECC: node scripts/ecc.js repair/list, ~/.claude/rules/ecc/ entfernen, Plugin in Claude Code deinstallieren, von doctor identifizierte doppelte Skill-Ordner löschen.

Funktioniert ECC per SSH von meinem Laptop?

Ja. ECC auf dem Remote-Mac-mini installieren, claude in tmux oder screen ausführen, vom Laptop per SSH verbinden. Port-Forwarding nur nötig, wenn Sie eine lokale GUI für das ECC-Tk-Dashboard (npm run dashboard) brauchen.