Espaces de travail

Les espaces de travail offrent un moyen d’organiser votre utilisation de l’API au sein d’une organisation. Utilisez les espaces de travail pour séparer différents projets, environnements ou équipes tout en maintenant une facturation et une administration centralisées.

Fonctionnement des espaces de travail

Chaque organisation dispose d’un espace de travail par défaut qui ne peut pas être renommé, archivé ou supprimé. Lorsque vous créez des espaces de travail supplémentaires, vous pouvez attribuer des membres, des comptes de service, des clés API et des limites de ressources à chacun.

Caractéristiques principales :

• Les identifiants d’espace de travail utilisent le préfixe wrkspc_ (par exemple, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ).
• 100 espaces de travail maximum par organisation par défaut (les espaces de travail archivés ne sont pas comptabilisés). Contactez votre équipe de compte si vous en avez besoin de plus.
• L’espace de travail par défaut possède un ID wrkspc_ comme tout autre espace de travail (renvoyé dans l’en-tête de réponse anthropic-workspace-id et accepté par Obtenir un espace de travailAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir.), mais il n’apparaît dans les résultats de Lister les espaces de travailAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir. que si vous transmettez include_default=true. L’API Usage and Cost Analytics rapporte son utilisation et son coût sous cet ID, tandis que les rapports de l’ancienne API d’utilisation et de coûts affichent null pour son workspace_id (le champ scope d’une clé API contient l’ID réel pour une clé liée à l’espace de travail par défaut).
• Les clés API peuvent être limitées à un seul espace de travail. Dans ce cas, elles ne peuvent accéder qu’aux ressources de cet espace de travail. Les autres clés API ne sont pas limitées à un espace de travail. Avec l’une de ces clés, envoyez un en-tête d’ID d’espace de travail à chaque requête pour choisir l’espace de travail. L’utilisateur ou le compte de service de la clé doit avoir accès à cet espace de travail.

Espace de travail Claude Code

Lorsqu’un membre de votre organisation se connecte pour la première fois à Claude Code avec son compte Claude Console, Anthropic crée automatiquement un espace de travail Claude Code dans l’organisation et y ajoute ce membre. Chaque membre suivant qui se connecte à Claude Code est ajouté de la même manière.

L’espace de travail Claude Code maintient le trafic Claude Code séparé de vos autres charges de travail API :

• Claude Code génère une clé API par utilisateur dans cet espace de travail lors de la connexion. Vous ne pouvez pas y créer de clés manuellement depuis la Console.
• Une clé Claude Code cesse de fonctionner si son propriétaire est retiré de l’espace de travail ou de l’organisation, contrairement à une clé d’espace de travail.
• L’utilisation de Claude Code fait l’objet d’une limite de débit distincte, et les administrateurs peuvent plafonner sa part des limites de l’organisation sous Limites de débit dans la Claude Console.
• C’est le seul espace de travail qui prend en charge les limites de dépenses mensuelles par utilisateur.

Rôles et permissions des workspaces

Les membres peuvent avoir différents rôles dans chaque espace de travail, permettant un contrôle d’accès granulaire.

Héritage des rôles

• Les administrateurs de l’organisation reçoivent automatiquement l’accès Administrateur de l’espace de travail à tous les espaces de travail.
• Les membres de facturation de l’organisation reçoivent automatiquement l’accès Facturation de l’espace de travail à tous les espaces de travail.
• Les utilisateurs et développeurs de l’organisation doivent être ajoutés explicitement à chaque espace de travail.
• Les comptes de service sont ajoutés aux espaces de travail sur la page Comptes de service (platform.claude.com/settings/service-accounts) de la Claude Console : sélectionnez Ajouter à l’espace de travail dans le menu du compte ou sur sa propre page. Pour voir les comptes d’un espace de travail, filtrez la liste par espace de travail.

Gestion des espaces de travail

Utilisation de la Console

