Arbeitsbereiche bieten eine Möglichkeit, Ihre API-Nutzung innerhalb einer Organisation zu organisieren. Verwenden Sie Arbeitsbereiche, um verschiedene Projekte, Umgebungen oder Teams zu trennen und gleichzeitig eine zentralisierte Abrechnung und Verwaltung beizubehalten.
Jede Organisation hat einen Standard-Arbeitsbereich, der nicht umbenannt, archiviert oder gelöscht werden kann. Wenn Sie zusätzliche Arbeitsbereiche erstellen, können Sie jedem API-Schlüssel, Mitglieder und Ressourcenlimits zuweisen.
Wichtige Merkmale:
wrkspc_ (z. B. wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)Mitglieder können in jedem Arbeitsbereich unterschiedliche Rollen haben, was eine differenzierte Zugriffskontrolle ermöglicht.
| Rolle | Berechtigungen |
|---|---|
| Arbeitsbereich-Benutzer | Verwenden Sie nur die Workbench |
| Arbeitsbereich-Entwickler mit eingeschränkten Rechten | Erstellen und verwalten Sie API-Schlüssel, verwenden Sie die API. Können nicht auf Session-Tracing-Ansichten zugreifen oder Dateien herunterladen. |
| Arbeitsbereich-Entwickler | Erstellen und verwalten Sie API-Schlüssel, verwenden Sie die API |
| Arbeitsbereich-Administrator | Vollständige Kontrolle über Arbeitsbereich-Einstellungen und Mitglieder |
| Arbeitsbereich-Abrechnung | Zeigen Sie Abrechnungsinformationen des Arbeitsbereichs an (geerbt von der Organisationsabrechnungsrolle) |
Die Arbeitsbereich-Abrechnungsrolle kann nicht manuell zugewiesen werden. Sie wird durch die Organisationsabrechnungsrolle geerbt.
Nur Organisationsadministratoren können Arbeitsbereiche erstellen. Organisationsbenutzer und Entwickler müssen von einem Administrator zu Arbeitsbereichen hinzugefügt werden.
Erstellen und verwalten Sie Arbeitsbereiche in der Claude Console.
Arbeitsbereich-Einstellungen öffnen
Gehen Sie in der Claude Console zu Einstellungen > Arbeitsbereiche.
Arbeitsbereich erstellen
Klicken Sie auf Arbeitsbereich erstellen.
Arbeitsbereich konfigurieren
Geben Sie einen Arbeitsbereich-Namen ein und wählen Sie eine Farbe zur visuellen Identifikation.
Arbeitsbereich erstellen
Klicken Sie auf Erstellen, um den Vorgang abzuschließen.
Um zwischen Arbeitsbereichen in der Console zu wechseln, verwenden Sie die Arbeitsbereiche-Auswahl in der oberen linken Ecke.
So ändern Sie den Namen oder die Farbe eines Arbeitsbereichs:
Der Standard-Arbeitsbereich 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 Arbeitsbereichen entfernt werden, während sie diese Organisationsrollen innehaben.
Auf der Registerkarte Limits können Sie Folgendes konfigurieren:
Um einen Arbeitsbereich zu archivieren, klicken Sie auf das Ellipsen-Menü (...) und wählen Sie Archivieren. Das Archivieren:
Das Archivieren eines Arbeitsbereichs widerruft sofort alle API-Schlüssel in diesem Arbeitsbereich. Diese Aktion kann nicht rückgängig gemacht werden.
Verwalten Sie Arbeitsbereiche 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 Console bereitstellen.
# Arbeitsbereich 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"}'
# Arbeitsbereiche 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"
# Arbeitsbereich 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 Arbeitsbereich hinzu, aktualisieren Sie sie oder entfernen Sie sie:
# Mitglied zu einem Arbeitsbereich 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"
}'
# 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"}'
# Mitglied aus einem Arbeitsbereich 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 Members API-Referenz.
API-Schlüssel sind auf einen bestimmten Arbeitsbereich beschränkt. Wenn Sie einen API-Schlüssel in einem Arbeitsbereich erstellen, kann er nur auf Ressourcen innerhalb dieses Arbeitsbereichs zugreifen.
Ressourcen, die auf Arbeitsbereiche beschränkt sind, umfassen:
Ab dem 5. Februar 2026 werden Prompt-Caches auch pro Arbeitsbereich isoliert (gilt für die Claude API und Azure nur).
Um die Arbeitsbereich-IDs Ihrer Organisation abzurufen, verwenden Sie den Endpunkt List Workspaces oder finden Sie sie in der Claude Console.
Sie können benutzerdefinierte Ausgaben- und Ratenlimits für jeden Arbeitsbereich festlegen, um Übernutzung zu verhindern und eine faire Ressourcenverteilung zu gewährleisten.
Arbeitsbereich-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 Arbeitsbereich 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: $ADMIN_API_KEY"Nutzung und Kosten, die dem Standard-Arbeitsbereich zugeordnet sind, haben einen null-Wert für workspace_id.
Erstellen Sie separate Arbeitsbereiche für Entwicklung, Staging und Produktion:
| Arbeitsbereich | 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 Arbeitsbereiche zu, um Kostenzuordnung und Zugriffskontrolle zu ermöglichen:
Erstellen Sie Arbeitsbereiche für spezifische Projekte oder Produkte, um Nutzung und Kosten separat zu verfolgen.
Planen Sie Ihre Arbeitsbereich-Struktur
Überlegen Sie, wie Sie Arbeitsbereiche organisieren möchten, bevor Sie sie erstellen. Berücksichtigen Sie Abrechnungs-, Zugriffskontroll- und Nutzungsverfolgungsanforderungen.
Verwenden Sie aussagekräftige Namen
Benennen Sie Arbeitsbereiche 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 Arbeitsbereich-Mitgliedschaft regelmäßig, um sicherzustellen, dass nur angemessene Benutzer Zugriff haben.
Überwachen Sie die Nutzung
Verwenden Sie die Usage and Cost API, um den Verbrauch auf Arbeitsbereich-Ebene zu verfolgen.
Was this page helpful?