Kosten, Abrechnung und Betrieb22. Oktober 2026Flatkey Team

Anthropic API-Key (2026): So bekommen Sie einen, Schlüsseltypen, Claude Code und Fehler

Schritt-für-Schritt-Anleitung zum Anthropic API-Key 2026: Console-Einrichtung, persönliche und Service-Account-Keys, Ablaufregeln, erste Anfrage, Claude Code, Kosten und Fehlerbehebung.

Anthropic API-Key (2026): So bekommen Sie einen, Schlüsseltypen, Claude Code und Fehler

Um einen Anthropic API-Key zu erhalten, melden Sie sich in der Claude Console an, öffnen API keys, klicken auf Create key, wählen Namen, Ablaufdatum und verknüpftes Konto (Sie selbst oder ein Service-Account) und kopieren den Schlüssel, der mit sk-ant- beginnt, denn die Console zeigt ihn nur einmal an. Hinterlegen Sie vor dem ersten API-Aufruf eine Zahlungsmethode oder Guthaben: Die Nutzung wird pro Token abgerechnet, und neue Konten erhalten laut Preisseite von Anthropic (Stand 22. Oktober 2026) nur ein kleines kostenloses Testguthaben. Derselbe Schlüssel funktioniert für alle Claude-Modelle; einen separaten „Claude API-Key“ oder „Sonnet-Key“ gibt es nicht.

Diese Anleitung richtet sich an Entwickler, die einen Schlüssel für Skripte, Coding-Agents wie Claude Code oder einen Produktivdienst brauchen. Sie behandelt die Schlüsseltypen von 2026 (persönlich, Service-Account und der ältere Workspace-Key), Ablaufregeln, den Header anthropic-workspace-id, an dem viele erste Anfragen scheitern, lauffähigen Code, die häufigen Fehler 401/400/429 und die Fälle, in denen ein Schlüssel für mehrere Anbieter sinnvoller ist.

Der Anthropic API-Key in 60 Sekunden

Schritt	Wo	Was Sie wissen sollten (geprüft am 22.10.2026)
1. Anmelden	platform.claude.com	API-Keys liegen in der Claude Console, nicht in der Chat-App claude.ai
2. API keys öffnen	Settings → API keys	Ist Create key ausgegraut, darf Ihre Rolle keine Schlüssel erstellen
3. Schlüssel erstellen	Name, Ablauf, verknüpftes Konto, optional Workspace	Ablauf-Voreinstellungen: 3 Stunden, 1 Tag, 7 Tage, 30 Tage, benutzerdefiniert oder Never
4. Einmal kopieren	Nur bei der Erstellung sichtbar	Beginnt mit `sk-ant-`; verlorene Schlüssel lassen sich nicht erneut anzeigen
5. Abrechnung einrichten	Settings → Billing	Nutzungsbasiert in USD; jede Stufe hat ein monatliches Ausgabenlimit
6. Testen	`POST https://api.anthropic.com/v1/messages`	Schlüssel als `Authorization: Bearer` senden (oder das ältere `x-api-key`)

Quelle: Anthropic-Dokumentation Get your Claude API key und Authentication, geprüft am 22. Oktober 2026.

Schritt für Schritt: Anthropic API-Key erstellen

Console-Konto anlegen oder anmelden unter platform.claude.com. Claude-Chat-Abo und API werden getrennt abgerechnet, allerdings enthalten Max-Pläne ein monatliches API-Guthaben (Details unten und in unserem Leitfaden zu den Anthropic API-Preisen).
Die Seite API keys öffnen. Hat Ihre Organisation mehrere Workspaces, können Sie hier einen auswählen und den Schlüssel darauf beschränken.
Auf Create key klicken und drei Felder ausfüllen: einen aussagekräftigen Namen (zum Beispiel ci-staging-claude), ein Ablaufdatum und den Linked account. Verknüpfen Sie ihn mit sich selbst, entsteht ein persönlicher Schlüssel; verknüpfen Sie ihn mit einem Service-Account, entsteht ein Schlüssel für gemeinsam genutzte Workloads.
Den Schlüssel sofort kopieren. Laut Anthropic-Dokumentation wird der vollständige Schlüssel nur einmal angezeigt. Speichern Sie ihn in einem Passwort- oder Secrets-Manager, niemals in einem Git-Repository.
Guthaben oder Karte hinzufügen auf der Seite Billing. Ohne Guthaben schlägt Ihre erste Anfrage fehl, selbst mit gültigem Schlüssel.
Als Umgebungsvariable exportieren, damit die SDKs ihn automatisch übernehmen:

