Einen Admin-API-Key erstellen
Erstelle einen Admin-API-Key für deine Claude Console- oder Claude Enterprise-Organisation.
Ein Admin-API-Key authentifiziert jede API im Abschnitt Admin dieses Leitfadens: die Admin API, Analytics APIs, Compliance API, Plugins API, Claude Tag API, Spend Limits API, Usage and Cost Analytics API, Usage and Cost API und Rate Limits API. Du benötigst keinen separaten Key für jede API. Die einzige Ausnahme sind die Service-Account-, Federation-Issuer- und Federation-Rule-Endpunkte der Admin API, die nur ein OAuth-Bearer-Token mit dem Scope org:admin akzeptieren. Siehe Ein OAuth-Bearer-Token erhalten.
Wo du den Key erstellst, hängt davon ab, welches Claude-Produkt deine Organisation verwendet.
Welchen Key benötigst du?
| Deine Organisation | Erstelle den Key in | Key-Präfix | Wer ihn erstellen kann | Funktioniert mit |
|---|---|---|---|---|
Claude Console (Claude Platform, platform.claude.com) | Seite Admin-Schlüssel (platform.claude.com/settings/admin-keys) in der Claude Console | sk-ant-admin01-... | Organisationsmitglieder mit der Rolle admin | Admin API, Usage and Cost Analytics API, Usage and Cost API, Rate Limits API, Claude Code Analytics API und dem Activity Feed der Compliance API |
Claude Enterprise (claude.ai) | claude.ai > Organisationseinstellungen > API | sk-ant-api01-... | Der Haupteigentümer der übergeordneten Organisation (alle verknüpften Organisationen). Ein Organisationseigentümer kann einen Key erstellen, der nur Compliance-API-Scopes trägt und auf seine eigene Organisation beschränkt ist | Benutzerverwaltung (die Mitglieder-, Einladungs- und Gruppen-Endpunkte der Admin API), Plugins API, Claude Tag API, Compliance API, Claude Enterprise Analytics API, Usage and Cost Analytics API und Spend Limits API, entsprechend den von dir ausgewählten Scopes |
Ein in einer Organisation erstellter Key kann nicht zur Verwaltung einer anderen Organisation verwendet werden. Wenn dein Unternehmen sowohl Claude Console als auch Claude Enterprise nutzt, erstelle in jeder Organisation einen Key.
Einen Key für eine Claude Console-Organisation erstellen
Als Organisations-Admin anmelden
Nur Organisationsmitglieder mit der Rolle admin können Admin-API-Keys erstellen. Siehe Organisationsrollen und Berechtigungen.
Die Einstellungen für Admin-Schlüssel öffnen
Gehe in der Claude Console zur Seite Admin-Schlüssel (
platform.claude.com/settings/admin-keys).Den Key erstellen
Klicke auf Admin-Schlüssel erstellen, gib ihm einen Namen, wähle eine Key-Ablaufzeit aus und klicke auf Hinzufügen. Claude Console-Keys haben keine auswählbaren Scopes; jeder Key verfügt über vollen Zugriff auf alle Endpunkte, die Admin-API-Keys akzeptieren (die oben auf dieser Seite genannten Service-Account- und Federation-Endpunkte akzeptieren keine Admin-API-Keys).
Das Secret kopieren und speichern
Kopiere das angezeigte Secret (beginnend mit
sk-ant-admin01-) und speichere es in deinem Secrets-Manager. Das vollständige Secret wird nur einmal angezeigt.
Einen Key für eine Claude Enterprise-Organisation erstellen
Als primärer Eigentümer oder Organisationseigentümer anmelden
Der primäre Eigentümer der übergeordneten Claude Enterprise-Organisation kann einen Key erstellen, der auf jede verknüpfte Organisation zugreifen kann, oder einen, der auf eine einzelne Organisation beschränkt ist. Ein Organisationseigentümer kann einen Key nur mit Compliance-API-Scopes erstellen, der auf seine eigene Organisation beschränkt ist.
Die API-Einstellungen öffnen
Gehe zu claude.ai > Organisationseinstellungen > API und suche den Abschnitt Schlüssel.
Auf „+ Schlüssel erstellen“ klicken
Benenne den Key und wähle die benötigten Scopes aus der Scopes-Tabelle aus. Der primäre Eigentümer kann Scopes verschiedener APIs (zum Beispiel
read:analyticsundread:spend_limits) in einem einzigen Key kombinieren.Das Secret kopieren und speichern
Kopiere das angezeigte Secret (beginnend mit
sk-ant-api01-) und speichere es in deinem Secrets-Manager. Das vollständige Secret wird nur einmal angezeigt.
Scopes für einen Claude Enterprise-Key auswählen
Wenn du einen Claude Enterprise-Key erstellst, wähle jeden Scope aus, den die APIs, die du aufrufen möchtest, erfordern. Scopes werden bei der Erstellung festgelegt; um später einen Scope hinzuzufügen, erstelle einen neuen Key.
| Um Folgendes aufzurufen ... | Wähle diese Scopes |
|---|---|
| Admin API Benutzerverwaltung: Mitglieder und Einladungen auflisten und nachschlagen; benutzerdefinierte Rollen und deren Berechtigungen lesen | read:members |
Admin API Benutzerverwaltung: Mitgliederrollen ändern, Mitglieder entfernen, Mitglieder überall abmelden (Beta), Einladungen erstellen und zurückziehen (um die Rolle managed bei einer Rollenänderung oder Einladung zuzuweisen, wähle zusätzlich write:rbac_groups) | write:members |
| Admin API Benutzerverwaltung: Gruppen und deren Mitglieder lesen | read:rbac_groups |
Admin API Benutzerverwaltung: Gruppen erstellen, umbenennen und löschen; Gruppenmitglieder hinzufügen und entfernen; zusammen mit write:members die Rolle managed zuweisen (bei einer Einladung oder Rollenänderung) oder Gruppen bei einer Einladung zuweisen | write:rbac_groups |
| Plugins API: Plugins, Versionen, Installationseinstellungen, Freigaben und Marketplaces lesen; Plugin-Dateien herunterladen, einschließlich der Dateien persönlicher Plugins von Mitgliedern; einen Marketplace validieren, bevor du ihn verbindest | read:plugins |
Plugins API: Plugins und Versionen hochladen; auswählen, welche Version Mitgliedern bereitgestellt wird; Plugins löschen, einschließlich persönlicher Plugins von Mitgliedern; Installationseinstellungen festlegen und entfernen; die Standard-Installationseinstellung eines Marketplace festlegen; einen Marketplace validieren, bevor du ihn verbindest (um Plugins zu lesen, wähle zusätzlich read:plugins) | write:plugins |
| Claude Tag API: Einstellungen von Claude Tag für Slack-Kanäle und Slack-Workspaces lesen; Zugriffspakete auflisten und wo sie angehängt sind (kein anderer Scope gewährt Zugriff auf die Claude Tag API) | read:claude_tag |
Claude Tag API: Kanäle einrichten und entfernen; Einstellungen ändern; Zugriffspakete anhängen und trennen (um auch lesen zu können, wähle zusätzlich read:claude_tag) | write:claude_tag |
| Spend Limits API: die effektiven Ausgabenlimits der Mitglieder und Erhöhungsanfragen lesen | read:spend_limits |
| Spend Limits API: Ausgabenlimits pro Benutzer festlegen oder aufheben; Erhöhungsanfragen genehmigen oder ablehnen | write:spend_limits |
| Claude Enterprise Analytics API: Berichte zu Engagement, Akzeptanz, Kosten und Nutzung; Usage and Cost Analytics API: Berichte zu Token-Nutzung und Kosten | read:analytics |
| Compliance API Activity Feed: organisationsweite Aktivitätsereignisse | read:compliance_activities |
| Chat-, Datei- und Projekt-Endpunkte der Compliance API und Sitzungs-Endpunkte der Compliance API: Chats, Dateien, Projekte, Sitzungstranskripte und Organisationsbenutzer lesen | read:compliance_user_data |
| Chat-, Datei- und Projekt-Endpunkte der Compliance API: Chats, Dateien und Projekte löschen | delete:compliance_user_data |
Organisations-Endpunkte der Compliance API: Organisationsmetadaten und effektive Einstellungen lesen; Plugins API: jeder GET-Endpunkt, einschließlich Datei-Downloads | read:compliance_org_data |
Lese-Endpunkte der Admin API für die Benutzerverwaltung, jeder Lese-Endpunkt der Compliance API und jeder GET-Endpunkt der Plugins API, einschließlich Datei-Downloads, mit einem einzigen Nur-Lese-Scope (für Sicherheitsaudit-Integrationen; umfasst nicht die Spend Limits oder Analytics APIs) | read:org_audit |
Die Compliance und Analytics APIs müssen für deine Organisation aktiviert sein, bevor Keys mit diesen Scopes verwendet werden können. Siehe Die Compliance API einrichten und Zugriff auf die Claude Enterprise Analytics API erhalten.
Du kannst Keys mit read:plugins oder write:plugins nur erstellen und verwenden, wenn deine Organisation die Plugins API nutzen kann. Der Leitfaden zur Plugins API gibt an, welche Organisationen sie nutzen können. In diesen Organisationen können Keys mit read:org_audit oder read:compliance_org_data auch die Lese-Endpunkte der Plugins API aufrufen, einschließlich Datei-Downloads, jedoch nicht die Marketplace-Validierung. Die Scopes read:plugins und write:plugins wirken nur auf die Organisation, in der der Key erstellt wurde. Siehe Scopes der Plugins API und Eine andere Organisation unter derselben übergeordneten Organisation lesen.
Den Key verwenden
Übergib den Key bei jeder Anfrage im Header x-api-key. Vollständige Anfragebeispiele findest du in der Dokumentation der jeweiligen API.
Ein Aufruf, der die Scopes des Keys überschreitet, gibt 403 Forbidden mit einer Meldung zurück, die die Scopes auflistet, die der Key besitzt, und die Scopes, die der Endpunkt benötigt.
Nächste Schritte
Verwalte Organisationsmitglieder, Workspaces und API-Keys.
Lege Ausgabenlimits pro Mitglied fest und prüfe Erhöhungsanfragen für deine Claude Enterprise-Organisation.
Erstelle Berichte zur Claude Code-Produktivität oder zu Engagement und Akzeptanz von Claude Enterprise.
Prüfe Aktivitäten und rufe Benutzerinhalte in deiner gesamten Organisation ab oder lösche sie.
War diese Seite hilfreich?