Administration et surveillance

Espaces de travail

Organisez les clés API, gérez l'accès de l'équipe et contrôlez les coûts avec les espaces de travail.

Les espaces de travail offrent un moyen d'organiser votre utilisation des 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 assigner des clés API, des membres et des limites de ressources à chacun d'eux.

Caractéristiques clés :

Les identifiants d'espace de travail utilisent le préfixe wrkspc_ (par exemple, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
Maximum 100 espaces de travail par organisation (les espaces de travail archivés ne comptent pas)
L'espace de travail par défaut n'a pas d'ID et n'apparaît pas dans les points de terminaison de liste
Les clés API sont limitées à un seul espace de travail et ne peuvent accéder qu'aux ressources de cet espace de travail

Rôles et permissions des espaces de travail

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

Rôle	Permissions
Utilisateur de l'espace de travail	Utiliser uniquement le Workbench
Développeur de l'espace de travail	Créer et gérer les clés API, utiliser l'API
Administrateur de l'espace de travail	Contrôle total sur les paramètres et les membres de l'espace de travail
Facturation de l'espace de travail	Afficher les informations de facturation de l'espace de travail (hérité du rôle de facturation de l'organisation)

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 explicitement ajoutés à chaque espace de travail

Le rôle Facturation de l'espace de travail ne peut pas être attribué manuellement. Il est hérité du fait d'avoir le rôle de facturation de l'organisation.

Gestion des espaces de travail

Seuls les administrateurs de l'organisation peuvent créer des espaces de travail. Les utilisateurs et développeurs de l'organisation doivent être ajoutés aux espaces de travail par un administrateur.

Via la Console

Créez et gérez les espaces de travail dans la Console Claude.

Créer un espace de travail

Ouvrir les paramètres de l'espace de travail
Dans la Console Claude, allez à Paramètres > Espaces de travail.
Ajouter un nouvel espace de travail
Cliquez sur Ajouter un espace de travail.
Configurer l'espace de travail
Entrez un nom d'espace de travail et sélectionnez une couleur pour l'identification visuelle.
Créer l'espace de travail
Cliquez sur Créer pour finaliser.

Pour basculer entre les espaces de travail dans la Console, utilisez le sélecteur Espaces de travail dans le coin supérieur gauche.

Modifier les détails de l'espace de travail

Pour modifier le nom ou la couleur d'un espace de travail :

Sélectionnez l'espace de travail dans la liste
Cliquez sur le menu des points de suspension (...) et choisissez Modifier les détails
Mettez à jour le nom ou la couleur et enregistrez vos modifications

L'espace de travail par défaut ne peut pas être renommé ou supprimé.

Ajouter des membres à un espace de travail

Accédez à l'onglet Membres de l'espace de travail
Cliquez sur Ajouter à l'espace de travail
Sélectionnez un membre de l'organisation et attribuez-lui un rôle d'espace de travail
Confirmez l'ajout

Pour supprimer un membre, cliquez sur l'icône de corbeille à côté de son nom.

Les administrateurs de l'organisation et les membres de facturation ne peuvent pas être supprimés des espaces de travail tant qu'ils occupent ces rôles d'organisation.

Définir les limites de l'espace de travail

Dans l'onglet Limites, vous pouvez configurer :

Limites de débit : Définissez des limites par niveau de modèle pour les demandes par minute, les jetons d'entrée ou les jetons de sortie
Notifications de dépenses : Configurez les alertes lorsque les dépenses atteignent certains seuils

Archiver un espace de travail

Pour archiver un espace de travail, cliquez sur le menu des points de suspension (...) et sélectionnez Archiver. L'archivage :

Préserve les données historiques pour les rapports
Désactive l'espace de travail et toutes les clés API associées
Ne peut pas être annulé

L'archivage d'un espace de travail révoque immédiatement toutes les clés API de cet espace de travail. Cette action ne peut pas être annulée.

Via l'API Admin

Gérez les espaces de travail par programmation en utilisant l'API Admin.

Les points de terminaison de l'API Admin nécessitent une clé API Admin (commençant par sk-ant-admin...) qui diffère des clés API standard. Seuls les membres de l'organisation ayant le rôle d'administrateur peuvent provisionner les clés API Admin via la Console Claude.

# Créer un espace de travail
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"}'

# Lister les espaces de travail
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"

# Archiver un espace de travail
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"

Pour les détails complets des paramètres et les schémas de réponse, consultez la référence de l'API Espaces de travail.

Gestion des membres de l'espace de travail

Ajoutez, mettez à jour ou supprimez des membres d'un espace de travail :

# Ajouter un membre à un espace de travail
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"
  }'

