Startseite / Lernen / Claude mit dem Vercel AI SDK: createAnthropic baseURL, Streaming und Fehlerbehebung
Vercel AI SDK. Eine gefaltete, dreieckige Papierstruktur verbindet ein Codefenster mit einem fließenden Band aus Zeichen, die Antworttext ähneln, und veranschaulicht die Streaming-Ausgabe einer Anwendung.

Claude mit dem Vercel AI SDK: createAnthropic baseURL, Streaming und Fehlerbehebung

Der Anthropic-Anbieter des AI SDK, @ai-sdk/anthropic, kommuniziert mit der Messages API. Seine baseURL ist standardmäßig https://api.anthropic.com/v1, daher ersetzen Sie für ein Gateway dieses gesamte Präfix, einschließlich /v1. OpenCode, Kilo Code und viele Agenten-Frameworks verwenden intern denselben Anbieter, weshalb dieselbe Regel auch in ihren Konfigurationen gilt.

Installation

Terminal
npm i ai @ai-sdk/anthropic

Anbieter erstellen

lib/anthropic.ts
import { createAnthropic } from '@ai-sdk/anthropic';

export const anthropic = createAnthropic({
  baseURL: 'https://aiprimetech.io/v1',                 // replaces https://api.anthropic.com/v1
  apiKey: process.env.AIPRIME_API_KEY,  // sent as x-api-key; defaults to ANTHROPIC_API_KEY
});
Es gibt keine Umgebungsvariable für die Basis-URL in @ai-sdk/anthropic: Übergeben Sie baseURL im Code. Der einfache anthropic -Import verwendet immer den eigenen Endpunkt von Anthropic.

generateText und streamText

generate.ts
import { generateText } from 'ai';
import { anthropic } from './lib/anthropic';

const { text, usage } = await generateText({
  model: anthropic('claude-sonnet-5'),
  prompt: 'Explain idempotency keys in two sentences.',
});
console.log(text, usage);
stream.ts
import { streamText } from 'ai';
import { anthropic } from './lib/anthropic';

const result = streamText({
  model: anthropic('claude-sonnet-5'),
  prompt: 'Write a haiku about load balancers.',
});

for await (const chunk of result.textStream) process.stdout.write(chunk);

Beide Aufrufe akzeptieren maxRetries (standardmäßig 2) für vorübergehende Fehler wie 429 und 5xx.

Thinking und Prompt-Caching

Anthropic-spezifische Optionen werden in providerOptions.anthropicangegeben. Aktuelle Modelle verwenden adaptives Thinking:

thinking.ts
const { text } = await generateText({
  model: anthropic('claude-sonnet-5'),
  providerOptions: { anthropic: { thinking: { type: 'adaptive' } } },
  prompt: 'Plan a zero-downtime database migration in five steps.',
});

Speichern Sie einen langen, stabilen Systemprompt im Cache mit cacheControl; Cache-Lesezugriffe erscheinen dann in usage.inputTokenDetails.cacheReadTokens. Prompts unterhalb der Mindestlänge des Modells werden nicht im Cache gespeichert.

cache.ts
const result = await generateText({
  model: anthropic('claude-sonnet-5'),
  messages: [
    {
      role: 'system',
      content: longStableInstructions,
      providerOptions: { anthropic: { cacheControl: { type: 'ephemeral' } } },
    },
    { role: 'user', content: question },
  ],
});

Die OpenAI-kompatible Alternative

Das Gateway unterstützt auch das Format von OpenAI Chat Completions, sodass @ai-sdk/openai-compatible mit derselben /v1 -Basis-URL funktioniert. Dies ist der Zugangsweg für GPT-Modelle mit demselben Schlüssel; bei Claude erhält der oben beschriebene native Anbieter Thinking und die Cache-Steuerung.

lib/gateway.ts
import { createOpenAICompatible } from '@ai-sdk/openai-compatible';

const gateway = createOpenAICompatible({
  name: 'aiprime',
  baseURL: 'https://aiprimetech.io/v1',
  apiKey: process.env.AIPRIME_API_KEY,
});

// gateway('claude-sonnet-5') or a GPT model ID

Fehlerbehebung

