Rastrear gastos por código de costo con etiquetas de proyecto

Este artículo explica cómo etiquetar proyectos con los códigos que tu organización ya utiliza, como un código de estructura de desglose de trabajo (WBS), código de cargo o número de cliente-asunto. Luego puedes ver la mayoría de los gastos en esos proyectos por etiqueta, en la configuración de tu organización o a través de la API.

Las etiquetas de proyecto están disponibles en versión beta en planes Claude Enterprise. No están disponibles para organizaciones con configuración HIPAA, claves de cifrado administradas por el cliente (CMEK), retención cero de datos (ZDR), incluida ZDR para Claude Code, retención mínima de datos o datos almacenados fuera de EE.UU. Tampoco están disponibles para organizaciones que enrutan Claude Desktop a través de su propio proveedor de modelo.

Importante: Las etiquetas de proyecto solo funcionan dentro de proyectos. El trabajo fuera de un proyecto no recibe una etiqueta.

Cómo funcionan las etiquetas de proyecto

Las etiquetas de proyecto utilizan dos componentes:

Etiqueta: La categoría sobre la que informas, como cost_code o client_matter.
Valor: El código en sí, como CC-1042.

Un propietario crea la etiqueta y sus valores, y cualquiera que pueda editar un proyecto puede establecer el valor para ese proyecto. Cada etiqueta contiene un valor por proyecto, y un proyecto puede tener hasta 16 etiquetas.

Antes de comenzar

Rol requerido para crear etiquetas y administrar sus valores: Propietario principal, Propietario o un rol personalizado con acceso de Propietario
Rol requerido para establecer las etiquetas de un proyecto: Acceso "Puede editar" al proyecto
Rol requerido para ver gastos por etiqueta: Propietario principal, Propietario o un rol personalizado con acceso de vista de Análisis y vista de Facturación
Rol requerido para crear claves de API: Propietario principal

Dónde se aplican las etiquetas de proyecto

Dónde ocurre el trabajo	¿Se reportan gastos por proyecto?
Chat en un proyecto	Sí
La experiencia de chat unificado y Cowork en un proyecto	Sí
Tarea de Cowork en tu computadora	Sí. Actualiza a Claude Desktop 3.6556.1 o posterior y elige un proyecto para la tarea.
Claude Code en tu terminal o en el escritorio	Sí, después de establecer el proyecto para Claude Code. Requiere Claude Code 2.1.305 o posterior, o Claude Desktop 3.6556.1 o posterior.

Las etiquetas de proyecto no se aplican a:

Claude Code en la web
Claude para Office
Claude en Chrome
Claude Design
Claude en Slack y Microsoft Teams
Artefactos
Modo de voz
La API de Claude o la Consola de Claude
Claude Code a través de Amazon Bedrock, Google Cloud Vertex AI, una puerta de enlace o una clave de API

Configurar etiquetas de proyecto

Las etiquetas de proyecto están activadas automáticamente para organizaciones elegibles, sin opción para activarlas. Para comenzar, crea una etiqueta.

Crear una etiqueta y agregar sus valores

Los propietarios pueden seguir estos pasos para crear una etiqueta:

Navega a Configuración de organización > Organización > Etiquetas de proyecto.
Haz clic en "Crear etiqueta".
Ingresa un nombre, como cost_code. Los nombres están en minúsculas sin espacios, y no puedes cambiar un nombre más tarde.
En Valores permitidos, selecciona "Solo valores predefinidos" para que los usuarios elijan de tu lista, o "Cualquier valor" para permitirles ingresar los suyos.
Si seleccionaste "Solo valores predefinidos", agrega tu lista en Valores. Ingresa un valor por línea, o agrega un archivo CSV con una sola columna con value como encabezado.
(Opcional) Activa el botón "Requerido" para obligar a los usuarios a establecer un valor en proyectos nuevos.
Haz clic en "Continuar".

Para agregar valores más tarde, abre la etiqueta en la página Etiquetas de proyecto y haz clic en "Agregar valores" o "Importar CSV".

Nota: Los nombres y valores de las etiquetas son visibles para todos los usuarios de tu organización, así que mantén la información sensible fuera de ellos.

Agregar una etiqueta a un proyecto

Cualquiera con acceso "Puede editar" puede agregar una etiqueta a un proyecto:

Abre el proyecto.
En Etiquetas, haz clic en "Agregar etiqueta".
Selecciona la etiqueta, luego elige o ingresa un valor.

Nota: Los nombres y valores de las etiquetas son visibles para todos los usuarios de tu organización, así que mantén la información sensible fuera de ellos.

Establecer el proyecto para Claude Code

Claude Code no tiene un selector de proyecto, así que los usuarios establecen el proyecto en un archivo de configuración. Si no se establece ningún proyecto, el uso de Claude Code no se etiqueta y no hay advertencia, así que informa a tus usuarios.

Abre el proyecto en Claude y copia su ID, que es la última parte de la URL: claude.ai/project/this-part.
Abre .claude/settings.json en un repositorio, o ~/.claude/settings.json para aplicarlo en todos los repositorios.
Agrega la línea a continuación, usando tu ID de proyecto.
Si usaste el archivo de configuración de un repositorio, confía en la carpeta cuando Claude Code lo solicite. La configuración entra en vigor después de eso.

{ "attributionProject": "PROJECT_ID" }

Advertencia: Asegúrate de que el archivo siga siendo JSON válido. Una coma extraviada puede romper Claude Code en esa computadora.

Ver gastos por etiqueta

