---
title: API-Übersicht
url: https://platform.claude.com/docs/de/api/overview
description: Verstehe die verfügbaren Endpunkte, Authentifizierungs-Header, Client-SDKs, Paginierung, Ratenlimits und Cloud-Plattform-Zugriffsoptionen der Claude API.
---
Die Claude API ist eine RESTful-API unter `https://api.anthropic.com`, die programmatischen Zugriff auf Claude-Modelle und Claude Managed Agents bietet.
**Neu bei Claude?** Für direkten Modellzugriff beginne mit [Erste Schritte](https://platform.claude.com/docs/de/get-started) und [Arbeiten mit Messages](https://platform.claude.com/docs/de/build-with-claude/working-with-messages). Für verwaltete Agent-Infrastruktur siehe den [Claude Managed Agents Schnellstart](https://platform.claude.com/docs/de/managed-agents/quickstart).
## Voraussetzungen
Um die Claude API zu nutzen, benötigst du:
* Ein [Claude Console-Konto](https://platform.claude.com)
* Einen [API-Key](https://platform.claude.com/settings/keys) aus der Console oder eine konfigurierte [Workload Identity Federation](https://platform.claude.com/docs/de/manage-claude/workload-identity-federation)-Regel
Für eine Schritt-für-Schritt-Einrichtungsanleitung siehe [Erste Schritte](https://platform.claude.com/docs/de/get-started).
## Verfügbare APIs
Die Claude API umfasst die folgenden APIs:
* **[Messages API](https://platform.claude.com/docs/de/api/messages/create)**: Sende Nachrichten an Claude für dialogorientierte Interaktionen (`POST /v1/messages`)
* **[Message Batches API](https://platform.claude.com/docs/de/api/messages/batches/create)**: Verarbeite große Mengen von Messages-Anfragen asynchron mit 50 % Kostenreduktion (`POST /v1/messages/batches`)
* **[Token Counting API](https://platform.claude.com/docs/de/api/messages/count_tokens)**: Zähle Token in einer Nachricht vor dem Senden, um Kosten und Ratenlimits zu verwalten (`POST /v1/messages/count_tokens`)
* **[Models API](https://platform.claude.com/docs/de/api/models/list)**: Liste verfügbare Claude-Modelle und ihre Details auf (`GET /v1/models`)
* **[Files API](https://platform.claude.com/docs/de/api/files/upload)**: Lade Dateien hoch und verwalte sie für die Verwendung über mehrere API-Aufrufe hinweg (`POST /v1/files`, `GET /v1/files`)
* **[Skills API](https://platform.claude.com/docs/de/api/skills/create)**: Erstelle und verwalte benutzerdefinierte Agent-Skills (`POST /v1/skills`, `GET /v1/skills`)
Die folgenden APIs befinden sich in der Beta-Phase:
* **[Agents API](https://platform.claude.com/docs/de/managed-agents/agent-setup)**: Definiere wiederverwendbare, versionierte Agent-Konfigurationen für Claude Managed Agents (`POST /v1/agents`, `GET /v1/agents`)
* **[Sessions API](https://platform.claude.com/docs/de/managed-agents/sessions)**: Führe zustandsbehaftete Agent-Sessions in verwalteten Cloud-Sandboxes aus (`POST /v1/sessions`, `GET /v1/sessions/{id}/events/stream`)
* **[Environments API](https://platform.claude.com/docs/de/managed-agents/environments)**: Konfiguriere Sandbox-Vorlagen für Agent-Sessions (`POST /v1/environments`, `GET /v1/environments`)
Für die vollständige API-Referenz mit allen Endpunkten, Parametern und Antwortschemata erkunde die in der Navigation aufgeführten API-Referenzseiten. Um auf Beta-Funktionen zuzugreifen, siehe [Beta-Header](https://platform.claude.com/docs/de/api/beta-headers).
## Authentifizierung
Für Details zu jeder Authentifizierungsmethode und wann sie zu verwenden ist, siehe [Authentifizierung](https://platform.claude.com/docs/de/manage-claude/authentication). Anfragen an die Claude API enthalten diese Header:
| Header | Wert | Erforderlich |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Authorization` | `Bearer `, wobei `` dein API-Key oder ein kurzlebiges Zugriffstoken ist, das du über `POST /v1/oauth/token` mittels [Workload Identity Federation](https://platform.claude.com/docs/de/manage-claude/workload-identity-federation) erhältst | Ja, sofern `x-api-key` nicht gesetzt ist |
| `x-api-key` | Dein API-Key aus der Console. Veralteter Fallback für `Authorization`, wird weiterhin unterstützt | Nein |
| `anthropic-workspace-id` | ID des [Workspace](https://platform.claude.com/docs/de/manage-claude/workspaces), in dem die Anfrage ausgeführt wird (zum Beispiel `wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ`). Siehe [Einen Workspace auswählen](https://platform.claude.com/docs/de/manage-claude/authentication#select-a-workspace). | Erforderlich bei einem Multi-Workspace-API-Key. Optional für andere API-Keys. Ein für einen einzelnen Workspace erstellter Key wird in diesem Workspace ausgeführt, wenn du den Header weglässt. Wird nicht mit Workload Identity Federation-Tokens verwendet, die beim Token-Austausch einen Workspace auswählen. |
| `anthropic-version` | API-Version (zum Beispiel `2023-06-01`) | Ja |
| `content-type` | `application/json` | Ja |
Wenn du die [Client-SDKs](https://platform.claude.com/docs/de/api/overview#client-sdks) verwendest, sendet das SDK die Authentifizierungs-, Versions- und Content-Type-Header automatisch; `anthropic-workspace-id` übergibst du selbst, wenn dein Key es benötigt. Für Details zur API-Versionierung siehe [API-Versionen](https://platform.claude.com/docs/de/api/versioning).
Beim Zugriff auf Claude über eine [Cloud-Plattform](https://platform.claude.com/docs/de/api/overview#claude-api-vs-cloud-platforms) ist die Authentifizierung in das IAM-System des Cloud-Anbieters integriert. Siehe die plattformspezifische Dokumentation für unterstützte Anmeldeinformationstypen, erforderliche Header und Authentifizierungsoptionen.
### API-Keys erhalten
Die API wird über die Web-[Console](https://platform.claude.com/) bereitgestellt. In der Console kannst du den [playground](https://platform.claude.com/playground) (`platform.claude.com/playground`) verwenden, um die API im Browser auszuprobieren, und anschließend auf der Seite [API-Keys](https://platform.claude.com/settings/keys) (`platform.claude.com/settings/keys`) API-Keys generieren. Wie das geht, erfährst du unter [Hol dir deinen Claude-API-Key](https://platform.claude.com/docs/de/get-api-key). Den Typ jedes Keys (siehe [Key-Typen](https://platform.claude.com/docs/de/manage-claude/authentication#key-types)) und seine [Ablaufzeit](https://platform.claude.com/docs/de/manage-claude/authentication#key-expiration) wählst du beim Erstellen aus. Verwende [Workspaces](https://platform.claude.com/settings/workspaces) in der Console, um Umgebungen zu trennen und [Ausgaben](https://platform.claude.com/docs/de/api/rate-limits) nach Anwendungsfall zu steuern.
## Client-SDKs
Anthropic stellt offizielle SDKs bereit, die die API-Integration vereinfachen, indem sie Authentifizierung, Anfrageformatierung, Fehlerbehandlung und mehr übernehmen.
**Vorteile:**
* Automatische Header-Verwaltung (Authentifizierung, `anthropic-version`, `content-type`)
* Typsichere Anfrage- und Antwortbehandlung
* Integrierte Wiederholungslogik und Fehlerbehandlung
* Streaming-Unterstützung
* Anfrage-Timeouts und Verbindungsverwaltung
Für eine Liste der Client-SDKs siehe [Client-SDKs](https://platform.claude.com/docs/de/cli-sdks-libraries/overview).
## Claude API vs. Cloud-Plattformen
Claude ist über die direkte Claude API und über Cloud-Plattformen verfügbar. Wähle basierend auf deiner Infrastruktur, Funktionsverfügbarkeit, Compliance-Anforderungen und Preispräferenzen.
### Claude API
* **Direkter Zugriff** auf die neuesten Modelle und Funktionen
* **Anthropic-Abrechnung und -Support**
* **Am besten geeignet für:** Neue Integrationen, vollständiger Funktionszugriff, direkte Beziehung zu Anthropic
### Cloud-Plattform-APIs
Greife auf Claude über AWS, Google Cloud oder Microsoft Azure zu:
* **Integriert** mit der Abrechnung und dem IAM des Cloud-Anbieters
* **Die Funktionsverfügbarkeit variiert je nach Plattform:** Von Anthropic betriebene Plattformen umfassen [Claude Platform on AWS](https://platform.claude.com/docs/de/build-with-claude/claude-platform-on-aws) und [Microsoft Foundry](https://platform.claude.com/docs/de/build-with-claude/claude-in-microsoft-foundry); von Partnern betriebene Plattformen umfassen Amazon Bedrock und Google Cloud. Siehe die Seite jeder Plattform für Funktionsverfügbarkeit und Zeitplanung.
* **Am besten geeignet für:** Bestehende Cloud-Verpflichtungen, spezifische Compliance-Anforderungen, konsolidierte Cloud-Abrechnung
| Plattform | Anbieter | Dokumentation |
| ---------------------- | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Agent Platform | Google Cloud | [Claude auf Google Cloud](https://platform.claude.com/docs/de/build-with-claude/claude-on-vertex-ai) |
| Amazon Bedrock | AWS | [Claude in Amazon Bedrock](https://platform.claude.com/docs/de/build-with-claude/claude-in-amazon-bedrock) |
| Claude Platform on AWS | AWS (von Anthropic betrieben) | [Claude Platform on AWS](https://platform.claude.com/docs/de/build-with-claude/claude-platform-on-aws) |
| Microsoft Foundry | Microsoft Azure (von Anthropic betrieben) | [Claude in Microsoft Foundry](https://platform.claude.com/docs/de/build-with-claude/claude-in-microsoft-foundry) |
Claude Managed Agents ist über die direkte Claude API und [Claude Platform on AWS](https://platform.claude.com/docs/de/build-with-claude/claude-platform-on-aws) verfügbar. Für die Funktionsverfügbarkeit über Plattformen hinweg siehe die [Funktionsübersicht](https://platform.claude.com/docs/de/build-with-claude/overview).
## Anfrage- und Antwortformat
### Anfragegrößenlimits
| Endpunkt | Maximale Anfragegröße |
| --------------------------------------------------------------------------------------------- | --------------------- |
| Messages, Token Counting | 32 MB |
| [Message Batches API](https://platform.claude.com/docs/de/build-with-claude/batch-processing) | 256 MB |
| [Files API](https://platform.claude.com/docs/de/build-with-claude/files) | 500 MB |
| Sessions, Agents, Environments | 32 MB |
Wenn du diese Limits überschreitest, erhältst du einen 413 `request_too_large`-Fehler.
Von Partnern betriebene Plattformen haben ihre eigenen Anfragegrößenlimits: Bedrock begrenzt Anfragen auf 20 MB, und Google Cloud begrenzt Anfragen auf 30 MB. Claude Platform on AWS verwendet dieselben Limits wie die direkte Claude API. Konsultiere die Dokumentation deiner Plattform für aktuelle Werte.
### Antwort-Header
Die Claude API enthält die folgenden Header in ihren Antworten:
| Header | Beschreibung |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `request-id` | Ein global eindeutiger Bezeichner für die Anfrage, wie `req_018EeWyXxfu5pfWkrYcMdjWG`. Gib ihn an, wenn du den Support zu einer bestimmten Anfrage kontaktierst. Siehe [Request ID](https://platform.claude.com/docs/de/api/errors#request-id). |
| `anthropic-organization-id` | Die ID der Organisation, zu der der in der Anfrage verwendete API-Key oder das Zugriffstoken gehört. |
| `anthropic-workspace-id` | Die mit `wrkspc_` präfixierte ID des [Workspace](https://platform.claude.com/docs/de/manage-claude/workspaces), auf den der API-Key oder das Zugriffstoken aufgelöst wurde, wie `wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ`, auch wenn dies der Standard-Workspace deiner Organisation ist. Fehlt, wenn die Anmeldeinformation nicht auf einen Workspace aufgelöst wird (zum Beispiel bei Admin-API-Anfragen) oder die Anfrage fehlschlägt, bevor die Authentifizierung abgeschlossen ist. Siehe [Den Workspace hinter einer API-Antwort identifizieren](https://platform.claude.com/docs/de/manage-claude/workspaces#identify-the-workspace-behind-an-api-response). |
Für die Ratenlimit-Header siehe [Antwort-Header](https://platform.claude.com/docs/de/api/rate-limits#response-headers) in Ratenlimits. Für Beispiele, die einen Antwort-Header nach Namen mit jedem SDK lesen, siehe [Den Workspace hinter einer API-Antwort identifizieren](https://platform.claude.com/docs/de/manage-claude/workspaces#identify-the-workspace-behind-an-api-response).
Claude Platform on AWS fügt eine AWS-Request-ID (`x-amzn-requestid`) neben dem Standard-`request-id`-Header hinzu. Siehe [Request IDs](https://platform.claude.com/docs/de/build-with-claude/claude-platform-on-aws#request-ids) für das Muster zur Behandlung der dualen ID.
## Paginierung
List-Endpunkte geben Ergebnisse in Seiten zurück. Die meisten neueren List-Endpunkte verwenden das in diesem Abschnitt beschriebene `page`- und `next_page`-Cursor-Schema. Einige verwenden ein anderes Schema; siehe den Hinweis am Ende dieses Abschnitts. Verwende den `limit`-Abfrageparameter, um die Seitengröße zu steuern, und den `page`-Abfrageparameter, um eine benachbarte Seite abzurufen. Jede Antwort enthält ein `data`-Array neben Cursor-Feldern zum Navigieren zwischen Seiten.
| Name | Ort | Beschreibung |
| ----------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit` | Abfrageparameter | Maximale Anzahl der pro Seite zurückzugebenden Elemente. |
| `page` | Abfrageparameter | Undurchsichtiger Cursor aus einer vorherigen Antwort. Übergib hier einen `next_page`- oder `prev_page`-Wert, um die benachbarte Seite abzurufen. |
| `order` | Abfrageparameter | Sortierrichtung für die Ergebnisse (`asc` oder `desc`), bei List-Endpunkten, die Sortierung unterstützen. Ein `page`-Cursor ist nur mit der `order` gültig, mit der er erstellt wurde. |
| `next_page` | Antwortfeld | Cursor für die nächste Seite oder `null`, wenn es keine weiteren Ergebnisse gibt. |
| `prev_page` | Antwortfeld | Cursor für die vorherige Seite bei Endpunkten, die Rückwärtspaginierung unterstützen (derzeit `GET /v1/sessions`), oder `null`, wenn du dich auf der ersten Seite befindest. Andere List-Endpunkte lassen das Feld weg. |
Um eine Seite zurückzugehen, übergib `prev_page` als `page`-Parameter. `prev_page` ist `null`, wenn du dich auf der ersten Seite befindest. Nicht alle List-Endpunkte unterstützen `prev_page`. Nur `GET /v1/sessions` gibt `prev_page` zurück; bei List-Endpunkten, die keine Rückwärtspaginierung unterstützen, fehlt das Feld in der Antwort, anstatt `null` zu sein. Für eine Anfrage-Durchführung siehe [Sessions auflisten](https://platform.claude.com/docs/de/managed-agents/session-operations#listing-sessions).
Das SDK bietet einen automatisch paginierenden Iterator, der `next_page` für dich verfolgt. Zum Beispiel durchläuft `for session in client.beta.sessions.list()` (typescript: `for await (const session of client.beta.sessions.list())`; go: `client.Beta.Sessions.ListAutoPaging()`; java: `client.beta().sessions().list().autoPager()`; csharp: `(await client.Beta.Sessions.List()).Paginate()`; php: `$client->beta->sessions->list()->pagingEachItem()`; ruby: `client.beta.sessions.list.auto_paging_each`) jede Session. Die automatische Paginierung des SDK funktioniert nur vorwärts; um eine Seite zurückzugehen, lies `prev_page` aus der Antwort und übergib es selbst als `page`-Parameter. Details findest du unter [Client-SDKs](https://platform.claude.com/docs/de/cli-sdks-libraries/overview).
Einige List-Endpunkte verwenden ein anderes Cursor-Schema. Die [Message Batches API](https://platform.claude.com/docs/de/build-with-claude/batch-processing), die [Models API](https://platform.claude.com/docs/de/api/models/list) und mehrere [Admin-API](https://platform.claude.com/docs/de/manage-claude/admin-api)-Endpunkte nehmen `after_id`- und `before_id`-Abfrageparameter anstelle von `page`. Ihre Antworten geben `has_more`, `first_id` und `last_id` anstelle von `next_page` zurück. Siehe die Referenzseite für jeden Endpunkt für seine genauen Paginierungsfelder.
## Ratenlimits und Verfügbarkeit
### Ratenlimits
Die API erzwingt Ratenlimits und Ausgabenlimits, um Missbrauch zu verhindern und die Kapazität zu verwalten. Limits sind in Nutzungsstufen organisiert; deine Organisation wird automatisch einer Stufe zugeordnet und kann im Laufe der Zeit zu einer höheren Stufe wechseln. Jede Stufe hat:
* **Ausgabenlimits**: Maximale monatliche Kosten für die API-Nutzung
* **Ratenlimits**: Maximale Anzahl von Anfragen pro Minute (RPM) und Token pro Minute (TPM)
Du kannst deine Ratenlimits auf der Seite [Ratenlimits](https://platform.claude.com/usage/limits) und deine Ausgabenlimits auf der Seite [Abrechnung](https://platform.claude.com/settings/billing) in der Console einsehen. Für höhere Ratenlimits oder eine höhere monatliche Ausgabenobergrenze verwende **Request tier increase** (Stufenerhöhung anfordern) auf der Seite Ratenlimits.
Für detaillierte Informationen über Limits, Stufen und den für die Ratenbegrenzung verwendeten Token-Bucket-Algorithmus siehe [Ratenlimits](https://platform.claude.com/docs/de/api/rate-limits).
### Verfügbarkeit
Die Claude API ist in [vielen Ländern und Regionen](https://platform.claude.com/docs/de/api/supported-regions) weltweit verfügbar. Überprüfe die Seite der unterstützten Regionen, um die Verfügbarkeit an deinem Standort zu bestätigen.
## Nächste Schritte
Vollständige API-Spezifikation für direkte Modellinteraktionen
Agents-, Sessions- und Environments-Endpunkte
Python, TypeScript, C#, Go, Java, PHP und Ruby
Nutzungsstufen, Anfordern höherer Limits und der Token-Bucket-Algorithmus