Claude API Key erstellen: Schritt für Schritt zum ersten eigenen Aufruf

Ein Pilotprojekt mit der Claude API scheitert selten an der Technik. Der Schlüssel ist in zwei Minuten angelegt, der erste Aufruf läuft im dritten. Was danach passiert, entscheidet darüber, ob aus dem Versuch ein Produkt wird: wer den Schlüssel in der Hand hält, welches Budget daran hängt und was passiert, wenn ein Skript nachts in einer Schleife festhängt.

Der Moment, in dem ein Zugangsschlüssel zum ersten Mal im Code landet. Von hier an ist er ein Betriebsmittel mit Kostenstelle. Foto: ThisIsEngineering auf Pexels

Abo oder API: die Frage, die vor dem Schlüssel kommt

Viele Unternehmen legen einen API-Schlüssel an und brauchen ihn gar nicht. Wenn dein Team Texte schreiben, Angebote zusammenfassen oder Dokumente auswerten will, reicht ein Abo bei claude.ai. Dort ist der Preis pro Kopf und Monat fix, die Oberfläche steht, und niemand muss eine Zeile Code anfassen.

Der API-Zugang lohnt sich, sobald Claude in ein eigenes System hineinwirken soll: in den Shop, ins Ticketsystem, in ein nächtliches Skript, das 800 Lieferantenmails sortiert. Hier zahlst du nach Verbrauch statt nach Kopf. Das ist bei kleinen Mengen spottbillig und bei unkontrollierten Mengen teuer, und genau diese Spreizung ist der Grund, warum dieser Artikel das Budget so früh behandelt. Welche Plattform für welche Aufgabe die richtige ist, haben wir im Claude-Unternehmensguide aufgedröselt; die reine Preisfrage zwischen Abo und Schnittstelle steht in Abo gegen API mit Rechenbeispielen.

Eine dritte Möglichkeit gibt es auch: Claude über AWS, Google Cloud oder Microsoft Foundry beziehen. Dann läuft die Abrechnung über den Cloud-Anbieter, und du brauchst gar keinen Anthropic-Schlüssel. Wann dieser Umweg sinnvoll ist, steht in Claude über Bedrock: wann sich der Umweg lohnt. Für den ersten Versuch ist der direkte Weg schneller.

Vorbereitung: Konto, Organisation, Guthaben

Der Zugang läuft über die Claude Console auf platform.claude.com. Das ist ein anderes Konto als claude.ai, auch wenn du dich mit derselben Mailadresse anmelden kannst. Beim ersten Login legst du eine Organisation an und gibst an, wofür du die Schnittstelle nutzen willst.

Danach kommt der Schritt, den die meisten Anleitungen unterschlagen: ohne Guthaben passiert nichts. Die Claude API läuft auf Vorkasse. Du kaufst in der Konsole unter Abrechnung ein Guthaben, das für API-Aufrufe, den Playground und Claude Code gilt. Läuft es leer, antwortet die Schnittstelle nicht mehr, bis du nachlegst. Für ein Pilotprojekt ist das eine angenehme Eigenschaft, weil eine Fehlkonfiguration am Guthaben endet statt auf der Kreditkartenabrechnung.

Drei Punkte dazu, die im Hilfe-Center stehen und über die später Diskussionen entstehen:

• Guthaben verfällt ein Jahr nach dem Kauf, die Frist lässt sich nicht verlängern.
• Käufe werden nicht erstattet. Kauf also so viel, wie das Projekt in den nächsten Wochen realistisch braucht, und nicht die Summe, die sich rund anfühlt.
• Fehlgeschlagene Aufrufe kosten nichts. Wenn die Verbindung mitten in einer bereits erfolgreichen Antwort abreißt, wird sie dagegen berechnet.

Monatliche Rechnungsstellung im Nachhinein gibt es, sie setzt aber eine Vereinbarung mit dem Vertrieb voraus. Für den Start ist Vorkasse der Normalfall.

Den Schlüssel anlegen: drei Entscheidungen, die bleiben

Der eigentliche Vorgang: In der Console auf Settings, dann API keys, dann Create key. Du vergibst einen Namen, und dann kommen die Felder, auf die es ankommt. Der Schlüsselwert wird genau einmal angezeigt. Kopiere ihn sofort dorthin, wo er hingehört, denn ein zweites Mal bekommst du ihn nicht zu sehen.