# Mettre à jour le rôle d'un membre
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"}'

# Supprimer un membre d'un espace de travail
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"

Pour les détails complets des paramètres, consultez la référence de l'API Membres de l'espace de travail.

Clés API et portée des ressources

Les clés API sont limitées à un espace de travail spécifique. Lorsque vous créez une clé API dans un espace de travail, elle ne peut accéder qu'aux ressources de cet espace de travail.

Les ressources limitées aux espaces de travail incluent :

Fichiers créés via l'API Fichiers
Lots de messages créés via l'API Batch
Compétences créées via l'API Compétences

À partir du 5 février 2026, les caches de prompt seront également isolés par espace de travail (s'applique à l'API Claude et à Azure uniquement).

Pour récupérer les ID d'espace de travail de votre organisation, utilisez le point de terminaison Lister les espaces de travail, ou trouvez-les dans la Console Claude.

Limites de l'espace de travail

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 l'utilisation excessive et d'assurer une distribution équitable des ressources.

Définition des limites de l'espace de travail

Les limites de l'espace de travail peuvent être définies plus bas que (mais pas plus haut que) les limites de votre organisation :

Limites de dépenses : Plafonner les dépenses mensuelles d'un espace de travail
Limites de débit : Limiter les demandes par minute, les jetons d'entrée par minute ou les jetons de sortie par minute

Vous ne pouvez pas définir de limites sur l'espace de travail par défaut
S'ils ne sont pas définis, les limites de l'espace de travail correspondent aux limites de l'organisation
Les limites à l'échelle de l'organisation s'appliquent toujours, même si les limites de l'espace de travail s'ajoutent à plus

Pour des informations détaillées sur les limites de débit et leur fonctionnement, consultez Limites de débit.

Suivi de l'utilisation et des coûts

Suivez l'utilisation et les coûts par espace de travail en utilisant l'API Utilisation et Coûts :

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"

L'utilisation et les coûts attribués à l'espace de travail par défaut ont une valeur null pour workspace_id.

Cas d'usage courants

Séparation des environnements

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

Espace de travail	Objectif
Développement	Test et expérimentation avec des limites de débit plus basses
Préproduction	Test de préproduction avec des limites similaires à la production
Production	Trafic en direct avec des limites de débit complètes et une surveillance

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 leurs propres clés API
Équipe d'assistance avec accès limité pour les outils clients

Organisation basée sur les projets

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

Bonnes pratiques

Planifiez votre structure d'espace de travail
Réfléchissez à la façon 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.
Utilisez des noms significatifs
Nommez les espaces de travail clairement pour indiquer leur objectif (par exemple, « Production - Chatbot client », « Dev - Outils internes »).
Définissez des limites appropriées
Configurez les limites de dépenses et de débit pour éviter les coûts inattendus et assurer une distribution équitable des ressources.
Auditez l'accès régulièrement
Examinez régulièrement l'adhésion à l'espace de travail pour vous assurer que seuls les utilisateurs appropriés ont accès.
Surveillez l'utilisation
Utilisez l'API Utilisation et Coûts pour suivre la consommation au niveau de l'espace de travail.

FAQ

Voir aussi

Was this page helpful?

Administration et surveillance

Espaces de travail

Organisez les clés API, gérez l'accès de l'équipe et contrôlez les coûts avec les espaces de travail.

Fonctionnement des espaces de travail

Caractéristiques clés :

Les identifiants d'espace de travail utilisent le préfixe wrkspc_ (par exemple, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
Maximum 100 espaces de travail par organisation (les espaces de travail archivés ne comptent pas)
L'espace de travail par défaut n'a pas d'ID et n'apparaît pas dans les points de terminaison de liste
Les clés API sont limitées à un seul espace de travail et ne peuvent accéder qu'aux ressources de cet espace de travail

Rôles et permissions des espaces de travail

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

