Anthropic API Key erstellen (Claude API Key) 2026: Anleitung, Guthaben & kostenlose Optionen

Einen Anthropic-API-Key (auch Claude-API-Key genannt) erstellen Sie in der Claude Console: Melden Sie sich auf platform.claude.com an, öffnen Sie die Seite API keys, klicken Sie auf Create key (Key erstellen) und kopieren Sie den Key, der mit sk-ant- beginnt und nur einmal angezeigt wird. Die Claude API ist vorausbezahlt, Sie brauchen also außerdem Guthaben auf der Billing-Seite, bevor Anfragen funktionieren. Ein dauerhaftes kostenloses API-Kontingent gibt es nicht: Die Preis-FAQ von Anthropic sagt lediglich, dass neue Nutzer eine kleine Menge kostenloser Credits zum Testen der API erhalten, ohne einen Betrag zu nennen. Größere inklusive API-Credits gibt es mit den Plänen Max 5x, Max 20x und Team.

Dieser Guide führt Sie mit den genauen Bezeichnungen in der Console durch jeden Schritt, zeigt, wie Sie die Variable ANTHROPIC_API_KEY unter macOS, Linux und Windows setzen, macht eine erste Testanfrage, erklärt die Kosten von Anfragen und listet die häufigsten Fehler samt Lösungen. Alles wurde am 17. Oktober 2026 mit der Dokumentation und dem Hilfecenter von Anthropic abgeglichen.

Was Sie vorab brauchen

• Ein Claude-Console-Konto. Es ist unabhängig von einem claude.ai-Chat-Abo. Sie können sich mit derselben E-Mail-Adresse in der Console anmelden, aber ein Pro- oder Max-Plan allein gibt Ihnen weder API-Zugang noch API-Credits.
• Eine Zahlungskarte oder inklusive Credits. Laut Preis-FAQ von Anthropic werden bei Standardkonten gängige Kreditkarten akzeptiert, Enterprise-Kunden können Rechnungsstellung vereinbaren. Mit Max 5x, Max 20x oder Team können Sie eine Console-Organisation verknüpfen und erhalten dann monatliche Credits, statt per Karte zu zahlen.
• Die richtige Console-Rolle. Für den Kauf von Credits brauchen Sie die Rolle Admin oder Billing. Wenn Sie in die Organisation einer anderen Person eingeladen wurden und die Schaltfläche Create key ausgegraut ist, erlaubt Ihre Rolle keine Key-Erstellung.
• Einen sicheren Ort für das Secret. Einen Passwortmanager oder einen Secrets-Manager. Sie sehen den Key nur ein einziges Mal.

Schritt 1: API-Key in der Claude Console erstellen

1. Gehen Sie zu platform.claude.com und melden Sie sich an oder erstellen Sie ein Claude-Console-Konto.
2. Öffnen Sie die Seite API keys unter platform.claude.com/settings/keys.
3. Klicken Sie auf Create key, geben Sie dem Key einen Namen, wählen Sie ein Ablaufdatum und setzen Sie Linked account auf sich selbst (persönlicher Key) oder auf ein Dienstkonto. Sie können den Key auch auf einen Workspace beschränken.
4. Kopieren Sie den vollständigen Key sofort und speichern Sie ihn in einem Passwort- oder Secrets-Manager. Die Console zeigt den Key nur einmal, bei der Erstellung. Wenn Sie ihn verlieren, können Sie ihn nicht erneut ansehen und müssen einen neuen Key erstellen.

Ist die Schaltfläche Create key deaktiviert, erlaubt Ihre Rolle in der Organisation vermutlich keine Key-Erstellung. Bitten Sie einen Admin der Organisation, Ihre Rolle zu ändern oder einen Dienstkonto-Key für Sie zu erstellen.

Welchen Key-Typ Sie wählen sollten

Die Authentifizierungsdokumentation von Anthropic erklärt, warum identitätsgebundene Keys bevorzugt werden: Ein persönlicher oder Dienstkonto-Key funktioniert automatisch nicht mehr, wenn die Person oder der Workload entfernt wird, Keys überleben ihre Besitzer also nicht. Ein geteilter persönlicher Key handelt als eine Person und funktioniert nicht mehr, wenn diese geht – alles Geteilte sollte daher ein Dienstkonto nutzen.

