• Nachrichten
  • Managed Agents
  • Admin
Search...
⌘K
Organisation
Admin APIWorkspaces
Authentifizierung
ÜbersichtWorkload Identity FederationWIF-Referenz
Monitoring
Usage and Cost APIRate Limits APIClaude Code Analytics API
Daten & Compliance
DatenresidenzAPI und Datenaufbewahrung
Compliance API
ÜbersichtZugriff erhaltenAktivitäts-FeedChats, Dateien und ProjekteOrganisationen, Benutzer, Rollen und GruppenIntegration entwerfenFehlerFAQ
Log in
Workspaces
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/Organisation

Workspaces

Organisiere API-Keys, verwalte Teamzugriffe und kontrolliere Kosten mit Workspaces.

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.

Wie Workspaces funktionieren

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:

  • Workspace-Identifier verwenden das Präfix wrkspc_ (zum Beispiel wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
  • Maximal 100 Workspaces pro Organisation (archivierte Workspaces zählen nicht)
  • Default Workspace hat keine ID und erscheint nicht in List-Endpunkten
  • API-Keys sind auf einen einzelnen Workspace beschränkt und können nur auf Ressourcen innerhalb dieses Workspace zugreifen

Claude Code-Workspace

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:

  • Claude Code erstellt bei der Anmeldung einen benutzerspezifischen API-Key in diesem Workspace. Du kannst darin keine Keys manuell über die Console erstellen.
  • Ein Claude Code-Key funktioniert nicht mehr, wenn sein Besitzer aus dem Workspace oder der Organisation entfernt wird – anders als bei Standard-Workspace-Keys.
  • Die Claude Code-Nutzung unterliegt einem separaten Ratenlimit, und Admins können ihren Anteil an den Limits der Organisation unter Settings > Workspaces begrenzen.
  • Es ist der einzige Workspace, der monatliche Ausgabenlimits pro Benutzer unterstützt.

Das Archivieren des Claude Code-Workspace deaktiviert die Claude Code-Anmeldung über die Console-Abrechnung für die gesamte Organisation.

Workspace-Rollen und -Berechtigungen

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

RolleBerechtigungen
Workspace UserNur die Workbench verwenden
Workspace Limited DeveloperAPI-Keys erstellen und verwalten, die API verwenden. Kein Zugriff auf Session-Tracing-Ansichten oder Datei-Downloads.
Workspace DeveloperAPI-Keys erstellen und verwalten, die API verwenden
Workspace AdminVolle Kontrolle über Workspace-Einstellungen und -Mitglieder
Workspace BillingAbrechnungsinformationen des Workspace einsehen (geerbt von der Organisations-Billing-Rolle)

Rollenvererbung

  • Organisations-Admins erhalten automatisch Workspace-Admin-Zugriff auf alle Workspaces
  • Organisations-Billing-Mitglieder erhalten automatisch Workspace-Billing-Zugriff auf alle Workspaces
  • Organisations-User und -Developer müssen jedem Workspace explizit hinzugefügt werden

Die Workspace-Billing-Rolle kann nicht manuell zugewiesen werden. Sie wird von der Organisations-Billing-Rolle geerbt.

Workspaces verwalten

Nur Organisations-Admins können Workspaces erstellen. Organisations-User und -Developer müssen von einem Admin zu Workspaces hinzugefügt werden.

Über die Console

Erstelle und verwalte Workspaces in der Claude Console.

Einen Workspace erstellen

  1. 1

    Workspace-Einstellungen öffnen

    Gehe in der Claude Console zu Settings > Workspaces.

  2. 2

    Einen Workspace erstellen

    Klicke auf Create workspace.

  3. 3

    Den Workspace konfigurieren

    Gib einen Workspace-Namen ein und wähle eine Farbe zur visuellen Identifikation.

  4. 4

    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.

Workspace-Details bearbeiten

So änderst du den Namen oder die Farbe eines Workspace:

  1. Wähle den Workspace aus der Liste aus
  2. Klicke auf das Auslassungsmenü (...) und wähle Edit details
  3. Aktualisiere den Namen oder die Farbe und speichere deine Änderungen

Der Default Workspace kann nicht umbenannt oder gelöscht werden.

Mitglieder zu einem Workspace hinzufügen

  1. Navigiere zum Tab Members des Workspace
  2. Klicke auf Add to Workspace
  3. Wähle ein Organisationsmitglied aus und weise ihm eine Workspace-Rolle zu
  4. Bestätige das Hinzufügen

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.

Workspace-Limits festlegen

Im Tab Limits kannst du Folgendes konfigurieren:

  • Ratenlimits: Lege Limits pro Modellstufe für Anfragen pro Minute, Input-Token oder Output-Token fest
  • Ausgabenbenachrichtigungen: Konfiguriere Benachrichtigungen, wenn die Ausgaben bestimmte Schwellenwerte erreichen

Einen Workspace archivieren

Um einen Workspace zu archivieren, klicke auf das Auslassungsmenü (...) und wähle Archive. Das Archivieren:

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

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.

Über die Admin-API

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.

cURL
# 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.

Workspace-Mitglieder verwalten

Füge Mitglieder zu einem Workspace hinzu, aktualisiere oder entferne sie:

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

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:

  • 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

Einige Ressourcen werden auf Organisationsebene verwaltet und können nicht mit einem Workspace-API-Key verwaltet werden:

  • MCP-Tunnel werden mit einem organisationsweiten OAuth-Token (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.
  • Workspaces selbst und Organisationsmitglieder werden über die Admin-API verwaltet, die einen Admin-API-Key erfordert.

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.

Workspace-Limits

Du kannst benutzerdefinierte Ausgaben- und Ratenlimits für jeden Workspace festlegen, um vor Übernutzung zu schützen und eine faire Ressourcenverteilung sicherzustellen.

Workspace-Limits festlegen

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

  • Ausgabenlimits: Begrenze die monatlichen Ausgaben für einen Workspace
  • Ratenlimits: Begrenze Anfragen pro Minute, Input-Token pro Minute oder Output-Token pro Minute
  • Du kannst keine Limits für den Default Workspace festlegen
  • Wenn nicht festgelegt, entsprechen die Workspace-Limits den Limits der Organisation
  • Organisationsweite Limits gelten immer, auch wenn die Workspace-Limits in Summe höher sind

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.

Nutzungs- und Kostenverfolgung

Verfolge Nutzung und Kosten pro Workspace mit der Usage-and-Cost-API:

cURL
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.

Häufige Anwendungsfälle

Trennung von Umgebungen

Erstelle separate Workspaces für Entwicklung, Staging und Produktion:

WorkspaceZweck
DevelopmentTesten und Experimentieren mit niedrigeren Ratenlimits
StagingVorproduktionstests mit produktionsähnlichen Limits
ProductionLive-Traffic mit vollen Ratenlimits und Monitoring

Team- oder Abteilungsisolation

Weise Workspaces verschiedenen Teams zu, um Kosten zuzuordnen und Zugriffe zu kontrollieren:

  • Engineering-Team mit Developer-Zugriff
  • Data-Science-Team mit eigenen API-Keys
  • Support-Team mit eingeschränktem Zugriff für Kunden-Tools

Projektbasierte Organisation

Erstelle Workspaces für bestimmte Projekte oder Produkte, um Nutzung und Kosten separat zu verfolgen.

Best Practices

  1. 1

    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.

  2. 2

    Verwende aussagekräftige Namen

    Benenne Workspaces klar, um ihren Zweck anzugeben (zum Beispiel „Production - Customer Chatbot", „Dev - Internal Tools").

  3. 3

    Lege angemessene Limits fest

    Konfiguriere Ausgaben- und Ratenlimits, um unerwartete Kosten zu vermeiden und eine faire Ressourcenverteilung sicherzustellen.

  4. 4

    Überprüfe Zugriffe regelmäßig

    Überprüfe die Workspace-Mitgliedschaft regelmäßig, um sicherzustellen, dass nur berechtigte Benutzer Zugriff haben.

  5. 5

    Überwache die Nutzung

    Verwende die Usage-and-Cost-API, um den Verbrauch auf Workspace-Ebene zu verfolgen.

FAQ

Siehe auch

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

Was this page helpful?

  • Wie Workspaces funktionieren
  • Claude Code-Workspace
  • Workspace-Rollen und -Berechtigungen
  • Rollenvererbung
  • Workspaces verwalten
  • Über die Console
  • Über die Admin-API
  • Workspace-Mitglieder verwalten
  • API-Keys und Ressourcen-Scoping
  • Workspace-Limits
  • Workspace-Limits festlegen
  • Nutzungs- und Kostenverfolgung
  • Häufige Anwendungsfälle
  • Trennung von Umgebungen
  • Team- oder Abteilungsisolation
  • Projektbasierte Organisation
  • Best Practices
  • FAQ
  • Siehe auch