Die erste Entscheidung ist der Schlüsseltyp. Anthropic unterscheidet drei, und die Wahl bestimmt, wann ein Schlüssel aufhört zu funktionieren.

Quelle: Anthropic, Dokumentation zur Authentifizierung, abgerufen am 14. September 2026.

Der Unterschied wird an einem Alltagsfall greifbar. Ein Mitarbeiter baut die Anbindung ans Ticketsystem, nimmt seinen persönlichen Schlüssel, alles läuft. Anderthalb Jahre später wechselt er die Firma, sein Konto wird gelöscht, und mit ihm stirbt die Anbindung. Anthropic hat diese Kopplung bewusst eingebaut, damit Zugänge nicht länger leben als die Menschen, denen sie gehören. Für geteilte Aufgaben gehört deshalb ein Service-Konto her, das ein Organisations-Administrator unter Settings und Service accounts anlegt.

Die zweite Entscheidung ist die Ablauffrist. Zur Auswahl stehen 3 Stunden, 1 Tag, 7 Tage, 30 Tage, eine eigene Dauer oder Never. Die Frist wird beim Anlegen festgelegt und lässt sich danach nicht mehr ändern. Wer eine Höchstdauer als Organisationsrichtlinie gesetzt hat, sieht die Option Never gar nicht erst.

Für den ersten Versuch sind 30 Tage eine gute Wahl: lang genug, um das Projekt zu bewerten, kurz genug, dass ein vergessener Schlüssel in einem alten Repository von selbst wertlos wird. Anthropic warnt den Ersteller per Mail, und zwar sieben Tage vorher bei Laufzeiten ab 14 Tagen sowie einen Tag vorher ab sieben Tagen Laufzeit. Alles darunter läuft ohne Vorwarnung ab.

Die dritte Entscheidung ist der Workspace. Bindest du den Schlüssel an einen bestimmten Workspace, läuft jeder Aufruf dort und du sparst dir einen Header. Lässt du ihn ungebunden, musst du bei jedem Aufruf anthropic-workspace-id mitschicken, sonst antwortet die API mit einem 400er und der Meldung, dass die Workspace-ID fehlt.

„Store API keys in a secrets manager, rotate them periodically, and disable or delete any key you suspect has leaked.”

— Anthropic, Dokumentation zur Authentifizierung, abgerufen am 14.09.2026

Budgetdeckel setzen, bevor der erste Aufruf rausgeht

Diese fünf Minuten sind der Unterschied zwischen einem Pilotprojekt und einer unangenehmen Überraschung. Deine Organisation bekommt automatisch eine Nutzungsstufe zugewiesen, und an jeder hängt ein monatlicher Ausgabendeckel.

Quelle: Anthropic, Dokumentation zu Rate limits, abgerufen am 14. September 2026. Neue Organisationen starten außerdem in einer Evaluation-Stufe mit niedrigeren Grenzen, die sich mit wachsender Nutzungshistorie automatisch anheben.

Der Deckel deiner Stufe ist eine Obergrenze, keine Empfehlung. Unter Settings und Billing setzt du ein eigenes, niedrigeres Limit. Der Unterschied zeigt sich im Fehlerverhalten, und den solltest du kennen, bevor du dein Monitoring baust: Ist der Deckel der Nutzungsstufe erreicht, antwortet die API mit HTTP 429, Typ rate_limit_error und dem Detailcode enforced_spend_limit_reached, ohne retry-after. Automatische Wiederholungen der SDKs laufen dann ins Leere, bis am Monatsersten um 00:00 UTC wieder freigeschaltet wird. Ist dagegen dein selbst gesetztes Limit erreicht, kommt HTTP 400 mit invalid_request_error und einer Meldung, die mit „You have reached your specified API usage limits” beginnt. Das lässt sich sofort beheben, indem du das Limit anhebst.

Der zweite Hebel sind Workspaces. Jede Organisation hat einen Default Workspace, und ein Administrator kann bis zu 100 weitere anlegen. Je Workspace lassen sich ein eigenes Ausgabenlimit und eigene Ratenlimits setzen, jeweils niedriger als die Organisationswerte. Für ein Unternehmen mit mehreren Vorhaben ist das die saubere Kostenstellenlogik: ein Workspace für das Kundenchat-Projekt, einer für die interne Dokumentenauswertung, einer für Tests. Eine Endlosschleife im Testsystem verbrennt dann das Testbudget und nicht das Budget des Kundenchats. Für den Default Workspace lassen sich keine eigenen Limits setzen, für alle anderen schon.