Was Sie sehen Ursache Lösung
Ein JSON-Parsing-Fehler, die Antwort beginnt mit <baseURL ohne /v1: Die Anfrage erreichte die WebsitebaseURL: 'https://aiprimetech.io/v1'
404 page not found/v1 zweimalGenau ein /v1
Invalid API keyprocess.env -Wert ist in dieser Laufzeitumgebung nicht definiert (Serverless- und Edge-Funktionen haben eigene Umgebungsvariablen), daher griff das SDK zurück auf ANTHROPIC_API_KEYSetzen Sie die Variable in der Umgebung des Deployments
Modell nicht unterstütztVeraltete oder falsch geschriebene Modell-IDVerwenden Sie eine ID aus der folgenden Tabelle
Concurrency limit exceeded for userPromise.all über ein großes ArrayBegrenzen Sie parallele Aufrufe, z. B. mit p-limit
No available accounts / 503Vorübergehend begrenzte Kapazität beim vorgelagerten AnbieterWird automatisch erneut versucht; erhöhen Sie maxRetries
Modell-ID Einsatzbereich
claude-sonnet-5Standard für Programmier- und Agentenaufgaben: schnell, leistungsstark, mittleres Preisniveau.
claude-opus-5-5Anspruchsvollere Denkaufgaben, umfangreiche Refactorings, lange Agentenläufe.
claude-fable-5-1Am leistungsfähigsten und am teuersten; für die schwierigsten Aufgaben reservieren.
claude-haiku-4-5Günstig und schnell: Titel, Zusammenfassungen, Klassifizierung, kleine Schritte.

Häufig gestellte Fragen

Was ist die standardmäßige baseURL von @ai-sdk/anthropic?
https://api.anthropic.com/v1. Ein Gateway ersetzt das gesamte Präfix, daher muss es mit /v1 enden, z. B. https://aiprimetech.io/v1.
Gibt es eine Umgebungsvariable für die Anthropic-Basis-URL des AI SDK?
Nein. Der Anbieter liest ANTHROPIC_API_KEY (oder ANTHROPIC_AUTH_TOKEN) aus der Umgebung, aber die Basis-URL wird mit createAnthropic({ baseURL }) festgelegt.
Warum schlägt das AI SDK beim Aufruf von Claude mit einem Parsing-Fehler fehl?
Meist fehlt /v1 in der baseURL, sodass die Anfrage eine Website erreicht und HTML statt JSON zurückerhält.
Sollte ich @ai-sdk/anthropic oder @ai-sdk/openai-compatible für Claude verwenden?
@ai-sdk/anthropic: Es verwendet die native Messages API, sodass Thinking und Prompt-Caching funktionieren. Verwenden Sie den OpenAI-kompatiblen Anbieter für GPT-Modelle.
Claude in wenigen Minuten nutzen

Holen Sie sich einen API-Schlüssel – ohne Anthropic-Konto oder Warteliste.

API-Schlüssel erhalten

AI Prime Tech ist ein unabhängiges API-Gateway. Es ist weder mit Anthropic verbunden noch von Anthropic empfohlen und auch kein Wiederverkäufer von Anthropic. Claude und zugehörige Modellnamen sind Marken ihrer jeweiligen Inhaber.

Weitere Anleitungen zur Claude API

So erhalten Sie einen Claude API-SchlüsselClaude-API-Preise erklärtDie günstigste Möglichkeit, die Claude API zu nutzenCursor unbegrenzt mit der Claude API nutzenUnbegrenzter Zugang zu Claude CodeClaude API-Gateway vs. direkter Zugang zu AnthropicClaude über eine OpenAI-kompatible API nutzenClaude-Modelle erklärt: ein Vergleich von Claude Opus, Sonnet, Haiku und Fable — alle Claude-API-Modelle, Anthropic-Modellnamen und Preise (2026)Die Claude API mit Kryptowährungen bezahlenZugang zur Claude API ohne WartelisteSo reduzieren Sie den Token-Verbrauch von ClaudeCline unbegrenzt mit der Claude API nutzenRoo Code unbegrenzt mit der Claude API nutzenClaude unbegrenzt in JetBrains-IDEs nutzenAider unbegrenzt mit der Claude API nutzenClaude unbegrenzt in VS Code nutzenOpenCode-Konfiguration für Claude: Einrichtung von opencode.json, Modelle und häufige FehlerEinen unbegrenzten Hermes-Agenten mit Claude betreibenOpenClaw unbegrenzt mit Claude betreibenWas eine Anthropic-kompatible API bedeutetClaude Code-API-Schlüssel — ANTHROPIC_API_KEY: So erhalten und konfigurieren Sie ihn, und wann Sie stattdessen claude setup-token verwenden solltenClaude Code-API-Kosten — Preise und Möglichkeiten zur KostensenkungClaude API-Fehler erklärt: Serverfehler 500, Überlastung 529, Ratenlimit 429, fehlerhafte Anfrage 400 — und die jeweilige LösungSo kaufen Sie Claude API-Guthaben – und warum Claude-Guthaben besser ist als jedes Angebot zum „Kauf eines Claude-Kontos“Kostenlose Claude API: Gibt es einen kostenlosen Claude API-Schlüssel, und was ist in 2026 tatsächlich kostenlos?Claude API vs. Claude Pro/Max-Abonnement — welche Option wählen?Die Codex CLI mit Claude ausführenClaude mit n8n verbindenLiteLLM-Anfragen an Claude weiterleitenClaude in Kilo Code verwendenClaude in GitHub Copilot integrierenZed über das Gateway mit Claude verbindenCherry Studio mit Claude verbindenChatAnthropic in LangChain: Import, base_url, Streaming, Tools und FehlerAnthropic Python SDK: installieren, base_url setzen, streamen und Fehler behandelnFactory Droid mit Claude betreibenDie Claude Code API erklärtDie Claude API in Ihre Anwendung integrierenSo nutzen Sie Claude unbegrenzt – und warum es kein „gecracktes Claude Code“ gibt

