Claude API Skill

Der claude-api-Skill ist ein Open-Source Agent Skill, der Claude mit detailliertem, aktuellem Referenzmaterial für die Entwicklung von Anwendungen auf zwei Anthropic-Oberflächen versorgt:

• Messages API: Die primäre Oberfläche für einzelne Anfragen, Streaming-Chat, „tool use“ (Tool-Nutzung), Batch-Verarbeitung, „prompt caching“ (Prompt-Caching), strukturierte Ausgaben und benutzerdefinierte Agent-Schleifen.
• Claude Managed Agents (Beta): Eine von Anthropic gehostete Oberfläche für serververwaltete, zustandsbehaftete Agenten mit von Anthropic gehosteter Tool-Ausführung, persistenten Agent-Konfigurationen und Sandboxes pro Session.

Er deckt acht Programmiersprachen sowohl für die Messages API als auch für Managed Agents ab: Python, TypeScript, C#, Go, Java, PHP, Ruby und cURL.

Der Skill wird zusammen mit Claude Code ausgeliefert und ist außerdem im Open-Source Anthropic Skills Repository verfügbar, von wo aus du ihn in jeder Umgebung installieren kannst, die Agent Skills unterstützt.

Der Skill verwendet „progressive disclosure“ (schrittweise Offenlegung), um den Kontext effizient zu halten: Claude lädt nur die Dokumentation, die für die Sprache deines Projekts, die Oberfläche (Messages API oder Managed Agents) und die konkrete Aufgabe (Tool-Nutzung, Streaming, Batches usw.) relevant ist, anstatt alles auf einmal zu laden.

Was der Skill bereitstellt

Wenn er ausgelöst wird, stattet der Skill Claude mit Folgendem aus:

Für die Messages API:

• Sprachspezifische SDK-Dokumentation: Installation, Schnellstart, gängige Muster und Fehlerbehandlung für die Sprache deines Projekts
• Anleitung zur Tool-Nutzung: Sprachspezifische Beispiele und konzeptionelle Grundlagen für Function Calling, einschließlich des Beta-Tool-Runners, sofern verfügbar
• Streaming-Muster: Implementierungsdetails für die Entwicklung von Chat-UIs und die Handhabung inkrementeller Anzeige
• Batch-Verarbeitung: Offline-Batch-Verarbeitung zu 50 % der Kosten
• Prompt-Caching: Design für Präfix-Stabilität, Platzierung von Breakpoints und Prüfung auf stille Invalidierungen
• Modellmigration: Schritt-für-Schritt-Anleitung für die Migration zu neueren Claude-Modellen (einschließlich der Breaking Changes und Verhaltensänderungen bei Claude Opus 5.5, Claude Sonnet 5.5, Claude Haiku 5.5 und Claude Fable 5.1)
• Migration für erhaltenes Nachdenken: Finden, Messen und Beheben der Verlaufsänderungen, die thinking-Blöcke ungültig machen, verfügbar über den Unterbefehl /claude-api preserved-thinking-migration
• Aktuelle Modellinformationen: Modell-IDs, Größen des „context window" (Kontextfenster) und Preise
• Häufige Fallstricke: Detaillierte Anleitung zur Vermeidung häufiger Fehler bei der Integration mit der API

Für Managed Agents (Beta):

• Onboarding-Ablauf: Ein interviewgesteuerter Walkthrough zum Einrichten eines neuen Managed Agent von Grund auf, verfügbar über den Unterbefehl /claude-api managed-agents-onboard
• Sprachspezifische Managed-Agents-Dokumentation: Erstellen persistenter Agenten, Starten von Sessions, Streaming von Events und Handhabung von Tool-Bestätigungen für Python, TypeScript, C#, Go, Java, PHP, Ruby und cURL
• Client-Muster: Verlustfreies Wiederverbinden von Streams, processed_at-Gate für queued/processed, Interrupt-Behandlung, Stolperfallen bei File-Mounts und Umgang mit Zugangsdaten
• Deployment-Einschränkungen: Managed Agents ist nur über die Claude API und die Claude Platform on AWS verfügbar (nicht auf Amazon Bedrock, Google Cloud oder Microsoft Foundry). Der Skill leitet andere Deployments stattdessen zur Messages API und Tool-Nutzung weiter.

Wann der Skill aktiviert wird

Der Skill wird auf zwei Arten aktiviert:

Automatische Aktivierung erfolgt, wenn:

• Dein Code ein Anthropic SDK importiert (anthropic für Python, @anthropic-ai/sdk für TypeScript/JavaScript)
• Du Claude bittest, beim Erstellen, Debuggen oder Optimieren von etwas mit der Claude API, einem Anthropic SDK oder Managed Agents zu helfen
• Du ein Claude-Feature in einer Datei hinzufügst, änderst oder abstimmst (Prompt-Caching, adaptives Nachdenken, Compaction, Tool-Nutzung, Batch, Dateien, Zitate, Memory) oder eine Modellreferenz

