Sådan bruges AI OpenHands: En praktisk guide til opsætning, prompter og workflows i den virkelige verden
Hvis du nogensinde har ønsket, at en dygtig udvikler kunne parprogrammere med dig 24/7, kommer AI OpenHands slående tæt på. Det er en open source "AI-ingeniør", der kan læse dit repo, skrive kode, køre terminaler, browse dokumenter og iterere – ligesom en juniorudvikler, der lærer hurtigt og arbejder utrætteligt. Men kraften frigøres først, når du har konfigureret det korrekt og lært at styre det.
Denne guide fører dig trin for trin gennem, hvordan du bruger AI OpenHands – fra installation til avancerede workflows – så du kan levere hurtigere med selvtillid.
- Installationsmuligheder og hurtig start
- Kørsel af OpenHands lokalt eller med cloud-modeller
- Best practices for prompter, repos og opgaver
- Dokumenterede workflows til feature-arbejde, debugging, tests og dokumenter
- Sikkerhedsforanstaltninger, privatliv og samarbejde
Værd at bemærke: OpenHands er aktivt udviklet af All Hands-teamet og fællesskabet. De officielle dokumenter er din rettesnor for aktuelle instruktioner og tips. Du kan også følge praktiske installationsguider fra praktikere, der har dokumenteret lokale og VM-opsætninger. Til kørsel med lokale modeller indeholder dokumenterne også specifik vejledning.
Hvad er AI OpenHands – og hvorfor bruge det?
Tænk på AI OpenHands som en AI-holdkammerat med et tastatur. I modsætning til chat-baserede assistenter kan OpenHands:
- Åbne og læse projektfiler
- Bruge en terminal til at køre kommandoer, tests og linters
- Redigere kode på tværs af filer og mapper
- Browse på internettet (afhængigt af konfigurationen)
- Foreslå og anvende trin-for-trin-planer
Dette gør det ideelt til opgaver som implementering af features, fejlrettelser, skrivning af tests, oprettelse af dokumenter, refactoring og modernisering af kodebaser. I stedet for at jonglere med prompter og kopiere/indsætte giver du OpenHands et mål og lader det iterere, mens du overvåger dets handlinger.
Hurtig start: Den hurtigste måde at bruge OpenHands på
Der er flere måder at komme i gang på. Dit valg afhænger af, om du vil bruge en cloud-LLM eller køre alt lokalt.
Valgmulighed A: Brug en Cloud LLM (lettest)
- Følg de officielle "Start Building" og "Getting Started" dokumenter for at installere og køre appen. Du vil typisk:
- Installere forudsætninger (Docker, Node, Python, Git afhængigt af stien)
- Angive en API-nøgle til en understøttet cloud-model (f.eks. OpenAI, Anthropic eller andre, som projektet understøtter på det tidspunkt)
- Starte OpenHands-grænsefladen og forbinde dit repository
Denne sti gør dig hurtigt produktiv med minimal compute-overhead.
Valgmulighed B: Kør OpenHands med en lokal LLM
- Hvis du foretrækker at holde kode og prompter væk fra skyen eller vil undgå API-omkostninger, skal du bruge guiden Lokale LLM'er i de officielle dokumenter.
- Konfigurere en kompatibel lokal model (via Ollama eller andre backends, der understøttes på det tidspunkt)
- Konfigurere model endpoints og kontekstgrænser
- Sikre, at din maskine har tilstrækkelig VRAM/CPU og diskplads
Valgmulighed C: Deploy til en VM
- Hvis du har brug for et dedikeret miljø, har praktikere dokumenteret, hvordan du kan spinne OpenHands op på en VM og bygge en app på få minutter. Dette er nyttigt for teams, der ønsker en stabil, delt AI-ingeniørinstans.
Første kørsel: Projektopsætning og opgaveformulering
OpenHands brillerer, når det kan se din kode. Start med at:
- Åbne det repository, du ønsker, at det skal arbejde på.
- Køre eller indeksere projektet, så OpenHands kan kortlægge strukturen.
- Give det et klart mål med begrænsninger.
Godt eksempel på opgaveformulering:
- "Tilføj nulstilling af brugeradgangskode til
auth-tjenesten ved hjælp af token-baserede e-mail-links. Brug eksisterende mailer-modul. Tilføj enhedstests for token-generering og udløb. Undlad at ændre brugerdataskema."
Hvorfor dette virker:
- Det navngiver komponenten, omfanget, afhængighederne og grænserne. Jo tydeligere du er, jo bedre planlægger og udfører OpenHands.
Sådan skriver du effektive prompter til OpenHands
Tænk på prompter som præcise tickets. De bedste:
- Definerer resultatet: "Implementer X med Y-begrænsninger"
- Refererer til filer, moduler eller tests: "Se
auth/routes.py og tests/test_auth.py"
- Angiver begrænsninger: "Ingen DB-skemaændringer; behold eksisterende grænseflader"
- Inkluderer acceptkriterier: "Tests skal bestå:
pytest -k password_reset"
Skabelon, du kan genbruge:
Mål: <Hvad du ønsker bygget eller rettet>
Kontekst: <Relevante filer, kendte begrænsninger, eksterne tjenester>
Accept: <Hvordan bestået ser ud: tests, endpoints, metrics>
Grænser: <Hvad der ikke skal ændres, eller tilgange der skal undgås>
Værktøjer: <Kommandoer, den kan køre, scripts eller datakilder>
Kernekworkflow: Planlæg → Udfør → Verificer → Forfin
OpenHands foreslår normalt en plan i flere trin. Sådan guider du det:
- Godkend eller juster dets plan tidligt. Pres det til at køre tests først for at baseline fejl.
- Bed det om at oprette eller opdatere en test for at definere succes, og implementer derefter koden.
- Få det til at køre testsuiten og linters ofte.
- Hvis det går i stå, skal du tilføje mere kontekst: filnavne, stack traces eller logs.
Pro tip: Tilskynd til små PR-størrelse ændringer i stedet for monolitiske redigeringer. Dette hjælper med gennemgang og rollback.
Eksempel på workflows, du kan kopiere
1) Feature-implementering
- Prompt: "Tilføj CSV-eksport til
orders-siden. Brug server-side pagination, stream resultater via text/csv. Tilføj Eksport-knap i OrdersTable.jsx og endpoint i routes/orders.ts. Inkluder tests for pagination og headers."
- Scanner repo; udarbejder plan
- Tilføjer endpoint og klientknap
- Skriver tests og kører dem
- Du overvåger, godkender ændringer og merger, når den er grøn.
2) Fejlfinding af en mislykket build
- Prompt: "CI fejler på Node 20. Ret ESM/CJS importfejl i
build.mjs. Behold eksisterende rollup-plugins; opdater konfiguration og kode for at bestå CI."
- Angiv logs eller link til CI-artefakter.
- Bed OpenHands om at replikere lokalt (
npm run build) og foreslå minimale diffs.
3) Testdækning og hærding
- Prompt: "Øg dækningen for
payments/service.py fra 62% til 85%+. Tilføj enhedstests for retry_charge, refund, webhook_signature. Undlad at ændre forretningslogik, medmindre testen afslører en fejl."
- Lad OpenHands generere tests, køre dem og forfine.
4) Dokumenter og udvikleroplevelse
- Prompt: "Opret en
CONTRIBUTING.md og DEVELOPMENT.md til dette repo. Inkluder miljøopsætning, scripts, testkommandoer og PR-retningslinjer."
- Få det til at verificere kommandoer ved faktisk at køre dem.
Sikkerhedsforanstaltninger: Hold OpenHands hjælpsom og sikker
- Mappebegrænsning: Peg den på et specifikt repo eller mappe for at undgå utilsigtet redigering andre steder.
- Filbeskyttelse: Marker konfigurationsfiler eller kritisk infrastruktur som skrivebeskyttet, hvor det er muligt.
- Kommandoauditering: Kræv godkendelse for destruktive kommandoer (f.eks.
rm -rf, nulstilling af databaser).
- Hemmelighedshygiejne: Indsæt aldrig API-nøgler i prompter. Brug miljøvariabler og maskerede logs.
- Netværksadgang: Hvis browsing er aktiveret, skal du sandkasse den og logge udgående opkald.
Lokale vs. Cloud-modeller: Valg af det rigtige for dig
- Fordele: Stærk ræsonnement/kodning, minimal opsætning, hurtig iteration
- Ulemper: Løbende omkostninger, overvejelser om datastyring
- Fordele: Privatliv, kontrol, forudsigelighed af omkostninger
- Ulemper: Hardwarekrav, modelkvalitet varierer, mere tuning er nødvendig
Se de officielle instruktioner for Lokale LLM'er for at konfigurere model backends og hukommelsesgrænser.
Team Play: Brug af OpenHands i et samarbejdende flow
- Branch-first workflow: Få OpenHands til at oprette en feature branch og pushe ændringer til PR-gennemgang.
- Commit-hygiejne: Bed den om at producere atomiske commits med klare beskeder og referere til issue-numre.
- PR-skabeloner: Generer og håndhæv PR-skabeloner, så korrekturlæsere ved, hvad der er ændret, og hvorfor.
- Kodeejere: Kombiner med CODEOWNERS for at dirigere AI-genererede PR'er til de rigtige korrekturlæsere.
Fejlfinding af almindelige problemer
- Den går i stå eller looper: Indsnævre omfanget. Bed den om at forklare sit næste trin. Angiv en mislykket test.
- Rodede diffs: Anmod om en mindre, staged plan – tests først, derefter minimale kodeændringer.
- Forkerte filredigeringer: Angiv nøjagtige stier og mind den om grænser.
- Bestået lokalt, men fejler i CI: Del CI-miljødetaljer og logs; få den til at replikere med en container.
Ydelsestips og Power Moves
- Varm-start kontekst: Bed den om at læse nøglefiler først (
README, package.json, vigtigste tjenestefiler).
- Giv den scripts: Angiv en
make test eller npm run verify, så den hurtigt kan validere.
- Lær domænet: Tilbyd et kort arkitektonisk overblik; det betaler sig i færre logikfejl.
- Håndhæv stil: Peg på
.eslintrc, .prettierrc, black/ruff konfigurationer, så den formaterer korrekt.
- Brug checkpoints: Efter hver milepæl skal du bede om en opsummering og næste trin for at holde den på sporet.
Real-World Scenario: Fra fejlrapport til patch på en time
- Situation: En produktionsfejl dropper uhåndterede 500'ere på forkert udformede JSON-payloads i
orders API.
- Din prompt: "Reproducer 500'eren på forkert udformet JSON i
orders POST. Tilføj skemavalidering og returner 400 med fejldetaljer. Opdater tests for at dække forkert udformede payloads."
- Kører API'en lokalt, reproducerer fejl
- Tilføjer et valideringslag og fejlhåndtering
- Opdaterer tests og sikrer, at CI består
- Producerer en kompakt PR med en changelog-post
Sparret tid: Du fokuserede på konsekvensanalyse og udrulning, mens OpenHands håndterede stilladset.
Integrationer, der Supercharge OpenHands
- Test runners: pytest, Jest, Vitest, JUnit
- Build tools: Vite, Webpack, Rollup, Babel
- Package managers: npm, pnpm, yarn, pip/poetry
- Linters/formatters: ESLint, Prettier, black, ruff
- Containere: Docker Compose for lokal paritet med CI
Ved at standardisere disse værktøjer kan OpenHands ræsonnere mere pålideligt om din stack og automatisere mere af dev loop.
I øvrigt: Brug af Sider.AI sammen med OpenHands
Relevansscore: 8/10. Hvis du bruger OpenHands som din AI-ingeniør, er det værd at parre det med en research- og udkastskopilot til specifikationer, PR-beskrivelser og dokumentation. Forresten kan Sider.AI hjælpe dig med hurtigt at udarbejde tekniske specifikationer, opsummere RFC'er eller transformere OpenHands-kørselslogs til rene changelogs og release notes. Kombinationen reducerer kontekstskift: OpenHands håndterer kodehandlinger, mens Sider.AI forvandler resultater til rene, brugerrettede dokumenter.
Tjekliste for sikkerhed, privatliv og overholdelse
- Opbevar hemmeligheder i env vars; indlej aldrig nøgler i prompter
- Gennemgå enhver AI-genereret ændring, som du ville gøre med en juniorudviklers PR
- Log kommandoer og handlinger for auditering
- Fastgør toolchain-versioner; undgå utilsigtede opgraderinger i lockfiles
- Hvis du bruger cloud LLM'er, skal du tilpasse dig dine dataopbevaringspolitikker
Hvornår du ikke skal bruge OpenHands
- Ny algoritmedesign uden stærk test- eller specifikationsstillads
- Stærkt regulerede kodebaser uden en robust gennemgangsproces
- Engangs-throwaway-scripts, hvor manuel kodning er hurtigere
Dine første 60 minutter med OpenHands: En mini-playbook
- Minut 0–10: Installer og start ved hjælp af den officielle Quickstart
- Minut 10–20: Tilslut dit repo; bed det om at kortlægge projektstrukturen
- Minut 20–35: Definer et lille, testbart mål; godkend dets plan
- Minut 35–50: Lad det implementere og køre tests; skub til efter behov
- Minut 50–60: Gennemgå diffs, forfin og merge til en feature branch
Vigtige links og næste trin
- Officielle "Start Building" og brugsdokumenter til OpenHands: tips, quickstart og best practices.
- Lokal LLM-opsætningsguide: konfigurer og kør OpenHands udelukkende på din maskine.
- Fællesskabsdrevet installationsgennemgang på en VM: installationstrin fra den virkelige verden og et hurtigt demoprojekt.
Takeaways
- Indram opgaver som tickets med klare acceptkriterier.
- Hold iterationer små; test tidligt og ofte.
- Brug sikkerhedsforanstaltninger og gennemgå ændringer – behandl det som en juniorholdkammerat.
- Vælg cloud for bekvemmelighed, lokale modeller for privatliv.
- Par med dokumentationsværktøjer (f.eks. Sider.AI) for at fremskynde specifikationer og release notes.
FAQ
Q1:Hvordan installerer jeg og begynder at bruge AI OpenHands hurtigt?
Brug den officielle quickstart til at installere forudsætninger, tilslutte en understøttet LLM (cloud eller lokal) og starte UI'en for at forbinde dit repository. "Start Building"-dokumenterne giver trin-for-trin-instruktioner med opsætningstips.
Q2:Kan jeg køre OpenHands med en lokal LLM i stedet for en cloud-model?
Ja. Følg guiden Lokale LLM'er for at konfigurere en lokal model backend og justere kontekstindstillinger. Dette er ideelt til privatlivsfølsomme projekter eller undgåelse af API-omkostninger.
Q3:Hvad er den bedste måde at prompte OpenHands til kodningsopgaver?
Skriv prompter som præcise tickets: definer målet, referer til specifikke filer, sæt grænser og inkluder acceptkriterier. Bed den om at oprette eller køre tests for at validere fremskridt.
Q4:Er AI OpenHands sikker at bruge på produktionskode?
Behandl det som en juniorudvikler: brug branch-beskyttelse, kodegennemgang og CI til at validere ændringer. Tilføj sikkerhedsforanstaltninger for kommandoer og hold hemmeligheder ude af prompter.
Q5:Hvordan sammenlignes OpenHands med en traditionel kodeassistent?
I modsætning til chat-only værktøjer kan OpenHands køre kommandoer, redigere filer og iterere autonomt inden for dit repo. Den er bygget til end-to-end opgaver som features, debugging og tests.