Ablaufdatum wählen

Beim Erstellen eines Keys wählen Sie ein vordefiniertes Ablaufdatum von 3 Stunden, 1 Tag, 7 Tagen oder 30 Tagen, eine benutzerdefinierte Dauer oder Never (nie) für Keys, die Sie in einem Secrets-Manager aufbewahren und selbst rotieren. Legt Ihre Organisation eine maximale Ablaufrichtlinie fest, wird Never nicht angeboten. Das Ablaufdatum wird bei der Erstellung festgelegt und lässt sich später nicht ändern. Anthropic schickt der Person, die den Key erstellt hat, vor dem Ablauf eine E-Mail: 7 Tage vorher bei Keys mit einer Laufzeit von mindestens 14 Tagen und 1 Tag vorher bei Keys mit einer Laufzeit von mindestens 7 Tagen. Kürzer laufende Keys verfallen ohne Warnung. Ein abgelaufener Key liefert einen 401 authentication_error und kann nicht reaktiviert werden; Sie erstellen einen neuen.

Workspaces und der Workspace-Header

Ein Key, der auf einen einzigen Workspace beschränkt ist, funktioniert nur in diesem Workspace, und Anfragen können die Workspace-ID weglassen. Ein persönlicher oder Dienstkonto-Key, der in mehreren Workspaces funktioniert, braucht bei jeder Claude-API-Anfrage den Header anthropic-workspace-id. Die ID eines Workspaces finden Sie in der Spalte ID der Workspaces-Seite unter platform.claude.com/settings/workspaces. Für einen ersten Key ist die Beschränkung auf einen Workspace die einfachste Wahl.

Schritt 2: Guthaben aufladen (Abrechnung)

Die Nutzung der Claude API und des Console-Playgrounds wird aus vorausbezahlten Nutzungs-Credits bezahlt. Ohne Guthaben schlagen Anfragen mit einem Guthabenfehler fehl.

1. Melden Sie sich mit der Rolle Admin oder Billing in der Console an.
2. Gehen Sie zu Settings > Billing, klicken Sie auf Buy credits (Credits kaufen), geben Sie einen Betrag ein und bestätigen Sie. Gekaufte Credits sind sofort verfügbar.
3. Optional: Klicken Sie im Bereich Credit balance auf Set up auto-reload (automatische Aufladung einrichten). Geben Sie unter When credit balance reaches einen Schwellenwert und unter Bring credit balance back up to einen Zielbetrag ein. Liegt Ihr Guthaben bereits auf oder unter dem Schwellenwert, wird sofort belastet, um es auf den Zielbetrag zu bringen, zuzüglich anfallender Steuern. Zum späteren Beenden klicken Sie auf Manage auto-reload und dann auf Turn off.
4. Empfohlen: Klicken Sie im Bereich Spend limits der Billing-Seite auf Adjust limit (bzw. Set limit), um die monatlichen Ausgaben zu begrenzen. Ihr eigenes Limit darf die Obergrenze Ihrer Stufe nicht überschreiten.

Laut Hilfecenter von Anthropic verfallen gekaufte Credits ein Jahr nach dem Kaufdatum, die Frist lässt sich nicht verlängern, und alle Credit-Käufe sind nicht erstattungsfähig. Abgelaufene Credits erscheinen unter Invoice history auf der Billing-Seite. Einen Mindestkaufbetrag nennt Anthropic in diesem Artikel nicht. Preise pro Token finden Sie unter Claude-API-Preise.

Nutzungsstufen und monatliche Ausgabengrenzen

Jede Organisation hat außerdem eine Nutzungsstufe mit einer monatlichen Ausgabengrenze. Anthropic ordnet Organisationen automatisch anhand ihres Nutzungsverlaufs und Kontostatus einer Stufe zu. Neue Organisationen starten eventuell in einer Evaluation-Stufe mit niedrigeren Limits, die automatisch steigen, wenn sich ein Verlauf aufbaut. Ihre Stufe sehen Sie auf der Rate-Limits-Seite unter platform.claude.com/usage/limits, und über Request tier increase auf derselben Seite können Sie mehr beantragen.