Créez et gérez des espaces de travail sur la page Espaces de travail de la Claude Console.

Créer un espace de travail

1. 1

   Ouvrir les paramètres de l’espace de travail

   Dans la Claude Console, accédez à la page Espaces de travail (platform.claude.com/settings/workspaces).

2. 2

   Ouvrir la page « Créer un espace de travail »

   Cliquez sur Créer un espace de travail pour ouvrir la page Créer un espace de travail (platform.claude.com/settings/workspaces/new) dans la Console.

3. 3

   Configurer l’espace de travail

   Saisissez un nom d’espace de travail et sélectionnez une couleur pour l’identification visuelle.

4. 4

   Créer l’espace de travail

   Cliquez sur Créer un espace de travail pour finaliser.

Modifier les détails d’un espace de travail

Pour modifier le nom ou la couleur d’un workspace :

1. Sélectionnez l’espace de travail dans la liste.
2. Ouvrez le menu Plus d’actions (trois points) et sélectionnez Modifier les détails.
3. Mettez à jour le nom ou la couleur et enregistrez vos modifications.

Ajouter des membres à un espace de travail

1. Dans la Claude Console, accédez à la page Membres (platform.claude.com/settings/members).
2. Cliquez sur Ajouter à l’espace de travail.
3. Sélectionnez l’espace de travail, le membre de l’organisation à ajouter et son rôle d’espace de travail.
4. Cliquez sur Ajouter à l’espace de travail pour confirmer.

Retirer des membres d’un espace de travail

1. Sur la page Membres de la Claude Console, sélectionnez l’espace de travail dans le menu déroulant Espace de travail. S’il affiche Tout, Supprimer le membre retire plutôt le membre de votre organisation.
2. À la fin de la ligne du membre, ouvrez le menu Plus d’actions (trois points) et sélectionnez Supprimer le membre.
3. Cliquez sur Supprimer pour confirmer.

Définir les limites de l’espace de travail

Vous définissez les limites de débit et les limites de dépenses d’un workspace à des endroits différents :

• Limites de débit : sous Limites de débit dans la Claude Console, sélectionnez l’espace de travail dans le menu déroulant Espace de travail et cliquez sur Modifier à côté d’un modèle pour définir des limites de requêtes par minute, de tokens d’entrée ou de tokens de sortie.
• Limites de dépenses : Sur la page Espaces de travail de la Claude Console, sélectionnez l’espace de travail. Dans le panneau qui s’ouvre, cliquez sur Limites de dépenses pour plafonner les dépenses mensuelles et configurer des alertes lorsque les dépenses atteignent certains seuils.

Archiver un espace de travail

Pour archiver un espace de travail, ouvrez son menu Plus d’actions (trois points) et sélectionnez Archiver l’espace de travail. L’archivage :

• Préserve les données historiques pour les rapports
• Désactive l’espace de travail et archive chaque clé API créée pour celui-ci
• Ne peut pas être annulé

Utilisation de l’Admin API

Gérez les espaces de travail de manière programmatique à l’aide de l’Admin API.

Les exemples SDK et CLI suivants construisent le client par défaut, qui lit la clé Admin API depuis la variable d’environnement ANTHROPIC_API_KEY ; le SDK expose ces points de terminaison sous client.organization.workspaces. Les méthodes de liste du SDK récupèrent les pages suivantes à la demande, donc limit définit la taille de page ; les exemples PHP, Ruby et curl renvoient une seule page.

Créer un espace de travail :

client = anthropic.Anthropic()

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

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

Lister les espaces de travail :

client = anthropic.Anthropic()

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

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

Archiver un espace de travail :

client = anthropic.Anthropic()

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

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

Pour obtenir tous les détails des paramètres et les schémas de réponse, consultez la référence de l’API des espaces de travailAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir..

Gestion des membres de l’espace de travail

Ajouter un membre à un espace de travail :

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}")

