Отслеживание расходов по кодам затрат с помощью тегов проектов

В этой статье объясняется, как добавлять теги к проектам с использованием кодов, которые уже использует ваша организация, например кода структуры разбиения работ (WBS), кода начисления или номера клиента-вопроса. Затем вы сможете просмотреть большую часть расходов в этих проектах по тегам в параметрах организации или через API.

Теги проектов доступны в бета-версии для планов Claude Enterprise. Они недоступны для организаций с конфигурацией HIPAA, ключами шифрования, управляемыми клиентом (CMEK), нулевым сохранением данных (ZDR), включая ZDR для Claude Code, минимальным сохранением данных или данными, хранящимися вне США. Они также недоступны для организаций, которые маршрутизируют Claude Desktop через собственного поставщика модели.

Важно: Теги проектов работают только внутри проектов. Работа вне проекта не получает тег.

Как работают теги проектов

Теги проектов используют два компонента:

Тег: Категория, по которой вы отчитываетесь, например cost_code или client_matter.
Значение: Сам код, например CC-1042.

Владелец создает тег и его значения, а любой, кто может редактировать проект, может установить значение для этого проекта. Каждый тег содержит одно значение на проект, и проект может иметь до 16 тегов.

Перед началом

Роль, необходимая для создания тегов и управления их значениями: Основной владелец, владелец или пользовательская роль с доступом владельца
Роль, необходимая для установки тегов проекта: Доступ «Может редактировать» к проекту
Роль, необходимая для просмотра расходов по тегам: Основной владелец, владелец или пользовательская роль с доступом к просмотру аналитики и просмотру выставления счетов
Роль, необходимая для создания ключей API: Основной владелец

Где применяются теги проектов

Где происходит работа	Отчитываются ли расходы по проекту?
Чат в проекте	Да
Единый чат и опыт совместной работы в проекте	Да
Задача совместной работы на вашем компьютере	Да. Обновитесь до Claude Desktop 3.6556.1 или более поздней версии и выберите один проект для задачи.
Claude Code в вашем терминале или на рабочем столе	Да, после того как вы установите проект для Claude Code. Требуется Claude Code 2.1.305 или более поздняя версия, или Claude Desktop 3.6556.1 или более поздняя версия.

Теги проектов не применяются к:

Claude Code в веб-версии
Claude для Office
Claude в Chrome
Claude Design
Claude в Slack и Microsoft Teams
Артефакты
Голосовой режим
Claude API или консоль Claude
Claude Code через Amazon Bedrock, Google Cloud Vertex AI, шлюз или ключ API

Настройка тегов проектов

Теги проектов включены автоматически для подходящих организаций, без параметра для включения. Чтобы начать, создайте тег.

Создание тега и добавление его значений

Владельцы могут выполнить следующие шаги для создания тега:

Перейдите в Параметры организации > Организация > Теги проектов.
Нажмите «Создать тег».
Введите имя, например cost_code. Имена пишутся в нижнем регистре без пробелов, и вы не сможете изменить имя позже.
В разделе Допустимые значения выберите «Только предопределенные значения», чтобы пользователи выбирали из вашего списка, или «Любое значение», чтобы позволить им вводить свои собственные.
Если вы выбрали «Только предопределенные значения», добавьте свой список в разделе Значения. Введите одно значение на строку или добавьте CSV-файл с одним столбцом с value в качестве заголовка.
(Необязательно) Включите переключатель «Обязательно», чтобы пользователи устанавливали значение для новых проектов.
Нажмите «Продолжить».

Чтобы добавить значения позже, откройте тег на странице Теги проектов и нажмите «Добавить значения» или «Импортировать CSV».

Примечание: Имена и значения тегов видны всем пользователям в вашей организации, поэтому не включайте в них конфиденциальную информацию.

Добавление тега к проекту

Любой, у кого есть доступ «Может редактировать», может добавить тег к проекту:

Откройте проект.
В разделе Теги нажмите «Добавить тег».
Выберите тег, затем выберите или введите значение.

Установка проекта для Claude Code

Claude Code не имеет средства выбора проекта, поэтому пользователи устанавливают проект в файле параметров. Если проект не установлен, использование Claude Code не помечается тегом и нет предупреждения, поэтому сообщите об этом своим пользователям.

Откройте проект в Claude и скопируйте его ID, который является последней частью URL: claude.ai/project/this-part.
Откройте .claude/settings.json в репозитории или ~/.claude/settings.json, чтобы применить его ко всем репозиториям.
Добавьте строку ниже, используя ID вашего проекта.
Если вы использовали файл параметров репозитория, доверьте папку, когда Claude Code попросит. Параметр вступит в силу после этого.

{ "attributionProject": "PROJECT_ID" }

Предупреждение: Убедитесь, что файл остается действительным JSON. Случайная запятая может нарушить Claude Code на этом компьютере.