Der erste Aufruf

Setz den Schlüssel als Umgebungsvariable, damit er nicht im Quelltext landet:

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

Danach der erste Aufruf gegen die Messages-API. Drei Kopfzeilen sind Pflicht: die Authentifizierung, die API-Version und der Inhaltstyp.

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1000,
    "messages": [
      {"role": "user", "content": "Fasse diese Lieferantenmail in drei Stichpunkten zusammen."}
    ]
  }'

Die Antwort ist JSON und enthält neben dem Text ein usage-Objekt mit input_tokens und output_tokens. Das ist deine Abrechnungseinheit, und es lohnt sich, diese beiden Zahlen von Anfang an mitzuloggen. Dann diskutierst du in vier Wochen über Messwerte statt über Schätzungen.

Der Header x-api-key ist die ältere Schreibweise und funktioniert weiterhin, deshalb steht er in fast allen Beispielen im Netz. Die aktuelle Form ist Authorization: Bearer <key>. Beides führt zum selben Ergebnis.

Mit dem Python-SDK sieht derselbe Aufruf so aus, die Header setzt die Bibliothek selbst:

import anthropic

client = anthropic.Anthropic()   # liest ANTHROPIC_API_KEY aus der Umgebung

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1000,
    messages=[
        {"role": "user", "content": "Fasse diese Lieferantenmail in drei Stichpunkten zusammen."}
    ],
)

print(message.content[0].text)
print(message.usage)

Installation vorher mit pip install anthropic, für TypeScript entsprechend npm install @anthropic-ai/sdk. Offizielle SDKs gibt es außerdem für C#, Go, Java, PHP und Ruby.

Ist der Schlüssel nicht an einen Workspace gebunden, kommt eine Kopfzeile dazu:

  -H "anthropic-workspace-id: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"

Die ID findest du in der Konsole unter Settings und Workspaces in der Spalte ID. Jede erfolgreiche Antwort trägt sie außerdem im Header anthropic-workspace-id, was beim Aufräumen hilft, wenn im Laufe eines Jahres mehrere Schlüssel entstanden sind.

Was der erste Monat kostet

Die Modellwahl bestimmt den Preis stärker als alles andere, was du im Code tust. Die Preise gelten je Million Token, ein Token entspricht grob vier Zeichen.

Quelle: Anthropic-Preisseite, Stand 14. September 2026. Der bei Sonnet 5 zum 1. September angekündigte Anstieg auf 3 und 15 USD ist gestrichen, die Einführungspreise sind Standardpreise geworden.

Ein Rechenbeispiel, das sich auf deinen Fall übertragen lässt. Anthropic beziffert einen durchschnittlichen Support-Vorgang mit rund 3.700 Token. Mit Haiku 4.5 kosten 10.000 solcher Vorgänge etwa 37 USD im Monat. Dieselbe Menge mit Opus 5 liegt beim Fünffachen bis Zehnfachen, je nach Verhältnis von Eingabe zu Ausgabe. Bei 300 Vorgängen am Tag ist das der Unterschied zwischen einem Posten, den niemand diskutiert, und einem, der ins Budget muss.

Zwei Hebel senken die Rechnung deutlich, ohne dass du an der Qualität sparst. Der erste ist Prompt-Caching: ein Cache-Treffer kostet zehn Prozent des normalen Eingabepreises, das Schreiben in den Cache kostet das 1,25-Fache bei fünf Minuten Haltbarkeit. Ab dem ersten Treffer rechnet sich das. Wer in jedem Aufruf dieselbe lange Systemanweisung oder dasselbe Handbuch mitschickt, halbiert damit typischerweise die Eingabekosten. Der zweite ist die Batch-API: für alles, was nicht in Echtzeit antworten muss, gibt es 50 Prozent Rabatt auf Ein- und Ausgabe. Nächtliche Auswertungen, Klassifizierungen von Altbeständen und Massenzusammenfassungen gehören dorthin.

