Cet article explique comment baliser les projets avec les codes que votre organisation utilise déjà, comme un code de structure de répartition du travail (WBS), un code de facturation ou un numéro client-dossier. Vous pouvez ensuite voir la plupart des dépenses dans ces projets par balise, dans les paramètres de votre organisation ou via l'API.
Les balises de projet sont disponibles en version bêta sur les plans Claude Enterprise. Elles ne sont pas disponibles pour les organisations avec une configuration HIPAA, des clés de chiffrement gérées par le client (CMEK), une rétention zéro des données (ZDR), y compris ZDR pour Claude Code, une rétention minimale des données ou des données stockées en dehors des États-Unis. Elles ne sont pas non plus disponibles pour les organisations qui acheminent Claude Desktop via leur propre fournisseur de modèles.
Important : Les balises de projet ne fonctionnent que dans les projets. Le travail en dehors d'un projet n'obtient pas de balise.
Comment fonctionnent les balises de projet
Les balises de projet utilisent deux éléments :
Balise : La catégorie sur laquelle vous rapportez, comme
cost_codeouclient_matter.Valeur : Le code lui-même, comme
CC-1042.
Un propriétaire crée la balise et ses valeurs, et toute personne pouvant modifier un projet peut définir la valeur de ce projet. Chaque balise contient une valeur par projet, et un projet peut avoir jusqu'à 16 balises.
Avant de commencer
Rôle requis pour créer des balises et gérer leurs valeurs : Propriétaire principal, Propriétaire ou un rôle personnalisé avec accès Propriétaire
Rôle requis pour définir les balises d'un projet : Accès « Peut modifier » au projet
Rôle requis pour afficher les dépenses par balise : Propriétaire principal, Propriétaire ou un rôle personnalisé avec accès Affichage Analytics et Affichage Facturation
Rôle requis pour créer des clés API : Propriétaire principal
Où s'appliquent les balises de projet
Où le travail se déroule | Les dépenses sont-elles rapportées par projet ? |
Chat dans un projet | Oui |
L'expérience de chat unifié et Cowork dans un projet | Oui |
Tâche Cowork sur votre ordinateur | Oui. Mettez à jour vers Claude Desktop 3.6556.1 ou version ultérieure et choisissez un projet pour la tâche. |
Claude Code dans votre terminal ou sur le bureau | Oui, après avoir défini le projet pour Claude Code. Nécessite Claude Code 2.1.305 ou version ultérieure, ou Claude Desktop 3.6556.1 ou version ultérieure. |
Les balises de projet ne s'appliquent pas à :
Claude Code sur le web
Claude pour Office
Claude dans Chrome
Claude Design
Claude dans Slack et Microsoft Teams
Artefacts
Mode vocal
L'API Claude ou la console Claude
Claude Code via Amazon Bedrock, Google Cloud Vertex AI, une passerelle ou une clé API
Configurer les balises de projet
Les balises de projet sont activées automatiquement pour les organisations éligibles, sans paramètre pour les activer. Pour commencer, créez une balise.
Créer une balise et ajouter ses valeurs
Les propriétaires peuvent suivre ces étapes pour créer une balise :
Cliquez sur « Créer une balise ».
Entrez un nom, comme
cost_code. Les noms sont en minuscules sans espaces, et vous ne pouvez pas modifier un nom ultérieurement.Sous Valeurs autorisées, sélectionnez « Valeurs prédéfinies uniquement » pour que les utilisateurs choisissent dans votre liste, ou « Toute valeur » pour leur permettre d'entrer la leur.
Si vous avez sélectionné « Valeurs prédéfinies uniquement », ajoutez votre liste sous Valeurs. Entrez une valeur par ligne, ou ajoutez un fichier CSV avec une seule colonne avec
valuecomme en-tête.(Facultatif) Activez le bouton bascule « Requis » pour obliger les utilisateurs à définir une valeur sur les nouveaux projets.
Cliquez sur « Continuer ».
Pour ajouter des valeurs ultérieurement, ouvrez la balise sur la page Balises de projet et cliquez sur « Ajouter des valeurs » ou « Importer CSV ».
Remarque : Les noms et valeurs des balises sont visibles par tous les utilisateurs de votre organisation, donc gardez les informations sensibles en dehors.
Ajouter une balise à un projet
Toute personne ayant accès « Peut modifier » peut ajouter une balise à un projet :
Ouvrez le projet.
Sous Balises, cliquez sur « Ajouter une balise ».
Sélectionnez la balise, puis choisissez ou entrez une valeur.
Remarque : Les noms et valeurs des balises sont visibles par tous les utilisateurs de votre organisation, donc gardez les informations sensibles en dehors.
Définir le projet pour Claude Code
Claude Code n'a pas de sélecteur de projet, donc les utilisateurs définissent le projet dans un fichier de paramètres. Si aucun projet n'est défini, l'utilisation de Claude Code n'est pas balisée et il n'y a pas d'avertissement, donc informez vos utilisateurs.
Ouvrez le projet dans Claude et copiez son ID, qui est la dernière partie de l'URL : claude.ai/project/cette-partie.
Ouvrez
.claude/settings.jsondans un référentiel, ou~/.claude/settings.jsonpour l'appliquer à tous les référentiels.Ajoutez la ligne ci-dessous, en utilisant votre ID de projet.
Si vous avez utilisé le fichier de paramètres d'un référentiel, approuvez le dossier lorsque Claude Code vous le demande. Le paramètre prend effet après cela.
{ "attributionProject": "PROJECT_ID" }
Avertissement : Assurez-vous que le fichier reste un JSON valide. Une virgule égarée peut casser Claude Code sur cet ordinateur.
Afficher les dépenses par balise
Les propriétaires principaux, les propriétaires et les rôles personnalisés avec accès Affichage Analytics et Affichage Facturation peuvent afficher les dépenses par balise :
Accédez à Paramètres de l'organisation > Utilisation > Dépenses par projet.
Utilisez le menu « Grouper par » pour sélectionner votre balise.
Utilisez les menus « Période » et « Produit » pour affiner les résultats.
Les données s'exécutent jusqu'à la fin d'hier (UTC). Pour télécharger les résultats, cliquez sur « Exporter CSV ».
Remarque : Les noms des projets privés s'affichent sous la forme « Projet privé » sur cette page et dans le CSV. Le tableau de bord Analytics, l'API Analytics et l'API Conformité affichent toujours leurs vrais noms.
Gardez ces points à l'esprit lorsque vous lisez les chiffres :
Ajoutez des balises avant le début du travail. Les dépenses ne comptent vers une balise qu'une fois que la balise prend effet, ce qui prend environ deux heures. Les dépenses antérieures dans ce projet ne comptent pas vers elle.
Les projets sans utilisation n'apparaîtront pas. Un projet s'affiche après avoir été utilisé aux dates que vous choisissez.
La création de rapports commence lorsque les balises de projet deviennent disponibles pour votre organisation. Ne traitez pas les dates antérieures comme l'historique complet.
Les nouvelles balises prennent environ deux heures pour s'afficher. L'utilisation pendant cette fenêtre peut rester sous la balise précédente ou sans balise.
Modifier une balise ne change pas les dépenses passées. L'utilisation reste sous la balise que le projet avait au moment.
Les dépenses en dehors d'un projet s'affichent sous « Pas dans un projet ». Cela inclut les sessions Claude Code sans projet défini. Les dépenses dans un projet sans valeur pour la balise s'affichent sous « Aucune valeur de balise ».
Les montants peuvent ne pas correspondre à votre facture. Ils sont affichés après votre remise et avant les crédits, et les chiffres récents peuvent changer jusqu'à environ une semaine après la fin du mois.
L'utilisation couverte par les sièges n'est pas comptée. Un projet utilisé principalement sur les sièges peut afficher peu ou pas de dépenses.
Gérer les balises et extraire les dépenses avec les API
Vous pouvez définir des balises et extraire les dépenses de vos propres systèmes. Les deux API sont en version bêta, donc les chemins et les noms peuvent changer. Votre propriétaire principal crée des clés API dans Paramètres de l'organisation > Organisation > API.
Définir les balises avec l'API Admin
Créez une clé avec les portées read:project_tags et write:project_tags. L'API Admin peut lister vos balises, ajouter des valeurs à la liste d'une balise et définir les balises d'un projet. Elle ne peut pas créer de balises, archiver des valeurs ou créer des projets.
POST /v1/organizations/apps/projects/claude_proj_.../tags
Header: anthropic-beta: ce-project-tags-2026-10-09
Body: {"tags": {"cost_code": "CC-1042"}}
L'API Admin utilise l'ID claude_proj_, pas l'ID dans l'URL du projet. Pour lister les ID, appelez GET /v1/organizations/analytics/apps/chat/projects?date=YYYY-MM-DD avec une date d'au moins un jour. Il ne retourne que les projets qui avaient une activité de chat à cette date. Cet appel nécessite la portée read:analytics, donc activez l'API Analytics et ajoutez cette portée à votre clé.
Extraire les dépenses avec les rapports d'utilisation et de coûts
Activez l'API Analytics et créez une clé avec la portée read:analytics. Les compartiments quotidiens couvrent jusqu'à 31 jours par appel, donc utilisez-les pour extraire un mois complet.
GET /v1/organizations/analytics/cost?starting_at=...&ending_at=...&time_bucket_width=1d&group_by[]=tags.claude_project[cost_code]&limit=1000
Header: anthropic-beta: analytics-usage-cost-2026-08-24
Les montants sont en cents, peuvent inclure des fractions de cent et incluent déjà votre remise, mais peuvent ne pas correspondre à votre facture.
Chaque appel retourne jusqu'à 1000 lignes. Si
has_moreest vrai, continuez la pagination ou vos totaux seront insuffisants.Le texte du filtre de balise se déplace dans l'URL, il peut donc apparaître dans les journaux de requête.
Limitations actuelles
Partage : Les noms et valeurs des balises sont visibles par tous les utilisateurs de votre organisation, donc gardez les informations sensibles en dehors.
Édition : Toute personne pouvant modifier un projet peut modifier ses balises et en effacer une sauf si elle est requise. Vous ne pouvez pas verrouiller une balise.
Balises requises : Elles ne s'appliquent qu'aux nouveaux projets créés sur le web, donc les projets existants ne sont pas affectés. Sur le web, la valeur d'une balise requise peut être modifiée mais pas supprimée. L'API Admin peut toujours la supprimer.
Caractères : Les valeurs peuvent contenir jusqu'à 256 caractères et peuvent inclure des espaces et des virgules. Les valeurs qui dépendent de caractères invisibles, comme les emoji combinés ou certains mots persan ou cinghalais, sont rejetées.
Non inclus dans cette version bêta : Balises sur un seul chat ou session, répartition des dépenses entre les balises, renommage des balises ou des valeurs, et limites de dépenses par balise.
Questions fréquemment posées
Un projet peut-il avoir plus d'une balise ?
Oui, en utilisant des balises séparées comme cost_center et client_matter, jusqu'à 16 par projet. Chaque balise contient une valeur, donc les dépenses d'un projet ne peuvent pas être réparties entre deux valeurs de la même balise.
Claude vérifie-t-il nos valeurs de balise ?
Non. Une liste limite ce que les utilisateurs peuvent choisir, mais les valeurs ne sont pas vérifiées par rapport à vos systèmes financiers.
Comment désactiver les balises de projet ?
Les balises de projet ne changent rien jusqu'à ce qu'un propriétaire crée une balise. Pour les désactiver, contactez votre équipe de compte.