Los propietarios principales, propietarios y roles personalizados con acceso de vista de Análisis y vista de Facturación pueden ver gastos por etiqueta:

Navega a Configuración de organización > Uso > Gastos por proyecto.
Usa el menú "Agrupar por" para seleccionar tu etiqueta.
Usa los menús "Período" y "Producto" para reducir los resultados.

Los datos se ejecutan hasta el final de ayer (UTC). Para descargar los resultados, haz clic en "Exportar CSV".

Nota: Los nombres de los proyectos privados se muestran como "Proyecto privado" en esta página y en el CSV. El panel de Análisis, la API de Análisis y la API de Cumplimiento aún muestran sus nombres reales.

Ten en cuenta estos puntos cuando leas los números:

Agrega etiquetas antes de que comience el trabajo. Los gastos solo se cuentan hacia una etiqueta una vez que la etiqueta entra en vigor, lo que toma aproximadamente dos horas. Los gastos anteriores en ese proyecto no se cuentan hacia ella.
Los proyectos sin uso no aparecerán. Un proyecto aparece después de haber sido utilizado en las fechas que selecciones.
Los informes comienzan cuando las etiquetas de proyecto están disponibles para tu organización. No trates las fechas anteriores como el historial completo.
Las nuevas etiquetas tardan aproximadamente dos horas en aparecer. El uso durante esa ventana puede permanecer bajo la etiqueta anterior o sin etiqueta.
Cambiar una etiqueta no cambia los gastos anteriores. El uso permanece bajo cualquier etiqueta que el proyecto tuviera en ese momento.
Los gastos fuera de un proyecto se muestran como "No en un proyecto". Esto incluye sesiones de Claude Code sin proyecto establecido. El gasto en un proyecto sin valor para la etiqueta se muestra como "Sin valor de etiqueta".
Los montos pueden no coincidir con tu factura. Se muestran después de tu descuento y antes de créditos, y los números recientes pueden cambiar hasta aproximadamente una semana después del cierre del mes.
El uso cubierto por asientos no se cuenta. Un proyecto utilizado principalmente en asientos puede mostrar poco o ningún gasto.

Administrar etiquetas y extraer gastos con las API

Puedes establecer etiquetas y extraer gastos de tus propios sistemas. Ambas API están en versión beta, por lo que las rutas y nombres pueden cambiar. Tu propietario principal crea claves de API en Configuración de organización > Organización > API.

Establecer etiquetas con la API de administración

Crea una clave con los alcances read:project_tags y write:project_tags. La API de administración puede enumerar tus etiquetas, agregar valores a la lista de una etiqueta y establecer las etiquetas de un proyecto. No puede crear etiquetas, archivar valores ni crear proyectos.

POST /v1/organizations/apps/projects/claude_proj_.../tags

Header: anthropic-beta: ce-project-tags-2026-10-09

Body: {"tags": {"cost_code": "CC-1042"}}

La API de administración utiliza el ID claude_proj_, no el ID en la URL del proyecto. Para enumerar IDs, llama a GET /v1/organizations/analytics/apps/chat/projects?date=YYYY-MM-DD con una fecha de al menos un día anterior. Solo devuelve proyectos que tuvieron actividad de chat en esa fecha. Esta llamada necesita el alcance read:analytics, así que activa la API de Análisis y agrega ese alcance a tu clave.

Extraer gastos con informes de uso y costo

Activa la API de Análisis y crea una clave con el alcance read:analytics. Los depósitos diarios cubren hasta 31 días por llamada, así que úsalos para extraer un mes 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

Los montos están en centavos, pueden incluir fracciones de centavo e incluyen tu descuento, pero pueden no coincidir con tu factura.
Cada llamada devuelve hasta 1000 filas. Si has_more es verdadero, continúa paginando o tus totales serán insuficientes.
El texto del filtro de etiqueta viaja en la URL, por lo que puede aparecer en registros de solicitud.

Limitaciones actuales

Compartir: Los nombres y valores de las etiquetas son visibles para todos los usuarios de tu organización, así que mantén la información sensible fuera de ellos.
Edición: Cualquiera que pueda editar un proyecto puede cambiar sus etiquetas y puede borrar una a menos que sea obligatoria. No puedes bloquear una etiqueta.
Etiquetas requeridas: Estas solo se aplican a proyectos nuevos creados en la web, por lo que los proyectos existentes no se ven afectados. En la web, el valor de una etiqueta requerida puede cambiarse pero no eliminarse. La API de administración aún puede eliminarlo.
Caracteres: Los valores pueden tener hasta 256 caracteres e incluir espacios y comas. Los valores que dependen de caracteres invisibles, como emoji combinados o algunas palabras en persa o cingalés, se rechazan.
No incluido en esta versión beta: Etiquetas en un chat o sesión única, división de gastos entre etiquetas, cambio de nombre de etiquetas o valores, y límites de gasto por etiqueta.

Preguntas frecuentes

¿Puede un proyecto tener más de una etiqueta?

Sí, usando etiquetas separadas como cost_center y client_matter, hasta 16 por proyecto. Cada etiqueta contiene un valor, por lo que los gastos de un proyecto no se pueden dividir entre dos valores de la misma etiqueta.

¿Claude verifica nuestros valores de etiqueta?

No. Una lista limita lo que los usuarios pueden elegir, pero los valores no se verifican contra tus sistemas financieros.

¿Cómo desactivo las etiquetas de proyecto?

Las etiquetas de proyecto no cambian nada hasta que un propietario crea una etiqueta. Para desactivarlas, comunícate con tu equipo de cuenta.