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 Workbench verwenden |
| Workspace Limited Developer | API-Keys erstellen und verwalten, die API verwenden. Kein Zugriff auf Session-Tracing-Ansichten oder Datei-Downloads. |
| 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.
So änderst du den Namen oder die Farbe eines Workspace:
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 Auslassungsmenü (...) 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. Nur Organisationsmitglieder mit der Admin-Rolle können Admin-API-Keys über die Claude Console bereitstellen.
# Erstelle einen Workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--data '{"name": "Production"}'
# Liste Workspaces auf
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"
# Archiviere einen Workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
--header "anthropic-version: 2023-06-01" \
--header "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 ein Mitglied zu einem Workspace hinzu
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--data '{
"user_id": "user_xxx",
"workspace_role": "workspace_developer"
}'
# Aktualisiere die Rolle eines Mitglieds
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--data '{"workspace_role": "workspace_admin"}'
# Entferne ein Mitglied aus einem Workspace
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
--header "anthropic-version: 2023-06-01" \
--header "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 dieser nur auf Ressourcen innerhalb dieses Workspace zugreifen.
Zu den auf Workspaces beschränkten Ressourcen gehören:
Einige Ressourcen werden auf Organisationsebene verwaltet und können nicht mit einem Workspace-API-Key verwaltet werden:
org:manage_tunnels) verwaltet, das über Workload Identity Federation bezogen wird, nicht mit einem Workspace-API-Key, und die Obergrenze von 10 aktiven Tunneln gilt organisationsweit. Die Tunnel-Verwaltung erfordert eine Rolle mit Tunnel-Verwaltungsberechtigungen; Organisations-Developer können sie einsehen, aber nicht ändern. Tunnel werden in einem Workspace erstellt, und die MCP tunnels-Liste in der Console sowie der Managed-Agent-Server-Picker zeigen nur Tunnel im aktuellen Workspace an.Prompt-Caches sind ebenfalls pro Workspace isoliert – auf der Claude-API, Claude Platform on AWS und Microsoft Foundry (wo Claude sich derzeit in der Beta befindet). Auf Amazon Bedrock und Vertex AI 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 benutzerdefinierte Ausgaben- und Ratenlimits für jeden Workspace festlegen, um vor Übernutzung zu schützen und eine faire Ressourcenverteilung sicherzustellen.
Workspace-Limits können niedriger (aber nicht höher) als die Limits deiner Organisation festgelegt werden:
Detaillierte Informationen zu Ratenlimits und ihrer 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 pro 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" \
--header "anthropic-version: 2023-06-01" \
--header "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 | Testen und Experimentieren mit niedrigeren Ratenlimits |
| Staging | Vorproduktionstests mit produktionsähnlichen Limits |
| Production | Live-Traffic mit vollen Ratenlimits und Monitoring |
Weise Workspaces verschiedenen Teams zu, um Kosten zuzuordnen und Zugriffe zu kontrollieren:
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 Zugriffe regelmäßig
Überprüfe die Workspace-Mitgliedschaft regelmäßig, um sicherzustellen, dass nur berechtigte Benutzer Zugriff haben.
Überwache die Nutzung
Verwende die Usage-and-Cost-API, um den Verbrauch auf Workspace-Ebene zu verfolgen.
Was this page helpful?