Weitere Claude API Guides

Was eine Anthropic-kompatible API bedeutetAnthropic Python SDK: installieren, base_url setzen, streamen und Fehler behandelnSo kaufen Sie Claude API-GuthabenDie günstigste Möglichkeit, die Claude API zu nutzenClaude API-Fehler erklärt: Serverfehler 500, Überlastung 529, Ratenlimit 429, fehlerhafte Anfrage 400 — und die jeweilige LösungKostenlose Claude API: Gibt es einen kostenlosen Claude API-Schlüssel, und was ist in 2026 tatsächlich kostenlos?Die Claude API in Ihre Anwendung integrierenClaude-Modelle erklärt: ein Vergleich von Claude Opus, Sonnet, Haiku und Fable — alle Claude-API-Modelle, Anthropic-Modellnamen und Preise (2026)Claude-API-Preise erklärtClaude API-Gateway vs. direkter Zugang zu AnthropicClaude API vs. Claude Pro/Max-Abonnement — welche Option wählen?Die Claude API mit Kryptowährungen bezahlenZugang zur Claude API ohne WartelisteDie Claude Code API erklärtClaude Code-API-Kosten — Preise und Möglichkeiten zur KostensenkungClaude Code-API-Schlüssel — ANTHROPIC_API_KEY: So erhalten und konfigurieren Sie ihn, und wann Sie stattdessen claude setup-token verwenden solltenSo erhalten Sie unbegrenzte Claude-NutzungSo erhalten Sie einen Claude-API-SchlüsselSo reduzieren Sie den Token-Verbrauch von ClaudeClaude mit dem OpenAI SDK verwenden: OpenAI-kompatibler Endpunkt, Streaming, Tools und LimitsHermes Agent mit Claude über ein Gateway: Einrichtung eines benutzerdefinierten Anbieters, Kostenkontrolle und FehlerbehebungenOpenClaw unbegrenzt mit Claude betreibenWas unbegrenzter Zugriff auf die Claude API bedeutetSo erhalten Sie einen unbegrenzten Claude API-SchlüsselUnbegrenzte Nutzung von Claude Code — ohne Token-LimitsUnbegrenzter Zugang zu Claude Opus 4.8Unbegrenzte Claude-Nutzung — Tarife und PreiseAider mit Claude über ein Gateway: ANTHROPIC_API_BASE, Konfigurationsdateien, Architektenmodus und FehlerbehebungenCherry Studio mit Claude verbindenUnbegrenzter Zugang zu Claude CodeCline unbegrenzt mit der Claude API nutzenCodex CLI mit einem benutzerdefinierten Anbieter: config.toml, GPT- und Claude-Modelle, IDE-Erweiterung und FehlerbehebungenCursor mit unbegrenztem Claude-Zugang nutzenFactory Droid mit Claude betreibenGitHub Copilot Chat mit Claude über ein Gateway: Einrichtung von Custom Endpoint, Agentenmodus und FehlerbehebungenClaude unbegrenzt in JetBrains-IDEs nutzenClaude in Kilo Code verwendenChatAnthropic in LangChain: Import, base_url, Streaming, Tools und FehlerLiteLLM-Anfragen an Claude weiterleitenClaude mit n8n verbindenOpenCode-Konfiguration für Claude: Einrichtung von opencode.json, Modelle und häufige FehlerRoo Code unbegrenzt mit der Claude API nutzenClaude unbegrenzt in VS Code nutzenZed über das Gateway mit Claude verbinden