Die vollständige Rechnung samt Cache-Multiplikatoren, Batch-Rabatt und Websuche steht in Claude API Kosten kalkulieren. Welches Modell zu welcher Aufgabenklasse passt, klärt Opus, Sonnet oder Haiku. Für den ersten Versuch ist Sonnet 5 der vernünftige Startpunkt, weil er stark genug für die meisten Aufgaben und günstig genug zum Ausprobieren ist.

Die fünf Fehlerbilder beim ersten Start

Das zweite Fehlerbild trifft fast jeden einmal, weil es nur bei ungebundenen Schlüsseln auftritt und die Fehlermeldung im ersten Moment nach einem Rechteproblem aussieht. Beim vierten hilft ein Blick in die Antwortheader: anthropic-ratelimit-requests-remaining und die drei Token-Zähler zeigen dir jederzeit, wie viel Luft noch da ist.

Ein Detail, das die Ratenlimits entspannter macht, als sie aussehen: Bei fast allen Modellen zählen aus dem Cache gelesene Token nicht gegen dein Eingabe-Ratenlimit. Bei einer Trefferquote von 80 Prozent verarbeitest du mit einem Limit von 2 Millionen Token pro Minute effektiv rund 10 Millionen. Caching senkt also nicht nur die Rechnung, es hebt auch den Durchsatz.

Der Schlüssel im Betrieb

Damit aus dem Versuch ein Betrieb wird, fehlen drei Dinge, die nichts mit Code zu tun haben.

Der Schlüssel gehört in einen Secrets-Manager, nicht in eine Datei im Repository. In der Konsole lässt sich ein Schlüssel deaktivieren (umkehrbar) oder löschen (endgültig, er bleibt als archiviert in der Admin-API sichtbar). Dass dieser Unterschied existiert, ist im Ernstfall die halbe Miete: Bei einem Verdacht deaktivierst du sofort und prüfst danach in Ruhe.

Die Zuordnung zu Projekten macht die Nutzungs- und Kosten-API sichtbar, aber nur, wenn du sie vorher angelegt hast. Ein Schlüssel je Umgebung und je Vorhaben kostet beim Einrichten zehn Minuten und erspart dir die Frage, wer eigentlich die 400 USD im März verursacht hat.

Und der datenschutzrechtliche Teil gehört vor den Produktivstart, nicht danach. Sobald Kundendaten durch die Schnittstelle laufen, brauchst du einen Auftragsverarbeitungsvertrag und einen Eintrag im Verarbeitungsverzeichnis. Was dafür nötig ist und welche Teamregeln sich bewährt haben, steht in Claude DSGVO-konform einführen. Eine Anmerkung zum Standort: Der Parameter inference_geo kennt aktuell nur die Werte global und us, eine EU-Option gibt es nicht. US-Verarbeitung kostet zusätzlich das 1,1-Fache des Normalpreises und ist ab Claude 4.6 verfügbar.

Wenn Claude auf eure Systeme zugreifen soll statt nur Text zu liefern, ist der API-Schlüssel ohnehin nur der erste Baustein. Wie die Anbindung an Warenwirtschaft, Ticketsystem oder Dateiablage sauber funktioniert, beschreibt MCP erklärt: Firmensysteme sicher andocken.

Konkret für heute: Leg einen Schlüssel mit 30 Tagen Laufzeit an, kauf Guthaben in Höhe eines realistischen Testmonats, setz ein eigenes Ausgabenlimit darunter und schick den curl-Befehl von oben mit einer echten Aufgabe aus deinem Betrieb los. Nach einer Woche mit mitgeloggten Token-Zahlen weißt du mehr über die Wirtschaftlichkeit als nach jeder weiteren Recherche.

Learoy Eichholz

Lead KI-Automation & Digitale Businessentwicklung, Collective Brain GmbH · Hamburg

Learoy Eichholz verantwortet bei Collective Brain die KI-Automation und die digitale Businessentwicklung. In 15 Jahren E-Commerce hat er Online-Geschäfte von innen kennengelernt, vom Shopsystem über Logistik und Daten bis zur Conversion. Diese Praxis bringt er heute in KI-gestützte Automatisierung ein: Er verzahnt Tools, Daten und Abläufe so, dass Mittelständler manuelle Arbeit abbauen und schneller wachsen. Sein Anspruch ist Automatisierung mit messbarem Geschäftseffekt statt Technik um der Technik willen.

Beratung anfragen