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, wo 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: Design für Präfix-Stabilität, Platzierung von Breakpoints und Prüfung auf stille Invalidierer
• Modellmigration: Schritt-für-Schritt-Anleitung für die Migration auf neuere Claude-Modelle (einschließlich der Breaking Changes und Verhaltensänderungen bei Claude Opus 5 und Claude Fable 5.1)
• 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 Denken, 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:

/claude-api

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 installiere ihn als Claude Code Plugin:

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

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

Du kannst auch vorab einen bestimmten Geltungsbereich übergeben, um die Frage zur Bestätigung des Geltungsbereichs 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 Geltungsbereich 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 er Dateien bearbeitet. Dies gilt sowohl für Aufrufer der Messages API als auch von Managed Agents.

Der Skill übernimmt:

• Austausch von Modell-IDs, einschließlich typisierter SDK-Konstanten (Model.CLAUDE_OPUS_4_8 → Model.CLAUDE_OPUS_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 beibehalten werden (zum Beispiel das Präfix anthropic. auf Amazon Bedrock) 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 die Umwandlung von thinking: {type: "enabled", budget_tokens: N} in thinking: {type: "adaptive"}
• Ersetzen von Prefill, wobei Prefill-Muster in Assistant-Nachrichten, wo anwendbar, 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 Ausgangspunkt 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, Tool-Auslösung, zu Subagenten und zur Befolgung von Anweisungen markiert werden, die sich auf dem Zielmodell möglicherweise anders verhalten
• Umgang mit stillen Standardwerten, wobei die Zusammenfassung des Denkens (thinking.display: "summarized") wieder aktiviert wird, wenn das Reasoning bei Claude Opus 4.8 und Claude Opus 4.7 den Nutzern angezeigt wird
• Konfiguration des Refusal-Fallbacks, wobei eine Behandlung von stop_reason: "refusal" vor dem Lesen des Antwortinhalts hinzugefügt und ein Fallback-Retry-Pfad eingerichtet wird, wenn das Ziel Claude Fable 5.1, Claude Fable 5 oder Claude Opus 5 ist (der serverseitige Parameter fallbacks, typischerweise im Modus "default", die Refusal-Fallback-Middleware des SDK oder ein Fallback-Credit-Retry), und Fallback-Code aktualisiert wird, 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, 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 auf Claude Opus 5 von Claude Opus 4.8 und Migration auf Claude Fable 5.1.

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

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 unter Verwendung aktueller API-Muster und Best Practices durch die Implementierung.

Nächste Schritte