Rôle	Permissions
Utilisateur de l'espace de travail	Utiliser uniquement le Workbench
Développeur de l'espace de travail	Créer et gérer les clés API, utiliser l'API
Administrateur de l'espace de travail	Contrôle total sur les paramètres et les membres de l'espace de travail
Facturation de l'espace de travail	Afficher les informations de facturation de l'espace de travail (hérité du rôle de facturation de l'organisation)

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 explicitement ajoutés à chaque espace de travail

Le rôle Facturation de l'espace de travail ne peut pas être attribué manuellement. Il est hérité du fait d'avoir le rôle de facturation de l'organisation.

Gestion des espaces de travail

Via la Console

Créez et gérez les espaces de travail dans la Console Claude.

Créer un espace de travail

Ouvrir les paramètres de l'espace de travail
Dans la Console Claude, allez à Paramètres > Espaces de travail.
Ajouter un nouvel espace de travail
Cliquez sur Ajouter un espace de travail.
Configurer l'espace de travail
Entrez un nom d'espace de travail et sélectionnez une couleur pour l'identification visuelle.
Créer l'espace de travail
Cliquez sur Créer pour finaliser.

Pour basculer entre les espaces de travail dans la Console, utilisez le sélecteur Espaces de travail dans le coin supérieur gauche.

Modifier les détails de l'espace de travail

Pour modifier le nom ou la couleur d'un espace de travail :

Sélectionnez l'espace de travail dans la liste
Cliquez sur le menu des points de suspension (...) et choisissez Modifier les détails
Mettez à jour le nom ou la couleur et enregistrez vos modifications

L'espace de travail par défaut ne peut pas être renommé ou supprimé.

Ajouter des membres à un espace de travail

Accédez à l'onglet Membres de l'espace de travail
Cliquez sur Ajouter à l'espace de travail
Sélectionnez un membre de l'organisation et attribuez-lui un rôle d'espace de travail
Confirmez l'ajout

Pour supprimer un membre, cliquez sur l'icône de corbeille à côté de son nom.

Les administrateurs de l'organisation et les membres de facturation ne peuvent pas être supprimés des espaces de travail tant qu'ils occupent ces rôles d'organisation.

Définir les limites de l'espace de travail

Dans l'onglet Limites, vous pouvez configurer :

Limites de débit : Définissez des limites par niveau de modèle pour les demandes par minute, les jetons d'entrée ou les jetons de sortie
Notifications de dépenses : Configurez les alertes lorsque les dépenses atteignent certains seuils

Archiver un espace de travail

Pour archiver un espace de travail, cliquez sur le menu des points de suspension (...) et sélectionnez Archiver. L'archivage :

Préserve les données historiques pour les rapports
Désactive l'espace de travail et toutes les clés API associées
Ne peut pas être annulé

L'archivage d'un espace de travail révoque immédiatement toutes les clés API de cet espace de travail. Cette action ne peut pas être annulée.

Via l'API Admin

Gérez les espaces de travail par programmation en utilisant l'API Admin.

# Créer un espace de travail
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"}'

# Lister les espaces de travail
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"

# Archiver un espace de travail
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"

Pour les détails complets des paramètres et les schémas de réponse, consultez la référence de l'API Espaces de travail.

Gestion des membres de l'espace de travail

Ajoutez, mettez à jour ou supprimez des membres d'un espace de travail :

# Ajouter un membre à un espace de travail
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"
  }'

# Mettre à jour le rôle d'un membre
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"}'

# Supprimer un membre d'un espace de travail
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"

Pour les détails complets des paramètres, consultez la référence de l'API Membres de l'espace de travail.

Clés API et portée des ressources

Les clés API sont limitées à un espace de travail spécifique. Lorsque vous créez une clé API dans un espace de travail, elle ne peut accéder qu'aux ressources de cet espace de travail.

Les ressources limitées aux espaces de travail incluent :

Fichiers créés via l'API Fichiers
Lots de messages créés via l'API Batch
Compétences créées via l'API Compétences

À partir du 5 février 2026, les caches de prompt seront également isolés par espace de travail (s'applique à l'API Claude et à Azure uniquement).

Pour récupérer les ID d'espace de travail de votre organisation, utilisez le point de terminaison Lister les espaces de travail, ou trouvez-les dans la Console Claude.

Limites de l'espace de travail

Définition des limites de l'espace de travail

Les limites de l'espace de travail peuvent être définies plus bas que (mais pas plus haut que) les limites de votre organisation :

Limites de dépenses : Plafonner les dépenses mensuelles d'un espace de travail
Limites de débit : Limiter les demandes par minute, les jetons d'entrée par minute ou les jetons de sortie par minute