Erreicht Ihre Organisation die Grenze ihrer Stufe, pausiert die API-Nutzung bis 00:00 UTC am ersten Tag des Folgemonats, sofern Sie nicht vorher ein höheres Limit erhalten. Erreicht sie ein niedrigeres Ausgabenlimit, das Sie selbst gesetzt haben, schlagen Anfragen fehl, bis Sie dieses Limit erhöhen oder entfernen. Wie Sie beides unterscheiden, zeigt der Abschnitt zur Fehlerbehebung weiter unten.

Schritt 3: Die Umgebungsvariable ANTHROPIC_API_KEY setzen

Die offiziellen SDKs lesen ANTHROPIC_API_KEY automatisch, Sie müssen den Key also nicht in Ihren Code einfügen. So setzen Sie ihn für die aktuelle Terminal-Sitzung unter macOS, Linux oder WSL:

export ANTHROPIC_API_KEY="sk-ant-api03-..."

Das gilt nur, bis Sie das Fenster schließen. Damit er in jedem neuen Terminal verfügbar ist, hängt die CLI-Dokumentation von Anthropic die Zeile an Ihr Shell-Profil an. Für Zsh, die Standard-Shell unter macOS:

echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.zshrc
source ~/.zshrc

Für Bash:

echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.bashrc
source ~/.bashrc

Unter Windows setzen Sie eine Benutzer-Umgebungsvariable und öffnen dann ein neues Terminal, damit die Änderung wirksam wird:

setx ANTHROPIC_API_KEY "sk-ant-api03-..."

Ein in einem Shell-Profil gespeicherter Key ist für alles lesbar, was unter Ihrem Benutzer läuft, und gerät leicht in Vergessenheit. Wenn Sie Claude Code später wieder auf ein Abo umstellen oder den Key rotieren, denken Sie daran, diese Zeile zu entfernen oder zu aktualisieren. Für Server und CI nutzen Sie statt einer Profildatei den Secrets-Speicher Ihrer Plattform.

Schritt 4: Eine erste Testanfrage senden

Direkte HTTP-Anfragen senden den Key im Header x-api-key (laut Anthropic-Dokumentation funktioniert auch ein Header Authorization: Bearer). Diese Anfrage aus der Authentifizierungsdokumentation von Anthropic prüft, ob Key und Abrechnung funktionieren:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

Ein erfolgreicher Aufruf liefert JSON mit einem content-Array, das die Antwort von Claude enthält. Ein Fehler liefert einen JSON-Body mit einem Fehlertyp wie authentication_error; siehe die Tabelle zur Fehlerbehebung weiter unten.

Python

Installieren Sie das offizielle SDK:

pip install anthropic

Rufen Sie dann die API auf. Das ist das Quickstart-Beispiel aus der Anthropic-Dokumentation; der Client liest ANTHROPIC_API_KEY selbstständig ein:

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What should I search for to find the latest developments in renewable energy?",
        }
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

TypeScript oder JavaScript

npm install @anthropic-ai/sdk

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

const client = new Anthropic();

const message = await client.messages.create({
  model: "claude-opus-5-5",
  max_tokens: 1000,
  messages: [
    {
      role: "user",
      content: "What should I search for to find the latest developments in renewable energy?"
    }
  ]
});

for (const block of message.content) {
  if (block.type === "text") {
    console.log(block.text);
  }
}

Die offiziellen SDKs wiederholen vorübergehende Fehler (Verbindungsfehler, Rate-Limits und 5xx-Fehler) standardmäßig zweimal mit exponentiellem Backoff und berücksichtigen den retry-after-Header, wenn er vorhanden ist.

Was Ihre ersten Anfragen kosten

Sie zahlen pro Million Tokens (MTok), mit getrennten Preisen für Input und Output. Das sind die Standardpreise von der Preisseite von Anthropic für drei aktuelle Modelle:

Rechenbeispiel: Eine kleine App sendet 1.000 Anfragen pro Tag mit jeweils 2.000 Input-Tokens und 500 Output-Tokens. Das sind 2 Millionen Input-Tokens und 0,5 Millionen Output-Tokens pro Tag.

• Opus 5.5: 2 × 4 $ + 0,5 × 20 $ = 8 $ + 10 $ = 18 $ pro Tag
• Sonnet 5.5: 2 × 2 $ + 0,5 × 10 $ = 4 $ + 5 $ = 9 $ pro Tag
• Haiku 5.5: 2 × 0,10 $ + 0,5 × 0,50 $ = 0,20 $ + 0,25 $ = 0,45 $ pro Tag

