Oh My Opencode QuickStart für OpenCode: Installieren, konfigurieren, ausführen

Installieren Sie Oh My Opencode und liefern Sie schneller aus.

Inhaltsverzeichnis

Oh My Opencode verwandelt OpenCode in einen Multi-Agent-Coding-Rahmen: Ein Orchestrator delegiert Aufgaben an spezialisierte Agenten, die parallel arbeiten.

oh my opencode agents with laptops and gpu

Das kürzeste mentale Modell, das Sie benötigen: Installieren Sie das Plugin und verwenden Sie dann das Schlüsselwort ultrawork (oder ulw), wenn Sie die volle Mehr-Agenten-Ausführung benötigen.

Dieser Schnellstart deckt die Installation und die Konfiguration für den ersten Tag ab. Sobald Sie einsatzbereit sind:

Für die breitere AI-Code-Toolchain sehen Sie den Überblick über KI-Entwickler-Tools. Wenn Sie eine sandboxfähige, browserfähige Alternative zu OpenCode bevorzugen, verfolgt OpenHands einen anderen architektonischen Ansatz für agiles Coding ein.

Warum Oh My Opencode existiert

OpenCode ist ein Open-Source-KI-Coding-Agent, der als Terminal-Benutzeroberfläche läuft und nicht-interaktive CLI-Läufe für Skripte und Automatisierung handhabt.

Oh My Opencode hebt diese Grenze deutlich höher. Es fügt eine vollständige Orchestrierungsschicht hinzu, die um den „Sisyphus“-Agenten, die Zusammenarbeit mehrerer Spezialisten und eine engere Tool-Integration herum aufgebaut ist. Das Ergebnis ist ein System, in dem komplexe Ingenieursaufgaben – die Art von Aufgaben, bei denen Sie normalerweise mehrere Prompts beaufsichtigen müssten – in einem einzigen Workflow geplant, delegiert und verifiziert werden.

Zwei Konzepte tauchen ständig auf, also klären Sie diese vor allem anderen:

  • Ultrawork-Modus: ein durch Schlüsselwort ausgelöster Workflow-Switch. Das Hinzufügen von ultrawork oder ulw zu Ihrem Prompt aktiviert parallele Hintergrundausführung, LSP-Integration, Kontextmanagement und automatische Aufgabenzerlegung – es ist keine stilistische Wahl.
  • Spezialisierte Agenten: benannte Rollen wie @oracle für Architektur und @librarian für Forschung und Dokumentation. Sie können sie explizit aufrufen oder dem Orchestrator die automatische Weiterleitung überlassen.

Dieser Artikel verwendet Oh My Opencode, oh-my-opencode und Oh My OpenCode synonym – alle beziehen sich auf dasselbe Plugin im OpenCode-Ökosystem.

Voraussetzungen und Terminologie

Sie müssen OpenCode zuerst installiert und funktionsfähig haben. Sehen Sie sich unseren OpenCode Schnellstart an, um zu lernen, wie man es installiert, konfiguriert und startet.

Standardmäßig startet opencode die Terminal-Benutzeroberfläche, wenn es ohne Argumente ausgeführt wird, und Sie können auch opencode run ... für nicht-interaktive Ausführungen verwenden.

Oh My Opencode erfordert mindestens einen konfigurierten Anbieter. OpenCode lädt Anbieter aus Credentials, Umgebungsvariablen oder einer Projektdatei .env. Der schnellste Weg, das zu erledigen:

opencode auth login
opencode auth list

Credentials befinden sich in ~/.local/share/opencode/auth.json.

