OpenAI SDK-Kompatibilität



Erste Schritte mit dem OpenAI SDK

Um die OpenAI SDK-Kompatibilitätsfunktion zu nutzen, musst du:

1. Ein offizielles OpenAI SDK verwenden
2. Folgendes ändern
   • Aktualisiere deine Basis-URL, sodass sie auf die Claude API zeigt
   • Ersetze deinen API-Key durch einen Claude API-Key
   • Aktualisiere deinen Modellnamen, um ein Claude-Modell zu verwenden
3. Die folgenden Abschnitte durchsehen, um zu erfahren, welche Funktionen unterstützt werden



Schnellstart-Beispiel

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",  # Claude model name
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"},
    ],
)

print(response.choices[0].message.content)



Wichtige Einschränkungen der OpenAI-Kompatibilität



API-Verhalten

Hier sind die wesentlichsten Unterschiede zur Verwendung von OpenAI:

• Der strict-Parameter für Function Calling wird ignoriert, was bedeutet, dass nicht garantiert ist, dass das JSON der Tool-Nutzung dem bereitgestellten Schema folgt. Für garantierte Schemakonformität verwende die native Claude API mit 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 verfügbar
• System-/Developer-Nachrichten werden an den Anfang der Konversation verschoben und zusammengefügt, da Anthropic nur eine einzelne initiale Systemnachricht unterstützt.

Die meisten nicht unterstützten Felder werden stillschweigend ignoriert, anstatt Fehler zu erzeugen. Diese sind alle in den folgenden Abschnitten dokumentiert.



Überlegungen zur Ausgabequalität

Wenn du viel Feinarbeit in deinen Prompt gesteckt hast, ist er wahrscheinlich speziell auf OpenAI abgestimmt. Erwäge, ihn für Claude mithilfe des Leitfadens zu Best Practices beim Prompting zu überarbeiten.



Verschieben von System-/Developer-Nachrichten

Die meisten Eingaben an das OpenAI SDK lassen sich eindeutig direkt auf die API-Parameter von Anthropic abbilden, aber ein deutlicher Unterschied ist die Handhabung von System-/Developer-Prompts. Diese beiden Prompts können über OpenAI an beliebiger Stelle in einer Chat-Konversation platziert werden. Da Anthropic nur eine initiale Systemnachricht unterstützt, nimmt die API alle System-/Developer-Nachrichten und fügt sie mit jeweils einem einzelnen Zeilenumbruch (\n) dazwischen zusammen. Diese vollständige Zeichenkette wird dann als einzelne Systemnachricht am Anfang der Nachrichten bereitgestellt.



Unterstützung für Denken

Du kannst Denken aktivieren, indem du den thinking-Parameter hinzufügst. Bei aktuellen Modellen ist das Denken adaptiv, wobei Claude entscheidet, wann und wie tief es denkt, und bei Claude 5-Modellen ist es standardmäßig aktiviert; manuell konfiguriertes erweitertes Denken ist ein Legacy-Modus. Während Denken Claudes Schlussfolgerungen bei komplexen Aufgaben verbessert, gibt das OpenAI SDK Claudes detaillierten Denkprozess nicht zurück. Für den vollen Funktionsumfang des Denkens, einschließlich des Zugriffs auf Claudes schrittweise Schlussfolgerungsausgabe, verwende die native Claude API.

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}},
)



Ratenlimits

Ratenlimits folgen den Standardlimits von Anthropic für den /v1/messages-Endpunkt.



Detaillierte Unterstützung der OpenAI-kompatiblen API



Request-Felder



Einfache Felder



tools- / functions-Felder



Felder des messages-Arrays



Response-Felder



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

Während 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.