Claude-Reihe

Die Claude-Modelle von Anthropic, darunter die Reihen Opus, Sonnet, Haiku und Fable. Empfohlen wird der Aufruf über den nativen Anthropic-Endpunkt: Extended Thinking, Prompt-Caching, PDF-Eingabe und weitere Funktionen verhalten sich wie in der offiziellen API. Der OpenAI-kompatible Endpunkt funktioniert ebenfalls und eignet sich für Projekte, die bereits Code mit dem OpenAI SDK haben.

Häufige Aufgaben

Extended Thinking aktivieren thinking, budget_tokens, adaptive und wie Sie die Thinking-Inhalte auslesen.Prompt-Caching cache_control, 1-Stunden-Cache und wie Sie einen Treffer prüfen.Websuche Das Tool web_search; erfordert den Anbieter Anthropic.Langer Kontext und PDF 1M Kontext, PDF-Dokumente hochladen.Fehlerbehebung prompt is too long, Modell nicht gefunden, abgeschnittene Antworten.In Claude Code verwenden Einrichtung und häufige Fragen.

Modelle

Alle Modelle unterstützen Text-, Bild- und PDF-Eingaben sowie Tool-Aufrufe. Die vollständige Modellliste und aktuelle Preise finden Sie auf der Modellseite ; alternativ können Sie sie über die Models API abfragen.

Gängige Modell-IDs (beim Aufruf exakt kopieren)

Claude Opus 5.5anthropic/claude-opus-5.5

Claude Sonnet 5.5anthropic/claude-sonnet-5.5

Claude Haiku 5.5anthropic/claude-haiku-5.5

Claude Fable 5.1anthropic/claude-fable-5.1

Das Präfix anthropic/ kann entfallen, und auch die offizielle Schreibweise von Anthropic wird akzeptiert. Alle folgenden Schreibweisen verweisen auf dasselbe Modell:

Schreibweise	Beispiel
OfoxAI-Standard	`anthropic/claude-sonnet-4.6`
Ohne Präfix	`claude-sonnet-4.6`
Offiziell (mit Bindestrichen)	`claude-sonnet-4-6`
Offiziell mit Datum	`claude-sonnet-4-6-20260217`

Die verfügbaren Aliasse jedes Modells stehen im Feld aliases der Antwort der Models API. Das Feld model in der Antwort enthält stets die Standardschreibweise.

Endpunktwahl

Kurz gesagtFür Extended Thinking, Prompt-Caching oder Tools wie Claude Code verwenden Sie den nativen Anthropic-Endpunkt.

	Nativer Anthropic-Endpunkt (empfohlen)	OpenAI-kompatibler Endpunkt
Adresse	`POST https://api.ofox.ai/anthropic/v1/messages`	`POST https://api.ofox.ai/v1/chat/completions`
SDK `base_url`	`https://api.ofox.ai/anthropic`	`https://api.ofox.ai/v1`
Authentifizierung	`x-api-key: <Key>`, auch `Authorization: Bearer <Key>` wird akzeptiert	`Authorization: Bearer <Key>`
Extended Thinking	Parameter `thinking`, liefert `thinking`-Blöcke	Parameter `reasoning`, liefert `reasoning_details`
Prompt-Caching	`cache_control`; usage liefert geschriebene und gelesene Mengen	`cache_control` im Inhaltsblock der Nachricht; usage liefert nur die gelesene Menge
PDF	Inhaltsblock `document`	Inhaltsblock `file`
Websuche	Unterstützt (erfordert den Anbieter Anthropic)	Nicht unterstützt

Alle Anfrageparameter finden Sie unter Anthropic Messages API und Chat Completions API.

Anbieter

Claude-Modelle werden von zwei Anbietern bereitgestellt; dasselbe Modell unterstützt je nach Anbieter unterschiedliche Funktionen:

Anbieter	Bereitgestellte Modelle	Verfügbare Endpunkte	Hinweis
Amazon Bedrock (`aws_bedrock`)	Alle Modelle	Beide Endpunkte	Standardanbieter
Anthropic (`anthropic`)	Fable 5, Opus 4.8, Opus 4.7, Sonnet 5	Nur nativer Anthropic-Endpunkt	Unterstützt Websuche; muss explizit festgelegt werden

Am nativen Anthropic-Endpunkt legen Sie den Anbieter per Request-Header fest:


-H "X-OfoxAI-Provider-Type: anthropic"

Stellt der festgelegte Anbieter das Modell nicht bereit, kommt 400 zurück; die Fehlermeldung nennt die verfügbaren Anbieter, zum Beispiel:


No available channel for platform 'anthropic' on model 'anthropic/claude-sonnet-4.6'. Available platforms for this model: aws_bedrock.

Weitere Möglichkeiten zur Festlegung: Provider-Routing.

Aufrufbeispiele

Python (Anthropic SDK)

claude_basic.py


import os
import anthropic
 
client = anthropic.Anthropic(
    base_url="https://api.ofox.ai/anthropic",
    api_key=os.environ["OFOX_API_KEY"],
)
 
message = client.messages.create(
    model="anthropic/claude-sonnet-4.6",
    max_tokens=1024,
    system="Du bist ein erfahrener Backend-Entwickler und antwortest knapp.",
    messages=[{"role": "user", "content": "Erkläre in einem Satz, was Idempotenz ist."}],
)
print(message.content[0].text)

cURL

Terminal


curl https://api.ofox.ai/anthropic/v1/messages \
  -H "x-api-key: $OFOX_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Erkläre in einem Satz, was Idempotenz ist."}]
  }'

Python (OpenAI SDK)

claude_openai_sdk.py


import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="anthropic/claude-sonnet-4.6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Erkläre in einem Satz, was Idempotenz ist."}],
)
print(resp.choices[0].message.content)

max_tokens ist am nativen Anthropic-Endpunkt ein Pflichtparameter und darf die maximale Ausgabelänge des Modells nicht überschreiten.

In Claude Code verwenden

Claude Code ruft den nativen Anthropic-Endpunkt auf; die Basisadresse lautet https://api.ofox.ai/anthropic. Die Einrichtungsschritte finden Sie unter Claude Code einrichten.

Konfigurationswerte für Claude Code

ANTHROPIC_BASE_URLhttps://api.ofox.ai/anthropic

ANTHROPIC_AUTH_TOKENIhren OfoxAI API Key einfügen

Häufige Fehler

Kurz gesagtParameterfehler liefern 400 mit einer Begründung. Eine abgeschnittene Antwort ist kein Fehler; prüfen Sie stop_reason.

HTTP · type	Fehlermeldung im Wortlaut	Ursache	Lösung
400 `ValidationException`	`prompt is too long: 280527 tokens > 200000 maximum`	Eingabe überschreitet den Kontext des Modells	Eingabe kürzen oder ein Modell mit 1M Kontext verwenden (alle außer Haiku 4.5)
404 `model_not_found`	`Model 'anthropic/claude-sonnet-9' not found`	Modell-ID falsch geschrieben oder Modell abgekündigt	Modell-ID von dieser Seite kopieren
401 `invalid_api_key`	`Invalid or expired API key`	Key falsch, gelöscht oder abgelaufen	Key in der Konsole prüfen; am nativen Endpunkt den Header `x-api-key` prüfen
400	`No available channel for platform 'anthropic' on model ...`	Der festgelegte Anbieter stellt dieses Modell nicht bereit	Anbieterfestlegung entfernen oder einen in der Fehlermeldung genannten Anbieter verwenden; siehe Anbieter
200, `stop_reason: "max_tokens"`	—	Die Ausgabe hat das Limit `max_tokens` erreicht, die Antwort wurde abgeschnitten	`max_tokens` erhöhen; bei aktiviertem Thinking zählt auch das Thinking zu diesem Kontingent

