Workspaces bieten eine Möglichkeit, Ihre API-Nutzung innerhalb einer Organisation zu organisieren. Verwenden Sie Workspaces, um verschiedene Projekte, Umgebungen oder Teams zu trennen und gleichzeitig eine zentralisierte Abrechnung und Verwaltung zu gewährleisten.
Jede Organisation hat einen Standard-Workspace, der nicht umbenannt, archiviert oder gelöscht werden kann. Wenn Sie zusätzliche Workspaces erstellen, können Sie jedem API-Schlüssel, Mitglieder und Ressourcenlimits zuweisen.
Wichtige Merkmale:
wrkspc_ (z. B. wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)Mitglieder können in jedem Workspace unterschiedliche Rollen haben, was eine differenzierte Zugriffskontrolle ermöglicht.
| Rolle | Berechtigungen |
|---|---|
| Workspace-Benutzer | Nur Workbench verwenden |
| Workspace-Entwickler | API-Schlüssel erstellen und verwalten, API verwenden |
| Workspace-Administrator | Vollständige Kontrolle über Workspace-Einstellungen und Mitglieder |
| Workspace-Abrechnung | Workspace-Abrechnungsinformationen anzeigen (geerbt von der Organisationsabrechnungsrolle) |
Die Workspace-Abrechnungsrolle kann nicht manuell zugewiesen werden. Sie wird durch die Organisationsabrechnungsrolle geerbt.
Nur Organisationsadministratoren können Workspaces erstellen. Organisationsbenutzer und -entwickler müssen von einem Administrator zu Workspaces hinzugefügt werden.
Erstellen und verwalten Sie Workspaces in der Claude-Konsole.
Workspace-Einstellungen öffnen
Gehen Sie in der Claude-Konsole zu Einstellungen > Workspaces.
Einen neuen Workspace hinzufügen
Klicken Sie auf Workspace hinzufügen.
Den Workspace konfigurieren
Geben Sie einen Workspace-Namen ein und wählen Sie eine Farbe zur visuellen Identifikation.
Den Workspace erstellen
Klicken Sie auf Erstellen, um den Vorgang abzuschließen.
Um zwischen Workspaces in der Konsole zu wechseln, verwenden Sie die Workspaces-Auswahl in der oberen linken Ecke.
So ändern Sie den Namen oder die Farbe eines Workspace:
Der Standard-Workspace kann nicht umbenannt oder gelöscht werden.
Um ein Mitglied zu entfernen, klicken Sie auf das Papierkorbsymbol neben seinem Namen.
Organisationsadministratoren und Abrechnungsmitglieder können nicht aus Workspaces entfernt werden, während sie diese Organisationsrollen innehaben.
In der Registerkarte Limits können Sie Folgendes konfigurieren:
Um einen Workspace zu archivieren, klicken Sie auf das Ellipsen-Menü (...) und wählen Sie Archivieren. Das Archivieren:
Das Archivieren eines Workspace widerruft sofort alle API-Schlüssel in diesem Workspace. Diese Aktion kann nicht rückgängig gemacht werden.
Verwalten Sie Workspaces programmgesteuert mit der Admin-API.
Admin-API-Endpunkte erfordern einen Admin-API-Schlüssel (beginnend mit sk-ant-admin...), der sich von Standard-API-Schlüsseln unterscheidet. Nur Organisationsmitglieder mit der Admin-Rolle können Admin-API-Schlüssel über die Claude-Konsole bereitstellen.
# Einen Workspace erstellen
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"}'
# Workspaces auflisten
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"
# Einen Workspace archivieren
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 Response-Schemas finden Sie in der Workspaces-API-Referenz.
Fügen Sie Mitglieder zu einem Workspace hinzu, aktualisieren Sie sie oder entfernen Sie sie:
# Ein Mitglied zu einem Workspace hinzufügen
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"
}'
# Die Rolle eines Mitglieds aktualisieren
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"}'
# Ein Mitglied aus einem Workspace entfernen
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 finden Sie in der Workspace-Mitglieder-API-Referenz.
API-Schlüssel sind auf einen bestimmten Workspace beschränkt. Wenn Sie einen API-Schlüssel in einem Workspace erstellen, kann er nur auf Ressourcen innerhalb dieses Workspace zugreifen.
Ressourcen, die auf Workspaces beschränkt sind, umfassen:
Ab dem 5. Februar 2026 werden Prompt-Caches auch pro Workspace isoliert (gilt für die Claude-API und Azure nur).
Um die Workspace-IDs Ihrer Organisation abzurufen, verwenden Sie den Endpunkt Workspaces auflisten oder finden Sie sie in der Claude-Konsole.
Sie können benutzerdefinierte Ausgaben- und Ratenlimits für jeden Workspace festlegen, um Übernutzung zu verhindern und eine faire Ressourcenverteilung zu gewährleisten.
Workspace-Limits können niedriger als (aber nicht höher als) die Limits Ihrer Organisation festgelegt werden:
Detaillierte Informationen zu Ratenlimits und deren Funktionsweise finden Sie unter Ratenlimits.
Verfolgen Sie Nutzung und Kosten nach Workspace mit der Nutzungs- und Kosten-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: $ADMIN_API_KEY"Nutzung und Kosten, die dem Standard-Workspace zugeordnet sind, haben einen null-Wert für workspace_id.
Erstellen Sie separate Workspaces für Entwicklung, Staging und Produktion:
| Workspace | Zweck |
|---|---|
| Entwicklung | Testen und Experimentieren mit niedrigeren Ratenlimits |
| Staging | Pre-Production-Tests mit produktionsähnlichen Limits |
| Produktion | Live-Traffic mit vollständigen Ratenlimits und Überwachung |
Weisen Sie verschiedenen Teams Workspaces zu, um Kostenverteilung und Zugriffskontrolle zu ermöglichen:
Erstellen Sie Workspaces für spezifische Projekte oder Produkte, um Nutzung und Kosten separat zu verfolgen.
Planen Sie Ihre Workspace-Struktur
Überlegen Sie, wie Sie Workspaces organisieren werden, bevor Sie sie erstellen. Berücksichtigen Sie Abrechnungs-, Zugriffskontroll- und Nutzungsverfolgungsanforderungen.
Verwenden Sie aussagekräftige Namen
Benennen Sie Workspaces klar, um ihren Zweck anzugeben (z. B. „Production - Customer Chatbot", „Dev - Internal Tools").
Legen Sie angemessene Limits fest
Konfigurieren Sie Ausgaben- und Ratenlimits, um unerwartete Kosten zu verhindern und eine faire Ressourcenverteilung zu gewährleisten.
Überprüfen Sie den Zugriff regelmäßig
Überprüfen Sie die Workspace-Mitgliedschaft regelmäßig, um sicherzustellen, dass nur angemessene Benutzer Zugriff haben.
Überwachen Sie die Nutzung
Verwenden Sie die Nutzungs- und Kosten-API, um den Workspace-Verbrauch zu verfolgen.
Was this page helpful?