Zwei offizielle Rabatte senken das weiter: Die Message Batches API kostet 50 Prozent weniger für Aufgaben, die keine sofortige Antwort brauchen, und Prompt-Caching macht wiederholten Kontext deutlich günstiger (Cache-Treffer bei Sonnet 5.5 kosten 0,10 $ / MTok statt 2 $). Die vollständige Tabelle inklusive Preisen für Cache-Schreibvorgänge und älterer Modelle finden Sie auf unserer Seite Claude-API-Preise.

Gibt es einen kostenlosen Anthropic-API-Key?

Nur einen kleinen. Die Preis-FAQ von Anthropic sagt, dass neue Nutzer eine kleine Menge kostenloser Credits zum Testen der API erhalten; den Betrag nennt sie nicht, und ein dauerhaftes kostenloses Kontingent gibt es nicht. Für erweiterte Enterprise-Testphasen verweist die FAQ an das Vertriebsteam von Anthropic. Websites, die kostenlose Claude-API-Keys verteilen, sind meist Wiederverkäufer oder Proxys, nicht Anthropic, und Ihre Prompts liefen dann über einen Dritten. Das sind die offiziellen Wege zu Claude-API-Credits, ohne sie direkt zu kaufen:

Team-Beispiel aus der Anthropic-Dokumentation: Ein Team mit drei Standard- und zwei Premium-Plätzen erhält 3 × 20 $ + 2 × 100 $ = 260 $ pro Monat. Ein weiterer Premium-Platz hebt das Guthaben des Folgemonats auf 360 $, und der Pool steigt nie über 500 $. Inklusive Credits werden vor gekauften Credits verbraucht, und eine Organisation, die mit einem berechtigten Plan verknüpft ist, steigt mindestens in die Start-Stufe auf (bzw. mindestens in Build, wenn ihre monatlichen Credits über 200 $ liegen).

Die monatlichen API-Credits der Max- und Team-Pläne decken die Claude API, Managed Agents, das Agent SDK und den Playground ab, aber nicht Claude Code oder Zusatznutzung in den Claude-Apps und auch nicht Claude auf Bedrock, Google Cloud oder Microsoft Foundry. Free-, Pro- und Enterprise-Pläne erhalten sie nicht. Jeder Plan wird mit genau einer Console-Organisation verknüpft, und Sie können die Verknüpfung nicht selbst ändern – wählen Sie also die Organisation, in der Sie entwickeln werden. Pläne vergleichen Sie unter Claude-Preise.

Wenn Sie Anbieter vergleichen, listet unser Guide zu kostenlosen KI-API-Keys, welche APIs echte kostenlose Kontingente haben, und der Guide zum Gemini-API-Key behandelt die API von Google, die ein kostenloses Kontingent hat. Für weitere Optionen siehe kostenlose KI-Credits bekommen.

Ihren API-Key mit Claude Code nutzen

Claude Code kann denselben Key verwenden. Ist ANTHROPIC_API_KEY gesetzt, fragt Claude Code einmal, ob er genutzt werden soll, und wenn Sie zustimmen, hat der Key Vorrang vor Ihrer Pro- oder Max-Anmeldung. Die Nutzung wird dann über Ihre API-Credits statt über Ihr Abo abgerechnet. Im nicht interaktiven Modus (Flag -p) wird der Key immer verwendet, wenn er gesetzt ist. Melden Sie sich stattdessen mit einem Console-Konto bei Claude Code an, wird laut Anthropic in der Console automatisch ein Workspace namens „Claude Code“ zur Kostenverfolgung angelegt.

Um zu Ihrem Abo zurückzukehren, entfernen Sie die Variable in Ihrer Shell (und löschen Sie sie aus Ihrem Shell-Profil, damit sie nicht zurückkommt):

unset ANTHROPIC_API_KEY

Starten Sie dann Claude Code und prüfen Sie mit diesem Befehl in der Sitzung, welche Anmeldung aktiv ist:

/status

