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 Base-URL, sodass sie auf die Claude API zeigt
   • Ersetze deinen API-Key durch einen Claude API-Key
   • Wenn dein Key ein persönlicher Key oder ein Service-Account-Key mit Zugriff auf mehrere Workspaces ist, sende zusätzlich bei jeder Anfrage den Header anthropic-workspace-id (zum Beispiel default_headers im Python SDK oder defaultHeaders in TypeScript); siehe Einen Workspace auswählen
   • Aktualisiere deinen Modellnamen, sodass ein Claude-Modell verwendet wird
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 Parameter strict für Function Calling wird ignoriert, was bedeutet, dass das JSON der Tool-Nutzung nicht garantiert dem übergebenen 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 einzige initiale System-Nachricht unterstützt.

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 viel an deinem Prompt gefeilt hast, ist er wahrscheinlich speziell auf OpenAI abgestimmt. Erwäge, ihn mithilfe des Leitfadens zu Best Practices beim Prompting für Claude zu überarbeiten.

Verschieben von System-/Developer-Nachrichten an den Anfang

Die meisten Eingaben des OpenAI SDK lassen sich eindeutig direkt auf die API-Parameter von Anthropic abbilden, ein deutlicher Unterschied ist jedoch die Behandlung von System-/Developer-Prompts. Diese beiden Prompt-Arten können bei OpenAI an beliebiger Stelle in einer Chat-Konversation platziert werden. Da Anthropic nur eine initiale System-Nachricht 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 System-Nachricht am Anfang der Nachrichten übergeben.

Unterstützung für Denken

Du kannst Denken aktivieren, indem du den Parameter thinking hinzufügst. Bei aktuellen Modellen ist das Denken adaptiv, wobei Claude entscheidet, wann und wie tief es nachdenkt, und bei Claude-5-Modellen ist es standardmäßig aktiviert; manuell konfiguriertes „extended thinking“ (erweitertes Denken) ist ein veralteter Modus. Obwohl Denken Claudes Schlussfolgerungsfähigkeit bei komplexen Aufgaben verbessert, gibt das OpenAI SDK Claudes detaillierten Denkprozess nicht zurück. Für den vollen Funktionsumfang des Denkens, einschließlich Zugriff auf Claudes schrittweise Reasoning-Ausgabe, 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 Endpunkt /v1/messages.

Detaillierte Unterstützung der OpenAI-kompatiblen API

Anfragefelder

Einfache Felder

tools- / functions-Felder

Felder des messages-Arrays

Antwortfelder

Kompatibilität von Fehlermeldungen

Die Kompatibilitätsschicht behält mit der OpenAI API konsistente Fehlerformate bei. Die detaillierten Fehlermeldungen sind jedoch nicht identisch. Verwende die Fehlermeldungen nur für Logging und Debugging.

Header-Kompatibilität

Das OpenAI SDK verwaltet Header zwar automatisch, hier ist jedoch die vollständige Liste der von der Claude API unterstützten Header für Entwickler, die direkt mit ihnen arbeiten müssen.