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-Nutzung, Batch-Verarbeitung, Prompt-Caching, strukturierte Ausgaben und benutzerdefinierte Agent-Loops.
• Claude Managed Agents (Beta): Eine von Anthropic gehostete Oberfläche für serverseitig verwaltete, zustandsbehaftete Agents mit von Anthropic gehosteter Tool-Ausführung, persistenten Agent-Konfigurationen und sitzungsbezogenen Sandboxes.

Er deckt 8 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 in Claude Code enthalten 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 nutzt progressive disclosure (progressive 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 der Skill ausgelöst wird, stattet er 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: Präfix-Stabilitäts-Design, Breakpoint-Platzierung und Audit stiller Invalidierungen
• Modell-Migration: Schritt-für-Schritt-Anleitung für die Migration zu neueren Claude-Modellen (einschließlich der Breaking Changes und Verhaltensänderungen bei Claude Opus 4.8)
• 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 interviewgesteuerte Anleitung zum Einrichten eines neuen Managed Agent von Grund auf, verfügbar über den Subcommand /claude-api managed-agents-onboard
• Sprachspezifische Managed-Agents-Dokumentation: Erstellen persistenter Agents, 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 Stream-Reconnect, processed_at-Queued/Processed-Gate, Interrupt-Handling, File-Mount-Fallstricke und Credential-Handling
• Deployment-Einschränkungen: Managed Agents ist nur über die Claude API und Claude Platform on AWS verfügbar (nicht über 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 anpasst (Prompt-Caching, adaptives Denken, Kompaktierung, Tool-Nutzung, Batch, Dateien, Zitate, Speicher) oder eine Modellreferenz

Manueller Aufruf durch Eingabe von /claude-api (mit optionalem Subcommand 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 (enthalten)

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

Weitere Informationen zur Funktionsweise von mitgelieferten Skills in Claude Code findest du in der Claude Code Skills-Dokumentation.



Aus dem Skills-Repository

Der Skill-Quellcode 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 zu einem neueren Claude-Modell

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

/claude-api migrate this project to claude-opus-4-8

Du kannst auch vorab einen bestimmten Scope übergeben, um die Scope-Bestätigungsfrage zu überspringen:

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

Wenn der Scope mehrdeutig ist (zum Beispiel ein bloßes /claude-api migrate to claude-opus-4-8), 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 Messages-API- als auch für Managed-Agents-Aufrufer.

Der Skill übernimmt:

• Modell-ID-Austausch, einschließlich typisierter SDK-Konstanten (Model.CLAUDE_OPUS_4_7 → Model.CLAUDE_OPUS_4_8) über alle unterstützten Sprachen hinweg, und klassifiziert jede Datei vor der Bearbeitung als Aufrufer, Modell-Definierer oder opake String-Referenz
• Cloud-Plattform-Erkennung, wobei plattformspezifische Modell-ID-Formate beibehalten werden (zum Beispiel das anthropic.-Präfix bei 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 Konvertierung von thinking: {type: "enabled", budget_tokens: N} zu thinking: {type: "adaptive"}
• Prefill-Ersetzung, wobei Assistant-Message-Prefill-Muster gegebenenfalls in strukturierte Ausgaben konvertiert werden
• Beta-Header-Bereinigung, wobei Header entfernt werden, die im Zielmodell GA sind (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 output_config.effort-Startwert für das Zielmodell empfohlen wird (zum Beispiel xhigh für Coding- und agentische Anwendungsfälle bei Claude Opus 4.8 und Claude Opus 4.7)
• Prompt-Verhaltens-Tuning, wobei Prompts für Längenkontrolle, Tool-Triggering, Subagents und Anweisungsbefolgung markiert werden, die sich auf dem Zielmodell möglicherweise anders verhalten
• Handhabung stiller Defaults, wobei die Thinking-Zusammenfassung (thinking.display: "summarized") wieder aktiviert wird, wenn Reasoning bei Claude Opus 4.8 und Claude Opus 4.7 für Nutzer sichtbar gemacht wird
• Refusal-Fallback-Konfiguration, wobei eine stop_reason: "refusal"-Behandlung vor dem Lesen des Antwortinhalts hinzugefügt und ein Fallback-Retry-Pfad eingerichtet wird, wenn das Ziel Claude Fable 5 ist (der serverseitige fallbacks-Parameter, die SDK-Refusal-Fallback-Middleware 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 Motivation inline. Nach Abschluss erstellt er eine Checkliste mit Punkten, die eine manuelle Überprüfung erfordern (typischerweise Integrationstests, Längenkontroll-Prompt-Tuning und Neubewertung von Kosten/Ratenlimits).

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



Einrichten eines Managed Agent

Um einen neuen Managed Agent von Grund auf zu erstellen, rufe den Subcommand 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 (Agent-Konfigurationen versus Sessions) führt, eine Agent-Konfiguration als Vorlage erstellt, Umgebungen und Tools konfiguriert, den Session-Loop einrichtet und ausführbaren Code für deine Sprache generiert. Der Skill behandelt auch den obligatorischen Agent (einmal) → Session (bei jedem Lauf)-Flow: model, system und tools gehören zum Agent, niemals zur Session, und Agents 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 client.beta.agents.*-, client.beta.environments.*-, client.beta.sessions.*- und client.beta.vaults.*-Aufrufe 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-4-8 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 durch die Implementierung unter Verwendung aktueller API-Muster und Best Practices.



Nächste Schritte