export ANTHROPIC_API_KEY="sk-ant-api03-..."   # macOS/Linux, current shell only
# Windows PowerShell:
# setx ANTHROPIC_API_KEY "sk-ant-api03-..."

Welchen Schlüsseltyp sollten Sie wählen?

2026 unterscheidet Anthropic drei Schlüsseltypen. Der falsche Typ ist der häufigste Grund, warum ein Schlüssel „plötzlich nicht mehr funktioniert“, wenn jemand das Team verlässt.

Schlüsseltyp	Handelt als	Funktioniert nicht mehr, wenn	Einsatz
Persönlicher Schlüssel	Sie, mit Ihren Rollen	Sie die Organisation verlassen oder ein Ein-Workspace-Schlüssel den Zugriff darauf verliert	Lokale Entwicklung, eigene Skripte, eigenes Claude Code
Service-Account-Schlüssel	Ein Service-Account	Der Service-Account archiviert oder aus dem Workspace entfernt wird	CI-Pipelines, Produktivdienste, gemeinsame Agents
Workspace-Schlüssel (veraltet)	Niemand (gehört zum Workspace)	Er abläuft, deaktiviert/gelöscht oder der Workspace archiviert wird	Nur bestehende Integrationen; migrieren

Daten von der Anthropic-Seite Authentication, 22. Oktober 2026. Anthropic empfiehlt persönliche oder Service-Account-Schlüssel, weil sie an eine Identität gebunden sind und die Person oder den Workload, dem sie gehören, nicht überdauern können. Für die Produktion auf AWS, Google Cloud, Azure, GitHub Actions oder Kubernetes empfiehlt dieselbe Seite Workload Identity Federation, die statische Schlüssel durch kurzlebige Tokens ersetzt.

Ablaufregeln, die Sie kennen sollten

Das Ablaufdatum wird bei der Erstellung festgelegt und kann später nicht geändert werden.
Bei Schlüsseln mit mindestens 14 Tagen Laufzeit mailt Anthropic dem Ersteller 7 Tage vor Ablauf, bei mindestens 7 Tagen Laufzeit 1 Tag vorher; kürzer laufende Schlüssel verfallen ohne Hinweis.
Nach Ablauf liefern Anfragen 401 authentication_error, und abgelaufene Schlüssel lassen sich nicht reaktivieren, nur löschen.
Disable ist umkehrbar; Delete ist endgültig.

Ein praktisches Muster: 30-Tage-Schlüssel für Laptops und Coding-Agents, Service-Account-Schlüssel in einem Secrets-Manager (mit Rotation) für Server. Unsere Leitfäden zur sicheren Verwaltung von API-Keys in KI-Produkten und zur Schlüsselrotation hinter einem Gateway gehen tiefer.

Schlüssel testen: erste Anfrage mit curl, Python und Node.js

Die unten verwendete Modell-ID claude-sonnet-5-5 ist laut Anthropics Modellübersicht vom 22. Oktober 2026 das aktuelle Sonnet-Modell.

curl https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Reply with the word ok if this key works."}]
  }'

# pip install anthropic
import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Reply with the word ok if this key works."}],
)
print(next(b.text for b in msg.content if b.type == "text"))
print("tokens:", msg.usage.input_tokens, "in /", msg.usage.output_tokens, "out")

// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY
const msg = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 256,
  messages: [{ role: "user", content: "Reply with the word ok if this key works." }],
});
console.log(msg.content.find((b) => b.type === "text")?.text);

