Claude API Skill

Der claude-api Skill ist ein Open-Source Agent Skill, der Claude mit detaillierten, aktuellen Referenzmaterialien für die Erstellung 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 Agent-Schleifen.
• Claude Managed Agents (beta) — eine First-Party-Oberfläche für servergesteuerte zustandsbehaftete Agenten mit von Anthropic gehosteter Tool-Ausführung, persistenten Agent-Konfigurationen und Pro-Session-Containern.

Es unterstützt 8 Programmiersprachen für die Messages API (Python, TypeScript, Java, Go, Ruby, C#, PHP und cURL) und 7 Sprachen für Managed Agents (Python, TypeScript, Java, Go, Ruby, PHP und cURL — C# wird derzeit nicht unterstützt).

Der Skill wird mit Claude Code gebündelt und ist auch im Open-Source Anthropic Skills Repository verfügbar, wo Sie ihn in jeder Umgebung installieren können, die Agent Skills unterstützt.

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

Was der Skill bietet

Wenn er aktiviert wird, stattet der Skill Claude mit folgendem aus:

Für die Messages API:

• Sprachspezifische SDK-Dokumentation: Installation, Schnellstart, häufige Muster und Fehlerbehandlung für die Sprache Ihres Projekts
• Tool-Nutzungs-Anleitung: Sprachspezifische Beispiele und konzeptionelle Grundlagen für Funktionsaufrufe, einschließlich des Beta-Tool-Runners, wo verfügbar
• Streaming-Muster: Implementierungsdetails für die Erstellung von Chat-UIs und die Verarbeitung inkrementeller Anzeige
• Batch-Verarbeitung: Offline-Batch-Verarbeitung mit 50% Kostenersparnis
• Prompt-Caching: Präfix-Stabilitätsdesign, Breakpoint-Platzierung und Audit für stille Invalidierung
• 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 4.7)
• Aktuelle Modellinformationen: Modell-IDs, Kontextfenstergröße und Preisgestaltung
• Häufige Fallstricke: Detaillierte Anleitung zur Vermeidung häufiger Fehler bei der Integration mit der API

Für Managed Agents (beta):

• Onboarding-Ablauf: Eine interview-gesteuerte Anleitung zum Einrichten eines neuen Managed Agent von Grund auf, verfügbar über den /claude-api managed-agents-onboard Unterbefehl
• Sprachspezifische Managed Agents Dokumentation: Erstellen persistenter Agenten, Starten von Sessions, Streaming-Events und Verarbeitung von Tool-Bestätigungen für Python, TypeScript, Java, Go, Ruby, PHP und cURL
• Client-Muster: Verlustfreie Stream-Wiederverbindung, processed_at Warteschlangen-/Verarbeitungs-Gate, Interrupt-Verarbeitung, File-Mount-Besonderheiten und Credential-Verarbeitung
• Deployment-Einschränkungen: Managed Agents ist nur First-Party (nicht verfügbar auf Amazon Bedrock, Google Vertex AI oder Microsoft Foundry) — der Skill leitet Third-Party-Deployments stattdessen zu Messages API + Tool-Nutzung weiter

Wann der Skill aktiviert wird

Der Skill wird auf zwei Arten aktiviert:

Automatische Aktivierung erfolgt, wenn:

• Ihr Code ein Anthropic SDK importiert (anthropic für Python, @anthropic-ai/sdk für TypeScript/JavaScript)
• Sie Claude bitten, etwas mit der Claude API, einem Anthropic SDK oder Managed Agents zu erstellen, zu debuggen oder zu optimieren
• Sie ein Claude-Feature in einer Datei hinzufügen, ändern oder abstimmen (Prompt-Caching, adaptives Denken, Komprimierung, Tool-Nutzung, Batch, Dateien, Zitationen, Speicher) oder eine Modellreferenz

Manuelle Aufrufe durch Eingabe von /claude-api (mit optionalem Unterbefehl oder Prosa) in jeder Umgebung, in der der Skill installiert ist.

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

Unterstützte Sprachen

Der Skill erkennt die Sprache Ihres Projekts automatisch durch Untersuchung von Projektdateien (z. B. requirements.txt für Python, tsconfig.json für TypeScript, go.mod für Go) und lädt die entsprechende Dokumentation.

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

