Workspaces bieten eine Möglichkeit, deine API-Nutzung innerhalb einer Organisation zu organisieren. Verwende Workspaces, um verschiedene Projekte, Umgebungen oder Teams zu trennen und gleichzeitig eine zentralisierte Abrechnung und Verwaltung beizubehalten.
Jede Organisation hat einen Default Workspace, der nicht umbenannt, archiviert oder gelöscht werden kann. Wenn du zusätzliche Workspaces erstellst, kannst du jedem davon API-Keys, Mitglieder und Ressourcenlimits zuweisen.
Wichtige Merkmale:
wrkspc_ (zum Beispiel wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)Wenn sich ein Mitglied deiner Organisation zum ersten Mal mit seinem Claude Console-Konto bei Claude Code anmeldet, erstellt Anthropic automatisch einen Claude Code-Workspace in der Organisation und fügt dieses Mitglied hinzu. Jedes weitere Mitglied, das sich bei Claude Code anmeldet, wird auf die gleiche Weise hinzugefügt.
Der Claude Code Workspace hält den Claude Code-Traffic von deinen anderen API-Workloads getrennt:
Das Archivieren des Claude Code Workspace deaktiviert die Claude Code-Anmeldung über die Console-Abrechnung für die gesamte Organisation.
Mitglieder können in jedem Workspace unterschiedliche Rollen haben, was eine feingranulare Zugriffskontrolle ermöglicht.
| Rolle | Berechtigungen |
|---|---|
| Workspace User | Nur die Anthropic Workbench verwenden |
| Workspace Limited Developer | API-Keys erstellen und verwalten, die API verwenden. Kein Zugriff auf Session-Tracing-Ansichten oder das Herunterladen von Dateien. |
| Workspace Developer | API-Keys erstellen und verwalten, die API verwenden |
| Workspace Admin | Volle Kontrolle über Workspace-Einstellungen und Mitglieder |
| Workspace Billing | Abrechnungsinformationen des Workspace einsehen (geerbt von der Organisations-Billing-Rolle) |
Die Workspace Billing-Rolle kann nicht manuell zugewiesen werden. Sie wird von der Organisations-Billing-Rolle geerbt.
Nur Organisations-Admins können Workspaces erstellen. Organisations-User und -Developer müssen von einem Admin zu Workspaces hinzugefügt werden.
Erstelle und verwalte Workspaces in der Claude Console.
Workspace-Einstellungen öffnen
Gehe in der Claude Console zu Settings > Workspaces.
Einen Workspace erstellen
Klicke auf Create workspace.
Den Workspace konfigurieren
Gib einen Workspace-Namen ein und wähle eine Farbe zur visuellen Identifikation.
Den Workspace erstellen
Klicke auf Create, um den Vorgang abzuschließen.
Um in der Console zwischen Workspaces zu wechseln, verwende den Workspaces-Selektor in der oberen linken Ecke.
Um den Namen oder die Farbe eines Workspace zu ändern:
Der Default Workspace kann nicht umbenannt oder gelöscht werden.
Um ein Mitglied zu entfernen, klicke auf das Papierkorb-Symbol neben seinem Namen.
Organisations-Admins und Billing-Mitglieder können nicht aus Workspaces entfernt werden, solange sie diese Organisationsrollen innehaben.
Im Tab Limits kannst du Folgendes konfigurieren:
Um einen Workspace zu archivieren, klicke auf das Ellipsen-Menü (...) und wähle Archive. Das Archivieren:
Das Archivieren eines Workspace widerruft sofort alle API-Keys in diesem Workspace. Diese Aktion kann nicht rückgängig gemacht werden. Wenn du den Claude Code Workspace archivierst, können sich Mitglieder deiner Organisation nicht mehr über die Console-Abrechnung bei Claude Code anmelden.
Verwalte Workspaces programmatisch mit der Admin API.
Admin API-Endpunkte erfordern einen Admin-API-Key (beginnend mit sk-ant-admin...), der sich von Standard-API-Keys unterscheidet. Siehe Einen Admin-API-Key erstellen, um zu erfahren, wie du einen bereitstellst.
# Erstelle einen Workspace
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-d '{"name": "Production"}'
# Liste Workspaces auf
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
# Archiviere einen Workspace
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"Vollständige Parameterdetails und Antwortschemata findest du in der Workspaces API-Referenz.
Füge Mitglieder zu einem Workspace hinzu, aktualisiere oder entferne sie:
# Füge einem Workspace ein Mitglied hinzu
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-d '{
"user_id": "user_xxx",
"workspace_role": "workspace_developer"
}'
# Aktualisiere die Rolle eines Mitglieds
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-d '{"workspace_role": "workspace_admin"}'
# Entferne ein Mitglied aus einem Workspace
curl -X DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"Vollständige Parameterdetails findest du in der Workspace Members API-Referenz.
API-Keys sind auf einen bestimmten Workspace beschränkt. Wenn du einen API-Key in einem Workspace erstellst, kann er nur auf Ressourcen innerhalb dieses Workspace zugreifen.
Zu den auf Workspaces beschränkten Ressourcen gehören:
Einige Ressourcen können nicht mit einem Workspace-API-Key verwaltet werden:
workspace:manage_tunnels-OAuth-Token verwaltet, das über Workload Identity Federation bezogen wird, nicht mit einem Workspace-API-Key. Tunnel werden in einem Workspace erstellt, und die Console-Liste MCP tunnels sowie die Serverauswahl für Managed Agents zeigen nur Tunnel im aktuellen Workspace an; die Obergrenze von 10 aktiven Tunneln gilt organisationsweit. Die Tunnelverwaltung erfordert eine Rolle mit Tunnelverwaltungsberechtigungen; Organisations-Developer können sie einsehen, aber nicht ändern.Prompt-Caches sind auf der Claude API, der Claude Platform on AWS und Microsoft Foundry ebenfalls pro Workspace isoliert. Auf Amazon Bedrock und Google Cloud sind Prompt-Caches pro Organisation isoliert.
Um die Workspace-IDs deiner Organisation abzurufen, verwende den List Workspaces-Endpunkt oder finde sie in der Claude Console.
Du kannst für jeden Workspace benutzerdefinierte Ausgaben- und Ratenlimits festlegen, um vor Übernutzung zu schützen und eine faire Ressourcenverteilung sicherzustellen.
Du kannst Workspace-Limits niedriger (aber nicht höher) als die Limits deiner Organisation festlegen:
Detaillierte Informationen zu Ratenlimits und deren Funktionsweise findest du unter Ratenlimits. Du kannst deine aktuellen Organisations- und Workspace-Ratenlimits auch programmatisch mit der Rate Limits API auslesen.
Verfolge Nutzung und Kosten nach Workspace mit der Usage and Cost API:
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
group_by[]=workspace_id&\
bucket_width=1d" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"Nutzung und Kosten, die dem Default Workspace zugeordnet sind, haben einen null-Wert für workspace_id.
Erstelle separate Workspaces für Entwicklung, Staging und Produktion:
| Workspace | Zweck |
|---|---|
| Development | Tests und Experimente mit niedrigeren Ratenlimits |
| Staging | Vorproduktionstests mit produktionsähnlichen Limits |
| Production | Live-Traffic mit vollen Ratenlimits und Monitoring |
Weise Workspaces verschiedenen Teams für Kostenzuordnung und Zugriffskontrolle zu:
Erstelle Workspaces für bestimmte Projekte oder Produkte, um Nutzung und Kosten separat zu verfolgen.
Plane deine Workspace-Struktur
Überlege dir, wie du Workspaces organisieren möchtest, bevor du sie erstellst. Denke an Abrechnung, Zugriffskontrolle und Anforderungen an die Nutzungsverfolgung.
Verwende aussagekräftige Namen
Benenne Workspaces klar, um ihren Zweck anzugeben (zum Beispiel „Production - Customer Chatbot", „Dev - Internal Tools").
Lege angemessene Limits fest
Konfiguriere Ausgaben- und Ratenlimits, um unerwartete Kosten zu vermeiden und eine faire Ressourcenverteilung sicherzustellen.
Überprüfe den Zugriff regelmäßig
Überprüfe die Workspace-Mitgliedschaft regelmäßig, um sicherzustellen, dass nur die richtigen Benutzer Zugriff haben.
Überwache die Nutzung
Verwende die Usage and Cost API, um den Verbrauch auf Workspace-Ebene zu verfolgen.
Was this page helpful?