Ein solcher Test kostet einen Bruchteil eines Cents: Beim offiziellen Preis von Sonnet 5.5 von 2 $ pro Million Eingabe-Tokens und 10 $ pro Million Ausgabe-Tokens (Anthropic-Preise, 22. Oktober 2026) kosten 30 Eingabe- und 5 Ausgabe-Tokens etwa 0,0001 $.

Der Workspace-Header, an dem erste Anfragen scheitern

Ist Ihr Schlüssel nicht auf einen Workspace beschränkt, muss jede Anfrage anthropic-workspace-id enthalten, sonst antwortet die API mit 400 invalid_request_error und der Meldung „This API key is not scoped to a workspace...“. Die ID finden Sie auf der Seite Workspaces in der Console. Die Lösung in Python:

client = anthropic.Anthropic(
    default_headers={"anthropic-workspace-id": "wrkspc_..."}  # only for keys not scoped to a workspace
)

Schlüssel, die für genau einen Workspace erstellt wurden, brauchen den Header nicht; deshalb rät Anthropic, Schlüssel schon bei der Erstellung zu beschränken (Authentication-Dokumentation).

Anthropic API-Key mit Claude Code verwenden

Claude Code kann sich über ein claude.ai-Abo, eine Console-Anmeldung, einen Cloud-Anbieter oder einen API-Key authentifizieren. Laut Authentifizierungsdokumentation von Claude Code, geprüft am 22. Oktober 2026:

Ist ANTHROPIC_API_KEY gesetzt, fragt Claude Code beim ersten Start, ob der Schlüssel verwendet werden soll, und überspringt nach Ihrer Zustimmung die Browser-Anmeldung.
ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN und die Einstellung apiKeyHelper gelten für CLI, VS-Code-Erweiterung, Agent SDK und GitHub Actions, nicht aber für Claude Desktop oder Cloud-Sitzungen.
apiKeyHelper führt ein Skript aus, das einen Schlüssel zurückgibt, praktisch, um einen kurzlebigen Schlüssel aus einem Vault zu holen. Scheitert das Skript dreimal, schlagen die Anfragen fehl.
Console-Nutzer können sich jetzt ohne API-Key anmelden (Claude Code v2.1.242 oder neuer); dabei wird ein OAuth-Profil statt eines statischen Schlüssels gespeichert. Entfernen Sie vorher ANTHROPIC_API_KEY.

export ANTHROPIC_API_KEY="sk-ant-api03-..."
claude        # approve the key when prompted
# inside Claude Code, /status shows which credential is active

Meldet Claude Code Token- oder Anmeldefehler, hilft unser Leitfaden zu Auth-Token-Fehlern in Claude Code. Um Claude Code über einen Router statt direkt über Anthropic laufen zu lassen, siehe API-Router-Setup für Claude Code.

Ist der Anthropic API-Key kostenlos?

Das Erstellen ist kostenlos, die Nutzung nicht. Laut Preis-FAQ von Anthropic erhalten neue Nutzer „eine kleine Menge kostenloser Credits zum Testen der API“; danach wird jede Anfrage pro Token abgerechnet. Eine Ausnahme sollten Sie kennen: Auf claude.com/pricing, geprüft am 22. Oktober 2026, enthält der Plan Max 5x (100 $/Monat) 100 $ pro Monat und Max 20x 200 $ pro Monat an API-Guthaben für die Claude Platform; Pro (20 $/Monat bei monatlicher Zahlung) enthält keines. Aktuelle Listenpreise pro Million Tokens auf Anthropics Preisseite, 22. Oktober 2026:

Modell	Modell-ID	Eingabe	Ausgabe	Cache-Lesen
Claude Fable 5.1	`claude-fable-5-1`	$10.00	$50.00	$0.25
Claude Opus 5.5	`claude-opus-5-5`	$4.00	$20.00	$0.20
Claude Sonnet 5.5	`claude-sonnet-5-5`	$2.00	$10.00	$0.10
Claude Haiku 5.5 (Prompts bis 100K)	`claude-haiku-5-5`	$0.10	$0.50	$0.01

