oh-my-claudecode Bereitstellung und Tipps: 32 professionelle Agenten arbeiten für dich, die Effizienz verdoppelt sich

Schwierigkeit: Mittel | Dauer: 30 Minuten | Ergebnis: Beherrschung von Multi-Agent-Orchestrierung, Zero-Config-Deployment, Aufbau von Team-Pipelines

Zielgruppe: Entwickler, die Claude Code bereits nutzen oder planen zu nutzen, sowie Teams, die die Effizienz der Agenten-Kollaboration steigern möchten.

Kernabhängigkeiten: Node.js ≥18, tmux (optional plattformübergreifend), Claude Code CLI

---

1. Projektvorstellung

Claude Code ist an sich schon leistungsstark, aber ein einzelner Agent stößt bei komplexen Multi-Modul-Projekten oft an seine Grenzen – man muss ständig zwischen Dialogfenstern wechseln oder Code-Reviews, Architekturdesign und Testvalidierung manuell koordinieren.

oh-my-claudecode (im Folgenden OMC genannt) wurde entwickelt, um dieses Problem zu lösen. Es ist eine Multi-Agenten-Orchestrierungsebene für Claude Code. Das Kernkonzept lautet:

Don't learn Claude Code. Just use OMC.

Einfach ausgedrückt: Du beschreibst in natürlicher Sprache, was du willst, und OMC plant automatisch 32 professionelle Agenten ein, wählt die passenden Modelle (Haiku / Sonnet / Opus) und verarbeitet Aufgaben parallel, bis die Validierung bestanden ist. Der gesamte Prozess ist konfigurationsfrei (Zero-Config), es müssen keine Befehle auswendig gelernt werden.

Projekt-URL: https://github.com/Yeachan-Heo/oh-my-claudecode

---

2. Kernfunktionen im Überblick

2.1 Zero-Config: Direkt einsatzbereit

Kein Schreiben von YAML- oder JSON-Konfigurationen erforderlich. Nach der Installation kannst du direkt loslegen. Intelligente Standardwerte decken 90 % der Szenarien ab.

2.2 32 professionelle Agenten

Jeder Agent hat einen klar definierten Aufgabenbereich. OMC leitet Aufgaben automatisch an den am besten geeigneten Agenten weiter:

Die vollständige Liste ist in AGENTS.md definiert.

2.3 Intelligentes Modell-Routing

OMC wählt das Modell automatisch basierend auf der Komplexität der Aufgabe aus:

• Haiku: Einfache Suche, Formatierung, kleine Textanpassungen
• Sonnet: Standardimplementierung, Debugging, Tests (täglicher Standard)
• Opus: Architekturdesign, Sicherheitsüberprüfungen, komplexe Refactorings

Der Vorteil ist die Kostenoptimierung; die Community berichtet von durchschnittlich 30-50 % Einsparung beim Token-Verbrauch.

2.4 Automatische Parallelisierung

Unabhängige Aufgaben werden automatisch verschiedenen Agenten zur parallelen Ausführung zugewiesen, ohne dass du sie manuell zerlegen musst.

2.5 Persistente Ausführung (verify/fix-Zyklus)

Im Ralph-Modus geht der Agent nach Abschluss der Aufgabe automatisch in einen Validierungszyklus über. Wenn die Validierung fehlschlägt, repariert er den Code selbst und führt ihn erneut aus, bis er tatsächlich besteht.

2.6 Skill-Selbstlernen (Learner-System)

Während des Betriebs gesammelte Debugging-Erfahrungen werden automatisch in wiederverwendbare Skill-Dateien extrahiert und unter .omc/skills/ abgelegt. Bei ähnlichen Problemen in der Zukunft wird der Kontext automatisch injiziert – du musst dich nicht manuell erinnern.

2.7 OpenClaw-Integration

Unterstützt die Weiterleitung von Claude Code Sitzungsereignissen an das OpenClaw Gateway für automatisierte Benachrichtigungen und Fernauslösung über Kanäle wie Telegram oder Discord.

---

3. Vollständige Projektstruktur

oh-my-claudecode/
├── agents/              # Definitionsdateien der 32 Agenten
├── bridge/              # OpenClaw / Drittanbieter-Bridges
├── docs/                # Architektur-Dokus, Migrationsleitfäden, Monitoring
├── examples/            # Beispiel-Workflows
├── hooks/               # Claude Code Hook-Injektionen
├── missions/            # Missionsdefinitionen
├── research/            # Forschungsmodule
├── scripts/             # Tool-Skripte (z. B. OpenClaw Gateway Demo)
├── skills/              # In OMC integrierte Skill-Dateien
├── src/                 # Kernquellcode
├── tests/               # Test-Suite
├── CLAUDE.md            # Hauptkonfiguration zur Laufzeit (OMC injiziert dies in Claude Code)
├── AGENTS.md            # Agenten-Verzeichnis und Beschreibungen
└── package.json