Mettre à jour le rôle d’un membre :

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}")

Retirer un membre d’un espace de travail :

client = anthropic.Anthropic()

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

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

Pour obtenir tous les détails des paramètres, consultez la référence de l’API des membres des espaces de travailAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir..

Clés API et portée des ressources

Chaque requête s’exécute dans exactement un espace de travail et ne peut accéder qu’aux ressources de cet espace de travail. L’espace de travail concerné dépend du type de clé :

• Une clé de workspace (une clé héritée sans propriétaire) appartient au workspace dans lequel elle a été créée et s’y exécute toujours.
• Une clé personnelle ou une clé de compte de service agit en tant que son utilisateur ou compte de service. Une clé limitée à un seul espace de travail s’exécute toujours dans l’espace de travail choisi lors de sa création. Une clé qui n’est pas limitée à un espace de travail s’exécute dans l’espace de travail indiqué par l’en-tête anthropic-workspace-id de chaque requête. Les comptes doivent avoir accès à l’espace de travail pour l’utiliser.

Les ressources limitées aux espaces de travail incluent :

• Les fichiers créés via l’API Files
• Les lots de messages créés via l’API Batch
• Les skills créés via l’API Skills

Certaines ressources sont gérées différemment :

• Les tunnels MCP sont gérés avec un jeton OAuth workspace:manage_tunnels obtenu via la Workload Identity Federation, et non une clé API. Les tunnels sont créés dans un espace de travail, et la liste Tunnels MCP de la Console ainsi que le sélecteur de serveur Managed Agent n’affichent que les tunnels de l’espace de travail actuel ; le plafond de 10 tunnels actifs s’applique à l’échelle de l’organisation. La gestion des tunnels nécessite un rôle avec des permissions de gestion des tunnels ; les développeurs de l’organisation peuvent les consulter mais pas les modifier.
• Les espaces de travail eux-mêmes et les membres de l’organisation sont gérés au niveau de l’organisation via l’Admin API, à l’aide d’une clé Admin API, d’un jeton OAuth org:admin, ou d’une clé de compte personnel ou de service qui n’est pas limitée à un espace de travail spécifique.

Pour rechercher les ID des espaces de travail de votre organisation, appelez le point de terminaison Lister les espaces de travailAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir. (transmettez include_default=true pour inclure l’espace de travail par défaut) ou trouvez-les sur la page Espaces de travail de la Claude Console.

Identifier l’espace de travail derrière une réponse API

Les réponses de l’API Claude incluent un en-tête anthropic-workspace-id aux côtés des en-têtes de réponse request-id et anthropic-organization-id. Sa valeur est l’ID préfixé par wrkspc_ de l’espace de travail auquel la clé API ou le jeton d’accès de la requête a été résolu, y compris lorsque cet espace de travail est l’espace de travail par défaut. Par exemple, une réponse réussie inclut des en-têtes comme ceux-ci :

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

L’en-tête est absent lorsque les identifiants ne se résolvent pas en un espace de travail (par exemple, sur les requêtes Admin API) ou lorsque la requête échoue avant la fin de l’authentification, comme une erreur 401.

Les exemples suivants envoient une requête à l’API Messages et lisent l’ID de l’espace de travail à partir des en-têtes de réponse :

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

Les mêmes accesseurs lisent l’en-tête à partir d’autres points de terminaison de l’API Claude également, y compris les API Claude Managed Agents. Par exemple, lisez anthropic-workspace-id à partir de la réponse qui crée une session pour enregistrer à quel espace de travail appartient la session.

Avec l’ID d’espace de travail d’une réponse, vous pouvez :

