Ein Claude-Modell auswählen
Der Opus/Sonnet/Haiku-Tradeoff und wie du wählst — ohne zu raten.
Tokens, Kontext & Preise
Tokens korrekt zählen, max_tokens vs. Kontextfenster und Kosten abschätzen.
Dein erster API-Aufruf
Installiere das SDK, authentifiziere dich und führe einen echten Aufruf an Claude in Python, TypeScript oder cURL aus.
API-Version 2026-10-21 — die erste Breaking-Version seit drei Jahren
Der Header anthropic-version von Claude hat sich zum ersten Mal seit 2023 bewegt. Was bricht, warum Ihr Paketmanager entscheidet, wann Sie umsteigen, und die genaue Upgrade-Reihenfolge.
Streaming & Konversationen über mehrere Runden
Antworten streamen und den Verlauf bei einer zustandslosen API selbst verwalten.
Tool-Nutzung / Function Calling
Tools definieren, die agentische Schleife ausführen und Ergebnisse verarbeiten — inklusive der drei Regeln zur Nachrichtenform, die 400er verursachen, und warum tool_choice "any" und "tool" auf den neuesten Claude-Modellen jetzt einen Fehler liefern.
Code Execution Tool — Sandboxed Bash, Dateien und Python
Anthropics serverseitige Sandbox lässt Claude Bash ausführen, Dateien bearbeiten und Python laufen lassen — mit 5 GiB RAM, 30 Tagen Container-Wiederverwendung und 1.550 kostenlosen Stunden pro Monat. Die drei Tool-Versionen, was jede hinzufügt, wann es kostenlos ist und die Datei-Erfassungsfalle, die niemand dokumentiert.
Vision, PDF & Datei-Eingabe
Sende Bilder und Dokumente und verwende Uploads per file_id wieder.
Strukturierte Ausgabe
Erhalte schemakonformes JSON, auf das du dich verlassen kannst — kein Prompt-and-Pray.
Extended Thinking & Effort
Adaptives Reasoning und die Effort-Steuerung — die Tiefe nach Arbeitslast wählen.
Effort-Tuning: 5 Stufen, Modell-Standards und die Cache-Falle
Der Effort-Parameter vom Juli 2026 hat fünf Stufen — low, medium, high, xhigh, max — und gehört in output_config, nicht auf die oberste Ebene. Er wirkt auf Tool-Aufrufe (nicht nur auf das Denken), macht den Prompt-Cache ungültig, wenn er mitten in einer Unterhaltung geändert wird, und jedes Modell hat einen anderen empfohlenen Startpunkt. Der praktische Tuning-Leitfaden.
Das Advisor-Tool: Sonnet macht die Arbeit, Fable macht das Denken
Das Advisor-Server-Tool (Beta advisor-tool-2026-03-01) lässt ein schnelles Executor-Modell während des Turns ein stärkeres Modell konsultieren. Vollständige Feld-Referenz, die Token-Abrechnungs-Falle, die die meisten Integratoren verpassen, die Modell-Paarungs-Matrix und die exakten Prompts, die Anthropic in Produktion ausliefert.
Task Budgets — Beratende Token-Obergrenzen, damit Agenten sauber zum Abschluss kommen
Die Messages-API-Beta vom März 2026 gibt Claude ein Token-Budget für die gesamte agentische Schleife — Denken, Tool-Aufrufe, Tool-Ergebnisse, Ausgabe — sodass langlaufende Agenten sich selbst regulieren und sauber abschließen, statt davonzulaufen. Wie der Countdown funktioniert, warum er beratend und nicht erzwungen ist, und wie man ihn dimensioniert, damit er kein ablehnungsähnliches Verhalten auslöst.
Prompt-Caching & Kostenoptimierung
Einen stabilen Prompt-Präfix wiederverwenden, um Kosten und Latenz zu senken — und die Falle, die es zunichtemacht.
Cache-Diagnostik — Finde genau heraus, warum dein Cache nicht traf
Hör auf zu raten, warum cache_read_input_tokens null ist. Die API sagt dir, welcher Teil deines Prompts abgewichen ist und um wie viele Tokens.
Message Batches — Asynchrone Jobs mit 50 % Rabatt
Kosten halbieren und Durchsatz steigern, indem du Massenarbeit in die asynchrone Batches API verlagerst — mit den Fallen, über die Leute stolpern.
System-Nachrichten mitten in der Konversation
Eine lange Agent-Sitzung steuern, ohne den Prompt-Cache zu sprengen — die neue System-Rolle, die du nach jedem User-Turn anhängen kannst.
Mid-Conversation Tool Changes
Tools zwischen Runden hinzufügen und zurückziehen, ohne den Prompt-Cache zu invalidieren — die Opus-5-Beta, die die größte versteckte Steuer auf lange Agenten-Sessions behebt.
Agenten auf der API bauen
Einzelaufruf vs. Workflow vs. eigener Agent — der Entscheidungstest und das Design der Schleife.
Verwaltete Agenten
Von Anthropic gehosteter Agent-Loop: Agenten vs. Sessions, Umgebungen, Memory, Vaults und geplante Deployments (Cron).
Managed Agents Memory Stores
Die Beta vom Juli 2026 — serverseitiger persistenter Speicher, der in eine Managed-Agents-Sandbox eingehängt wird, mit Versionierung, Audit-Trail und Redaction.
Session-Budgets für Managed Agents
Die Beta vom August 2026 — harte Dollar-Obergrenzen für eine Managed-Agents-Session, durchgesetzt zu öffentlichen Listenpreisen, mit dem stop_reason budget_reached, dem Ein-Request-Überschuss und dem Pause-und-Resume-Modell.
Managed Agents Domain-Beschränkungen
Die Beta vom 26. August 2026 — allowed_domains, blocked_domains, max_content_tokens und user_location auf web_search und web_fetch in Managed Agents. Formatregeln, Multiagent-Semantik, Updates mitten in der Session und der url_not_allowed-Fehler.
Cowork & Agententeams
Der agentische Desktop-Arbeitsbereich und Multi-Agenten-Zusammenarbeit als Produkte.
MCP & Verbindung zu Tools
Remote-MCP-Server direkt aus der Messages-API aufrufen — Request-Form, Allowlists und Denylists, verzögertes Laden und die Grenzen, die in der Produktion beißen.
MCP 2026-07-28: Die zustandslose Spezifikation
Die größte MCP-Revision seit dem Start: die Session ist weg, jede Anfrage beschreibt sich selbst, und jede Serverinstanz kann jeden Aufruf beantworten. Was sich am 28. Juli 2026 tatsächlich geändert hat — und wie du migrierst, ohne die heutigen Server zu brechen.
MCP Apps: Interaktive UIs innerhalb eines Tool-Calls
MCP Apps (SEP-1865) erlaubt einem MCP-Server, eine HTML-UI auszuliefern, die der Client in einem sandboxed iframe rendert — wobei jede Aktion weiterhin über den standardmäßigen JSON-RPC-Audit-Pfad läuft. Was die Spec tatsächlich sagt, was man damit bauen soll und was man abzulehnen hat.
MCP Tasks: Langlaufende Arbeit ohne Session
Die 2026-07-28 stateless MCP-Spec hat die Session getötet — wie modelliert man also einen 20-minütigen CI-Job, einen Batch-Import oder ein menschliches Approval-Gate? Mit der offiziellen Tasks-Extension (SEP-2663). Vollständiger Lifecycle, Wire-Protocol, Migration von der alten experimentellen Tasks-API und die Polling-/Notification-Muster, die in Produktion tatsächlich funktionieren.
Playwright MCP: Der praxisnahe Deep-Dive (2026)
Microsofts Playwright MCP ist inzwischen der weltweit meistinstallierte MCP-Server – noch vor GitHub und Figma. Der Teil, den fast niemand erklärt: Der voreingestellte Accessibility-Snapshot-Modus ist nicht nur schneller als Vision, er ist ein komplett anderes Automatisierungsparadigma. Profile, opt-in Caps, Browser-Extension-Modus, der sich an Ihr echtes Chrome hängt, der Token-Cost-Kampf gegen Playwright-als-Skill – und die Sicherheitsgrenze, die Sie nicht überschreiten dürfen.
Sicherheit, Verweigerungen & Fallbacks
Verweigerungen souverän behandeln und sie von Classifier-Blocks unterscheiden.
Serverseitige Fallbacks & Fallback Credit
Die Opus-5-Beta, die eine Fable-5- / Opus-5-Refusal innerhalb eines API-Aufrufs in eine normale Antwort verwandelt — plus das Credit-Token, das dich davor bewahrt, den Prompt-Cache beim Retry doppelt zu bezahlen.
Fehler, Rate Limits & Zuverlässigkeit
Die Fehlerübersicht, Wiederholungen mit Backoff, Rate-Limit-Stufen und Modellmigration.
Memory & Context Editing
Gib Agenten persistentes Gedächtnis und automatisch beschnittenen Kontext — das clientseitige memory tool plus Context Editing, das veraltete Tool-Ergebnisse löscht, um lange Läufe zu überstehen.
Conversation Compaction — Verlauf serverseitig zusammenfassen und weitermachen
Die Messages API kann eine Konversation in einen einzigen signierten Block zusammenfassen, den du anstelle der Nachrichten zurückschickst, die er ersetzt. Die vier Varianten (on demand, Keep-Tail, Hintergrund, Schwellenwert), die Austauschregeln, die zwei Fehler, die stillschweigend mit HTTP 200 durchgehen, und was eine Zusammenfassung niemals mitnehmen kann.
Tool Search & Deferred Loading
Auf Tausende Tools skalieren, ohne den Kontext aufzublähen: wie defer_loading und das Tool-Search-Tool tatsächlich funktionieren, die fünf 400er, die sie erzeugen, und warum Ihr Request-Body nicht kleiner wird.
Message Threads — nur den neuen Turn senden
Die Messages API kann deine Konversation auf dem Server halten, sodass jeder Turn nur die neuen Nachrichten sendet. Was das wirklich spart (Bytes und Latenz, nicht Tokens), der Replay-Pfad, den du vor dem Release bauen musst, die drei Feldgruppen und das Limit von 4 Cache-Breakpoints.
Programmatisches Tool Calling
Claude ruft deine Tools aus Python heraus in der Code-Execution-Sandbox auf — das spart Roundtrips und hält Zwischenergebnisse aus dem Kontext heraus.
Die Admin-API: automatisiere deine Claude-Org
Der Operator-Leitfaden für Anthropics Admin-API — Mitglieder listen, Nutzer einladen, RBAC-Gruppen führen, sauber offboarden. Console + Claude Enterprise, mit den Seat-Pool- und SSO-Fallstricken, die echte Teams treffen.
Agent-Observability: einen Agenten tracen, den man nicht reproduzieren kann
Ein Agentenlauf ist ein nicht-deterministischer verteilter Trace, also lässt er sich nicht durch erneutes Ausführen debuggen — man muss ihn aufgezeichnet haben. Diese Seite behandelt, was aufzuzeichnen ist: die OpenTelemetry-GenAI-Span-Formen (und warum jedes gen_ai.*-Attribut noch immer „Development“ ist), die exakten Metrik- und Event-Namen von Claude Code, die request-id, die Ihren Trace mit dem Anthropic-Support verknüpft, und die drei Datenschutzfallen in der Agenten-Telemetrie.
First-Party-OpenTelemetry-Tracing: zwei Pfade, ein Trace
Seit Oktober 2026 senden die Claude API und das Claude SDK OpenTelemetry-Spans selbst — ohne handgeschriebene Instrumentierung. Aber die beiden Pfade überlappen sich, und beide zu summieren verdoppelt Ihre Token-Zahlen. Diese Seite behandelt die Einrichtung für jeden Pfad, die eine Regel, die Token-Zahlen ehrlich hält, das traceparent-Flag, das Ihre Traces stillschweigend löscht, und die Zustellregeln, die ein Ziel nach 24 Stunden deaktivieren.
Die Usage-&-Cost-Analytics-API: jeden Dollar zuordnen
Der praktische Leitfaden zur Usage-and-Cost-Analytics-API von Claude — die Beta, die die älteren Endpunkte usage_report und cost_report abgelöst hat. Zeilenform, das Limit von fünf Dimensionen, die Semantik der Akteure, die Cent-Falle (Faktor 100), Regeln zur Datenaktualität, die naive Dashboards brechen, und die Migrationstabelle vom Legacy-Stand.
Inference Hooks: Inline-DLP für Claude Enterprise
Der Betreiberleitfaden zu Claude Enterprise Inference Hooks – der HTTPS-Webhook, mit dem Ihr DLP-Server jeden Prompt in Chat, Claude Code und Cowork freigeben oder ablehnen kann, bevor das Modell ihn sieht. Vollständige Spezifikation, Verdict-Schema, Signierung, Rollout-Playbook.
Benutzerprofile & Durchsetzung: Lass nicht einen Kunden deine ganze Organisation sperren
Der Leitfaden für Betreiber zu Claude-API-Benutzerprofilen — ordne jede Anfrage einem Endkunden zu, damit eine Sicherheitsbeschränkung oder Sperre ein einzelnes Profil trifft statt deine gesamte Organisation. Vollständige Feldreferenz, die vier enforcement_status-Werte, das enac_-Aktionsschema, Organisations-Webhooks und die Polling-Schleife, die du brauchst, weil die Ereigniszustellung noch nicht aktiv ist.