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 ausstattet:

• Messages API: Die primäre Oberfläche für einzelne Anfragen, Streaming-Chat, Tool-Nutzung, Batch-Verarbeitung, Prompt-Caching, strukturierte Ausgaben und benutzerdefinierte Agenten-Loops.
• Claude Managed Agents (Beta): Eine von Anthropic gehostete Oberfläche für serververwaltete zustandsbehaftete Agenten mit von Anthropic gehosteter Tool-Ausführung, persistenten Agenten-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 ist mit Claude Code gebündelt und auch im Open-Source Anthropic Skills-Repository verfügbar, wo 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 jeweilige Aufgabe (Tool-Nutzung, Streaming, Batches und so weiter) 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 den Aufbau von Chat-UIs und die Handhabung inkrementeller Anzeige
• Batch-Verarbeitung: Offline-Batch-Verarbeitung zu 50 % der Kosten
• Prompt-Caching: Prefix-Stabilitäts-Design, Breakpoint-Platzierung und Audit stiller Invalidatoren
• 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)
• Aktuelle Modellinformationen: Modell-IDs, Kontextfenster-Größen und Preise
• Häufige Fallstricke: Detaillierte Anleitung zur Vermeidung häufiger Fehler bei der Integration mit der API

Für Managed Agents (Beta):

• Onboarding-Flow: Eine interviewgeführte Schritt-für-Schritt-Anleitung 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: Verlustfreie Stream-Wiederverbindung, processed_at Queued/Processed-Gate, Interrupt-Handling, Fallstricke bei File-Mounts und Umgang mit Anmeldedaten
• Deployment-Einschränkungen: Managed Agents ist nur auf der Claude API und der 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, etwas mit der Claude API, einem Anthropic SDK oder Managed Agents zu bauen, zu debuggen oder zu optimieren
• Du ein Claude-Feature in einer Datei hinzufügst, änderst oder anpasst (Prompt-Caching, adaptives Denken, Kompaktierung, Tool-Nutzung, Batch, Dateien, Zitationen, 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 entsprechende 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 (gebündelt)

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

Du kannst ihn auch direkt aufrufen:

/claude-api

Mehr darüber, wie gebündelte 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 Befehl npx installieren:

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

Oder installiere ihn als Claude Code Plugin:

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



Migration zu einem neueren Claude-Modell

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

/claude-api migrate this project to claude-opus-5

Du kannst auch vorab einen bestimmten Umfang angeben, um die Frage zur Umfangsbestätigung zu überspringen:

/claude-api migrate everything under src/ to claude-opus-5
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-5

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

Der Skill übernimmt:

• Austausch von Modell-IDs, einschließlich typisierter SDK-Konstanten (Model.CLAUDE_OPUS_4_8 → Model.CLAUDE_OPUS_5) über alle unterstützten Sprachen hinweg, und klassifiziert jede Datei vor der Bearbeitung als Aufrufer, Modell-Definierer oder opake String-Referenz
• Erkennung der Cloud-Plattform, wobei plattformspezifische Modell-ID-Formate erhalten bleiben (zum Beispiel das Präfix anthropic. auf Amazon Bedrock) und Änderungen für Features übersprungen werden, die auf partnerbetriebenen Plattformen nicht verfügbar sind
• Breaking-Parameter-Änderungen, wie das Entfernen von temperature, top_p und top_k für Claude Opus 4.8 und Claude Opus 4.7 sowie die Umwandlung von thinking: {type: "enabled", budget_tokens: N} in thinking: {type: "adaptive"}
• Prefill-Ersetzung, Umwandlung von Assistant-Message-Prefill-Mustern in strukturierte Ausgaben, wo anwendbar
• Bereinigung von Beta-Headern, Entfernen von Headern, die auf dem Zielmodell GA sind (zum Beispiel effort-2025-11-24, fine-grained-tool-streaming-2025-05-14, interleaved-thinking-2025-05-14), und Zurückwechseln von client.beta.messages.create zu client.messages.create
• Effort-Kalibrierung, Empfehlung eines output_config.effort-Startpunkts für das Zielmodell (zum Beispiel der Standardwert high auf Claude Opus 5 und xhigh für Coding- und agentische Anwendungsfälle auf Claude Opus 4.8 und Claude Opus 4.7)
• Prompt-Verhaltens-Tuning, Kennzeichnung von Prompts zur Längensteuerung, Tool-Auslösung, für Subagenten und zur Befolgung von Anweisungen, die sich auf dem Zielmodell möglicherweise anders verhalten
• Umgang mit stillen Standardwerten, erneutes Aktivieren der Denk-Zusammenfassung (thinking.display: "summarized"), wenn das Reasoning auf Claude Opus 4.8 und Claude Opus 4.7 für Benutzer sichtbar gemacht wird
• Konfiguration des Refusal-Fallbacks, Hinzufügen der Behandlung von stop_reason: "refusal" vor dem Lesen des Antwortinhalts und Einrichten eines Fallback-Retry-Pfads, wenn das Ziel Claude Fable 5 oder Claude Opus 5 ist (der serverseitige fallbacks-Parameter, typischerweise im "default"-Modus, die SDK-Refusal-Fallback-Middleware oder ein Fallback-Credit-Retry), sowie Aktualisierung von Fallback-Code, der gegen 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, Tuning von Prompts zur Längensteuerung und Neubestimmung der Baseline für Kosten/Ratenlimits).

Die vollständige Liste der modellspezifischen Änderungen, die der Skill anwendet, findest du unter Migration zu Claude Opus 5 von Claude Opus 4.8.



Einrichten eines Managed Agent

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

/claude-api managed-agents-onboard

Der Skill führt ein Interview durch, das dich durch das mentale Modell von Managed Agents (Agenten-Konfigurationen versus Sessions) führt, eine Agenten-Konfiguration als Vorlage erstellt, Umgebungen und Tools konfiguriert, den Session-Loop einrichtet und lauffähigen Code für deine Sprache ausgibt. Der Skill behandelt auch den obligatorischen Ablauf Agent (einmal) → Session (bei jedem Lauf): model, system und tools gehören zum Agenten, niemals zur 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:

Build a streaming chat UI with the Claude API in TypeScript

Migration eines bestehenden Projekts:

/claude-api migrate this codebase to claude-opus-5 and re-tune effort

Onboarding eines neuen Managed Agent:

/claude-api managed-agents-onboard

In jedem Fall lädt der Skill die relevante sprachspezifische Dokumentation und führt Claude mit aktuellen API-Mustern und Best Practices durch die Implementierung.



Nächste Schritte