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 Standard-Workspace, der nicht umbenannt, archiviert oder gelöscht werden kann. Wenn du zusätzliche Workspaces erstellst, kannst du jedem davon Mitglieder, Service-Accounts, API-Keys und Ressourcenlimits zuweisen.

Wichtige Merkmale:

• Workspace-Kennungen verwenden das Präfix wrkspc_ (zum Beispiel wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ).
• Maximal 100 Workspaces pro Organisation standardmäßig (archivierte Workspaces zählen nicht mit). Wende dich an dein Account-Team, wenn du mehr benötigst.
• Der Standard-Workspace hat wie jeder andere Workspace eine wrkspc_-ID (zurückgegeben im anthropic-workspace-id-Response-Header und akzeptiert von Workspace abrufenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren.), erscheint aber in den Ergebnissen von Workspaces auflistenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. nur, wenn du include_default=true übergibst. Die Usage and Cost Analytics API meldet seine Nutzung und Kosten unter dieser ID, während die Berichte der veralteten Usage and Cost API für seine workspace_id den Wert null anzeigen (das scope-Feld eines API-Keys enthält die echte ID für einen Key, der an den Standard-Workspace gebunden ist).
• API-Keys können auf einen einzelnen Workspace beschränkt werden. In diesem Fall können sie nur auf Ressourcen innerhalb dieses Workspace zugreifen. Andere API-Keys sind nicht auf einen Workspace beschränkt. Sende mit einem dieser Keys bei jeder Anfrage einen Workspace-ID-Header, um den Workspace auszuwählen. Der Benutzer oder Service-Account des Keys muss Zugriff auf diesen Workspace haben.

Claude Code-Workspace

Wenn ein Mitglied deiner Organisation sich zum ersten Mal bei Claude Code mit seinem Claude Console-Account anmeldet, erstellt Anthropic automatisch einen Claude Code-Workspace in der Organisation und fügt dieses Mitglied hinzu. Jedes nachfolgende Mitglied, das sich bei Claude Code anmeldet, wird auf dieselbe 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 ein Workspace-Key.
• Die Claude Code-Nutzung unterliegt separaten Ratenlimits, und Admins können ihren Anteil an den Limits der Organisation unter Ratenlimits in der Claude Console begrenzen.
• Es ist der einzige Workspace, der benutzerspezifische monatliche Ausgabenlimits unterstützt.

Workspace-Rollen und -Berechtigungen

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

Rollenvererbung

• Organisations-Admins erhalten automatisch Workspace Admin-Zugriff auf alle Workspaces.
• Abrechnungsmitglieder der Organisation erhalten automatisch Workspace Billing-Zugriff auf alle Workspaces.
• Benutzer und Entwickler der Organisation müssen explizit zu jedem Workspace hinzugefügt werden.
• Service-Accounts werden auf der Seite Dienstkonten (platform.claude.com/settings/service-accounts) in der Claude Console zu Workspaces hinzugefügt: Wähle Zum Workspace hinzufügen im Menü des Accounts oder auf seiner eigenen Seite. Um die Accounts in einem Workspace zu sehen, filtere die Liste nach Workspace.

Workspaces verwalten

Verwendung der Console

Erstelle und verwalte Workspaces auf der Seite Arbeitsbereiche in der Claude Console.

Einen Workspace erstellen

1. 1

   Workspace-Einstellungen öffnen

   Gehe in der Claude Console zur Seite Arbeitsbereiche (platform.claude.com/settings/workspaces).

2. 2

   Die Seite „Workspace erstellen“ öffnen

   Klicke auf Workspace erstellen, um die Seite Workspace erstellen (platform.claude.com/settings/workspaces/new) in der Console zu öffnen.

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 Workspace erstellen, um den Vorgang abzuschließen.

Workspace-Details bearbeiten

Um den Namen oder die Farbe eines Workspaces zu ändern:

1. Wähle den Workspace aus der Liste aus.
2. Öffne das Menü Weitere Aktionen (drei Punkte) und wähle Details bearbeiten.
3. Aktualisiere den Namen oder die Farbe und speichere deine Änderungen.

