---
title: Claude API Skill
url: https://platform.claude.com/docs/de/agents-and-tools/agent-skills/claude-api-skill
description: Ein Open-Source Agent Skill, der Claude mit aktuellem API-Referenzmaterial, SDK-Dokumentation und Best Practices für die Entwicklung von Anwendungen mit der Claude API und Claude Managed Agents versorgt.
---
Der `claude-api`-Skill ist ein Open-Source [Agent Skill](https://platform.claude.com/docs/de/agents-and-tools/agent-skills/overview), 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](https://code.claude.com/docs/en/overview) ausgeliefert und ist außerdem im Open-Source [Anthropic Skills Repository](https://github.com/anthropics/skills) verfügbar, von wo aus du ihn in jeder Umgebung installieren kannst, die Agent Skills unterstützt.
Der Skill verwendet „progressive disclosure“ ([schrittweise Offenlegung](https://platform.claude.com/docs/de/agents-and-tools/agent-skills/overview#how-skills-work)), 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](https://platform.claude.com/docs/de/agents-and-tools/tool-use/overview) 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](https://platform.claude.com/docs/de/models/opus-5-5/migration-guide#migrating-from-claude-opus-5), [Claude Sonnet 5.5](https://platform.claude.com/docs/de/models/sonnet-5-5/migration-guide#migrating-from-claude-sonnet-5), [Claude Haiku 5.5](https://platform.claude.com/docs/de/models/haiku-5-5/migration-guide) und [Claude Fable 5.1](https://platform.claude.com/docs/de/models/fable-5-1/migration-guide))
* **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](https://platform.claude.com/docs/de/build-with-claude/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.
| Sprache | Messages API SDK | Tool-Runner | Managed Agents |
| ---------- | ---------------- | ----------- | -------------- |
| Python | Ja | Ja (Beta) | Ja (Beta) |
| TypeScript | Ja | Ja (Beta) | Ja (Beta) |
| C# | Ja | Ja (Beta) | Ja (Beta) |
| Go | Ja | Ja (Beta) | Ja (Beta) |
| Java | Ja | Ja (Beta) | Ja (Beta) |
| PHP | Ja | Ja (Beta) | Ja (Beta) |
| Ruby | Ja | Ja (Beta) | Ja (Beta) |
| cURL | Ja | N/A | Ja (Beta) |
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](https://code.claude.com/docs/en/overview) 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:
Verwende diesen Skill in Claude Code
```text
/claude-api
```
Mehr darüber, wie mitgelieferte Skills in Claude Code funktionieren, findest du in der [Claude Code Skills-Dokumentation](https://code.claude.com/docs/en/skills#bundled-skills).
### Aus dem Skills Repository
Der Quellcode des Skills ist im [Anthropic Skills Repository](https://github.com/anthropics/skills) verfügbar. Du kannst ihn mit dem `npx`-Befehl installieren:
```bash
npx skills add https://github.com/anthropics/skills --skill claude-api
```
Oder bitte Claude Code, ihn als [Claude Code Plugin](https://code.claude.com/docs/en/plugins) zu installieren:
Lass Claude Code das für dich installieren
```text
Installiere das claude-api-Plugin aus dem anthropics/skills-Plugin-Marketplace
```
```text wrap
/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:
Lass Claude Code deinen Code für dich migrieren
```text
/claude-api migrate dieses Projekt auf das neueste Claude Opus-Modell
```
Du kannst auch vorab einen bestimmten Geltungsbereich übergeben, um die Frage zur Bestätigung des Geltungsbereichs zu überspringen:
Lass Claude Code deinen Code für dich migrieren
```text
/claude-api migrate alles unter src/ auf das neueste Claude Opus-Modell
```
Lass Claude Code deinen Code für dich migrieren
```text
/claude-api migrate apps/api.py und apps/worker.py auf das neueste Claude Opus-Modell
```
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](https://platform.claude.com/docs/de/build-with-claude/structured-outputs) 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()` (go: `client.Beta.Messages.New()`; java: `client.beta().messages().create()`; csharp: `client.Beta.Messages.Create()`; php: `$client->beta->messages->create()`) zurück zu `client.messages.create()` (go: `client.Messages.New()`; java: `client.messages().create()`; csharp: `client.Messages.Create()`; php: `$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](https://platform.claude.com/docs/de/build-with-claude/refusals-and-fallback) 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](https://platform.claude.com/docs/de/models/opus-5-5/migration-guide#migrating-from-claude-opus-5), [Migration zu Claude Opus 5.5 von Claude Opus 4.8](https://platform.claude.com/docs/de/models/opus-5-5/migration-guide#migrating-from-claude-opus-4-8), [Migration zu Claude Sonnet 5.5 von Claude Sonnet 5](https://platform.claude.com/docs/de/models/sonnet-5-5/migration-guide#migrating-from-claude-sonnet-5), [Migrationsleitfaden für Claude Haiku 5.5](https://platform.claude.com/docs/de/models/haiku-5-5/migration-guide) und [Migrationsleitfaden für Claude Fable 5.1 und Claude Mythos 5.1](https://platform.claude.com/docs/de/models/fable-5-1/migration-guide).
## Eine Integration auf erhaltenes Nachdenken prüfen
[Erhaltenes Nachdenken](https://platform.claude.com/docs/de/build-with-claude/preserved-thinking) 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:
Lass Claude Code deinen Code für dich prüfen
```text
/claude-api preserved-thinking-migration
```
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](https://platform.claude.com/docs/de/build-with-claude/preserved-thinking#replace-prefix-edits), 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:
Lass Claude Code deinen Agenten für dich einrichten
```text
/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:**
Lass Claude Code das für dich entwickeln
```text
Entwickle eine Streaming-Chat-UI mit der Claude API in TypeScript
```
**Migration eines bestehenden Projekts:**
Lass Claude Code deinen Code für dich migrieren
```text
/claude-api migrate diese Codebasis auf das neueste Claude Opus-Modell und stimme den Effort neu ab
```
**Onboarding eines neuen Managed Agent:**
Lass Claude Code deinen Agenten für dich einrichten
```text
/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
Erfahre, wie Agent Skills funktionieren und wie das Modell der schrittweisen Offenlegung aufgebaut ist
Durchsuche die offiziellen Anthropic SDKs für alle unterstützten Sprachen
Erkunde das öffentliche Anthropic Skills Repository auf GitHub