Просмотр расходов по тегам

Основные владельцы, владельцы и пользовательские роли с доступом к просмотру аналитики и просмотру выставления счетов могут просматривать расходы по тегам:

Перейдите в Параметры организации > Использование > Расходы по проекту.
Используйте меню «Группировать по», чтобы выбрать свой тег.
Используйте меню «Период» и «Продукт», чтобы сузить результаты.

Данные актуальны до конца вчерашнего дня (UTC). Чтобы загрузить результаты, нажмите «Экспортировать CSV».

Примечание: Имена приватных проектов отображаются как «Приватный проект» на этой странице и в CSV. Панель аналитики, API аналитики и API соответствия по-прежнему показывают их реальные имена.

Помните об этих моментах при чтении цифр:

Добавляйте теги перед началом работы. Расходы учитываются для тега только после того, как тег вступит в силу, что занимает около двух часов. Более ранние расходы в этом проекте не учитываются.
Проекты без использования не будут отображаться. Проект появляется после его использования в выбранные вами даты.
Отчетность начинается, когда теги проектов становятся доступны для вашей организации. Не рассматривайте более ранние даты как полную историю.
Новые теги появляются примерно через два часа. Использование в течение этого периода может остаться под предыдущим тегом или без тега.
Изменение тега не изменяет прошлые расходы. Использование остается под тем тегом, который был у проекта в то время.
Расходы вне проекта отображаются как «Не в проекте». Это включает сеансы Claude Code без установленного проекта. Расходы в проекте без значения для тега отображаются как «Нет значения тега».
Суммы могут не совпадать с вашим счетом. Они отображаются после вашей скидки и до кредитов, и недавние цифры могут измениться примерно через неделю после конца месяца.
Использование, покрытое местами, не учитывается. Проект, используемый в основном на местах, может показать мало или вообще не показать расходы.

Управление тегами и получение расходов с помощью API

Вы можете устанавливать теги и получать расходы из собственных систем. Оба API находятся в бета-версии, поэтому пути и имена могут измениться. Ваш основной владелец создает ключи API в Параметры организации > Организация > API.

Установка тегов с помощью Admin API

Создайте ключ с областями read:project_tags и write:project_tags. Admin API может перечислять ваши теги, добавлять значения в список тега и устанавливать теги проекта. Он не может создавать теги, архивировать значения или создавать проекты.

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

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

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

Admin API использует ID claude_proj_, а не ID в URL проекта. Чтобы перечислить ID, вызовите GET /v1/organizations/analytics/apps/chat/projects?date=YYYY-MM-DD с датой как минимум на один день раньше. Он возвращает только проекты, которые имели активность чата в эту дату. Этот вызов требует область read:analytics, поэтому включите Analytics API и добавьте эту область к вашему ключу.

Получение расходов с помощью отчетов об использовании и затратах

Включите Analytics API и создайте ключ с областью read:analytics. Ежедневные сегменты охватывают до 31 дня за вызов, поэтому используйте их для получения полного месяца.

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

Суммы указаны в центах, могут включать доли цента и уже включают вашу скидку, но могут не совпадать с вашим счетом.
Каждый вызов возвращает до 1000 строк. Если has_more имеет значение true, продолжайте разбиение на страницы, иначе ваши итоги будут неполными.
Текст фильтра тега передается в URL, поэтому он может появиться в журналах запросов.

Текущие ограничения

Общий доступ: Имена и значения тегов видны всем пользователям в вашей организации, поэтому не включайте в них конфиденциальную информацию.
Редактирование: Любой, кто может редактировать проект, может изменять его теги и может очистить один, если он не требуется. Вы не можете заблокировать тег.
Обязательные теги: Они применяются только к новым проектам, созданным в веб-версии, поэтому существующие проекты не затрагиваются. В веб-версии значение обязательного тега можно изменить, но не удалить. Admin API все еще может удалить его.
Символы: Значения могут содержать до 256 символов и могут включать пробелы и запятые. Значения, которые полагаются на невидимые символы, такие как комбинированные эмодзи или некоторые персидские или сингальские слова, отклоняются.
Не включено в эту бета-версию: Теги на одном чате или сеансе, разделение расходов между тегами, переименование тегов или значений и ограничения расходов по тегам.

Часто задаваемые вопросы

Может ли проект иметь более одного тега?

Да, используя отдельные теги, такие как cost_center и client_matter, до 16 на проект. Каждый тег содержит одно значение, поэтому расходы проекта не могут быть разделены между двумя значениями одного тега.

Проверяет ли Claude наши значения тегов?

Нет. Список ограничивает то, что пользователи могут выбрать, но значения не проверяются в соответствии с вашими финансовыми системами.

Как отключить теги проектов?

Теги проектов ничего не меняют, пока владелец не создаст тег. Чтобы отключить их, обратитесь к своей команде аккаунта.