Wie man den Skill verwendet

In Claude Code (gebündelt)

Der Skill wird mit Claude Code ausgeliefert und erfordert keine Installation. Wenn Sie Claude bitten, etwas mit der Claude API zu erstellen, oder wenn Ihr Projekt bereits ein Anthropic SDK importiert, wird der Skill automatisch aktiviert.

Sie können ihn auch direkt aufrufen:

/claude-api

Weitere Informationen zur Funktionsweise gebündelter Skills in Claude Code finden Sie in der Claude Code Skills-Dokumentation.

Aus dem Skills Repository

Der Skill-Quellcode ist im Anthropic Skills Repository verfügbar. Sie können ihn mit dem npx Befehl installieren:

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

Oder installieren Sie 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 Codebasis durchführen. Rufen Sie ihn direkt mit /claude-api migrate auf:

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

Sie können auch einen bestimmten Umfang im Voraus angeben, um die Umfangsbestätigungsfrage zu überspringen:

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

Wenn der Umfang mehrdeutig ist (z. B. ein einfaches /claude-api migrate to claude-opus-4-7), fragt der Skill Sie 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 verarbeitet:

• Modell-ID-Swaps, einschließlich typisierter SDK-Konstanten (Model.CLAUDE_OPUS_4_6 → Model.CLAUDE_OPUS_4_7) über alle unterstützten Sprachen hinweg, und klassifiziert jede Datei als Aufrufer, Modell-Definierer oder undurchsichtige String-Referenz vor der Bearbeitung
• Breaking Parameter-Änderungen, wie das Entfernen von temperature, top_p und top_k für Claude Opus 4.7, und das Konvertieren von thinking: {type: "enabled", budget_tokens: N} zu thinking: {type: "adaptive"}
• Prefill-Ersetzung, Konvertierung von Assistant-Message-Prefill-Mustern zu strukturierten Ausgaben, wo zutreffend
• Beta-Header-Bereinigung, Entfernung von Headern, die auf dem Zielmodell GA sind (z. B. effort-2025-11-24, fine-grained-tool-streaming-2025-05-14, interleaved-thinking-2025-05-14) und Rückwechsel von client.beta.messages.create zu client.messages.create
• Effort-Kalibrierung, Empfehlung eines output_config.effort Startpunkts für das Zielmodell (z. B. xhigh für Coding und agentic Use Cases auf Claude Opus 4.7)
• Prompt-Verhalten-Abstimmung, Kennzeichnung von Längensteuerungs-, Tool-Auslösungs-, Subagenten- und Anweisungs-Folge-Prompts, die sich auf dem Zielmodell möglicherweise unterschiedlich verhalten
• Stille Standard-Verarbeitung, Rückwechsel zur Thinking-Zusammenfassung (thinking.display: "summarized"), wenn Reasoning für Benutzer auf Claude Opus 4.7 angezeigt wird

Bei der Bearbeitung erklärt der Skill jede Änderung und ihre Motivation inline. Nach Abschluss erstellt er eine Checkliste von Elementen, die manuelle Überprüfung erfordern (typischerweise Integrationstests, Längensteuerungs-Prompt-Abstimmung und Kosten-/Rate-Limit-Neubaseline).

Für die vollständige Liste der modellspezifischen Änderungen, die der Skill anwendet, siehe Migration zu Claude Opus 4.7.

Einrichten eines Managed Agent

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

/claude-api managed-agents-onboard

Der Skill führt ein Interview durch, das Sie durch das Managed Agents Mentalmodell führt (Agent-Konfigurationen versus Sessions), erstellt eine Agent-Konfigurationsvorlage, konfiguriert Umgebungen und Tools, richtet die Session-Schleife ein und gibt ausführbaren Code für Ihre Sprache aus. Der Skill behandelt auch den obligatorischen Agent (einmal) → Session (bei jedem Durchlauf) Ablauf — model, system und tools befinden sich auf dem Agent, niemals auf der Session, und Agenten sollten einmal erstellt und nach ID referenziert werden.

Managed Agents erfordert den managed-agents-2026-04-01 Beta-Header, 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 hilft:

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-7 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 mit aktuellen API-Mustern und Best Practices.

Nächste Schritte