Questo articolo spiega come etichettare i progetti con i codici che la tua organizzazione già utilizza, come un codice della struttura di suddivisione del lavoro (WBS), un codice di addebito o un numero cliente-materia. Puoi quindi visualizzare la maggior parte della spesa in questi progetti per tag, nelle impostazioni dell'organizzazione o tramite l'API.
I tag di progetto sono disponibili in beta sui piani Claude Enterprise. Non sono disponibili per le organizzazioni con configurazione HIPAA, chiavi di crittografia gestite dal cliente (CMEK), conservazione dati zero (ZDR), inclusa ZDR per Claude Code, conservazione dati minima o dati archiviati al di fuori degli Stati Uniti. Non sono inoltre disponibili per le organizzazioni che instradano Claude Desktop attraverso il proprio provider di modelli.
Importante: I tag di progetto funzionano solo all'interno dei progetti. Il lavoro al di fuori di un progetto non riceve un tag.
Come funzionano i tag di progetto
I tag di progetto utilizzano due elementi:
Tag: La categoria su cui fai rapporto, come
cost_codeoclient_matter.Valore: Il codice stesso, come
CC-1042.
Un proprietario crea il tag e i suoi valori, e chiunque possa modificare un progetto può impostare il valore per quel progetto. Ogni tag contiene un valore per progetto e un progetto può avere fino a 16 tag.
Prima di iniziare
Ruolo richiesto per creare tag e gestire i loro valori: Proprietario principale, Proprietario o un ruolo personalizzato con accesso Proprietario
Ruolo richiesto per impostare i tag di un progetto: Accesso "Può modificare" al progetto
Ruolo richiesto per visualizzare la spesa per tag: Proprietario principale, Proprietario o un ruolo personalizzato con accesso Visualizzazione analitiche e Visualizzazione fatturazione
Ruolo richiesto per creare chiavi API: Proprietario principale
Dove si applicano i tag di progetto
Dove avviene il lavoro | La spesa è segnalata per progetto? |
Chat in un progetto | Sì |
L'esperienza di chat unificata e Cowork in un progetto | Sì |
Attività Cowork sul tuo computer | Sì. Aggiorna a Claude Desktop 3.6556.1 o versione successiva e seleziona un progetto per l'attività. |
Claude Code nel tuo terminale o sul desktop | Sì, dopo aver impostato il progetto per Claude Code. Richiede Claude Code 2.1.305 o versione successiva, o Claude Desktop 3.6556.1 o versione successiva. |
I tag di progetto non si applicano a:
Claude Code sul web
Claude per Office
Claude in Chrome
Claude Design
Claude in Slack e Microsoft Teams
Artefatti
Modalità vocale
L'API Claude o la console Claude
Claude Code tramite Amazon Bedrock, Google Cloud Vertex AI, un gateway o una chiave API
Configura i tag di progetto
I tag di progetto sono attivi automaticamente per le organizzazioni idonee, senza alcuna impostazione per attivarli. Per iniziare, crea un tag.
Crea un tag e aggiungi i suoi valori
I proprietari possono seguire questi passaggi per creare un tag:
Fai clic su "Crea tag".
Inserisci un nome, come
cost_code. I nomi sono minuscoli senza spazi e non puoi cambiare un nome in seguito.In Valori consentiti, seleziona "Solo valori predefiniti" per far scegliere agli utenti dalla tua lista, o "Qualsiasi valore" per permettere loro di inserire il proprio.
Se hai selezionato "Solo valori predefiniti", aggiungi la tua lista in Valori. Inserisci un valore per riga, o aggiungi un file CSV con una singola colonna con
valuecome intestazione.(Facoltativo) Attiva l'interruttore "Obbligatorio" per fare in modo che gli utenti impostino un valore sui nuovi progetti.
Fai clic su "Continua".
Per aggiungere valori in seguito, apri il tag nella pagina Tag di progetto e fai clic su "Aggiungi valori" o "Importa CSV".
Nota: I nomi e i valori dei tag sono visibili a tutti gli utenti della tua organizzazione, quindi mantieni le informazioni sensibili fuori da essi.
Aggiungi un tag a un progetto
Chiunque abbia accesso "Può modificare" può aggiungere un tag a un progetto:
Apri il progetto.
In Tag, fai clic su "Aggiungi tag".
Seleziona il tag, quindi scegli o inserisci un valore.
Nota: I nomi e i valori dei tag sono visibili a tutti gli utenti della tua organizzazione, quindi mantieni le informazioni sensibili fuori da essi.
Imposta il progetto per Claude Code
Claude Code non ha un selettore di progetto, quindi gli utenti impostano il progetto in un file di impostazioni. Se nessun progetto è impostato, l'utilizzo di Claude Code non è etichettato e non c'è alcun avviso, quindi informi i tuoi utenti.
Apri il progetto in Claude e copia il suo ID, che è l'ultima parte dell'URL: claude.ai/project/this-part.
Apri
.claude/settings.jsonin un repository, o~/.claude/settings.jsonper applicarlo su tutti i repository.Aggiungi la riga sottostante, utilizzando il tuo ID progetto.
Se hai utilizzato il file di impostazioni di un repository, affida la cartella quando Claude Code lo chiede. L'impostazione ha effetto dopo.
{ "attributionProject": "PROJECT_ID" }
Avvertenza: Assicurati che il file rimanga un JSON valido. Una virgola fuori posto può interrompere Claude Code su quel computer.
Visualizza la spesa per tag
I proprietari principali, i proprietari e i ruoli personalizzati con accesso Visualizzazione analitiche e Visualizzazione fatturazione possono visualizzare la spesa per tag:
Vai a Impostazioni organizzazione > Utilizzo > Spesa per progetto.
Utilizza il menu "Raggruppa per" per selezionare il tuo tag.
Utilizza i menu "Periodo" e "Prodotto" per restringere i risultati.
I dati vengono eseguiti fino alla fine di ieri (UTC). Per scaricare i risultati, fai clic su "Esporta CSV".
Nota: I nomi dei progetti privati sono mostrati come "Progetto privato" su questa pagina e nel CSV. Il dashboard Analitiche, l'API Analitiche e l'API Conformità mostrano ancora i loro nomi reali.
Tieni presenti questi punti quando leggi i numeri:
Aggiungi tag prima che inizi il lavoro. La spesa conta verso un tag solo una volta che il tag entra in vigore, il che richiede circa due ore. La spesa precedente in quel progetto non conta verso di esso.
I progetti senza utilizzo non appariranno. Un progetto viene visualizzato dopo essere stato utilizzato nelle date che scegli.
La segnalazione inizia quando i tag di progetto diventano disponibili per la tua organizzazione. Non trattare le date precedenti come la cronologia completa.
I nuovi tag impiegano circa due ore per apparire. L'utilizzo durante quella finestra può rimanere sotto il tag precedente o nessun tag.
Cambiare un tag non cambia la spesa passata. L'utilizzo rimane sotto qualsiasi tag il progetto aveva al momento.
La spesa al di fuori di un progetto viene visualizzata come "Non in un progetto". Questo include le sessioni di Claude Code senza progetto impostato. La spesa in un progetto senza valore per il tag viene visualizzata come "Nessun valore di tag".
Gli importi potrebbero non corrispondere alla tua fattura. Vengono visualizzati dopo lo sconto e prima dei crediti, e i numeri recenti possono cambiare fino a circa una settimana dopo la fine del mese.
L'utilizzo coperto dai posti non viene conteggiato. Un progetto utilizzato principalmente su posti può mostrare poco o nessuna spesa.
Gestisci i tag e estrai la spesa con le API
Puoi impostare i tag ed estrarre la spesa dai tuoi sistemi. Entrambe le API sono in beta, quindi i percorsi e i nomi potrebbero cambiare. Il tuo proprietario principale crea le chiavi API in Impostazioni organizzazione > Organizzazione > API.
Imposta i tag con l'API Admin
Crea una chiave con gli ambiti read:project_tags e write:project_tags. L'API Admin può elencare i tuoi tag, aggiungere valori all'elenco di un tag e impostare i tag di un progetto. Non può creare tag, archiviare valori o creare progetti.
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 utilizza l'ID claude_proj_, non l'ID nell'URL del progetto. Per elencare gli ID, chiama GET /v1/organizations/analytics/apps/chat/projects?date=YYYY-MM-DD con una data di almeno un giorno fa. Restituisce solo i progetti che avevano attività di chat in quella data. Questa chiamata richiede l'ambito read:analytics, quindi attiva l'API Analitiche e aggiungi quell'ambito alla tua chiave.
Estrai la spesa con i rapporti di utilizzo e costo
Attiva l'API Analitiche e crea una chiave con l'ambito read:analytics. I bucket giornalieri coprono fino a 31 giorni per chiamata, quindi usali per estrarre un mese completo.
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
Gli importi sono in centesimi, possono includere frazioni di centesimo e includono già lo sconto, ma potrebbero non corrispondere alla tua fattura.
Ogni chiamata restituisce fino a 1000 righe. Se
has_moreè true, continua a sfogliare o i tuoi totali saranno insufficienti.Il testo del filtro tag viaggia nell'URL, quindi potrebbe apparire nei registri delle richieste.
Limitazioni attuali
Condivisione: I nomi e i valori dei tag sono visibili a tutti gli utenti della tua organizzazione, quindi mantieni le informazioni sensibili fuori da essi.
Modifica: Chiunque possa modificare un progetto può cambiare i suoi tag e può cancellarne uno a meno che non sia obbligatorio. Non puoi bloccare un tag.
Tag obbligatori: Questi si applicano solo ai nuovi progetti creati sul web, quindi i progetti esistenti non sono interessati. Sul web, il valore di un tag obbligatorio può essere modificato ma non rimosso. L'API Admin può comunque rimuoverlo.
Caratteri: I valori possono essere fino a 256 caratteri e possono includere spazi e virgole. I valori che si basano su caratteri invisibili, come emoji combinati o alcune parole persiane o singalesi, vengono rifiutati.
Non incluso in questa beta: Tag su una singola chat o sessione, divisione della spesa tra tag, ridenominazione di tag o valori e limiti di spesa per tag.
Domande frequenti
Un progetto può avere più di un tag?
Sì, utilizzando tag separati come cost_center e client_matter, fino a 16 per progetto. Ogni tag contiene un valore, quindi la spesa di un progetto non può essere divisa tra due valori dello stesso tag.
Claude controlla i nostri valori di tag?
No. Un elenco limita ciò che gli utenti possono scegliere, ma i valori non vengono controllati rispetto ai tuoi sistemi finanziari.
Come disattivo i tag di progetto?
I tag di progetto non cambiano nulla fino a quando un proprietario crea un tag. Per disattivarli, contatta il tuo team di account.