So verwenden Sie AI OpenHands: Eine praktische Anleitung zu Einrichtung, Prompts und realen Workflows
Haben Sie sich jemals gewünscht, ein fähiger Entwickler könnte rund um die Uhr mit Ihnen Pair-Programming betreiben? AI OpenHands kommt dem verblüffend nahe. Es ist ein Open-Source-"KI-Ingenieur", der Ihr Repo lesen, Code schreiben, Terminals ausführen, Dokumente durchsuchen und iterieren kann – ähnlich einem Junior-Entwickler, der schnell lernt und unermüdlich arbeitet. Aber das Potenzial entfaltet sich erst, wenn Sie es richtig einrichten und lernen, es zu steuern.
Diese Anleitung führt Sie Schritt für Schritt durch die Verwendung von AI OpenHands – von der Installation bis zu fortgeschrittenen Workflows –, damit Sie schneller und mit mehr Vertrauen liefern können.
- Was wir behandeln werden:
- Installationsoptionen und Schnellstart
- OpenHands lokal oder mit Cloud-Modellen ausführen
- Best Practices für Prompts, Repos und Aufgaben
- Bewährte Workflows für Feature-Entwicklung, Debugging, Tests und Dokumentation
- Leitplanken, Datenschutz und Zusammenarbeit
Wichtig: OpenHands wird aktiv vom All Hands-Team und der Community entwickelt. Die offizielle Dokumentation ist Ihr Nordstern für aktuelle Anweisungen und Tipps. Sie können auch praktische Installationsanleitungen von Praktikern verfolgen, die lokale und VM-Setups dokumentiert haben. Für die Ausführung mit lokalen Modellen enthält die Dokumentation ebenfalls spezifische Anleitungen.
Was ist AI OpenHands – und warum sollte man es verwenden?
Stellen Sie sich AI OpenHands als einen KI-Teamkollegen mit einer Tastatur vor. Im Gegensatz zu reinen Chat-Assistenten kann OpenHands:
- Projektdateien öffnen und lesen
- Ein Terminal verwenden, um Befehle, Tests und Linter auszuführen
- Code in Dateien und Verzeichnissen bearbeiten
- Im Web surfen (abhängig von der Konfiguration)
- Schrittweise Pläne vorschlagen und anwenden
Dies macht es ideal für Aufgaben wie die Implementierung von Funktionen, das Beheben von Fehlern, das Schreiben von Tests, das Erstellen von Dokumentationen, das Refactoring und die Modernisierung von Codebasen. Anstatt mit Prompts zu jonglieren und Copy/Paste zu verwenden, geben Sie OpenHands ein Ziel und lassen es iterieren, während Sie seine Bewegungen überwachen.
Schnellstart: Der schnellste Weg, OpenHands zu verwenden
Es gibt verschiedene Möglichkeiten, um loszulegen. Ihre Wahl hängt davon ab, ob Sie ein Cloud-LLM verwenden oder alles lokal ausführen möchten.
Option A: Verwenden Sie ein Cloud-LLM (am einfachsten)
- Befolgen Sie die offiziellen Dokumente "Start Building" und "Getting Started", um die App zu installieren und auszuführen. Typischerweise werden Sie:
- Voraussetzungen installieren (Docker, Node, Python, Git, abhängig vom Pfad)
- Einen API-Schlüssel für ein unterstütztes Cloud-Modell bereitstellen (z. B. OpenAI, Anthropic oder andere, die das Projekt zu diesem Zeitpunkt unterstützt)
- Die OpenHands-Oberfläche starten und Ihr Repository verbinden
Dieser Weg bringt Sie schnell und mit minimalem Rechenaufwand zur Produktivität.
Option B: Führen Sie OpenHands mit einem lokalen LLM aus
- Wenn Sie es vorziehen, Code und Prompts nicht in der Cloud zu speichern oder API-Kosten zu vermeiden, verwenden Sie die Anleitung für lokale LLMs in der offiziellen Dokumentation.
- Ein kompatibles lokales Modell einrichten (über Ollama oder andere Backends, die zu diesem Zeitpunkt unterstützt werden)
- Modell-Endpunkte und Kontextlimits konfigurieren
- Sicherstellen, dass Ihr Rechner über ausreichend VRAM/CPU und Festplattenspeicher verfügt
Option C: Bereitstellung auf einer VM
- Wenn Sie eine dedizierte Umgebung benötigen, haben Praktiker dokumentiert, wie man OpenHands auf einer VM hochfährt und in wenigen Minuten eine App erstellt. Dies ist nützlich für Teams, die eine stabile, gemeinsam genutzte AI-Ingenieur-Instanz wünschen.
Erster Start: Projekteinrichtung und Aufgabenformulierung
OpenHands glänzt, wenn es Ihren Code sehen kann. Beginnen Sie mit:
- Öffnen Sie das Repository, an dem es arbeiten soll.
- Führen Sie das Projekt aus oder indizieren Sie es, damit OpenHands die Struktur abbilden kann.
- Geben Sie ihm ein klares Ziel mit Einschränkungen.
Beispiel für eine gute Aufgabenformulierung:
- "(Füge eine Funktion zum Zurücksetzen des Benutzerpassworts zum
auth-Dienst hinzu, indem du tokenbasierte E-Mail-Links verwendest. Verwende das bestehende mailer-Modul. Füge Unit-Tests für die Token-Generierung und das Ablaufen hinzu. Ändere das Benutzerdatenschema nicht.)"
Warum das funktioniert:
- Es benennt die Komponente, den Umfang, die Abhängigkeiten und die Grenzen. Je klarer Sie sind, desto besser plant und führt OpenHands aus.
So schreiben Sie effektive Prompts für OpenHands
Stellen Sie sich Prompts als prägnante Tickets vor. Die besten:
- Definieren Sie das Ergebnis: "Implementiere X mit Y-Einschränkungen"
- Referenzieren Sie Dateien, Module oder Tests: "Siehe
auth/routes.py und tests/test_auth.py"
- Geben Sie Einschränkungen an: "Keine DB-Schemaänderungen; bestehende Schnittstellen beibehalten"
- Fügen Sie Akzeptanzkriterien hinzu: "Tests sollten bestanden werden:
pytest -k password_reset"
Vorlage, die Sie wiederverwenden können:
Ziel: <Was Sie erstellt oder repariert haben möchten>
Kontext: <Relevante Dateien, bekannte Einschränkungen, externe Dienste>
Akzeptanz: <Wie das Bestehen aussieht: Tests, Endpunkte, Metriken>
Grenzen: <Was nicht geändert werden sollte oder zu vermeidende Ansätze>
Werkzeuge: <Befehle, die es ausführen kann, Skripte oder Datenquellen>
Kern-Workflow: Planen → Ausführen → Überprüfen → Verfeinern
OpenHands schlägt normalerweise einen mehrstufigen Plan vor. So führen Sie es:
- Genehmigen oder passen Sie den Plan frühzeitig an. Drängen Sie es, zuerst Tests auszuführen, um Fehler zu erkennen.
- Fordern Sie es auf, einen Test zu erstellen oder zu aktualisieren, um den Erfolg zu definieren, und implementieren Sie dann den Code.
- Lassen Sie es die Testsuite und die Linter häufig ausführen.
- Wenn es ins Stocken gerät, fügen Sie mehr Kontext hinzu: Dateinamen, Stacktraces oder Protokolle.
Profi-Tipp: Fördern Sie kleine Änderungen in PR-Größe anstelle von monolithischen Änderungen. Dies hilft bei der Überprüfbarkeit und dem Rollback.
Beispiel-Workflows, die Sie kopieren können
1) Feature-Implementierung
- Prompt: "Füge CSV-Export zur
orders-Seite hinzu. Verwende serverseitige Paginierung, streame die Ergebnisse über text/csv. Füge den Export-Button in OrdersTable.jsx und den Endpunkt in routes/orders.ts hinzu. Füge Tests für die Paginierung und die Header hinzu."
- Scannt das Repo; entwirft einen Plan
- Fügt Endpunkt und Client-Button hinzu
- Schreibt Tests und führt sie aus
- Sie überwachen, genehmigen Änderungen und führen sie zusammen, sobald alles in Ordnung ist.
2) Debuggen eines fehlerhaften Builds
- Prompt: "CI schlägt auf Node 20 fehl. Behebe ESM/CJS-Importfehler in
build.mjs. Behalte die bestehenden Rollup-Plugins bei; aktualisiere die Konfiguration und den Code, um CI zu bestehen."
- Stellen Sie Protokolle bereit oder verlinken Sie zu CI-Artefakten.
- Fordern Sie OpenHands auf, sich lokal zu replizieren (
npm run build) und minimale Diffs vorzuschlagen.
3) Testabdeckung und Härtung
- Prompt: "Erhöhe die Abdeckung für
payments/service.py von 62 % auf 85 %+. Füge Unit-Tests für retry_charge, refund, webhook_signature hinzu. Modifiziere die Business-Logik nur, wenn ein Test einen Fehler aufdeckt."
- Lassen Sie OpenHands Tests generieren, ausführen und verfeinern.
4) Dokumentation und Entwicklererfahrung
- Prompt: "Erstelle eine
CONTRIBUTING.md und DEVELOPMENT.md für dieses Repo. Füge Umgebungseinrichtung, Skripte, Testbefehle und PR-Richtlinien hinzu."
- Lassen Sie es die Befehle verifizieren, indem Sie sie tatsächlich ausführen.
Leitplanken: Sorgen Sie dafür, dass OpenHands hilfreich und sicher bleibt
- Verzeichnisumfang: Richten Sie es auf ein bestimmtes Repo oder Verzeichnis, um versehentliche Bearbeitungen an anderer Stelle zu vermeiden.
- Dateischutz: Markieren Sie Konfigurationsdateien oder kritische Infrastruktur nach Möglichkeit als schreibgeschützt.
- Befehlsprüfung: Fordern Sie die Genehmigung für destruktive Befehle an (z. B.
rm -rf, Datenbank-Resets).
- Geheimnis-Hygiene: Fügen Sie niemals API-Schlüssel in Prompts ein. Verwenden Sie Umgebungsvariablen und maskierte Protokolle.
- Netzwerkzugriff: Wenn das Surfen aktiviert ist, verwenden Sie eine Sandbox und protokollieren Sie ausgehende Anrufe.
Lokale vs. Cloud-Modelle: Wählen Sie das Richtige für Sie
- Vorteile: Starke Argumentation/Codierung, minimale Einrichtung, schnelle Iteration
- Nachteile: Laufende Kosten, datenschutzrechtliche Überlegungen
- Vorteile: Datenschutz, Kontrolle, Kostenvorhersagbarkeit
- Nachteile: Hardwareanforderungen, Modellqualität variiert, mehr Tuning erforderlich
Siehe die offiziellen Anweisungen für lokale LLMs, um Modell-Backends und Speicherlimits zu konfigurieren.
Teamarbeit: Verwenden von OpenHands in einem kollaborativen Flow
- Branch-First-Workflow: Lassen Sie OpenHands einen Feature-Branch erstellen und Änderungen zur PR-Überprüfung pushen.
- Commit-Hygiene: Fordern Sie es auf, atomare Commits mit klaren Nachrichten zu erstellen und auf Issue-Nummern zu verweisen.
- PR-Vorlagen: Generieren und erzwingen Sie PR-Vorlagen, damit die Reviewer wissen, was sich geändert hat und warum.
- Code-Eigentümer: Kombinieren Sie dies mit CODEOWNERS, um KI-generierte PRs an die richtigen Reviewer weiterzuleiten.
Fehlerbehebung bei häufigen Problemen
- Es bleibt hängen oder schleift: Beschränken Sie den Umfang. Fordern Sie es auf, seinen nächsten Schritt zu erklären. Stellen Sie einen fehlerhaften Test bereit.
- Unübersichtliche Diffs: Fordern Sie einen kleineren, gestaffelten Plan an – zuerst Tests, dann minimale Codeänderungen.
- Falsche Dateibearbeitungen: Geben Sie genaue Pfade an und erinnern Sie es an die Grenzen.
- Lokale Tests bestehen, aber CI schlägt fehl: Teilen Sie CI-Umgebungsdetails und -Protokolle; lassen Sie es sich mit einem Container replizieren.
Performance-Tipps und Power-Moves
- Warmstart-Kontext: Fordern Sie es auf, zuerst Schlüsseldateien zu lesen (
README, package.json, Hauptdienstdateien).
- Geben Sie ihm Skripte: Stellen Sie ein
make test oder npm run verify bereit, damit es schnell validieren kann.
- Bringen Sie ihm die Domäne bei: Geben Sie einen kurzen architektonischen Überblick; dies zahlt sich in weniger Logikfehlern aus.
- Stil erzwingen: Verweisen Sie auf
.eslintrc, .prettierrc, black/ruff-Konfigurationen, damit es korrekt formatiert.
- Verwenden Sie Checkpoints: Fragen Sie nach jedem Meilenstein nach einer Zusammenfassung und den nächsten Schritten, um es auf dem Laufenden zu halten.
Reales Szenario: Vom Fehlerbericht zum Patch in einer Stunde
- Situation: Ein Produktionsfehler verursacht unbehandelte 500er auf fehlerhafte JSON-Nutzdaten in der
orders-API.
- Ihr Prompt: "Reproduziere den 500er auf fehlerhaftes JSON in
orders POST. Füge Schema-Validierung hinzu und gib 400 mit Fehlerdetails zurück. Aktualisiere die Tests, um fehlerhafte Nutzdaten abzudecken."
- Führt die API lokal aus, reproduziert den Fehler
- Fügt eine Validierungsebene und einen Fehlerhandler hinzu
- Aktualisiert Tests und stellt sicher, dass CI besteht
- Erstellt einen kompakten PR mit einem Changelog-Eintrag
Zeitersparnis: Sie haben sich auf die Auswirkungsanalyse und den Rollout konzentriert, während OpenHands das Gerüst übernommen hat.
Integrationen, die OpenHands aufladen
- Test-Runner: pytest, Jest, Vitest, JUnit
- Build-Tools: Vite, Webpack, Rollup, Babel
- Paketmanager: npm, pnpm, yarn, pip/poetry
- Linter/Formatierer: ESLint, Prettier, black, ruff
- Container: Docker Compose für lokale Parität mit CI
Durch die Standardisierung dieser Tools kann OpenHands Ihre Ihren Stack zuverlässiger interpretieren und mehr vom Entwicklungszyklus automatisieren.
Übrigens: Verwendung von Sider.AI neben OpenHands
Relevanz-Score: 8/10. Wenn Sie OpenHands als Ihren KI-Ingenieur verwenden, lohnt es sich, ihn mit einem Recherche- und Entwurfskopiloten für Spezifikationen, PR-Beschreibungen und Dokumentation zu kombinieren. Übrigens kann Sider.AI Ihnen helfen, schnell technische Spezifikationen zu entwerfen, RFCs zusammenzufassen oder OpenHands-Laufprotokolle in saubere Changelogs und Release Notes umzuwandeln. Die Kombination reduziert den Kontextwechsel: OpenHands übernimmt Code-Aktionen, während Sider.AI die Ergebnisse in saubere, benutzerorientierte Dokumente umwandelt.
Checkliste für Sicherheit, Datenschutz und Compliance
- Bewahren Sie Geheimnisse in Umgebungsvariablen auf; betten Sie niemals Schlüssel in Prompts ein
- Überprüfen Sie jede KI-generierte Änderung, wie Sie es bei einem PR eines Junior-Entwicklers tun würden
- Protokollieren Sie Befehle und Aktionen zur Auditierbarkeit
- Pinnen Sie Toolchain-Versionen; vermeiden Sie versehentliche Upgrades in Lockfiles
- Wenn Sie Cloud-LLMs verwenden, stimmen Sie diese mit Ihren Datenaufbewahrungsrichtlinien ab
Wann Sie OpenHands nicht verwenden sollten
- Neuartiges Algorithmusdesign ohne starkes Test- oder Spezifikationsgerüst
- Stark regulierte Codebasen ohne robusten Überprüfungsprozess
- Einmalige Wegwerfskripte, bei denen manuelles Programmieren schneller ist
Ihre ersten 60 Minuten mit OpenHands: Ein Mini-Playbook
- Minute 0–10: Installieren und starten Sie die offizielle Schnellstartanleitung
- Minute 10–20: Verbinden Sie Ihr Repo; fordern Sie es auf, die Projektstruktur abzubilden
- Minute 20–35: Definieren Sie ein kleines, testbares Ziel; genehmigen Sie seinen Plan
- Minute 35–50: Lassen Sie es implementieren und Tests ausführen; geben Sie bei Bedarf Anstöße
- Minute 50–60: Überprüfen Sie Diffs, verfeinern Sie und führen Sie sie in einen Feature-Branch zusammen
Wichtige Links und nächste Schritte
- Offizielle "Start Building"- und Nutzungsdokumente für OpenHands: Tipps, Schnellstart und Best Practices.
- Anleitung zur Einrichtung lokaler LLMs: Konfigurieren und führen Sie OpenHands vollständig auf Ihrem Rechner aus.
- Community-gesteuerte Installationsanleitung auf einer VM: reale Installationsschritte und ein schnelles Demo-Projekt.
Kernaussagen
- Formulieren Sie Aufgaben wie Tickets mit klaren Akzeptanzkriterien.
- Halten Sie Iterationen klein; testen Sie früh und oft.
- Verwenden Sie Leitplanken und überprüfen Sie Änderungen – behandeln Sie es wie einen Junior-Teamkollegen.
- Wählen Sie Cloud für Komfort, lokale Modelle für Datenschutz.
- Kombinieren Sie es mit Dokumentationstools (z. B. Sider.AI), um Spezifikationen und Release Notes zu beschleunigen.
FAQ
F1:Wie installiere ich AI OpenHands schnell und beginne es zu verwenden?
Verwenden Sie den offiziellen Schnellstart, um die Voraussetzungen zu installieren, ein unterstütztes LLM (Cloud oder lokal) anzuschließen und die Benutzeroberfläche zu starten, um Ihr Repository zu verbinden. Die "Start Building"-Dokumente bieten Schritt-für-Schritt-Anleitungen mit Einrichtungstipps.
F2:Kann ich OpenHands mit einem lokalen LLM anstelle eines Cloud-Modells ausführen?
Ja. Befolgen Sie die Anleitung für lokale LLMs, um ein lokales Modell-Backend zu konfigurieren und die Kontexteinstellungen anzupassen. Dies ist ideal für datenschutzsensible Projekte oder zur Vermeidung von API-Kosten.
F3:Was ist der beste Weg, OpenHands für Programmieraufgaben zu prompten?
Schreiben Sie Prompts wie prägnante Tickets: Definieren Sie das Ziel, referenzieren Sie bestimmte Dateien, legen Sie Grenzen fest und fügen Sie Akzeptanzkriterien hinzu. Fordern Sie es auf, Tests zu erstellen oder auszuführen, um den Fortschritt zu validieren.
F4:Ist AI OpenHands sicher für die Verwendung in Produktionscode?
Behandeln Sie es wie einen Junior-Entwickler: Verwenden Sie Branch-Schutz, Code-Reviews und CI, um Änderungen zu validieren. Fügen Sie Leitplanken für Befehle hinzu und halten Sie Geheimnisse aus Prompts heraus.
F5:Wie schneidet OpenHands im Vergleich zu einem traditionellen Code-Assistenten ab?
Im Gegensatz zu reinen Chat-Tools kann OpenHands Befehle ausführen, Dateien bearbeiten und autonom in Ihrem Repo iterieren. Es ist für End-to-End-Aufgaben wie Funktionen, Debugging und Tests konzipiert.