Manueller Aufruf durch Eingabe von /claude-api (mit optionalem Unterbefehl oder Freitext) in jeder Umgebung, in der der Skill installiert ist.

Der Skill wird nicht für allgemeine Programmieraufgaben, ML-/Data-Science-Arbeit oder Code aktiviert, der andere KI-SDKs importiert (wie OpenAI).

Unterstützte Sprachen

Der Skill erkennt die Sprache deines Projekts automatisch, indem er Projektdateien untersucht (zum Beispiel requirements.txt für Python, tsconfig.json für TypeScript, go.mod für Go), und lädt die passende Dokumentation.

Wenn dein Projekt mehrere Sprachen verwendet, fragt Claude, welche zutrifft. Für nicht unterstützte Sprachen (Rust, Swift, C++) stellt der Skill cURL-/Raw-HTTP-Beispiele bereit.

So verwendest du den Skill

In Claude Code (mitgeliefert)

Der Skill wird mit Claude Code ausgeliefert und erfordert keine Installation. Wenn du Claude bittest, beim Erstellen von etwas mit der Claude API zu helfen, oder wenn dein Projekt bereits ein Anthropic SDK importiert, wird der Skill automatisch aktiviert.

Du kannst ihn auch direkt aufrufen:

Mehr darüber, wie mitgelieferte Skills in Claude Code funktionieren, findest du in der Claude Code Skills-Dokumentation.

Aus dem Skills Repository

Der Quellcode des Skills ist im Anthropic Skills Repository verfügbar. Du kannst ihn mit dem npx-Befehl installieren:

npx skills add https://github.com/anthropics/skills --skill claude-api

Oder bitte Claude Code, ihn als Claude Code Plugin zu installieren:

/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills

Migration auf ein neueres Claude-Modell

Der Claude API Skill kann Claude-Modellmigrationen über eine gesamte Codebasis hinweg durchführen. Rufe ihn direkt mit /claude-api migrate auf:

Du kannst auch vorab einen bestimmten Geltungsbereich übergeben, um die Frage zur Bestätigung des Geltungsbereichs zu überspringen:

Wenn der Geltungsbereich nicht eindeutig ist (zum Beispiel bei einem bloßen /claude-api migrate to claude-opus-5-5), fordert dich der Skill auf, zwischen dem gesamten Arbeitsverzeichnis, einem bestimmten Unterverzeichnis oder einer expliziten Dateiliste zu wählen, bevor Dateien bearbeitet werden. Dies gilt sowohl für Aufrufer der Messages API als auch für Aufrufer von Managed Agents.

Der Skill übernimmt:

• Austausch von Modell-IDs, einschließlich typisierter SDK-Konstanten (Model.CLAUDE_OPUS_4_8 → Model.CLAUDE_OPUS_5_5) in allen unterstützten Sprachen, und klassifiziert jede Datei vor der Bearbeitung als Aufrufer, Modelldefinierer oder opake String-Referenz
• Erkennung von Cloud-Plattformen, wobei plattformspezifische Modell-ID-Formate (zum Beispiel das Präfix anthropic. auf Amazon Bedrock) erhalten bleiben und Änderungen für Features übersprungen werden, die auf von Partnern betriebenen Plattformen nicht verfügbar sind
• Breaking Changes bei Parametern, wie das Entfernen von temperature, top_p und top_k für Claude Opus 4.8 und Claude Opus 4.7 sowie das Umwandeln von thinking: {type: "enabled", budget_tokens: N} in thinking: {type: "adaptive"}
• Ersetzen von Prefills, wobei Prefill-Muster in Assistant-Nachrichten, wo zutreffend, in strukturierte Ausgaben umgewandelt werden
• Bereinigung von Beta-Headern, wobei Beta-Header entfernt werden, die das Zielmodell nicht benötigt (zum Beispiel effort-2025-11-24, fine-grained-tool-streaming-2025-05-14, interleaved-thinking-2025-05-14), und von client.beta.messages.create() zurück zu client.messages.create() gewechselt wird
• Effort-Kalibrierung, wobei ein Ausgangswert für output_config.effort für das Zielmodell empfohlen wird (zum Beispiel der Standardwert high bei Claude Opus 5 und xhigh für Coding- und agentische Anwendungsfälle bei Claude Opus 4.8 und Claude Opus 4.7)
• Abstimmung des Prompt-Verhaltens, wobei Prompts zur Längensteuerung, zum Auslösen von Tools, zu Subagents und zur Befolgung von Anweisungen markiert werden, die sich beim Zielmodell möglicherweise anders verhalten
• Behandlung stiller Standardwerte, wobei die Zusammenfassung des Nachdenkens (thinking.display: "summarized") wieder aktiviert wird, wenn Überlegungen bei Claude Opus 4.8 und Claude Opus 4.7 für Benutzer angezeigt werden
• Konfiguration des Refusal-Fallbacks, wobei die Behandlung von stop_reason: "refusal" vor dem Lesen des Antwortinhalts hinzugefügt und ein Fallback-Wiederholungspfad eingerichtet wird, wenn das Ziel Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5 oder Claude Sonnet 5.5 ist (der serverseitige Parameter fallbacks, typischerweise in seinem "default"-Modus, die Refusal-Fallback-Middleware des SDK oder eine Wiederholung mit Fallback-Guthaben), und wobei Fallback-Code aktualisiert wird, der für frühere Preview-Formen geschrieben wurde

