---
title: OpenAI-SDK-Kompatibilität
url: https://platform.claude.com/docs/de/cli-sdks-libraries/libraries/openai-sdk
description: Anthropic bietet eine Kompatibilitätsschicht, mit der du das OpenAI SDK verwenden kannst, um die Claude API zu testen. Mit wenigen Codeänderungen kannst du die Fähigkeiten der Anthropic-Modelle evaluieren.
---
Diese Kompatibilitätsschicht ist in erster Linie dazu gedacht, Modellfähigkeiten zu testen und zu vergleichen, und gilt für die meisten Anwendungsfälle nicht als langfristige oder produktionsreife Lösung. Obwohl sie voll funktionsfähig bleiben und keine Breaking Changes erhalten soll, liegt die Priorität auf der Zuverlässigkeit und Effektivität der [Claude API](https://platform.claude.com/docs/de/api/overview).
Weitere Informationen zu bekannten Kompatibilitätseinschränkungen findest du unter [Wichtige Einschränkungen der OpenAI-Kompatibilität](https://platform.claude.com/docs/de/cli-sdks-libraries/libraries/openai-sdk#important-openai-compatibility-limitations).
Wenn du auf Probleme mit der OpenAI SDK-Kompatibilitätsfunktion stößt, teile dein Feedback über dieses [Kompatibilitäts-Feedbackformular](https://forms.gle/oQV4McQNiuuNbz9n8).
Für die beste Erfahrung und den Zugriff auf den vollen Funktionsumfang der Claude API ([PDF-Verarbeitung](https://platform.claude.com/docs/de/build-with-claude/pdf-support), [Zitate](https://platform.claude.com/docs/de/build-with-claude/citations), [Nachdenken](https://platform.claude.com/docs/de/build-with-claude/thinking) und [Prompt-Caching](https://platform.claude.com/docs/de/build-with-claude/prompt-caching)) verwende die native [Claude API](https://platform.claude.com/docs/de/api/overview).
## Erste Schritte mit dem OpenAI SDK
Um die OpenAI SDK-Kompatibilitätsfunktion zu verwenden, musst du:
1. Ein offizielles OpenAI SDK verwenden.
2. Folgendes ändern:
* Aktualisiere deine Basis-URL so, dass sie auf die Claude API verweist.
* Ersetze deinen API-Key durch einen [Claude API-Key](https://platform.claude.com/settings/keys) aus der Claude Console.
* Wenn dein Key ein [persönlicher oder Service-Account-Key](https://platform.claude.com/docs/de/manage-claude/authentication#key-types) ist, der nicht auf einen Workspace beschränkt ist, sende bei jeder Anfrage zusätzlich den Header `anthropic-workspace-id` (zum Beispiel `default_headers` im Python SDK oder `defaultHeaders` in TypeScript); siehe [Einen Workspace auswählen](https://platform.claude.com/docs/de/manage-claude/authentication#select-a-workspace).
* Aktualisiere deinen Modellnamen, sodass ein [Claude-Modell](https://platform.claude.com/docs/de/models/overview) verwendet wird.
3. Lies die folgenden Abschnitte, um zu erfahren, welche Funktionen unterstützt werden.
### Schnellstart-Beispiel
```python Python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ.get("ANTHROPIC_API_KEY"), # Your Claude API key
base_url="https://api.anthropic.com/v1/", # the Claude API endpoint
)
response = client.chat.completions.create(
model="claude-opus-5-5", # Claude model name
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Who are you?"},
],
)
print(response.choices[0].message.content)
```
```typescript TypeScript
import OpenAI from "openai";
const openai = new OpenAI({
apiKey: process.env.ANTHROPIC_API_KEY, // Your Claude API key
baseURL: "https://api.anthropic.com/v1/" // Claude API endpoint
});
const response = await openai.chat.completions.create({
messages: [
{ role: "system", content: "You are a helpful assistant." },
{ role: "user", content: "Who are you?" }
],
model: "claude-opus-5-5" // Claude model name
});
console.log(response.choices[0].message.content);
```
```csharp C#
using System.ClientModel;
using OpenAI;
using OpenAI.Chat;
ChatClient chatClient = new(
model: "claude-opus-5-5", // Claude model name
credential: new ApiKeyCredential(
Environment.GetEnvironmentVariable("ANTHROPIC_API_KEY")), // Your Claude API key
options: new OpenAIClientOptions()
{
Endpoint = new Uri("https://api.anthropic.com/v1/") // the Claude API endpoint
});
ChatCompletion completion = chatClient.CompleteChat(
new SystemChatMessage("You are a helpful assistant."),
new UserChatMessage("Who are you?"));
Console.WriteLine(completion.Content[0].Text);
```
```go Go
package main
import (
"context"
"fmt"
"os"
"github.com/openai/openai-go/v3"
"github.com/openai/openai-go/v3/option"
)
func main() {
client := openai.NewClient(
option.WithAPIKey(os.Getenv("ANTHROPIC_API_KEY")), // Your Claude API key
option.WithBaseURL("https://api.anthropic.com/v1/"), // the Claude API endpoint
)
response, err := client.Chat.Completions.New(context.Background(), openai.ChatCompletionNewParams{
Model: "claude-opus-5-5", // Claude model name
Messages: []openai.ChatCompletionMessageParamUnion{
openai.SystemMessage("You are a helpful assistant."),
openai.UserMessage("Who are you?"),
},
})
if err != nil {
panic(err)
}
fmt.Println(response.Choices[0].Message.Content)
}
```
```java Java
import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.chat.completions.ChatCompletion;
import com.openai.models.chat.completions.ChatCompletionCreateParams;
public class QuickStart {
public static void main(String[] args) {
OpenAIClient client = OpenAIOkHttpClient.builder()
.apiKey(System.getenv("ANTHROPIC_API_KEY")) // Your Claude API key
.baseUrl("https://api.anthropic.com/v1/") // the Claude API endpoint
.build();
ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
.model("claude-opus-5-5") // Claude model name
.addSystemMessage("You are a helpful assistant.")
.addUserMessage("Who are you?")
.build();
ChatCompletion completion = client.chat().completions().create(params);
System.out.println(completion.choices().get(0).message().content().orElse(""));
}
}
```
OpenAI hat kein offizielles PHP SDK. Um Claude aus PHP heraus zu verwenden, nutze stattdessen das [Claude SDK für PHP](https://platform.claude.com/docs/de/cli-sdks-libraries/sdks/php).
```ruby Ruby
require "openai"
openai = OpenAI::Client.new(
api_key: ENV["ANTHROPIC_API_KEY"], # Your Claude API key
base_url: "https://api.anthropic.com/v1/" # the Claude API endpoint
)
response = openai.chat.completions.create(
model: "claude-opus-5-5", # Claude model name
messages: [
{role: "system", content: "You are a helpful assistant."},
{role: "user", content: "Who are you?"}
]
)
puts response.choices.first.message.content
```
## Wichtige Einschränkungen der OpenAI-Kompatibilität
### API-Verhalten
Hier sind die wesentlichsten Unterschiede zur Verwendung von OpenAI:
* Der Parameter `strict` für Function Calling wird ignoriert, was bedeutet, dass nicht garantiert ist, dass das JSON der Tool-Nutzung dem angegebenen Schema entspricht. Für garantierte Schemakonformität verwende die native [Claude API mit Structured Outputs](https://platform.claude.com/docs/de/build-with-claude/structured-outputs).
* Audio-Eingaben werden nicht unterstützt; sie werden ignoriert und aus der Eingabe entfernt.
* Prompt-Caching wird nicht unterstützt, ist aber in den [Anthropic SDKs](https://platform.claude.com/docs/de/cli-sdks-libraries/overview) verfügbar.
* System-/Developer-Nachrichten werden an den Anfang verschoben und im Top-Level-Feld `system` zusammengefügt, unabhängig davon, wo sie in der Konversation erscheinen. Um Systemanweisungen mitten in einer Konversation hinzuzufügen, verwende [System-Nachrichten mitten in der Konversation](https://platform.claude.com/docs/de/build-with-claude/mid-conversation-system-messages) in der nativen Claude API.
Die meisten nicht unterstützten Felder werden stillschweigend ignoriert, anstatt Fehler zu erzeugen. Sie sind alle in den folgenden Abschnitten dokumentiert.
### Überlegungen zur Ausgabequalität
Wenn du deinen Prompt umfassend angepasst hast, ist er wahrscheinlich speziell auf OpenAI abgestimmt. Erwäge, ihn für Claude mithilfe des Leitfadens [Best Practices für Prompts](https://platform.claude.com/docs/de/build-with-claude/prompt-engineering/claude-prompting-best-practices) zu überarbeiten.
### Verschieben von System-/Developer-Nachrichten an den Anfang
Die meisten Eingaben des OpenAI SDK lassen sich eindeutig direkt auf Parameter der Claude API abbilden, ein deutlicher Unterschied ist jedoch die Behandlung von System-/Developer-Prompts. Diese beiden Prompts können in der OpenAI API an beliebiger Stelle einer Chat-Konversation platziert werden. Die Kompatibilitätsschicht nimmt alle System-/Developer-Nachrichten und fügt sie mit einem einzelnen Zeilenumbruch (`\n`) dazwischen zusammen. Dieser vollständige String wird dann als Top-Level-Feld `system` vor allen Nachrichten übergeben.
### Unterstützung für Nachdenken
Du kannst [Nachdenken](https://platform.claude.com/docs/de/build-with-claude/thinking) aktivieren, indem du den Parameter `thinking` hinzufügst. Bei aktuellen Modellen ist das Nachdenken adaptiv, wobei Claude bestimmt, wann und wie tief nachgedacht wird, und bei Claude-5-Modellen ist es standardmäßig aktiviert; manuell konfiguriertes erweitertes Nachdenken ist ein veralteter Modus. Obwohl Nachdenken Claudes Schlussfolgerungen bei komplexen Aufgaben verbessert, gibt das OpenAI SDK Claudes Nachdenken nicht zurück. Für den vollen Funktionsumfang des Nachdenkens, einschließlich des [zusammengefassten Nachdenkens](https://platform.claude.com/docs/de/build-with-claude/thinking#summarized-thinking), verwende die native Claude API.
```python Python
response = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Who are you?"}],
extra_body={"thinking": {"type": "enabled", "budget_tokens": 2000}},
)
```
```typescript TypeScript
const response = await openai.chat.completions.create({
messages: [{ role: "user", content: "Who are you?" }],
model: "claude-sonnet-4-6",
// @ts-expect-error
thinking: { type: "enabled", budget_tokens: 2000 }
});
```
```csharp C#
// Das .NET SDK hat keinen extra_body-Parameter wie Python, daher sendet dieses Beispiel
// den thinking-Parameter mit der dokumentierten Protokollmethode des SDK
// (ein roher JSON-Request-Body).
BinaryData input = BinaryData.FromString("""
{
"model": "claude-sonnet-4-6",
"messages": [{ "role": "user", "content": "Who are you?" }],
"thinking": { "type": "enabled", "budget_tokens": 2000 }
}
""");
using BinaryContent content = BinaryContent.Create(input);
ClientResult result = chatClient.CompleteChat(content);
```
```go Go
response, err := client.Chat.Completions.New(
context.Background(),
openai.ChatCompletionNewParams{
Model: "claude-sonnet-4-6",
Messages: []openai.ChatCompletionMessageParamUnion{
openai.UserMessage("Who are you?"),
},
},
option.WithJSONSet("thinking", map[string]any{"type": "enabled", "budget_tokens": 2000}),
)
```
```java Java
ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
.model("claude-sonnet-4-6")
.addUserMessage("Who are you?")
.putAdditionalBodyProperty("thinking",
JsonValue.from(Map.of("type", "enabled", "budget_tokens", 2000)))
.build();
ChatCompletion completion = client.chat().completions().create(params);
```
OpenAI hat kein offizielles PHP SDK. Um Claude aus PHP heraus zu verwenden, nutze stattdessen das [Claude SDK für PHP](https://platform.claude.com/docs/de/cli-sdks-libraries/sdks/php).
```ruby Ruby
response = openai.chat.completions.create(
model: "claude-sonnet-4-6",
messages: [{role: "user", content: "Who are you?"}],
request_options: {extra_body: {thinking: {type: "enabled", budget_tokens: 2000}}}
)
```
## Ratenlimits
Ratenlimits folgen den [Standardlimits](https://platform.claude.com/docs/de/api/rate-limits) von Anthropic für den Endpunkt `/v1/messages`.
## Detaillierte Unterstützung der OpenAI-kompatiblen API
### Anfragefelder
#### Einfache Felder
| Feld | Unterstützungsstatus |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model` | Verwende Claude-Modellnamen |
| `max_tokens` | Vollständig unterstützt |
| `max_completion_tokens` | Vollständig unterstützt |
| `stream` | Vollständig unterstützt |
| `stream_options` | Vollständig unterstützt |
| `top_p` | Wird an das Modell weitergegeben. Claude 4.7 und neuere Modelle sowie Claude Mythos Preview geben bei jedem anderen Wert als `0.99`, dem Standardwert, einen 400-Fehler zurück, also lass ihn weg. Eine Anfrage, die sowohl `temperature` als auch `top_p` setzt, gibt ebenfalls einen 400-Fehler zurück. Siehe [Verwendung der Messages API](https://platform.claude.com/docs/de/build-with-claude/working-with-messages). |
| `parallel_tool_calls` | Vollständig unterstützt |
| `stop` | Alle Stop-Sequenzen ohne Leerraumzeichen funktionieren |
| `temperature` | Zwischen 0 und 1 (einschließlich). Werte größer als 1 werden auf 1 begrenzt. Bei Claude 4.7 und neueren Modellen sowie Claude Mythos Preview gibt jeder Wert unter 1 einen 400-Fehler zurück, also lass ihn weg. Siehe [Verwendung der Messages API](https://platform.claude.com/docs/de/build-with-claude/working-with-messages). |
| `n` | Muss genau 1 sein |
| `logprobs` | Ignoriert |
| `metadata` | Ignoriert |
| `response_format` | Ignoriert. Für JSON-Ausgabe verwende [Structured Outputs](https://platform.claude.com/docs/de/build-with-claude/structured-outputs) mit der nativen Claude API. |
| `prediction` | Ignoriert |
| `presence_penalty` | Ignoriert |
| `frequency_penalty` | Ignoriert |
| `seed` | Ignoriert |
| `service_tier` | Ignoriert |
| `audio` | Ignoriert |
| `logit_bias` | Ignoriert |
| `store` | Ignoriert |
| `user` | Ignoriert |
| `modalities` | Ignoriert |
| `top_logprobs` | Ignoriert |
| `reasoning_effort` | Ignoriert |
#### `tools`- / `functions`-Felder
`tools[n].function`-Felder
| Feld | Unterstützungsstatus |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name` | Vollständig unterstützt |
| `description` | Vollständig unterstützt |
| `parameters` | Vollständig unterstützt |
| `strict` | Ignoriert. Verwende [Structured Outputs](https://platform.claude.com/docs/de/build-with-claude/structured-outputs) mit der nativen Claude API für eine strikte Schemavalidierung. |
`functions[n]`-Felder
OpenAI hat das Feld `functions` abgekündigt und empfiehlt, stattdessen `tools` zu verwenden.
| Feld | Unterstützungsstatus |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name` | Vollständig unterstützt |
| `description` | Vollständig unterstützt |
| `parameters` | Vollständig unterstützt |
| `strict` | Ignoriert. Verwende [Structured Outputs](https://platform.claude.com/docs/de/build-with-claude/structured-outputs) mit der nativen Claude API für eine strikte Schemavalidierung. |
#### Felder des `messages`-Arrays
Felder für `messages[n].role == "developer"`
Developer-Nachrichten werden als Teil der initialen System-Nachricht an den Anfang der Konversation gezogen.
| Feld | Unterstützungsstatus |
| --------- | ------------------------------------------------------ |
| `content` | Vollständig unterstützt, aber an den Anfang verschoben |
| `name` | Ignoriert |
Felder für `messages[n].role == "system"`
System-Nachrichten werden als Teil der initialen System-Nachricht an den Anfang der Konversation gezogen.
| Feld | Unterstützungsstatus |
| --------- | ------------------------------------------------------ |
| `content` | Vollständig unterstützt, aber an den Anfang verschoben |
| `name` | Ignoriert |
Felder für `messages[n].role == "user"`
| Feld | Variante | Unterfeld | Unterstützungsstatus |
| --------- | -------------------------------- | --------- | ----------------------- |
| `content` | `string` | | Vollständig unterstützt |
| | `array`, `type == "text"` | | Vollständig unterstützt |
| | `array`, `type == "image_url"` | `url` | Vollständig unterstützt |
| | | `detail` | Ignoriert |
| | `array`, `type == "input_audio"` | | Ignoriert |
| | `array`, `type == "file"` | | Ignoriert |
| `name` | | | Ignoriert |
Felder für `messages[n].role == "assistant"`
| Feld | Variante | Unterstützungsstatus |
| --------------- | ---------------------------- | ----------------------- |
| `content` | `string` | Vollständig unterstützt |
| | `array`, `type == "text"` | Vollständig unterstützt |
| | `array`, `type == "refusal"` | Ignoriert |
| `tool_calls` | | Vollständig unterstützt |
| `function_call` | | Vollständig unterstützt |
| `audio` | | Ignoriert |
| `refusal` | | Ignoriert |
Felder für `messages[n].role == "tool"`
| Feld | Variante | Unterstützungsstatus |
| -------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `content` | `string` | Vollständig unterstützt |
| | `array`, `type == "text"` | Vollständig unterstützt |
| `tool_call_id` | | Vollständig unterstützt |
| `tool_choice` | | Unterstützt. `"required"` und Werte mit benannten Funktionen erzwingen einen Tool-Aufruf; Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.1 und Claude Mythos 5.1 unterstützen keine erzwungene Tool-Nutzung und geben einen Fehler zurück, verwende daher bei diesen Modellen `"auto"`. Siehe [Tool-Nutzung erzwingen](https://platform.claude.com/docs/de/agents-and-tools/tool-use/define-tools#forcing-tool-use). |
| `name` | | Ignoriert |
Felder für `messages[n].role == "function"`
| Feld | Variante | Unterstützungsstatus |
| ------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `content` | `string` | Vollständig unterstützt |
| | `array`, `type == "text"` | Vollständig unterstützt |
| `tool_choice` | | Unterstützt. `"required"` und Werte mit benannten Funktionen erzwingen einen Tool-Aufruf; Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.1 und Claude Mythos 5.1 unterstützen keine erzwungene Tool-Nutzung und geben einen Fehler zurück, verwende daher bei diesen Modellen `"auto"`. Siehe [Tool-Nutzung erzwingen](https://platform.claude.com/docs/de/agents-and-tools/tool-use/define-tools#forcing-tool-use). |
| `name` | | Ignoriert |
### Antwortfelder
| Feld | Unterstützungsstatus |
| --------------------------------- | -------------------------- |
| `id` | Vollständig unterstützt |
| `choices[]` | Hat immer eine Länge von 1 |
| `choices[].finish_reason` | Vollständig unterstützt |
| `choices[].index` | Vollständig unterstützt |
| `choices[].message.role` | Vollständig unterstützt |
| `choices[].message.content` | Vollständig unterstützt |
| `choices[].message.tool_calls` | Vollständig unterstützt |
| `object` | Vollständig unterstützt |
| `created` | Vollständig unterstützt |
| `model` | Vollständig unterstützt |
| `finish_reason` | Vollständig unterstützt |
| `content` | Vollständig unterstützt |
| `usage.completion_tokens` | Vollständig unterstützt |
| `usage.prompt_tokens` | Vollständig unterstützt |
| `usage.total_tokens` | Vollständig unterstützt |
| `usage.completion_tokens_details` | Immer leer |
| `usage.prompt_tokens_details` | Immer leer |
| `choices[].message.refusal` | Immer leer |
| `choices[].message.audio` | Immer leer |
| `logprobs` | Immer leer |
| `service_tier` | Immer leer |
| `system_fingerprint` | Immer leer |
### Kompatibilität von Fehlermeldungen
Die Kompatibilitätsschicht behält konsistente Fehlerformate mit der OpenAI API bei. Die detaillierten Fehlermeldungen sind jedoch nicht gleichwertig. Verwende die Fehlermeldungen nur für Logging und Debugging.
### Header-Kompatibilität
Obwohl das OpenAI SDK Header automatisch verwaltet, findest du hier die vollständige Liste der von der Claude API unterstützten Header für Entwickler, die direkt mit ihnen arbeiten müssen.
| Header | Unterstützungsstatus |
| -------------------------------- | ----------------------- |
| `x-ratelimit-limit-requests` | Vollständig unterstützt |
| `x-ratelimit-limit-tokens` | Vollständig unterstützt |
| `x-ratelimit-remaining-requests` | Vollständig unterstützt |
| `x-ratelimit-remaining-tokens` | Vollständig unterstützt |
| `x-ratelimit-reset-requests` | Vollständig unterstützt |
| `x-ratelimit-reset-tokens` | Vollständig unterstützt |
| `retry-after` | Vollständig unterstützt |
| `request-id` | Vollständig unterstützt |
| `openai-version` | Immer `2020-10-01` |
| `authorization` | Vollständig unterstützt |
| `openai-processing-ms` | Immer leer |