Für normale Benutzer sind im Alltag vor allem wichtig:

• skills/ — Benutzerdefinierte Skill-Dateien
• .omc/ — Zur Laufzeit generierte Sitzungs-, Status- und Plandateien

---

4. Installation und Konfiguration

4.1 Voraussetzungen

Zwingend erforderlich:

• Claude Code CLI — Benötigt Max/Pro-Abonnement oder Anthropic API Key
• Node.js ≥18 — OMC selbst ist ein TypeScript/npm-Projekt

Optional, aber dringend empfohlen:

• tmux — Die Funktionen omc team und die automatische Wiederherstellung bei Rate-Limits basieren auf tmux.

Installation von tmux:

# macOS
brew install tmux

# Ubuntu / Debian
sudo apt install tmux

# Arch
sudo pacman -S tmux

# Windows nativ (empfohlen)
winget install psmux

# Windows WSL2
sudo apt install tmux

4.2 OMC installieren (zwei Wege)

Weg 1: Marketplace-Installation (Empfohlen)

# Plugin-Quelle hinzufügen
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode

# Plugin installieren
/plugin install oh-my-claudecode

Weg 2: Globale npm-Installation

npm i -g oh-my-claude-sisyphus@latest

Nach der Installation aktiviert sich OMC automatisch. Alle /-Befehle und magischen Schlüsselwörter sind sofort einsatzbereit.

4.3 Initiale Konfiguration

# In einem beliebigen Verzeichnis ausführen
/setup
/omc-setup

Beim ersten Durchlauf wirst du durch folgendes geführt:

• Bestätigung des Claude Code Konfigurationsverzeichnisses
• OpenClaw Gateway (optional)
• tmux Sitzungserkennung

Bei Problemen führe das Diagnose-Tool aus:

/omc-doctor

4.4 Team-Modus aktivieren (Empfohlen)

Der Team-Modus ist ab OMC v4.1.7 die Standard-Orchestrierung. Er muss in den Claude Code Einstellungen als experimentelles Feature aktiviert werden:

# Bearbeite ~/.claude/settings.json

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

---

5. Tiefenanalyse der Ausführungsmodi

OMC bietet verschiedene Modi für unterschiedliche Szenarien. Das Verständnis dieser Unterschiede ist der Schlüssel zur effizienten Nutzung.

5.1 Team-Modus (Empfohlen) ⭐

Szenario: Komplexe Multi-Modul-Aufgaben, die Architektur, Codierung, Review und Tests erfordern.

Der Team-Modus läuft in einer strikten Pipeline:

team-plan → team-prd → team-exec → team-verify → team-fix (Zyklus)

Die Aufgabe beginnt mit der Planung, gefolgt von Produktdesign, Code-Ausführung und Validierung. Falls im fix-Schritt Probleme gefunden werden, geht es zurück zur Ausführung. Der gesamte Prozess wird automatisch von OMC koordiniert.

Grundlegende Nutzung:

/team 3:executor "Fixe alle TypeScript-Kompilierungsfehler"

Die Zahl 3 gibt an, dass 3 Executor-Agenten parallel arbeiten sollen.

CLI-Version tmux Workers (v4.4.0+):

omc team 2:codex "Sicherheit des Auth-Moduls prüfen"
omc team 2:gemini "Barrierefreiheit der UI-Komponenten neu gestalten"
omc team 1:claude "Zahlungsprozess implementieren"
omc team status auth-review
omc team shutdown auth-review

Dies sind echte, unabhängige tmux-Prozesse, die sich nach Abschluss automatisch beenden.

5.2 Autopilot

Szenario: Klare Anforderungen, eine Funktion soll Ende-zu-Ende ohne viel menschliches Eingreifen erstellt werden.

autopilot: build a REST API for managing tasks

Im Autopilot-Modus ist ein einzelner Lead-Agent für den gesamten Prozess von Design bis Implementierung verantwortlich, unabhängig von einer Pipeline.

5.3 Ralph (Persistenz-Modus)

Szenario: Die Aufgabe muss vollständig abgeschlossen werden; ein Abbruch bei "teilweiser Erledigung" ist nicht akzeptabel.

Der Ralph-Modus kombiniert die Parallelität von Ultrawork mit einem zusätzlichen verify/fix-Zyklus:

executor → verify → fix → verify (bis bestanden)

ralph: Auth-Modul refactorieren, alle Tests müssen bestehen

Wenn Claude Code oft abbricht, nachdem es "fertig aussieht", aber tatsächlich nicht validiert wurde, ist Ralph die Lösung.