Die Batch API halbiert Ein- und Ausgabepreise, und reine US-Inferenz (inference_geo: "us") schlägt mit dem Faktor 1,1 zu Buche. Für Workload-Rechnungen siehe unseren vollständigen Leitfaden zu den Anthropic API-Preisen. Wenn Sie ein wirklich kostenloses Modell für Prototypen brauchen, listet unser Vergleich kostenloser LLM-APIs Optionen mit echten Limits.

Ausgabenlimits und Rate Limits gehören zum Schlüssel

Die Nutzungsstufe Ihrer Organisation bestimmt sowohl die Rate Limits als auch ein monatliches Ausgabenlimit. Laut Anthropics Rate-Limit-Seite, geprüft am 22. Oktober 2026, liegen die Limits bei 500 $ (Start), 1.000 $ (Build) und 200.000 $ (Scale) pro Monat; neue Organisationen starten unter Umständen in einer niedrigeren Evaluation-Stufe. Ist das Limit erreicht, liefert die API HTTP 429 bis 00:00 UTC am Ersten des Folgemonats, sofern Sie keine höhere Stufe beantragen. Auf der Seite Billing können Sie zusätzlich ein eigenes, niedrigeres Limit setzen, eine gute Gewohnheit für jeden Schlüssel, den ein autonomer Agent nutzt.

Häufige Fehler beim Anthropic API-Key und Lösungen

Fehler	Wahrscheinliche Ursache	Lösung
`401 authentication_error`	Tippfehler, Schlüssel widerrufen, deaktiviert oder abgelaufen	Neuen Schlüssel erstellen; abgelaufene lassen sich nicht reaktivieren
`400 invalid_request_error` mit Workspace-Hinweis	Schlüssel ohne Workspace-Bindung und kein Header gesendet	`anthropic-workspace-id` ergänzen oder Workspace-gebundenen Schlüssel erstellen
`404 not_found_error` „Workspace ... not found“	Falsche Workspace-ID oder der Schlüsselidentität fehlt der Zugriff	ID auf der Seite Workspaces prüfen
`429` „reached your API usage limits“	Monatliches Ausgabenlimit der Stufe erreicht	Höhere Stufe beantragen oder monatlichen Reset abwarten
`429` mit `retry-after`	Anfragen oder Tokens pro Minute überschritten	Warten und erneut versuchen; siehe LLM-Rate-Limits erklärt
`529 overloaded_error`	Kapazitätsengpass bei Anthropic, nicht Ihr Schlüssel	Mit Backoff wiederholen oder Failover; siehe API-Fehler 529
Button Create key deaktiviert	Ihre Console-Rolle darf keine Schlüssel erstellen	Admin um Rollenänderung oder Service-Account-Schlüssel bitten

Quellen: Anthropic-Dokumentation zu Authentication, Rate Limits und Fehlern, geprüft am 22. Oktober 2026.

Den Schlüssel schützen

Fügen Sie den Schlüssel nie in Frontend-Code, mobile Apps oder öffentliche Notebooks ein. Für iOS- und macOS-Apps, die Claude direkt aufrufen müssen, bietet Anthropic App Attest an, das Geräte-Tokens mit 1 Stunde Gültigkeit ausstellt.
Verwenden Sie einen Schlüssel pro Umgebung und pro Agent, damit Sie einen widerrufen können, ohne die anderen zu beschädigen.
Setzen Sie ein Ablaufdatum, auch ein langes, damit ein geleakter Schlüssel ein Verfallsdatum hat.
Aktivieren Sie Secret Scanning in der CI; unser Leitfaden zum Secret Scanning für KI-APIs zeigt ein Setup.
Beobachten Sie die Nutzung in der Console und setzen Sie ein Ausgabenlimit unterhalb des Stufenlimits.

Wann ein Schlüssel für viele Modelle einfacher ist