• Confirmer à quel workspace l’utilisation, le coût et les limites de débit de la requête ont été comptabilisés
• Le comparer avec le champ workspace_id des lignes de l’API Usage and Cost Analytics, qui contiennent ce même ID pour l’espace de travail par défaut, et avec le champ scope des clés API dans l’Admin API, qui contient l’ID réel de l’espace de travail auquel une clé est liée, y compris l’espace de travail par défaut
• Vérifier s’il s’agit de l’ID de votre espace de travail par défaut en le passant à Obtenir un espace de travailAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir. avec une clé Admin API : l’espace de travail par défaut est renvoyé avec "name": "Default", même si Lister les espaces de travailAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir. l’omet à moins que vous ne passiez include_default=true
• Ouvrir cet espace de travail dans la Console pour trouver les ressources de la requête, telles que les sessions, les fichiers, les lots de messages et les skills

Limites des workspaces

Vous pouvez définir des limites de dépenses et de débit personnalisées pour chaque espace de travail afin de vous protéger contre la surutilisation et d’assurer une distribution équitable des ressources.

Définir les limites des workspaces

Vous pouvez définir des limites d’espace de travail inférieures (mais pas supérieures) aux limites de votre organisation :

• Limites de dépenses : Plafonnez les dépenses mensuelles d’un espace de travail. Pour les définir, accédez à la page Espaces de travail (platform.claude.com/settings/workspaces) de la Claude Console et sélectionnez l’espace de travail. Dans le panneau qui s’ouvre, cliquez sur Limites de dépenses.
• Limites de débit : limitez les requêtes par minute, les tokens d’entrée par minute ou les tokens de sortie par minute. Pour les définir, accédez à Limites de débit dans la Claude Console, sélectionnez l’espace de travail dans le menu déroulant Espace de travail, puis cliquez sur Modifier à côté d’un modèle.

Pour des informations détaillées sur les « rate limits » (limites de débit) et leur fonctionnement, consultez Limites de débit. Vous pouvez également consulter les limites de débit actuelles de votre organisation et de votre espace de travail, et définir les limites de débit de l’espace de travail par programmation avec l’API des limites de débit, qui enregistre une valeur supérieure à la limite de l’organisation mais applique tout de même la plus basse des deux.

Suivi de l’utilisation et des coûts

Suivez l’utilisation et les coûts par espace de travail à l’aide de l’API Usage and Cost Analytics :

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}")

L’utilisation et les coûts de l’espace de travail par défaut sont rapportés sous son propre ID.

Cas d’usage courants

Séparation des environnements

Créez des espaces de travail distincts pour le développement, la préproduction et la production :

Isolation par équipe ou département

Attribuez des espaces de travail à différentes équipes pour l’allocation des coûts et le contrôle d’accès :

• Équipe d’ingénierie avec accès développeur
• Équipe de science des données avec ses propres clés API
• Équipe de support avec un accès limité pour les outils clients

Organisation par projet

Créez des espaces de travail pour des projets ou produits spécifiques afin de suivre l’utilisation et les coûts séparément.

Bonnes pratiques

1. 1

   Planifiez la structure de vos workspaces

   Réfléchissez à la manière dont vous organiserez les espaces de travail avant de les créer. Pensez aux besoins de facturation, de contrôle d’accès et de suivi de l’utilisation.

2. 2

   Utilisez des noms significatifs

   Nommez clairement les espaces de travail pour indiquer leur objectif (par exemple, « Production - Customer Chatbot » ou « Dev - Internal Tools »).

3. 3

   Définissez des limites appropriées

   Configurez des limites de dépenses et de débit pour éviter les coûts inattendus et assurer une distribution équitable des ressources.

4. 4

   Auditez l’accès régulièrement

   Examinez périodiquement l’appartenance aux workspaces pour vous assurer que seuls les utilisateurs appropriés y ont accès.

5. 5

   Surveillez l’utilisation

   Utilisez l’API Usage and Cost Analytics pour suivre la consommation au niveau du workspace.

FAQ

Voir aussi

• Admin API
• Référence de l’Admin API
• Limites de débit
• API Usage and Cost Analytics et l’ancienne API d’utilisation et de coûts