Während der Bearbeitung erklärt der Skill jede Änderung und ihre Begründung inline. Nach Abschluss erstellt er eine Checkliste mit Punkten, die eine manuelle Überprüfung erfordern (typischerweise Integrationstests, Abstimmung von Prompts zur Längensteuerung und Neubewertung von Kosten/„rate limits“ (Ratenlimits)).

Die vollständige Liste der modellspezifischen Änderungen, die der Skill anwendet, findest du unter Migration zu Claude Opus 5.5 von Claude Opus 5, Migration zu Claude Opus 5.5 von Claude Opus 4.8, Migration zu Claude Sonnet 5.5 von Claude Sonnet 5, Migrationsleitfaden für Claude Haiku 5.5 und Migrationsleitfaden für Claude Fable 5.1 und Claude Mythos 5.1.

Eine Integration auf erhaltenes Nachdenken prüfen

Erhaltenes Nachdenken hält einen thinking-Block nur so lange gültig, wie der system-Prompt, die tools und die Nachrichten davor unverändert bleiben. Um die Stellen zu finden und zu beheben, an denen dein Code diesen Verlauf bearbeitet, öffne das Repository, das deine Anfragen erstellt, und rufe den Unterbefehl preserved-thinking-migration auf:

Der Skill arbeitet in fünf Schritten:

1. Umfang: Prüft, ob deine Integration betroffen ist, und sendet dann drei Testanfragen, um zu bestätigen, dass die API eine absichtliche Bearbeitung meldet.
2. Finden: Zeichnet einige deiner eigenen Multi-Turn-Sitzungen auf, vergleicht aufeinanderfolgende Anfragen und listet jede Stelle auf, an der dein Code das Präfix bearbeitet.
3. Messen: Spielt die Sitzungen mit "drop_block" erneut ab und meldet, welche Konversationen thinking-Blöcke verlieren, in welchem Turn und warum.
4. Beheben: Ersetzt jeweils eine Bearbeitung durch das passende Muster aus Änderungen vornehmen, ohne das Präfix zu bearbeiten, und misst nach jeder Änderung erneut.
5. Bericht: Fasst jede Ursache, die dafür vorgenommene Änderung und die Zählwerte vorher und nachher zusammen.

Wenn dein Projekt eine Eval hat, vergleicht der Skill außerdem Scores und Token-Verbrauch mit und ohne verworfene thinking-Blöcke.

Die Testanfragen und Wiederholungen sind echte Messages API-Anfragen, die zu den normalen Preisen des Modells abgerechnet werden. Jede Wiederholung fordert nur wenige Ausgabe-Token an und setzt tool_choice auf none, sodass kein Tool ausgeführt wird. Der Skill nennt die Kosten und bittet um deine Zustimmung, bevor er sie sendet.

Einrichten eines Managed Agent

Um einen neuen Managed Agent von Grund auf zu erstellen, rufe den Unterbefehl managed-agents-onboard auf:

Der Skill führt ein Interview durch, das dich durch das mentale Modell von Managed Agents führt (Agent-Konfigurationen versus Sessions), eine Agent-Konfiguration als Vorlage erstellt, Umgebungen und Tools konfiguriert, die Session-Schleife einrichtet und lauffähigen Code für deine Sprache ausgibt. Der Skill behandelt auch den verpflichtenden Ablauf Agent (einmalig) → Session (bei jedem Lauf): model, system und tools liegen auf dem Agenten, niemals auf der Session, und Agenten sollten einmal erstellt und per ID referenziert werden.

Managed Agents erfordert den Beta-Header managed-agents-2026-04-01, den das SDK automatisch für alle Aufrufe von client.beta.agents.*, client.beta.environments.*, client.beta.sessions.* und client.beta.vaults.* setzt.

Beispielverwendung

Hier sind Beispiele für Aufgaben, bei denen der Skill Claude unterstützt:

Erstellen einer Chat-Anwendung:

Migration eines bestehenden Projekts:

Onboarding eines neuen Managed Agent:

In jedem Fall lädt der Skill die relevante sprachspezifische Dokumentation und führt Claude unter Verwendung aktueller API-Muster und Best Practices durch die Implementierung.

Nächste Schritte