Ein Anthropic-Schlüssel schaltet nur Claude frei. Ruft Ihr Produkt oder Coding-Agent auch GPT, Gemini, DeepSeek, Qwen oder Kimi auf, verwalten Sie am Ende fünf Schlüssel, fünf Guthaben und fünf Sätze von Limits. Eine einheitliche API wie Flatkey stellt einen Schlüssel für alle aus. Am 22. Oktober 2026 führten die Modellseiten von Flatkey Claude Sonnet 5.5 mit 1,60 $ Eingabe / 8,00 $ Ausgabe pro Million Tokens und Claude Opus 5.5 mit 3,20 $ / 16,00 $, gegenüber Anthropics Listenpreisen von 2 $ / 10 $ und 4 $ / 20 $. Das Anthropic SDK funktioniert nach Änderung der Base URL, wie im Anthropic-SDK-Leitfaden von Flatkey beschrieben:

import anthropic

client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Summarize this changelog in 3 bullets."}],
)
print(next(b.text for b in msg.content if b.type == "text"))

Bleiben Sie bei einem direkten Anthropic-Schlüssel, wenn Sie Anthropic-exklusive Funktionen am Veröffentlichungstag, Workload Identity Federation, Datenresidenz-Kontrollen oder einen Enterprise-Vertrag brauchen. Für einen breiteren Vergleich lesen Sie Flatkey vs. direkte Anbieterkonten und ein API-Key für mehrere KI-Modelle.

FAQ

Wie bekomme ich einen Anthropic API-Key?

Melden Sie sich in der Claude Console unter platform.claude.com an, gehen Sie zu Settings → API keys, klicken Sie auf Create key, legen Sie Namen, Ablauf und verknüpftes Konto fest und kopieren Sie den einmalig angezeigten sk-ant--Schlüssel. Laden Sie vor den ersten Anfragen Guthaben auf der Seite Billing auf.

Sind Anthropic API-Keys kostenlos?

Das Erstellen ist kostenlos, und neue Konten erhalten ein kleines Testguthaben, danach wird die API-Nutzung jedoch pro Token abgerechnet. Stand 22. Oktober 2026 gibt es keine dauerhaft kostenlose Stufe für die Claude API.

Ist ein Claude API-Key dasselbe wie ein Anthropic API-Key?

Ja. Laut Anthropic-Dokumentation heißen Schlüssel für die Claude API auch Anthropic API-Keys. Ein Schlüssel funktioniert für alle Claude-Modelle, auf die Ihre Organisation Zugriff hat.

Wo finde ich meinen bestehenden Anthropic API-Key?

Unter platform.claude.com/settings/keys sehen Sie Name, Hinweis und Ablauf jedes Schlüssels, aber nicht das vollständige Secret. Haben Sie ihn verloren, erstellen Sie einen neuen und löschen Sie den alten.

Enthält ein Claude-Pro- oder Max-Abo API-Guthaben?

Pro nicht. Max-Pläne weisen auf claude.com/pricing (Stand 22. Oktober 2026) monatliches API-Guthaben aus (100 $/Monat bei Max 5x, 200 $/Monat bei Max 20x). Darüber hinaus wird die API-Nutzung über einen Console-Schlüssel pro Token abgerechnet, getrennt vom Chat-Abo.

Warum liefert mein Anthropic API-Key einen 401-Fehler?

Der Schlüssel ist falsch eingegeben, deaktiviert, gelöscht oder abgelaufen. Abgelaufene Schlüssel lassen sich nicht reaktivieren; erstellen Sie einen neuen. Erwähnt der Fehler einen Workspace, handelt es sich in Wahrheit um einen 400-Fehler wegen des fehlenden Headers anthropic-workspace-id.

Wie nutze ich meinen Anthropic API-Key mit Claude Code?

Setzen Sie ANTHROPIC_API_KEY in Ihrer Shell, starten Sie claude und bestätigen Sie den Schlüssel, wenn Sie gefragt werden. Mit /status in Claude Code prüfen Sie, welche Anmeldedaten aktiv sind.