Handbücher · Agent-Harnesses
Harness-Landschaft
Lernziele
- Du kennst acht verbreitete Harnesses und weißt, wofür jeder gebaut ist.
- Du wählst für ein konkretes Vorhaben einen passenden Harness und begründest die Wahl.
Diese Übersicht zeigt, was im November 2026 lebt, mit je einer Einschätzung. Alle Harnesses fahren denselben Loop aus Was ein Harness ist. Sie unterscheiden sich darin, wie viel Maschinerie sie darum legen und wessen Entscheidungen du übernimmst. Versionen und Termine ändern sich schnell. Alle Angaben haben den Stand vom November 2026.
Die wichtigsten Optionen
-
Claude Agent SDK (Anthropic, Python und TypeScript). Der Loop von Claude Code als Bibliothek, mit Berechtigungen, Hooks, Subagents, Skills und Kompaktierung. Nach unserer Einschätzung der vollständigste Harness, den du komplett übernehmen kannst. Der Preis: die Entscheidungen von Anthropic, und am besten arbeiten darin die Modelle von Anthropic. Details in Claude Code als Harness.
-
OpenAI Agents SDK (Python und TypeScript). Leichtgewichtig, mit drei Grundbausteinen: Agents, Handoffs und Guardrails. Sessions und Sandbox-Agents kommen als Funktionen dazu. Im April 2026 bekam das SDK einen „model-native harness“ und Sandbox-Ausführung, zuerst in Python. Die TypeScript-Fassung zog im Mai 2026 mit Sandbox-Agents nach. Das SDK gehört zum Paket AgentKit. Dessen grafischer Agent Builder wird am 30. November 2026 abgeschaltet. Setz also auf das SDK.
-
LangGraph (LangChain, Python und JavaScript). Agenten als ausdrückliche Zustandsgraphen, Version 1.0 seit Oktober 2025, mit dauerhafter Ausführung, die nach einem Absturz an der richtigen Stelle weiterläuft, und Unterbrechungen für menschliche Freigaben. Im Produktivbetrieb bewährt und schwergewichtig. Nach unserer Einschätzung wählst du es, wenn du einen nachprüfbaren Kontrollfluss brauchst.
-
Vercel AI SDK (TypeScript). Version 6 vom Dezember 2025 machte aus dem Streaming-Baukasten einen echten Harness:
ToolLoopAgent, Freigaben für Tools und volle MCP-Unterstützung. Seit Juni 2026 ist Version 7 aktuell, mitWorkflowAgentfür dauerhafte, fortsetzbare Abläufe und dem experimentellenHarnessAgent, der Claude Code, Codex und pi ansteuert. Nach unserer Einschätzung die vernünftige Wahl, wenn dein Agent in einem Webprodukt lebt. -
smolagents (Hugging Face, Python). Laut README passt die Logik der Agenten in rund 1.000 Zeilen. Agenten schreiben ihre Aktionen als Python-Code, statt Tools per JSON aufzurufen. Der schnellste Weg zu einem laufenden Loop und nach unserer Einschätzung die beste Codebasis zum Lernen. Für den Produktivbetrieb bewusst dünn. Das letzte Release stammt vom Mai 2026.
-
OpenHands (früher OpenDevin, das Repository liegt heute bei der Organisation OpenHands). Autonome Softwareentwicklung als Open Source: Laufzeit in der Sandbox, Browser und eine Cloud-Plattform unter openhands.dev. Die Referenz dafür, wie ein vollständig abgeschotteter Coding-Harness aussieht. Selbst zu betreiben ist er aufwendiger als ein Werkzeug für die Kommandozeile.
-
pi (Earendil, früher
badlogic/pi-mono, Hauptentwickler laut GitHub Mario Zechner, Doku unter pi.dev). Ein bewusst minimaler Harness für das Terminal. Du erweiterst ihn mit TypeScript-Modulen und kommst mit wenig Konfiguration aus. Bei Databricks schickte pi bei gleichem Modell rund ein Drittel des Kontexts pro Runde bei gleicher Qualität. Minimalismus als Context Engineering und ein Beleg dafür, dass der Harness die Zahlen bewegt. -
Pydantic AI (Python). Typsichere Agenten vom Team hinter Pydantic, durchgehend typisiert. Unspektakulär im besten Sinn. Nach unserer Einschätzung eine starke Wahl, wenn strukturierte Ausgaben die ganze Aufgabe sind.
| Harness | Sprache | Stärke | Abwägung |
|---|---|---|---|
| Claude Agent SDK | Python, TypeScript | vollständig: Rechte, Hooks, Subagents, Skills | Entscheidungen und Modelle von Anthropic |
| OpenAI Agents SDK | Python, TypeScript | leicht, Handoffs, Sandbox-Agents | Harness auf OpenAI-Modelle abgestimmt |
| LangGraph | Python, JavaScript | nachprüfbarer Kontrollfluss, dauerhafte Ausführung | schwergewichtig |
| Vercel AI SDK 7 | TypeScript | passt in Webprodukte, Freigaben, MCP | auf TypeScript festgelegt |
| smolagents | Python | Code als Aktion, gut lesbar | dünn für den Produktivbetrieb |
| OpenHands | Python | vollständige Sandbox für Coding | aufwendig selbst zu betreiben |
| pi | TypeScript | minimal, wenig Kontext pro Runde | wenig fertige Maschinerie |
| Pydantic AI | Python | Typen und strukturierte Ausgaben | kein fertiger Coding-Agent |
Wie du wählst
Baust du auf Claude: Agent SDK. Lebt der Agent in einem Webprodukt mit TypeScript: Vercel AI SDK. Brauchst du ausdrückliche Kontrolle über den Ablauf: LangGraph. Zum Lernen: smolagents, danach den Code von pi lesen. Für eine Infrastruktur autonomer Coding-Agenten: OpenHands. Die meisten Teams brauchen einen einzigen Harness und die Disziplin, ihn gut zu füttern.
Welcher Harness passt?
Ordne jedes Vorhaben dem Harness zu, den diese Lektion dafür empfiehlt.
Noch offen (5)
- Ein Coding-Agent auf Claude, der mit Hooks und Subagents in deiner eigenen Infrastruktur läuft.
- Ein Assistent in einer Next.js-App, der vor dem Versand einer Bestellung eine Freigabe einholt.
- Ein Kreditprozess, bei dem die Prüfung jeden Schritt und jede Verzweigung nachvollziehen muss.
- Ein Wochenende, an dem du verstehen willst, wie ein Agenten-Loop von innen aussieht.
- Eine Plattform, auf der viele Coding-Agenten abgeschottet in Sandboxen an Tickets arbeiten.
Claude Agent SDK (0)
Vercel AI SDK (0)
LangGraph (0)
smolagents (0)
OpenHands (0)
Merksätze
- Alle Harnesses fahren denselben Loop. Sie unterscheiden sich in der Maschinerie darum und in den Entscheidungen, die du übernimmst.
- Claude Agent SDK für Claude, Vercel AI SDK für Webprodukte, LangGraph für nachprüfbaren Ablauf, smolagents zum Lernen, OpenHands für abgeschottete Coding-Agenten.
- Pi zeigt, dass ein minimaler Harness bei gleicher Qualität mit einem Drittel des Kontexts auskommen kann.
- Ein Harness und die Disziplin, ihn gut zu füttern, bringen mehr als ein Vergleich aller Frameworks.
Prüf dich selbst
Denkfrage
Ein Team baut seit einem Monat im Agent Builder von OpenAI. Was rätst du?
Den Umzug auf das Agents SDK jetzt zu planen. Der Agent Builder wird am 30. November 2026 abgeschaltet. Das SDK bietet dieselben Bausteine als Code und hat seit April 2026 Sandbox-Ausführung.
Denkfrage
Warum lohnt es sich, nach smolagents noch den Code von pi zu lesen?
Smolagents zeigt den Loop mit Code als Aktion in sehr wenig Code. Pi ist ein vollständiger Harness, der trotzdem klein genug zum Lesen ist. Dort siehst du, wie Tools, Erweiterungen und Kontextverwaltung ohne viel Zeremonie zusammenspielen.
Prüf dich selbst
Quellen
- Agent SDK overview
Claude Code als Bibliothek.
- OpenAI Agents SDK
Agents, Handoffs, Guardrails, Sessions, Sandbox-Agents.
- The next evolution of the Agents SDK
Model-native harness und Sandbox-Ausführung.
- Deprecations
Agent Builder und Evals ab 30. November 2026 abgeschaltet.
- LangChain and LangGraph Agent Frameworks Reach v1.0 Milestones
LangGraph 1.0.
- AI SDK 6
ToolLoopAgent, Freigaben, MCP.
- AI SDK 7
WorkflowAgent, HarnessAgent (experimentell).
- smolagents
Code-Agenten in rund 1.000 Zeilen.
- OpenHands
Abgeschotteter Coding-Harness.
- pi
Minimaler, erweiterbarer Harness.
- Pydantic AI
Typsichere Agenten.
- Benchmarking Coding Agents on Databricks’ Multi-Million Line Codebase
Pi gegen Claude Code und Codex.