Ein Namensmerkmal, das sich lohnt, im Voraus zu kennen: Das upstream GitHub-Repository wird nun als oh-my-openagent („früher oh-my-opencode") vermarktet, aber der Plugin- und Paketname in den Konfigurationen ist immer noch oh-my-opencode. Beide Namen tauchen in Community-Beiträgen auf – es ist dasselbe.

Installations-Schnellstart

Es gibt mehrere Wege (CLI-Installer, manuelles Repo-Clonen oder „lass einen Agenten es installieren"). Die richtige Wahl hängt davon ab, ob Sie einen wiederholbaren Installer-Flow oder volle manuelle Kontrolle wünschen.

Wenn Sie Bun installiert haben, ist bunx Bun’s npx-Äquivalent, entworfen, um npm-Pakete schnell auszuführen, ohne einen separaten globalen Installationsschritt.

Um bunx unter Linux zu installieren:

curl -fsSL https://bun.com/install | bash

Automatische Installation mit OpenCode

Sie können einen Prompt in OpenCode ausführen, und es wird OmO automatisch installieren.

Installieren und konfigurieren Sie oh-my-opencode, indem Sie den Anweisungen hier folgen:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

Es wird einige Fragen zu Ihren LLM-Abonnements stellen und Oh My Opencode in den OpenCode-Plugins registrieren.

Manueller Pfad: Führen Sie den Oh My Opencode-Installer mit bunx oder npx aus

Interaktiver Installer, der Sie über Ihre Anbieter befragt und eine „optimale" Konfiguration automatisch generiert, sowie ein nicht-interaktiver Modus für Automatisierung und Agenten.

Interaktive Installation:

bunx oh-my-opencode install
# oder wenn Sie npm-Tooling bevorzugen
npx oh-my-opencode install

Nicht-interaktive Installation (nützlich für Provisioning-Skripte, CI-Images oder „Agent-Installationen"):

bunx oh-my-opencode install --no-tui \
  --claude=<yes|no|max20> \
  --openai=<yes|no> \
  --gemini=<yes|no> \
  --copilot=<yes|no>

Was der Installer auf hoher Ebene tut:

  • registriert das Plugin in der OpenCode-Konfiguration
  • generiert Modellzuweisungen basierend auf der Anbieterverfügbarkeit und Fallback-Regeln
  • schreibt oh-my-opencode-Konfigurationen neben den OpenCode-Konfigurationsdateien

Manueller Pfad: Klonen Sie das Repo und führen Sie das Installationsskript aus

Es gibt auch einen „menschlichen" manuellen Flow: Klonen Sie das Repo, installieren Sie die Abhängigkeiten und führen Sie dann ein Installationsskript aus, das Ihre OpenCode-Konfigurationsposition erkennt, ein Backup erstellt und Einstellungen zusammenführt.

git clone https://github.com/code-yeongyu/oh-my-opencode.git ~/.oh-my-opencode
cd ~/.oh-my-opencode
npm install
npm run install

Wenn das Skript Ihre OpenCode-Konfiguration nicht automatisch finden kann, setzen Sie die Umgebungsvariable für den Konfigurationspfad explizit, bevor Sie den Installer erneut ausführen.

Schnellüberprüfungsliste

Nach der Installation validieren Sie drei Dinge:

  • Ihre Oh My Opencode-Konfigurationsdatei existiert an einem bekannten Ort
  • Spezialisierte Agenten können aufgerufen werden
  • Die Auslösung des Ultrawork-Schlüsselworts funktioniert wie erwartet

Beispiele zum Kopieren:

# Zeigt die Plugin-Konfigurationsdatei (versuchen Sie den Ort, der zu Ihrer Einrichtung passt)
cat .opencode/oh-my-opencode.json
cat ~/.config/opencode/oh-my-opencode.json

# Schneller Agententest
opencode run "Verwenden Sie @oracle, um die Architektur des aktuellen Projekts zu analysieren"

# Schneller Ultrawork-Auslösetest
opencode run "ulw listet alle Konfigurationsdateien in diesem Projekt auf"

Wenn alle drei bestehen, sind Sie wirklich bereit – nicht nur installiert.

Konfiguration und Feinjustierung

Wo Konfigurationen liegen und wie die Priorität funktioniert

Oh My Opencode sucht nach Konfigurationsdateien in einer Prioritätsreihenfolge, wobei die Konfiguration auf Projektebene Vorrang vor der auf Benutzerebene hat. Die dokumentierte Suchreihenfolge ist:

  • .opencode/oh-my-opencode.json (Projektebene, höchste Priorität)
  • ~/.config/opencode/oh-my-opencode.json (Benutzerebene auf macOS und Linux)
  • %APPDATA%\opencode\oh-my-opencode.json (Benutzerebene auf Windows)

OpenCode selbst unterstützt auch mehrere Konfigurationsquellen und fusioniert sie, anstatt sie zu ersetzen, wobei spätere Quellen frühere nur dann überschreiben, wenn Schlüssel in Konflikt geraten. Das ist wichtig, da Sie normalerweise eine stabile globale Basis plus pro-Repo-Überschreibungen wünschen.

JSONC-Unterstützung für vernünftige Konfigurationen

Sowohl OpenCode als auch Oh My Opencode unterstützen JSONC, was bedeutet, dass Sie Kommentare und nachgestellte Kommas in Konfigurationsdateien belassen können, ohne die Analyse zu stören. Das ist besonders hilfreich, um zu dokumentieren, warum bestimmte Limits oder Modelle gewählt wurden.

Das „ultrawork"-Schlüsselwort und was es ermöglicht

ultrawork (oder ulw) ist der Modus-Switch, zu dem Sie am häufigsten greifen werden. Fügen Sie es in Ihre Aufgabenbeschreibung ein, und das System aktiviert die parallele Hintergrundausführung, LSP-Integration, Kontextmanagement und automatische Aufgabenzerlegung. Es ist kein Hinweis für das Modell – es ist ein harter Auslöser, der ändert, wie der gesamte Lauf strukturiert wird.

Parallelität und Hintergrundaufgaben

Oh My Opencode stellt Parallelitätskontrollen für die Hintergrundausführung über sisyphus.max_concurrent_tasks bereit.

Verfolgen Sie hier keine hohe Parallelität. Jeder Anbieterplan hat eine Obergrenze – Claude Max20 beispielsweise kommt auf 3 parallele Aufgaben – und das Überschreiten führt zu flackernden Vollendungen und schwer zu debuggenden Timeouts. Beginnen Sie konservativ und erhöhen Sie nur nach sauberen Läufen.

Eine minimale Parallelitätskonfiguration sieht so aus:

{
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 2,
    "task_timeout": 300
  }
}

Eine Parallelität von 2 ist ein sicherer Startpunkt für die meisten Pläne.

Modellrouting pro Agent und pro Kategorie

Oh My Opencode basiert auf der Idee, dass verschiedene Aufgaben von verschiedenen Modellen profitieren, sodass die Konfiguration Folgendes unterstützt:

  • Modellauswahl pro Agent, Varianten und Prompt-Erweiterungen
  • Routing basierend auf Kategorien für „schnelle" vs. „tiefgehende" Arbeit
  • Fallback-Modelle, wenn Ihr bevorzugter Anbieter nicht verfügbar ist

Der Tiefenblick in spezialisierte Agenten behandelt das vollständige Modellrouting-System im Detail – einschließlich, warum bestimmte Agenten nicht auf die falsche Modellfamilie geschaltet werden dürfen, die vollständigen Fallback-Ketten und wie man Modelle für selbst gehostete Setups sicher überschreibt.

Die Modellauflösung ist geschichtet: Ihre explizite Überschreibung gewinnt, dann der Anbieter-Fallback, dann der Systemsstandard. Die Fallback-Kette beginnt mit Ihren nativen Anbietern und kann auf Alternativen wie GitHub Copilot absinken, wenn nichts anderes verfügbar ist – was bedeutet, dass ein falsch konfiguierter Agent unwahrscheinlich stillschweigend fehlschlägt; er wird einfach ein schwächeres Modell verwenden.

Eine praktische Startkonfiguration, die Sie anpassen können (JSONC empfohlen):

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",

  // Bleiben Sie bei Parallelität konservativ, bis Sie Ihren Anbieterlimits vertrauen
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 2,
    "task_timeout": 300
  },

  // Agentenfeinjustierung
  "agents": {
    "oracle": {
      "enabled": true,
      "model": "openai/gpt-5.2",
      "variant": "high",
      "temperature": 0.7,
      "prompt_append": "Bieten Sie prägnante Trade-offs und eine klare Empfehlung"
    },
    "librarian": {
      "enabled": true,
      "model": "google/gemini-3.1-pro"
    }
  },

  // Kategoriesortierung für schnelle Abfragen vs. tiefere Arbeit
  "categories": {
    "quick": { "model": "opencode/gpt-5-nano" },
    "visual-engineering": { "model": "google/gemini-3.1-pro" }
  }
}