Mitglieder zu einem Workspace hinzufügen

1. Gehe in der Claude Console zur Seite Mitglieder (platform.claude.com/settings/members).
2. Klicke auf Zum Workspace hinzufügen.
3. Wähle den Workspace, das hinzuzufügende Organisationsmitglied und seine Workspace-Rolle.
4. Klicke zur Bestätigung auf Zum Workspace hinzufügen.

Mitglieder aus einem Workspace entfernen

1. Wähle auf der Seite Mitglieder in der Claude Console den Workspace aus dem Dropdown-Menü Arbeitsbereich aus. Wenn dort Alle angezeigt wird, entfernt Mitglied entfernen das Mitglied stattdessen aus deiner Organisation.
2. Öffne am Ende der Zeile des Mitglieds das Menü Weitere Aktionen (drei Punkte) und wähle Mitglied entfernen.
3. Klicke zur Bestätigung auf Entfernen.

Workspace-Limits festlegen

Ratenlimits und Ausgabenlimits eines Workspaces legst du an unterschiedlichen Stellen fest:

• Ratenlimits: Wähle unter Ratenlimits in der Claude Console den Workspace im Dropdown-Menü Arbeitsbereich aus und klicke neben einem Modell auf Bearbeiten, um Limits für Anfragen pro Minute, Eingabe-Token oder Ausgabe-Token festzulegen.
• Ausgabenlimits: Wähle auf der Seite Arbeitsbereiche in der Claude Console den Workspace aus. Klicke im sich öffnenden Bereich auf Ausgabenlimits, um die monatlichen Ausgaben zu begrenzen und Benachrichtigungen zu konfigurieren, wenn die Ausgaben bestimmte Schwellenwerte erreichen.

Einen Workspace archivieren

Um einen Workspace zu archivieren, öffne sein Menü Weitere Aktionen (drei Punkte) und wähle Workspace archivieren. Das Archivieren:

• Bewahrt historische Daten für Berichte auf
• Deaktiviert den Workspace und archiviert jeden für ihn erstellten API-Key
• Kann nicht rückgängig gemacht werden

Verwendung der Admin-API

Verwalte Workspaces programmatisch mit der Admin-API.

Die folgenden SDK- und CLI-Beispiele erstellen den Standard-Client, der den Admin-API-Key aus der Umgebungsvariable ANTHROPIC_API_KEY liest; das SDK stellt diese Endpunkte unter client.organization.workspaces bereit. SDK-Listenmethoden rufen weitere Seiten bei Bedarf ab, daher legt limit die Seitengröße fest; die PHP-, Ruby- und curl-Beispiele geben eine Seite zurück.

Einen Workspace erstellen:

client = anthropic.Anthropic()

workspace = client.organization.workspaces.create(name="Production")

print(f"id: {workspace.id}")
print(f"name: {workspace.name}")

Workspaces auflisten:

client = anthropic.Anthropic()

workspaces = client.organization.workspaces.list(limit=10, include_archived=False)

for workspace in workspaces:
    print(f"{workspace.id}: {workspace.name}")

Einen Workspace archivieren:

client = anthropic.Anthropic()

workspace = client.organization.workspaces.archive("wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ")

print(f"id: {workspace.id}")
print(f"archived_at: {workspace.archived_at}")

Vollständige Parameterdetails und Response-Schemas findest du in der Workspaces-API-ReferenzVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren..

Workspace-Mitglieder verwalten

Ein Mitglied zu einem Workspace hinzufügen:

client = anthropic.Anthropic()

member = client.organization.workspaces.members.add(
    "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
    user_id="user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_role="workspace_developer",
)

print(f"user_id: {member.user_id}")
print(f"workspace_role: {member.workspace_role}")

Die Rolle eines Mitglieds aktualisieren:

client = anthropic.Anthropic()

member = client.organization.workspaces.members.update(
    "user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_id="wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
    workspace_role="workspace_admin",
)

