Loading...
  • Erstellen
  • Admin
  • Modelle & Preise
  • Client-SDKs
  • API-Referenz
Search...
⌘K
Log in
Arbeitsbereiche
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Amazon Bedrock
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
Admin/Administration

Arbeitsbereiche

Organisieren Sie API-Schlüssel, verwalten Sie Teamzugriff und kontrollieren Sie Kosten mit Arbeitsbereichen.

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.

Funktionsweise von Arbeitsbereichen

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:

  • Arbeitsbereich-Identifikatoren verwenden das Präfix wrkspc_ (z. B. wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
  • Maximal 100 Arbeitsbereiche pro Organisation (archivierte Arbeitsbereiche zählen nicht)
  • Standard-Arbeitsbereich hat keine ID und erscheint nicht in List-Endpunkten
  • API-Schlüssel sind auf einen einzelnen Arbeitsbereich beschränkt und können nur auf Ressourcen innerhalb dieses Arbeitsbereichs zugreifen

Arbeitsbereich-Rollen und Berechtigungen

Mitglieder können in jedem Arbeitsbereich unterschiedliche Rollen haben, was eine differenzierte Zugriffskontrolle ermöglicht.

RolleBerechtigungen
Arbeitsbereich-BenutzerVerwenden Sie nur die Workbench
Arbeitsbereich-Entwickler mit eingeschränkten RechtenErstellen und verwalten Sie API-Schlüssel, verwenden Sie die API. Können nicht auf Session-Tracing-Ansichten zugreifen oder Dateien herunterladen.
Arbeitsbereich-EntwicklerErstellen und verwalten Sie API-Schlüssel, verwenden Sie die API
Arbeitsbereich-AdministratorVollständige Kontrolle über Arbeitsbereich-Einstellungen und Mitglieder
Arbeitsbereich-AbrechnungZeigen Sie Abrechnungsinformationen des Arbeitsbereichs an (geerbt von der Organisationsabrechnungsrolle)

Rollenvererbung

  • Organisationsadministratoren erhalten automatisch Arbeitsbereich-Administrator-Zugriff auf alle Arbeitsbereiche
  • Organisationsmitglieder mit Abrechnungsrolle erhalten automatisch Arbeitsbereich-Abrechnungszugriff auf alle Arbeitsbereiche
  • Organisationsbenutzer und Entwickler müssen explizit zu jedem Arbeitsbereich hinzugefügt werden

Die Arbeitsbereich-Abrechnungsrolle kann nicht manuell zugewiesen werden. Sie wird durch die Organisationsabrechnungsrolle geerbt.

Verwalten von Arbeitsbereichen

Nur Organisationsadministratoren können Arbeitsbereiche erstellen. Organisationsbenutzer und Entwickler müssen von einem Administrator zu Arbeitsbereichen hinzugefügt werden.

Über die Claude Console

Erstellen und verwalten Sie Arbeitsbereiche in der Claude Console.

Arbeitsbereich erstellen

  1. 1

    Arbeitsbereich-Einstellungen öffnen

    Gehen Sie in der Claude Console zu Einstellungen > Arbeitsbereiche.

  2. 2

    Arbeitsbereich erstellen

    Klicken Sie auf Arbeitsbereich erstellen.

  3. 3

    Arbeitsbereich konfigurieren

    Geben Sie einen Arbeitsbereich-Namen ein und wählen Sie eine Farbe zur visuellen Identifikation.

  4. 4

    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.

Arbeitsbereich-Details bearbeiten

So ändern Sie den Namen oder die Farbe eines Arbeitsbereichs:

  1. Wählen Sie den Arbeitsbereich aus der Liste aus
  2. Klicken Sie auf das Ellipsen-Menü (...) und wählen Sie Details bearbeiten
  3. Aktualisieren Sie den Namen oder die Farbe und speichern Sie Ihre Änderungen

Der Standard-Arbeitsbereich kann nicht umbenannt oder gelöscht werden.

Mitglieder zu einem Arbeitsbereich hinzufügen

  1. Navigieren Sie zur Registerkarte Mitglieder des Arbeitsbereichs
  2. Klicken Sie auf Zum Arbeitsbereich hinzufügen
  3. Wählen Sie ein Organisationsmitglied aus und weisen Sie ihm eine Arbeitsbereich-Rolle zu
  4. Bestätigen Sie das Hinzufügen

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.

Arbeitsbereich-Limits festlegen

Auf der Registerkarte Limits können Sie Folgendes konfigurieren:

  • Ratenlimits: Legen Sie Limits pro Modell-Tier für Anfragen pro Minute, Eingabe-Token oder Ausgabe-Token fest
  • Ausgabenmitteilungen: Konfigurieren Sie Warnungen, wenn die Ausgaben bestimmte Schwellenwerte erreichen

Arbeitsbereich archivieren

Um einen Arbeitsbereich zu archivieren, klicken Sie auf das Ellipsen-Menü (...) und wählen Sie Archivieren. Das Archivieren:

  • Bewahrt historische Daten für Berichte
  • Deaktiviert den Arbeitsbereich und alle zugehörigen API-Schlüssel
  • Kann nicht rückgängig gemacht werden

Das Archivieren eines Arbeitsbereichs widerruft sofort alle API-Schlüssel in diesem Arbeitsbereich. Diese Aktion kann nicht rückgängig gemacht werden.

Über die Admin API

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.

Verwalten von Arbeitsbereich-Mitgliedern

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 und Ressourcen-Scoping

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:

  • Dateien, die über die Files API erstellt wurden
  • Message Batches, die über die Batch API erstellt wurden
  • Skills, die über die Skills API erstellt wurden

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.

Arbeitsbereich-Limits

Sie können benutzerdefinierte Ausgaben- und Ratenlimits für jeden Arbeitsbereich festlegen, um Übernutzung zu verhindern und eine faire Ressourcenverteilung zu gewährleisten.

Festlegen von Arbeitsbereich-Limits

Arbeitsbereich-Limits können niedriger als (aber nicht höher als) die Limits Ihrer Organisation festgelegt werden:

  • Ausgabenlimits: Begrenzen Sie die monatlichen Ausgaben für einen Arbeitsbereich
  • Ratenlimits: Begrenzen Sie Anfragen pro Minute, Eingabe-Token pro Minute oder Ausgabe-Token pro Minute
  • Sie können keine Limits für den Standard-Arbeitsbereich festlegen
  • Falls nicht festgelegt, entsprechen Arbeitsbereich-Limits den Organisationslimits
  • Organisationsweite Limits gelten immer, auch wenn Arbeitsbereich-Limits zusammen mehr ergeben

Detaillierte Informationen zu Ratenlimits und deren Funktionsweise finden Sie unter Ratenlimits.

Nutzungs- und Kostenverfolgung

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.

Häufige Anwendungsfälle

Umgebungstrennung

Erstellen Sie separate Arbeitsbereiche für Entwicklung, Staging und Produktion:

ArbeitsbereichZweck
EntwicklungTesten und Experimentieren mit niedrigeren Ratenlimits
StagingPre-Production-Tests mit produktionsähnlichen Limits
ProduktionLive-Traffic mit vollständigen Ratenlimits und Überwachung

Team- oder Abteilungsisolation

Weisen Sie verschiedenen Teams Arbeitsbereiche zu, um Kostenzuordnung und Zugriffskontrolle zu ermöglichen:

  • Engineering-Team mit Entwicklerzugriff
  • Data-Science-Team mit eigenen API-Schlüsseln
  • Support-Team mit eingeschränktem Zugriff für Kundentools

Projektbasierte Organisation

Erstellen Sie Arbeitsbereiche für spezifische Projekte oder Produkte, um Nutzung und Kosten separat zu verfolgen.

Best Practices

  1. 1

    Planen Sie Ihre Arbeitsbereich-Struktur

    Überlegen Sie, wie Sie Arbeitsbereiche organisieren möchten, bevor Sie sie erstellen. Berücksichtigen Sie Abrechnungs-, Zugriffskontroll- und Nutzungsverfolgungsanforderungen.

  2. 2

    Verwenden Sie aussagekräftige Namen

    Benennen Sie Arbeitsbereiche klar, um ihren Zweck anzugeben (z. B. „Production - Customer Chatbot", „Dev - Internal Tools").

  3. 3

    Legen Sie angemessene Limits fest

    Konfigurieren Sie Ausgaben- und Ratenlimits, um unerwartete Kosten zu verhindern und eine faire Ressourcenverteilung zu gewährleisten.

  4. 4

    Überprüfen Sie den Zugriff regelmäßig

    Überprüfen Sie die Arbeitsbereich-Mitgliedschaft regelmäßig, um sicherzustellen, dass nur angemessene Benutzer Zugriff haben.

  5. 5

    Überwachen Sie die Nutzung

    Verwenden Sie die Usage and Cost API, um den Verbrauch auf Arbeitsbereich-Ebene zu verfolgen.

Häufig gestellte Fragen

Siehe auch

  • Admin API-Übersicht
  • Admin API-Referenz
  • Ratenlimits
  • Usage and Cost API

Was this page helpful?

  • Funktionsweise von Arbeitsbereichen
  • Arbeitsbereich-Rollen und Berechtigungen
  • Rollenvererbung
  • Verwalten von Arbeitsbereichen
  • Über die Claude Console
  • Über die Admin API
  • Verwalten von Arbeitsbereich-Mitgliedern
  • API-Schlüssel und Ressourcen-Scoping
  • Arbeitsbereich-Limits
  • Festlegen von Arbeitsbereich-Limits
  • Nutzungs- und Kostenverfolgung
  • Häufige Anwendungsfälle
  • Umgebungstrennung
  • Team- oder Abteilungsisolation
  • Projektbasierte Organisation
  • Best Practices
  • Häufig gestellte Fragen
  • Siehe auch