Das $schema-Feld lohnt sich – es schaltet die Autovervollständigung in den meisten Editoren frei und fängt Tippfehler in Agentennamen ab, bevor Sie eine Laufzeit mit einer kaputten Konfiguration verschwenden.

MCP-Integration und Hooks

Oh My Opencode unterstützt MCP-Server (Model Context Protocol) über einen Konfigurationsblock, in dem Sie den Serverbefehl, Argumente und Umgebungsvariablen definieren.

In der Praxis ist der einfachere Weg, MCPS direkt über OpenCode mit der Befehlsgruppe opencode mcp zu verwalten – es übernimmt das Hinzufügen, Auflisten und die OAuth-Authentifizierung, ohne dass Sie Konfigurationsdateien manuell berühren müssen.

Workflow-Beispiele, die Sie kopieren können

Die beiden Beispiele unten sind absichtlich „echtes Repo"-förmig: Sie zeigen, wie man Orchestrierung auslöst, wie man spezialisierte Agenten anvisiert und wie man Ergebnisse verifizierbar hält.

Beispiel: Architekturüberprüfung mit Oracle und einer Repo-Karte

Verwenden Sie dies, wenn Sie eine neue Codebasis beitreten oder einen Service übernehmen und eine schnelle, handlungsorientierte Ansicht der Architektur benötigen. Oracle ist ein read-only-Spezialist – er kann keine Änderungen vornehmen, nur beraten.

