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 Mitglieder, Service-Accounts, API-Keys und Ressourcenlimits zuweisen.

Wichtige Merkmale:

• Workspace-Identifikatoren verwenden das Präfix wrkspc_ (zum Beispiel wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
• Maximal 100 Workspaces pro Organisation standardmäßig (archivierte Workspaces zählen nicht); kontaktiere dein Account-Team, wenn du mehr benötigst
• Der Default Workspace hat wie jeder andere Workspace eine wrkspc_-ID (zurückgegeben im anthropic-workspace-id-Response-Header und akzeptiert von Get Workspace), erscheint aber in den Ergebnissen von List Workspaces nur, wenn du include_default=true übergibst, und API-Keys, Nutzungsberichte und Kostenberichte zeigen null für seine workspace_id an, ebenso wie API-Keys für alle Workspaces (das Feld scope eines API-Keys unterscheidet die beiden; bei einem an den Default Workspace gebundenen Key enthält es die echte ID)
• API-Keys können auf einen einzelnen Workspace beschränkt werden. In diesem Fall können sie nur auf Ressourcen innerhalb dieses Workspaces zugreifen. Einige API-Keys können Berechtigungen über mehrere Workspaces hinweg erhalten und stellen einen Workspace-ID-Header bereit, um auf Ressourcen innerhalb dieses Workspaces zuzugreifen

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 auf der Seite Rate limits 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
• Organisations-Abrechnungsmitglieder erhalten automatisch Workspace Billing-Zugriff auf alle Workspaces
• Organisations-Benutzer und -Entwickler müssen jedem Workspace explizit hinzugefügt werden
• Service-Accounts werden Workspaces unter Settings > Service accounts hinzugefügt: Wähle Add to workspace 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 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 workspace, 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ü More actions (drei Punkte) und wähle Edit details.
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 Members.
2. Klicke auf Add to workspace.
3. Wähle den Workspace, das hinzuzufügende Organisationsmitglied und seine Workspace-Rolle.
4. Klicke zur Bestätigung auf Add to workspace.

Mitglieder aus einem Workspace entfernen

1. Wähle auf der Seite Members den Workspace aus dem Dropdown-Menü Workspace aus. Wenn dort All angezeigt wird, entfernt Remove member das Mitglied stattdessen aus deiner Organisation.
2. Öffne am Ende der Zeile des Mitglieds das Menü More actions (drei Punkte) und wähle Remove member.
3. Klicke zur Bestätigung auf Remove.

Workspace-Limits festlegen

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

• Rate limits: Wähle auf der Seite Rate limits den Workspace aus dem Dropdown-Menü Workspace aus und klicke neben einem Modell auf Edit, um Limits für Anfragen pro Minute, Input-Tokens oder Output-Tokens festzulegen.
• Spend limits: Wähle den Workspace unter Settings > Workspaces aus. Klicke im sich öffnenden Bereich auf Spend limits, 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ü More actions (drei Punkte) und wähle Archive workspace. 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; die SDKs stellen 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-Referenz.

Workspace-Mitglieder verwalten

Ein Mitglied zu einem Workspace hinzufügen:

client = anthropic.Anthropic()

member = client.organization.workspaces.members.add(
    "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
    user_id="user_01XyDMpzjS89pFZXqSFUBDr6",
    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_01XyDMpzjS89pFZXqSFUBDr6",
    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_01XyDMpzjS89pFZXqSFUBDr6",
    workspace_id="wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
)

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

Vollständige Parameterdetails findest du in der Workspace-Members-API-Referenz.

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 Multi-Workspace-Key läuft in dem Workspace, der durch den anthropic-workspace-id-Header jeder Anfrage benannt wird. 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 tunnels 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 List Workspaces auf (übergib include_default=true, um den Default Workspace einzuschließen) oder finde sie 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 Default 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 geben die Workspace-ID aus den Response-Headern aus:

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 mit dem workspace_id-Feld in Usage- und Cost-API-Berichten und auf Admin-API-Objekten wie API-Keys abgleichen (beide melden null für den Default Workspace, ebenso wie API-Keys für All-Workspaces-Keys; das scope-Feld eines API-Keys unterscheidet die beiden und trägt für einen an einen Workspace gebundenen Key die echte ID dieses Workspaces)
• Prüfen, ob es die ID deines Default Workspace ist, indem du sie mit einem Admin-API-Key an Get Workspace übergibst: Der Default Workspace wird mit "name": "Default" zurückgegeben, obwohl List Workspaces 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:

• Spend limits: Begrenze die monatlichen Ausgaben für einen Workspace. Wähle dazu den Workspace unter Settings > Workspaces in der Claude Console aus. Klicke im sich öffnenden Bereich auf Spend limits.
• Rate limits: Begrenze Anfragen pro Minute, Input-Tokens pro Minute oder Output-Tokens pro Minute. Um diese festzulegen, gehe in der Claude Console zur Seite Rate limits, wähle den Workspace aus dem Dropdown-Menü Workspace aus und klicke neben einem Modell auf Edit.

Detaillierte Informationen zu Ratenlimits und deren 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 nach Workspace mit der Usage- und 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "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

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