--- title: Beta-Header url: https://platform.claude.com/docs/de/api/beta-headers description: Greife mit dem `anthropic-beta`-Header oder dem `betas`-Parameter des SDK auf experimentelle Funktionen zu, bevor sie Teil der Standard-API werden. --- Beta-Header ermöglichen dir den Zugriff auf experimentelle Funktionen und neue Modellfähigkeiten, bevor sie Teil der Standard-API werden. Das [Client-SDK](https://platform.claude.com/docs/de/cli-sdks-libraries/overview) stellt einen `client.beta` (csharp, go: `client.Beta`; java: `client.beta()`; php: `$client->beta`)-Namespace bereit, um die API mit aktivierten Beta-Funktionen aufzurufen. ## So verwendest du Beta-Header Um auf Beta-Funktionen zuzugreifen, füge den `anthropic-beta`-Header in deine API-Anfragen ein: ```http POST /v1/messages x-api-key: YOUR_API_KEY anthropic-version: 2023-06-01 anthropic-beta: BETA_FEATURE_NAME content-type: application/json ``` Die Dokumentation jeder Funktion gibt den genauen Beta-Namen an, der gesendet werden muss. Die [API-Übersicht](https://platform.claude.com/docs/de/api/overview) listet die APIs auf, die sich derzeit in der Beta-Phase befinden. Die folgenden Beispiele zeigen dieselbe Anfrage mit cURL, der `ant`-CLI und dem SDK, wobei die Beta für [Kontextbearbeitung](https://platform.claude.com/docs/de/build-with-claude/context-editing) als Beispiel dient. Das SDK nimmt Beta-Namen über `betas` (csharp, go: `Betas`; java: `.addBeta()`) entgegen und sendet den `anthropic-beta`-Header für dich: ```bash cURL curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: context-management-2025-06-27" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 1024, "messages": [ {"role": "user", "content": "Hello, Claude"} ] }' ``` ```bash CLI ant beta:messages create \ --beta context-management-2025-06-27 \ --model claude-opus-5-5 \ --max-tokens 1024 \ --message '{role: user, content: "Hello, Claude"}' ``` ```python Python client = Anthropic() response = client.beta.messages.create( model="claude-opus-5-5", max_tokens=1024, messages=[{"role": "user", "content": "Hello, Claude"}], betas=["context-management-2025-06-27"], ) print(response.content) ``` ```typescript TypeScript const client = new Anthropic(); const msg = await client.beta.messages.create({ model: "claude-opus-5-5", max_tokens: 1024, messages: [{ role: "user", content: "Hello, Claude" }], betas: ["context-management-2025-06-27"] }); console.log(msg.content); ``` ```csharp C# var client = new AnthropicClient(); var message = await client.Beta.Messages.Create( new MessageCreateParams { Model = Model.ClaudeOpus5_5, MaxTokens = 1024, Messages = [new() { Role = Role.User, Content = "Hello, Claude" }], Betas = ["context-management-2025-06-27"], } ); Console.WriteLine(string.Join("\n", message.Content)); ``` ```go Go client := anthropic.NewClient() message, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 1024, Messages: []anthropic.BetaMessageParam{ anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Hello, Claude")), }, Betas: []anthropic.AnthropicBeta{anthropic.AnthropicBetaContextManagement2025_06_27}, }) if err != nil { panic(err) } fmt.Printf("%+v\n", message.Content) ``` ```java Java AnthropicClient client = AnthropicOkHttpClient.fromEnv(); MessageCreateParams params = MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(1024) .addUserMessage("Hello, Claude") .addBeta(AnthropicBeta.CONTEXT_MANAGEMENT_2025_06_27) .build(); BetaMessage message = client.beta().messages().create(params); System.out.println(message.content()); ``` ```php PHP $client = new Client(); $message = $client->beta->messages->create( maxTokens: 1024, messages: [['role' => 'user', 'content' => 'Hello, Claude']], model: 'claude-opus-5-5', betas: ['context-management-2025-06-27'], ); echo $message; ``` ```ruby Ruby client = Anthropic::Client.new message = client.beta.messages.create( model: "claude-opus-5-5", max_tokens: 1024, messages: [{role: "user", content: "Hello, Claude"}], betas: ["context-management-2025-06-27"] ) puts(message.content) ``` Beta-Funktionen sind experimentell und können: * Breaking Changes mit Vorankündigung aufweisen * Abgekündigt oder entfernt werden * Andere Ratenlimits oder Preise haben * Nicht in allen Regionen verfügbar sein ### Mehrere Beta-Funktionen Um mehrere Beta-Funktionen in einer einzigen Anfrage zu verwenden, füge alle Funktionsnamen durch Kommas getrennt in den Header ein: ```http anthropic-beta: feature1,feature2,feature3 ``` Du kannst den `anthropic-beta`-Header auch mehrmals in derselben Anfrage senden. Die Claude API liest jeden `anthropic-beta`-Header, daher ist Folgendes gleichwertig zum vorherigen Beispiel: ```http anthropic-beta: feature1 anthropic-beta: feature2 anthropic-beta: feature3 ``` Liste mit dem SDK jede Funktion auf (zum Beispiel `betas=["feature1", "feature2"]` (typescript, ruby: `betas: ["feature1", "feature2"]`; php: `betas: ['feature1', 'feature2']`; csharp: `Betas = ["feature1", "feature2"]`; go: `Betas: []anthropic.AnthropicBeta{"feature1", "feature2"}`; java: `.addBeta("feature1").addBeta("feature2")`)). Übergib mit der CLI ein einzelnes `--beta`-Flag mit den durch Kommas getrennten Funktionsnamen (zum Beispiel `--beta feature1,feature2`). Du kannst das Flag auch wiederholen (zum Beispiel `--beta feature1 --beta feature2`). ### Beta-Funktionen auf anderen Plattformen Beta-Namen sind auf jeder Plattform, die sie akzeptiert, gleich, aber nicht jede Plattform akzeptiert jede Beta. [Claude Platform on AWS](https://platform.claude.com/docs/de/build-with-claude/claude-platform-on-aws), [Microsoft Foundry](https://platform.claude.com/docs/de/build-with-claude/claude-in-microsoft-foundry) und [Google Cloud](https://platform.claude.com/docs/de/build-with-claude/claude-on-vertex-ai) nehmen Beta-Namen im `anthropic-beta`-Header entgegen, genau wie die Claude API. Um mehrere Betas zu senden, füge ihre Namen durch Kommas getrennt in einen Header ein: Google Cloud liest nur einen `anthropic-beta`-Header und ignoriert die übrigen, sodass Betas in den anderen Headern nicht wirksam werden. Bei Amazon Bedrock hängt es von der aufgerufenen API ab, wo die Beta-Namen angegeben werden: * [Claude in Amazon Bedrock](https://platform.claude.com/docs/de/build-with-claude/claude-in-amazon-bedrock) (`bedrock-mantle`-Endpunkte) nimmt sie im `anthropic-beta`-Header entgegen. * Die [InvokeModel API](https://platform.claude.com/docs/de/build-with-claude/claude-on-amazon-bedrock-legacy) liest sie aus dem Anfragetext, nicht aus einem Header. Liste sie im `anthropic_beta`-Array des Anfragetexts auf, ein Name pro Element, zum Beispiel `"anthropic_beta": ["feature1", "feature2"]`. ### Endpunktspezifische Header Einige Beta-APIs sind auf bestimmte Endpunkte beschränkt und erfordern bei jeder Anfrage einen funktionsspezifischen Beta-Header: | Endpunkte | Beta-Header | | ------------------------------------------------ | --------------------------- | | `/v1/agents`, `/v1/sessions`, `/v1/environments` | `managed-agents-2026-04-01` | | `/v1/tunnels` | `mcp-tunnels-2026-06-22` | | `/v1/memory_stores` und Unterressourcen | `agent-memory-2026-07-22` | Der `client.beta` (csharp, go: `client.Beta`; java: `client.beta()`; php: `$client->beta`)-Namespace des SDK fügt diese Header automatisch hinzu. Füge sie nur selbst hinzu, wenn du rohe HTTP-Anfragen stellst. Details findest du in der [Managed-Agents-Übersicht](https://platform.claude.com/docs/de/managed-agents/overview), unter [Agent-Memory verwenden](https://platform.claude.com/docs/de/managed-agents/memory) und in der [MCP-Tunnel-Referenz](https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/reference#tunnels-api). Endpunktspezifische Header, die für denselben Endpunkt gelten, lassen sich nicht immer kombinieren. Bei Memory-Store-Endpunkten ersetzt `agent-memory-2026-07-22` den Header `managed-agents-2026-04-01`: Wenn du beide in derselben Anfrage sendest, wird ein `400`-Fehler zurückgegeben. Das SDK sendet automatisch den richtigen Header für jeden Endpunkt. ### Konventionen für die Versionsbenennung Namen von Beta-Funktionen folgen in der Regel dem Muster `feature-name-YYYY-MM-DD`, wobei das Datum angibt, wann die Beta veröffentlicht wurde. Verwende immer den genauen Namen der Beta-Funktion, wie er dokumentiert ist. ## Fehlerbehandlung Wenn du einen ungültigen Beta-Namen oder eine Beta verwendest, auf die deine Organisation keinen Zugriff hat, erhältst du eine `400`-Fehlerantwort: ```json Output { "type": "error", "error": { "type": "invalid_request_error", "message": "Unexpected value(s) `invalid-beta-name` for the `anthropic-beta` header. Please consult our documentation at platform.claude.com/docs or try again without the header." }, "request_id": "req_011CcnGfC9fELffo2EALu4Wd" } ``` ## Hilfe erhalten Aktualisierungen zu Beta-Funktionen findest du in den [Versionshinweisen](https://platform.claude.com/docs/de/release-notes/overview). Bei Problemen im Produktivbetrieb wende dich an den [Support](https://support.claude.com/). ## Nächste Schritte Verstehe die HTTP-Statuscodes, die Struktur von Fehlerantworten und die Request-IDs, die die Claude API zurückgibt, und behandle Fehler mit den typisierten Exceptions des SDK. Entdecke die Funktionen der Claude API, einschließlich der APIs, die sich derzeit in der Beta-Phase befinden.