5.4 Ultrawork (Maximale Parallelität)

Szenario: Große Mengen an Fixes/Refactorings, bei denen es auf Geschwindigkeit ankommt.

ulw Fixe alle ESLint-Fehler
ulw Benenne alle Komponenten in PascalCase um

Alle Fixes laufen parallel, ohne auf den vorherigen zu warten – ideal für die Abarbeitung bekannter Fehlerlisten.

5.5 /ccg Drei-Modell-Berater

Szenario: Wenn man gleichzeitig die Perspektiven von Codex und Gemini benötigt und Claude diese zusammenfassen soll.

/ccg Review this PR — architecture (Codex) and UI components (Gemini)

Es ruft /ask codex + /ask gemini auf, und Claude liefert die abschließende Synthese. Ideal für Backend+Frontend-Reviews.

5.6 Vergleichstabelle der Modi

---

6. Praxis-Beispiele

6.1 Szenario 1: Aufbau einer REST API (Team-Modus)

Angenommen, wir wollen eine Task-Management-API bauen:

/team 2:executor "Implementiere eine Task-Management REST API mit CRUD-Endpunkten unter Nutzung von Express + TypeScript"

OMC zerlegt die Aufgabe automatisch:

1. architect entwirft API-Struktur und Datenmodell
2. executor implementiert die Endpunkte parallel
3. test-engineer schreibt Integrationstests
4. code-reviewer prüft den Code
5. verifier führt die Tests zur Validierung aus

6.2 Szenario 2: Alle Fehler automatisch beheben (Ultrawork)

ulw Fixe alle TypeScript-Typfehler und ESLint-Warnungen

Ideal für CI/CD-Pipelines oder zum Aufräumen von Legacy-Projekten.

6.3 Szenario 3: Wenn Anforderungen unklar sind (Deep Interview)

Wenn du selbst nicht sicher bist, was zu tun ist:

/deep-interview "Ich möchte ein persönliches Blog-System erstellen"

Deep Interview stellt sokratische Fragen, um Anforderungen zu klären: Zielgruppe, Tech-Stack, CMS-Bedarf, SEO-Anforderungen... Kläre alles vorher, um doppelte Arbeit zu vermeiden.

6.4 Szenario 4: Cross-Modell-Review (/ccg)

/ccg Prüfe die Backend-Architektur dieses PRs mit Codex und die UI mit Gemini

6.5 Szenario 5: Automatische Wiederherstellung bei Rate-Limits

Wenn das Claude-API-Limit erreicht wird:

omc wait          # Aktuellen Status und Anweisungen anzeigen
omc wait --start  # Daemon für automatische Wiederherstellung starten
omc wait --stop   # Daemon stoppen

---

7. Fehlerbehebung (FAQ)

Q1: Befehl /team funktioniert nicht, Fehler "Team Mode nicht aktiviert"

Ursache: Die Umgebungsvariable CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS ist nicht gesetzt.

Lösung:

# Bearbeite ~/.claude/settings.json und füge hinzu:
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Starte die Claude Code Sitzung neu.

---

Q2: omc team meldet tmux-Fehler

Ursache: tmux ist nicht installiert oder nicht im PATH (besonders bei Windows).

Lösung:

# Windows nativ
winget install psmux

# macOS
brew install tmux

# Installation prüfen
tmux -V

---

Q3: OMC-Befehle funktionieren nach Marketplace-Installation nicht

Ursache: Plugin-Cache nicht aktualisiert oder falscher Pfad.

Lösung:

/plugin marketplace update omc
/setup
/omc-doctor

---

8. Weiterführende Themen / Fortgeschrittene Nutzung

8.1 Eigene Skills schreiben

OMC kann aus Debugging-Erfahrungen Skills extrahieren:

/learner

Dies generiert YAML-Dateien unter .omc/skills/, die künftig automatisch injiziert werden.

8.2 OpenClaw-Integration

OMC kann Ereignisse an das OpenClaw Gateway weiterleiten:

/oh-my-claudecode:configure-notifications
# -> Wähle "OpenClaw Gateway"

8.3 Benachrichtigungssysteme (Telegram / Discord / Slack)

omc config-stop-callback telegram --enable --token <token> --chat <id>

Sendet am Ende der Sitzung eine Zusammenfassung an die Gruppe.

---

Referenz-Links

• Projekt-Homepage: https://github.com/Yeachan-Heo/oh-my-claudecode
• npm-Paket: https://www.npmjs.com/package/oh-my-claude-sisyphus
• Dokumentation: https://yeachan-heo.github.io/oh-my-claudecode-website
• Discord Community: https://discord.gg/PUwSMR9XNk