Este artigo explica como marcar projetos com os códigos que sua organização já usa, como um código de estrutura de divisão de trabalho (WBS), código de cobrança ou número de cliente-assunto. Você pode então ver a maioria dos gastos nesses projetos por tag, nas configurações da sua organização ou através da API.
As tags de projeto estão disponíveis em beta nos planos Claude Enterprise. Elas não estão disponíveis para organizações com configuração HIPAA, chaves de criptografia gerenciadas pelo cliente (CMEK), retenção zero de dados (ZDR), incluindo ZDR para Claude Code, retenção mínima de dados ou dados armazenados fora dos EUA. Também não estão disponíveis para organizações que roteiam Claude Desktop através de seu próprio provedor de modelo.
Importante: As tags de projeto funcionam apenas dentro de projetos. O trabalho fora de um projeto não recebe uma tag.
Como as tags de projeto funcionam
As tags de projeto usam duas partes:
Tag: A categoria sobre a qual você relata, como
cost_codeouclient_matter.Valor: O código em si, como
CC-1042.
Um proprietário cria a tag e seus valores, e qualquer pessoa que possa editar um projeto pode definir o valor para esse projeto. Cada tag contém um valor por projeto, e um projeto pode ter até 16 tags.
Antes de começar
Função necessária para criar tags e gerenciar seus valores: Proprietário Primário, Proprietário ou uma função personalizada com acesso de Proprietário
Função necessária para definir as tags de um projeto: Acesso "Pode editar" ao projeto
Função necessária para visualizar gastos por tag: Proprietário Primário, Proprietário ou uma função personalizada com acesso de visualização de Análises e visualização de Faturamento
Função necessária para criar chaves de API: Proprietário Primário
Onde as tags de projeto se aplicam
Onde o trabalho acontece | O gasto é relatado por projeto? |
Chat em um projeto | Sim |
A experiência de chat unificado e Cowork em um projeto | Sim |
Tarefa Cowork no seu computador | Sim. Atualize para Claude Desktop 3.6556.1 ou posterior e escolha um projeto para a tarefa. |
Claude Code no seu terminal ou desktop | Sim, depois que você definir o projeto para Claude Code. Requer Claude Code 2.1.305 ou posterior, ou Claude Desktop 3.6556.1 ou posterior. |
As tags de projeto não se aplicam a:
Claude Code na web
Claude para Office
Claude no Chrome
Claude Design
Claude no Slack e Microsoft Teams
Artefatos
Modo de voz
A API Claude ou o Console Claude
Claude Code através do Amazon Bedrock, Google Cloud Vertex AI, um gateway ou uma chave de API
Configurar tags de projeto
As tags de projeto estão ativadas automaticamente para organizações elegíveis, sem configuração para ativar. Para começar, crie uma tag.
Criar uma tag e adicionar seus valores
Os proprietários podem seguir estas etapas para criar uma tag:
Clique em "Criar tag."
Digite um nome, como
cost_code. Os nomes são minúsculos sem espaços, e você não pode alterar um nome depois.Em Valores Permitidos, selecione "Apenas valores predefinidos" para que os usuários escolham em sua lista, ou "Qualquer valor" para deixá-los inserir o seu próprio.
Se você selecionou "Apenas valores predefinidos", adicione sua lista em Valores. Digite um valor por linha ou adicione um arquivo CSV com uma única coluna com
valuecomo cabeçalho.(Opcional) Ative o botão "Obrigatório" para fazer com que os usuários definam um valor em novos projetos.
Clique em "Continuar."
Para adicionar valores depois, abra a tag na página Tags de Projeto e clique em "Adicionar valores" ou "Importar CSV."
Nota: Os nomes e valores das tags são visíveis para todos os usuários em sua organização, portanto, mantenha informações confidenciais fora deles.
Adicionar uma tag a um projeto
Qualquer pessoa com acesso "Pode editar" pode adicionar uma tag a um projeto:
Abra o projeto.
Em Tags, clique em "Adicionar tag."
Selecione a tag e escolha ou digite um valor.
Nota: Os nomes e valores das tags são visíveis para todos os usuários em sua organização, portanto, mantenha informações confidenciais fora deles.
Definir o projeto para Claude Code
Claude Code não possui um seletor de projeto, portanto, os usuários definem o projeto em um arquivo de configurações. Se nenhum projeto for definido, o uso do Claude Code não será marcado e não haverá aviso, portanto, informe seus usuários.
Abra o projeto no Claude e copie seu ID, que é a última parte da URL: claude.ai/project/this-part.
Abra
.claude/settings.jsonem um repositório, ou~/.claude/settings.jsonpara aplicá-lo em todos os repositórios.Adicione a linha abaixo, usando seu ID de projeto.
Se você usou o arquivo de configurações de um repositório, confie na pasta quando Claude Code solicitar. A configuração entra em vigor depois disso.
{ "attributionProject": "PROJECT_ID" }
Aviso: Certifique-se de que o arquivo permaneça JSON válido. Uma vírgula deslocada pode quebrar Claude Code nesse computador.
Visualizar gastos por tag
Proprietários Primários, Proprietários e funções personalizadas com acesso de visualização de Análises e visualização de Faturamento podem visualizar gastos por tag:
Navegue até Configurações da Organização > Uso > Gastos por projeto.
Use o menu "Agrupar por" para selecionar sua tag.
Use os menus "Período" e "Produto" para restringir os resultados.
Os dados são executados até o final de ontem (UTC). Para baixar os resultados, clique em "Exportar CSV."
Nota: Os nomes dos projetos privados são mostrados como "Projeto privado" nesta página e no CSV. O painel de Análises, a API de Análises e a API de Conformidade ainda mostram seus nomes reais.
Tenha esses pontos em mente ao ler os números:
Adicione tags antes do trabalho começar. O gasto só conta para uma tag depois que a tag entra em vigor, o que leva cerca de duas horas. O gasto anterior nesse projeto não conta para isso.
Projetos sem uso não aparecerão. Um projeto aparece depois de ser usado nas datas que você escolher.
O relatório começa quando as tags de projeto ficam disponíveis para sua organização. Não trate datas anteriores como o histórico completo.
Novas tags levam cerca de duas horas para aparecer. O uso durante essa janela pode permanecer sob a tag anterior ou sem tag.
Alterar uma tag não altera o gasto anterior. O uso permanece sob qualquer tag que o projeto tinha no momento.
O gasto fora de um projeto aparece como "Não em um projeto." Isso inclui sessões do Claude Code sem projeto definido. O gasto em um projeto sem valor para a tag aparece como "Sem valor de tag."
Os valores podem não corresponder à sua fatura. Eles são mostrados após seu desconto e antes de créditos, e números recentes podem mudar até cerca de uma semana após o final do mês.
O uso coberto por assentos não é contado. Um projeto usado principalmente em assentos pode mostrar pouco ou nenhum gasto.
Gerenciar tags e extrair gastos com as APIs
Você pode definir tags e extrair gastos de seus próprios sistemas. Ambas as APIs estão em beta, portanto, os caminhos e nomes podem mudar. Seu Proprietário Primário cria chaves de API em Configurações da Organização > Organização > API.
Definir tags com a Admin API
Crie uma chave com os escopos read:project_tags e write:project_tags. A Admin API pode listar suas tags, adicionar valores à lista de uma tag e definir as tags de um projeto. Ela não pode criar tags, arquivar valores ou criar projetos.
POST /v1/organizations/apps/projects/claude_proj_.../tags
Header: anthropic-beta: ce-project-tags-2026-10-09
Body: {"tags": {"cost_code": "CC-1042"}}
A Admin API usa o ID claude_proj_, não o ID na URL do projeto. Para listar IDs, chame GET /v1/organizations/analytics/apps/chat/projects?date=YYYY-MM-DD com uma data com pelo menos um dia de antecedência. Ele retorna apenas projetos que tiveram atividade de chat nessa data. Esta chamada precisa do escopo read:analytics, portanto, ative a API de Análises e adicione esse escopo à sua chave.
Extrair gastos com relatórios de uso e custo
Ative a API de Análises e crie uma chave com o escopo read:analytics. Os buckets diários cobrem até 31 dias por chamada, portanto, use-os para extrair um mês 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
Os valores estão em centavos, podem incluir frações de centavo e já incluem seu desconto, mas podem não corresponder à sua fatura.
Cada chamada retorna até 1000 linhas. Se
has_morefor verdadeiro, continue paginando ou seus totais ficarão curtos.O texto do filtro de tag viaja na URL, portanto, pode aparecer nos logs de solicitação.
Limitações atuais
Compartilhamento: Os nomes e valores das tags são visíveis para todos os usuários em sua organização, portanto, mantenha informações confidenciais fora deles.
Edição: Qualquer pessoa que possa editar um projeto pode alterar suas tags e pode limpar uma, a menos que seja obrigatória. Você não pode bloquear uma tag.
Tags obrigatórias: Estas se aplicam apenas a novos projetos criados na web, portanto, os projetos existentes não são afetados. Na web, o valor de uma tag obrigatória pode ser alterado, mas não removido. A Admin API ainda pode removê-lo.
Caracteres: Os valores podem ter até 256 caracteres e podem incluir espaços e vírgulas. Valores que dependem de caracteres invisíveis, como emoji combinado ou algumas palavras em persa ou cingalês, são rejeitados.
Não incluído neste beta: Tags em um único chat ou sessão, divisão de gastos entre tags, renomeação de tags ou valores e limites de gastos por tag.
Perguntas frequentes
Um projeto pode ter mais de uma tag?
Sim, usando tags separadas como cost_center e client_matter, até 16 por projeto. Cada tag contém um valor, portanto, o gasto de um projeto não pode ser dividido entre dois valores da mesma tag.
Claude verifica nossos valores de tag?
Não. Uma lista limita o que os usuários podem escolher, mas os valores não são verificados em relação aos seus sistemas financeiros.
Como desativo as tags de projeto?
As tags de projeto não mudam nada até que um Proprietário crie uma tag. Para desativá-las, entre em contato com sua equipe de conta.