Vous ne pouvez pas définir de limites sur l'espace de travail par défaut
S'ils ne sont pas définis, les limites de l'espace de travail correspondent aux limites de l'organisation
Les limites à l'échelle de l'organisation s'appliquent toujours, même si les limites de l'espace de travail s'ajoutent à plus

Pour des informations détaillées sur les limites de débit et leur fonctionnement, consultez Limites de débit.

Suivi de l'utilisation et des coûts

Suivez l'utilisation et les coûts par espace de travail en utilisant l'API Utilisation et Coûts :

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"

L'utilisation et les coûts attribués à l'espace de travail par défaut ont une valeur null pour workspace_id.

Cas d'usage courants

Séparation des environnements

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

Espace de travail	Objectif
Développement	Test et expérimentation avec des limites de débit plus basses
Préproduction	Test de préproduction avec des limites similaires à la production
Production	Trafic en direct avec des limites de débit complètes et une surveillance

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 leurs propres clés API
Équipe d'assistance avec accès limité pour les outils clients

Organisation basée sur les projets

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

Bonnes pratiques

Planifiez votre structure d'espace de travail
Réfléchissez à la façon 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.
Utilisez des noms significatifs
Nommez les espaces de travail clairement pour indiquer leur objectif (par exemple, « Production - Chatbot client », « Dev - Outils internes »).
Définissez des limites appropriées
Configurez les limites de dépenses et de débit pour éviter les coûts inattendus et assurer une distribution équitable des ressources.
Auditez l'accès régulièrement
Examinez régulièrement l'adhésion à l'espace de travail pour vous assurer que seuls les utilisateurs appropriés ont accès.
Surveillez l'utilisation
Utilisez l'API Utilisation et Coûts pour suivre la consommation au niveau de l'espace de travail.

FAQ

Voir aussi

Was this page helpful?

Fonctionnement des espaces de travail

Rôles et permissions des espaces de travail

Héritage des rôles

Gestion des espaces de travail

Via la Console

Créer un espace de travail

Modifier les détails de l'espace de travail

Ajouter des membres à un espace de travail

Définir les limites de l'espace de travail

Archiver un espace de travail

Via l'API Admin

Gestion des membres de l'espace de travail

Clés API et portée des ressources

Limites de l'espace de travail

Définition des limites de l'espace de travail

Suivi de l'utilisation et des coûts

Cas d'usage courants

Séparation des environnements

Isolation par équipe ou département

Organisation basée sur les projets

Bonnes pratiques

FAQ

Qu'est-ce que l'espace de travail par défaut ?

Y a-t-il des limites sur les espaces de travail ?

Comment les rôles de l'organisation affectent-ils l'accès à l'espace de travail ?

Quels rôles peuvent être attribués dans les espaces de travail ?

Les rôles d'espace de travail des administrateurs ou des membres de facturation de l'organisation peuvent-ils être modifiés ?

Que se passe-t-il pour l'accès à l'espace de travail lorsque les rôles de l'organisation changent ?

Que se passe-t-il pour les clés API lorsqu'un utilisateur est supprimé d'un espace de travail ?

Voir aussi

Fonctionnement des espaces de travail

Rôles et permissions des espaces de travail

Héritage des rôles

Gestion des espaces de travail

Via la Console

Créer un espace de travail

Modifier les détails de l'espace de travail

Ajouter des membres à un espace de travail

Définir les limites de l'espace de travail

Archiver un espace de travail

Via l'API Admin

Gestion des membres de l'espace de travail

Clés API et portée des ressources

Limites de l'espace de travail

Définition des limites de l'espace de travail

Suivi de l'utilisation et des coûts

Cas d'usage courants

Séparation des environnements

Isolation par équipe ou département

Organisation basée sur les projets

Bonnes pratiques

FAQ

Qu'est-ce que l'espace de travail par défaut ?

Y a-t-il des limites sur les espaces de travail ?

Comment les rôles de l'organisation affectent-ils l'accès à l'espace de travail ?

Quels rôles peuvent être attribués dans les espaces de travail ?

Les rôles d'espace de travail des administrateurs ou des membres de facturation de l'organisation peuvent-ils être modifiés ?

Que se passe-t-il pour l'accès à l'espace de travail lorsque les rôles de l'organisation changent ?

Que se passe-t-il pour les clés API lorsqu'un utilisateur est supprimé d'un espace de travail ?

Voir aussi