Weitere allgemeine Fehler: Fehlerbehandlung.

Offizielle Dokumentation

Die offizielle Dokumentation beschreibt das Verhalten bei direktem Aufruf von Anthropic. Beim Aufruf über OfoxAI gelten für Modell-IDs und Endpunktadressen die Angaben auf dieser Seite.

Häufige Fragen

Wie schreibe ich die Modell-ID von Claude?

Die Standardschreibweise ist anthropic/claude-sonnet-4.6. Sie können das Präfix anthropic/ weglassen oder die offiziellen Schreibweisen claude-sonnet-4-6 bzw. claude-sonnet-4-6-20260217 verwenden; alle verweisen auf dasselbe Modell.

Kann ich Claude mit dem OpenAI SDK aufrufen?

Ja. Setzen Sie base_url auf https://api.ofox.ai/v1 und als Modell-ID etwa anthropic/claude-sonnet-4.6. Wenn Sie Extended Thinking oder vollständige Angaben zur Cache-Nutzung benötigen, empfiehlt sich der native Anthropic-Endpunkt.

Wie aktiviere ich den Thinking-Modus bei Claude?

Am nativen Endpunkt übergeben Sie thinking: {"type": "enabled", "budget_tokens": 2000}; budget_tokens muss mindestens 1024 und kleiner als max_tokens sein. Alternativ überlässt {"type": "adaptive"} die Entscheidung dem Modell. Am OpenAI-kompatiblen Endpunkt übergeben Sie reasoning: {"max_tokens": 2000}. Setzen Sie bei aktiviertem Thinking keine temperature.

Was tun, wenn das Prompt-Caching bei Claude nicht greift?

Prüfen Sie der Reihe nach: Ist cache_control am festen Inhaltsblock gesetzt (keiner der beiden Endpunkte cacht automatisch)? Erreicht der Inhalt die minimale cachebare Länge? Ist das Präfix beider Anfragen exakt identisch? Liegen zwischen den beiden Anfragen mehr als 5 Minuten?

Was tun beim Fehler prompt is too long?

Die Eingabe überschreitet den Kontext des Modells. Haiku 4.5 hat einen Kontext von 200K Tokens, die übrigen Claude-Modelle 1M Tokens. Wechseln Sie das Modell oder kürzen Sie die Eingabe.

Unterstützt Claude 1M Kontext? Brauche ich einen Beta-Header?

Alle Modelle außer Haiku 4.5 unterstützen 1M Kontext. Bei OfoxAI ist kein Beta-Header nötig.

Was tun, wenn die Antwort von Claude abgeschnitten ist?

Prüfen Sie stop_reason in der Antwort. Lautet der Wert max_tokens, hat die Ausgabe das Limit erreicht; erhöhen Sie max_tokens. Bei aktiviertem Thinking zählen auch die Thinking-Inhalte zum Kontingent von max_tokens.

Welcher Anbieter stellt Claude bei OfoxAI bereit?

Alle Modelle werden von Amazon Bedrock bereitgestellt, dem Standardanbieter. Fable 5, Opus 4.8, Opus 4.7 und Sonnet 5 sind zusätzlich über den Anbieter Anthropic verfügbar, nur am nativen Anthropic-Endpunkt und nur nach Festlegung per Header X-OfoxAI-Provider-Type: anthropic.

Kann Claude im Web suchen?

Ja, aber nur mit festgelegtem Anbieter Anthropic, nur für Fable 5, Opus 4.8, Opus 4.7 und Sonnet 5 und nur am nativen Anthropic-Endpunkt. Fügen Sie {"type": "web_search_20250305", "name": "web_search"} zu tools hinzu.

Kann Claude PDFs lesen?

Ja. Am nativen Endpunkt übergeben Sie das base64-kodierte PDF in einem document-Inhaltsblock; am OpenAI-kompatiblen Endpunkt in einem file-Inhaltsblock, wobei file_data das Format data:application/pdf;base64,... hat.