Führen Sie es vom Projektstamm aus:

opencode

OpenCode startet standardmäßig seine Terminal-Benutzeroberfläche, wenn es ohne Argumente gestartet wird.

Bitten Sie dann Oracle, eine Architekturanalyse und einen konkreten Refactoring- oder Modularisierungsplan zu erstellen:

Verwenden Sie @oracle, um die Architektur dieses Repositories zu analysieren.
Identifizieren Sie die wichtigsten begrenzten Kontexte, Hauptabhängigkeitskanten und die Komponenten mit dem höchsten Risiko.
Enden Sie mit einem Refactoring-Plan, der in kleinen PRs ausgeführt werden kann.

Für Logging oder Skripting überspringen Sie die TUI entirely und verwenden Sie opencode run:

opencode run "Verwenden Sie @oracle, um die Architektur dieses Repositories zu analysieren und einen gestaffelten Refactoring-Plan vorzuschlagen"

opencode run übergibt den Prompt direkt und beendet sich, wenn er fertig ist – genau das, was Sie für CI-Schritte oder Automatisierungspipelines möchten.

Beispiel: Vollständige Feature-Implementierung mit Ultrawork-Orchestrierung

Verwenden Sie dies, wenn Sie ein Feature benötigen, das mehrere Dateien oder Ebenen berührt, oder wenn Sie Hintergrundaufgaben und spezialisierte Agenten automatisch aktivieren möchten.

Beginnen Sie mit einem Ultrawork-Prompt:

opencode run "ultrawork implementieren Sie einen neuen /health-Endpunkt mit Readiness- und Liveness-Checks, fügen Sie Tests hinzu, aktualisieren Sie die Dokumentation und überprüfen Sie, ob er lokal läuft"

Das ultrawork-Schlüsselwort aktiviert alle konfigurierten spezialisierten Agenten, die Parallelität von Hintergrundaufgaben und tiefere Werkzeugung in einem Schlag. Sie benötigen keine separaten Prompts für Planung, Implementierung und Testen.

Wenn Sie Ultrawork verwenden, können Sie das Verhalten von Spezialisten immer noch explizit steuern. Zum Beispiel könnten Sie zuerst das Architekturentwurf erzwingen:

opencode run "ultrawork bitten Sie @oracle, zuerst den Endpunktvertrag und die Abhängigkeiten zu entwerfen, dann mit minimalen Änderungen zu implementieren und Tests hinzuzufügen"

Die Kombination von ultrawork mit expliziten Agentenerwähnungen wie @oracle ist der sweet spot: Sie erhalten die volle Orchestrierung, behalten aber die Kontrolle darüber, welcher Spezialist die kritischen Designentscheidungen trifft.

Eines, das Sie für größere Ultrawork-Aufgaben richtig machen müssen: Halten Sie die Parallelität innerhalb Ihrer Anbieterlimits. Beginnen Sie bei 2, führen Sie einige Aufgaben sauber aus und entscheiden Sie dann, ob Sie erhöhen sollen. Das Überschreiten der Decke Ihres Plans macht die Dinge nicht schneller – es macht sie unzuverlässig.

Fehlerbehebung und Best Practices

Ultrawork-Schlüsselwort löst nicht aus

Wenn ulw oder ultrawork ignoriert wird, behandeln Sie dies als Signal, um das Plugin-Laden und die Versionkompatibilität zu überprüfen. Es gab mindestens einen berichteten Regress, bei dem die Schlüsselerkennung den erwarteten Ultrawork-Modus-Prompt nicht injiziert hat, wobei die Untersuchung auf den dedizierten Keyword-Detector-Hook hinweist.

In der Praxis sind die schnellsten Fixes:

  • bestätigen Sie, dass das Plugin registriert ist und Konfigurationsdateien vorhanden sind (siehe die Überprüfungsliste oben)
  • aktualisieren Sie OpenCode oder das Plugin, wenn Sie auf einer Version sind, bei der die Schlüsselerkennung bekanntermaßen Regressionen aufweist

Installationsskript kann Ihre OpenCode-Konfiguration nicht finden

Überprüfen Sie, ob OpenCode installiert ist (opencode --version), und setzen Sie dann eine explizite Umgebungsvariable für den Konfigurationspfad, bevor Sie den Installer erneut ausführen.

Zu viele Hintergrundaufgaben oder Drosselungsprobleme

Wenn Sie auf Rate-Limits, Timeouts oder flackernde Vollendungen stoßen, ist die Lösung immer dieselbe: Reduzieren Sie die Parallelität und führen Sie erneut aus. Das Verfolgen höherer Parallelität, wenn Ihr Anbieter Sie bereits drosselt, ist ein verlorener Kampf.

Wann Sie Ultrawork nicht verwenden sollten

Ultrawork ist mächtig, aber nicht kostenlos – jeder parallele Agent kostet Tokens und zählt gegen Ihre Rate-Limits. Reservieren Sie es für große Refactors, Full-Stack-Feature-Arbeit und komplexe mehrstufige Aufgaben. Für eine kleine Einzeldatei-Bearbeitung oder eine schnelle Frage ist ein einfacher Prompt schneller und günstiger.

Eine solide Faustregel:

  • verwenden Sie normale Prompts für kleine Änderungen und direkte Fragen
  • verwenden Sie Ultrawork, wenn Sie möchten, dass das System zerlegt, delegiert, ausführt und über das gesamte Repository verifiziert

Hinweis zur Compliance bezüglich Anbieterbedingungen

Einige Community-Diskussionen in diesem Ökosystem berühren Anbieterbeschränkungen und Nutzungsbedingungen, insbesondere rund um OAuth von Drittanbietern und Kompatibilitätsschichten. Dies sind echte Einschränkungen – überprüfen Sie die Bedingungen Ihres Anbieters, bevor Sie automatisierte oder parallele Workflows im großen Stil ausführen, und nehmen Sie nicht an, dass eine funktionierende Integration eine erlaubte ist.

Bereit, tiefer einzusteigen? Der Tiefenblick in spezialisierte Agenten erklärt die Rolle jedes Agenten, Modellanforderungen und Optionen zur Selbsthosting. Für ehrliche Leistungsdaten und von der Community gemeldete Abrechnungsrisiken sehen Sie den Oh My Opencode Erfahrungsartikel.