print(f"user_id: {member.user_id}")
print(f"workspace_role: {member.workspace_role}")

Ein Mitglied aus einem Workspace entfernen:

client = anthropic.Anthropic()

removed_member = client.organization.workspaces.members.remove(
    "user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_id="wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
)

print(f"user_id: {removed_member.user_id}")

Vollständige Parameterdetails findest du in der Workspace-Members-API-ReferenzVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren..

API-Keys und Ressourcen-Scoping

Jede Anfrage läuft in genau einem Workspace und kann nur auf Ressourcen innerhalb dieses Workspaces zugreifen. Welcher Workspace, hängt vom Key-Typ ab:

• Ein Workspace-Key (ein veralteter Key ohne Besitzer) gehört zu dem Workspace, in dem er erstellt wurde, und läuft immer dort.
• Ein persönlicher Key oder Service-Account-Key agiert als sein Benutzer oder Service-Account. Ein Single-Workspace-Key läuft immer in dem Workspace, der bei seiner Erstellung gewählt wurde. Ein Key, der nicht auf einen Workspace beschränkt ist, läuft in dem Workspace, der im anthropic-workspace-id-Header der jeweiligen Anfrage angegeben ist. Accounts müssen Zugriff auf den Workspace haben, um ihn zu verwenden.

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 anders verwaltet:

• MCP-Tunnel werden mit einem workspace:manage_tunnels-OAuth-Token verwaltet, das über Workload Identity Federation erhalten wird, nicht mit einem API-Key. Tunnel werden in einem Workspace erstellt, und die Console-Liste MCP-Tunnel sowie der Managed-Agent-Server-Picker zeigen nur Tunnel im aktuellen Workspace; das Limit von 10 aktiven Tunneln gilt organisationsweit. Die Tunnelverwaltung erfordert eine Rolle mit Tunnelverwaltungsberechtigungen; Organisationsentwickler können sie anzeigen, aber nicht ändern.
• Workspaces selbst und Organisationsmitglieder werden auf Organisationsebene über die Admin-API verwaltet, unter Verwendung eines Admin-API-Keys, eines org:admin-OAuth-Tokens oder eines persönlichen oder Service-Account-Keys, der nicht auf einen bestimmten Workspace beschränkt ist.

Um die Workspace-IDs deiner Organisation nachzuschlagen, rufe den Endpunkt Workspaces auflistenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. auf (übergib include_default=true, um den Standard-Workspace einzuschließen), oder finde sie auf der Seite Arbeitsbereiche in der Claude Console.

Den Workspace hinter einer API-Antwort identifizieren

Claude-API-Antworten enthalten einen anthropic-workspace-id-Header neben den Response-Headern request-id und anthropic-organization-id. Sein Wert ist die mit wrkspc_ präfixierte ID des Workspaces, zu dem der API-Key oder das Access-Token der Anfrage aufgelöst wurde, auch wenn dieser Workspace der Standard-Workspace ist. Zum Beispiel enthält eine erfolgreiche Antwort Header wie diese:

HTTP/1.1 200 OK
request-id: req_018EeWyXxfu5pfWkrYcMdjWG
anthropic-organization-id: 0d0e7a3b-52f1-4c7e-9a51-3f6f2f7c1b9e
anthropic-workspace-id: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ

Der Header fehlt, wenn die Anmeldeinformation nicht zu einem Workspace aufgelöst wird (zum Beispiel bei Admin-API-Anfragen) oder wenn die Anfrage fehlschlägt, bevor die Authentifizierung abgeschlossen ist, etwa bei einem 401-Fehler.

Die folgenden Beispiele senden eine Messages-API-Anfrage und lesen die Workspace-ID aus den Response-Headern:

client = anthropic.Anthropic()

response = client.messages.with_raw_response.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)
workspace_id = response.headers.get("anthropic-workspace-id")
print(f"Workspace ID: {workspace_id}")

Workspace ID: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ

Dieselben Accessoren lesen den Header auch von anderen Claude-API-Endpunkten, einschließlich der Claude Managed Agents-APIs. Lies zum Beispiel anthropic-workspace-id aus der Antwort, die eine Session erstellt, um festzuhalten, zu welchem Workspace die Session gehört.

Mit der Workspace-ID aus einer Antwort kannst du:

• Bestätigen, auf welche Nutzung, Kosten und Ratenlimits welches Workspaces die Anfrage angerechnet wurde
• Sie abgleichen mit dem Feld workspace_id in Zeilen der Usage and Cost Analytics API, die für den Standard-Workspace dieselbe ID enthalten, sowie mit dem Feld scope von API-Keys in der Admin API, das die echte ID des Workspaces enthält, an den ein Key gebunden ist, einschließlich des Standard-Workspace
• Prüfen, ob es die ID deines Standard-Workspace ist, indem du sie mit einem Admin-API-Key an Workspace abrufenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. übergibst: Der Standard-Workspace wird mit "name": "Default" zurückgegeben, obwohl Workspaces auflistenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. ihn auslässt, sofern du nicht include_default=true übergibst
• Diesen Workspace in der Console öffnen, um die Ressourcen der Anfrage zu finden, wie Sessions, Dateien, Message Batches und Skills

Workspace-Limits

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

Workspace-Limits festlegen

Du kannst Workspace-Limits niedriger (aber nicht höher) als die Limits deiner Organisation festlegen:

• Ausgabenlimits: Begrenze die monatlichen Ausgaben für einen Workspace. Um diese festzulegen, gehe in der Claude Console zur Seite Arbeitsbereiche (platform.claude.com/settings/workspaces) und wähle den Workspace aus. Klicke im sich öffnenden Bereich auf Ausgabenlimits.
• Ratenlimits: Begrenze Anfragen pro Minute, Eingabe-Token pro Minute oder Ausgabe-Token pro Minute. Gehe dazu zu Ratenlimits in der Claude Console, wähle den Workspace im Dropdown-Menü Arbeitsbereich aus und klicke neben einem Modell auf Bearbeiten.

Ausführliche Informationen zu „rate limits“ (Ratenlimits) und ihrer Funktionsweise findest du unter Ratenlimits. Du kannst außerdem die aktuellen Ratenlimits deiner Organisation und deiner Workspaces abrufen und Workspace-Ratenlimits programmatisch mit der Rate Limits API festlegen. Diese speichert auch einen Wert oberhalb des Limits der Organisation, erzwingt aber dennoch den niedrigeren der beiden Werte.

Nutzungs- und Kostenverfolgung

Verfolge Nutzung und Kosten nach Workspace mit der Usage and Cost Analytics API:

client = anthropic.Anthropic()

rows = client.beta.organization.analytics.usage.list(
    starting_at="2026-09-01T00:00:00Z",
    ending_at="2026-09-08T00:00:00Z",
    time_bucket_width="1d",
    workspace_ids=["wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"],
    group_by=["workspace_id"],
)

for row in rows:
    print(f"{row.starting_at} {row.group.workspace_id}: {row.usage.total_tokens}")

Nutzung und Kosten im Standard-Workspace werden unter der eigenen ID des Standard-Workspace gemeldet.

Häufige Anwendungsfälle

Umgebungstrennung

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

Team- oder Abteilungsisolierung

Weise verschiedenen Teams Workspaces für Kostenzuordnung und Zugriffskontrolle zu:

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

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, wie du Workspaces organisieren wirst, bevor du sie erstellst. Denke an Abrechnungs-, Zugriffskontroll- und Nutzungsverfolgungsbedürfnisse.

2. 2

   Verwende aussagekräftige Namen

   Benenne Workspaces klar, um ihren Zweck anzugeben (zum Beispiel „Production - Customer Chatbot“ oder „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 den Zugriff regelmäßig

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

5. 5

   Überwache die Nutzung

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

FAQ

Siehe auch

• Admin-API
• Admin-API-Referenz
• Ratenlimits
• Usage and Cost Analytics API und die veraltete Usage and Cost API