Denken Sie daran, dass die monatlichen API-Credits von Max und Team nicht für Claude Code gelten. Hat eine Console-Organisation nur diese Credits, zeigt Claude Code die Meldung Credit balance too low (Guthaben zu niedrig). Welche Option günstiger ist, erfahren Sie unter Claude-Code-Preise, die Einrichtung unter Claude Code installieren.

Fehler beim API-Key beheben

Die Claude API gibt einen JSON-Fehler mit HTTP-Status und Fehlertyp zurück. Das sind die Fehler, auf die man beim Einrichten eines neuen Keys am häufigsten stößt, jeweils mit der Lösung aus der Anthropic-Dokumentation.

Der Key funktioniert mit curl, aber nicht in meiner App

• Ihre App wurde aus einer Shell oder einem Dienst gestartet, der die Variable nie geladen hat. Umgebungsvariablen, die in einem Terminal gesetzt wurden, erreichen keine Programme, die anderswo gestartet werden, etwa eine aus dem Dock geöffnete IDE oder einen systemd-Dienst. Setzen Sie die Variable dort, wo das Programm startet, oder übergeben Sie den Key aus Ihrem Secrets-Manager.
• Unter Windows erscheint eine mit setx gesetzte Variable nur in danach geöffneten Terminals. Schließen und öffnen Sie Terminal oder Editor neu.
• Prüfen Sie, ob ein älterer Key den neuen überschreibt, etwa eine veraltete Zeile in Ihrem Shell-Profil oder eine .env-Datei, die Ihr Framework lädt.

Ich habe meinen Key verloren oder glaube, er ist geleakt

Die Console kann das Secret eines Keys nie wieder anzeigen, und laut Anthropic kann auch die Admin API einen verlorenen Key nicht wiederherstellen; sie liefert nur einen teilweise geschwärzten Hinweis. Erstellen Sie einen neuen Key, stellen Sie Ihre Apps darauf um und deaktivieren oder löschen Sie dann den alten auf der API-Keys-Seite. Disable (Deaktivieren) ist umkehrbar (Sie können den Key wieder aktivieren), Delete (Löschen) ist endgültig.

Die Schaltfläche Create key ist ausgegraut

Ihre Rolle in dieser Organisation erlaubt keine Key-Erstellung. Bitten Sie einen Admin der Organisation, Ihre Rolle zu ändern oder einen Dienstkonto-Key für Ihren Workload zu erstellen. Wenn Sie nur beigetreten sind, um Claude Code zu nutzen, erlaubt die Rolle Claude Code ausschließlich das Erstellen von Claude-Code-Keys.

Ich werde bei einem brandneuen Konto rate-limitiert

Neue Organisationen können in der Evaluation-Stufe starten, deren Limits unter den Standardlimits der Start-Stufe liegen, solange sich der Kontoverlauf aufbaut. Laut Anthropic steigen diese Limits automatisch. Anthropic weist außerdem darauf hin, dass ein starker Nutzungsanstieg 429-Fehler durch Beschleunigungslimits auslösen kann – steigern Sie den Traffic also schrittweise.

Sicherheitstipps für API-Keys

• Committen Sie einen Key nie in Git und fügen Sie ihn nie in clientseitigen Code wie eine Browser- oder Mobile-App ein. Laden Sie ihn auf einem Server, den Sie kontrollieren, aus einer Umgebungsvariable oder einem Secrets-Manager.
• Wählen Sie beim Erstellen des Keys ein Ablaufdatum und verwenden Sie für geteilte oder produktive Systeme Dienstkonto-Keys.
• Geben Sie jedem Projekt einen eigenen Workspace mit Workspace-Ausgabenlimit, damit ein geleakter Key nicht Ihr gesamtes Guthaben aufbrauchen kann.
• Setzen Sie auf der Billing-Seite ein Ausgabenlimit für die Organisation unterhalb der Grenze Ihrer Stufe.
• Rotieren Sie Keys regelmäßig. Für Cloud-Workloads unterstützt Anthropic außerdem Workload Identity Federation, die langlebige Keys durch kurzlebige Tokens eines bereits genutzten Identitätsanbieters ersetzt.
• Wenn ein Key leakt, erstellen Sie in der Console einen neuen Key, stellen Sie Ihre Apps darauf um und deaktivieren oder löschen Sie den alten. Verlorene Keys lassen sich nicht wiederherstellen.