Dieser Artikel erklärt, wie Sie Projekte mit Codes taggen, die Ihre Organisation bereits verwendet, z. B. ein WBS-Code (Work Breakdown Structure), Kostencode oder eine Mandanten-Materie-Nummer. Sie können dann die meisten Ausgaben in diesen Projekten nach Tag in Ihren Organisationseinstellungen oder über die API anzeigen.
Projekt-Tags sind in der Beta-Phase für Claude Enterprise-Pläne verfügbar. Sie sind nicht für Organisationen mit HIPAA-Konfiguration, kundenverwalteten Verschlüsselungsschlüsseln (CMEK), Null-Datenspeicherung (ZDR), einschließlich ZDR für Claude Code, minimaler Datenspeicherung oder Daten außerhalb der USA verfügbar. Sie sind auch nicht für Organisationen verfügbar, die Claude Desktop über ihren eigenen Modell-Provider leiten.
Wichtig: Projekt-Tags funktionieren nur innerhalb von Projekten. Arbeiten außerhalb eines Projekts erhalten kein Tag.
Wie Projekt-Tags funktionieren
Projekt-Tags verwenden zwei Komponenten:
Tag: Die Kategorie, über die Sie berichten, wie
cost_codeoderclient_matter.Wert: Der Code selbst, wie
CC-1042.
Ein Eigentümer erstellt das Tag und seine Werte, und jeder, der ein Projekt bearbeiten kann, kann den Wert für dieses Projekt festlegen. Jedes Tag enthält einen Wert pro Projekt, und ein Projekt kann bis zu 16 Tags haben.
Bevor Sie beginnen
Rolle erforderlich zum Erstellen von Tags und Verwalten ihrer Werte: Primärer Eigentümer, Eigentümer oder eine benutzerdefinierte Rolle mit Eigentümer-Zugriff
Rolle erforderlich zum Festlegen der Tags eines Projekts: "Kann bearbeiten"-Zugriff auf das Projekt
Rolle erforderlich zum Anzeigen von Ausgaben nach Tag: Primärer Eigentümer, Eigentümer oder eine benutzerdefinierte Rolle mit Analyse- und Abrechnungszugriff
Rolle erforderlich zum Erstellen von API-Schlüsseln: Primärer Eigentümer
Wo Projekt-Tags gelten
Wo die Arbeit stattfindet | Werden Ausgaben nach Projekt gemeldet? |
Chat in einem Projekt | Ja |
Die einheitliche Chat- und Cowork-Erfahrung in einem Projekt | Ja |
Cowork-Aufgabe auf Ihrem Computer | Ja. Aktualisieren Sie auf Claude Desktop 3.6556.1 oder später und wählen Sie ein Projekt für die Aufgabe. |
Claude Code in Ihrem Terminal oder auf dem Desktop | Ja, nachdem Sie das Projekt für Claude Code festgelegt haben. Erfordert Claude Code 2.1.305 oder später oder Claude Desktop 3.6556.1 oder später. |
Projekt-Tags gelten nicht für:
Claude Code im Web
Claude für Office
Claude in Chrome
Claude Design
Claude in Slack und Microsoft Teams
Artefakte
Sprachmodus
Die Claude API oder die Claude Console
Claude Code über Amazon Bedrock, Google Cloud Vertex AI, ein Gateway oder einen API-Schlüssel
Projekt-Tags einrichten
Projekt-Tags sind für berechtigte Organisationen automatisch aktiviert, ohne dass eine Einstellung zum Aktivieren erforderlich ist. Erstellen Sie zunächst ein Tag.
Erstellen Sie ein Tag und fügen Sie seine Werte hinzu
Eigentümer können diese Schritte befolgen, um ein Tag zu erstellen:
Navigieren Sie zu Organisationseinstellungen > Organisation > Projekt-Tags.
Klicken Sie auf "Tag erstellen".
Geben Sie einen Namen ein, z. B.
cost_code. Namen sind Kleinbuchstaben ohne Leerzeichen, und Sie können einen Namen später nicht ändern.Wählen Sie unter Zulässige Werte "Nur vordefinierte Werte", damit Benutzer aus Ihrer Liste wählen können, oder "Beliebiger Wert", um ihnen die Eingabe eigener Werte zu ermöglichen.
Wenn Sie "Nur vordefinierte Werte" ausgewählt haben, fügen Sie Ihre Liste unter Werte hinzu. Geben Sie einen Wert pro Zeile ein, oder fügen Sie eine CSV-Datei mit einer einzelnen Spalte mit
valueals Header hinzu.(Optional) Aktivieren Sie den Schalter "Erforderlich", um Benutzer zu zwingen, einen Wert für neue Projekte festzulegen.
Klicken Sie auf "Weiter".
Um später Werte hinzuzufügen, öffnen Sie das Tag auf der Seite Projekt-Tags und klicken Sie auf "Werte hinzufügen" oder "CSV importieren".
Hinweis: Tag-Namen und -Werte sind für alle Benutzer in Ihrer Organisation sichtbar, daher halten Sie vertrauliche Informationen davon fern.
Fügen Sie ein Tag zu einem Projekt hinzu
Jeder mit "Kann bearbeiten"-Zugriff kann ein Tag zu einem Projekt hinzufügen:
Öffnen Sie das Projekt.
Klicken Sie unter Tags auf "Tag hinzufügen".
Wählen Sie das Tag aus und wählen Sie dann einen Wert aus oder geben Sie ihn ein.
Hinweis: Tag-Namen und -Werte sind für alle Benutzer in Ihrer Organisation sichtbar, daher halten Sie vertrauliche Informationen davon fern.
Legen Sie das Projekt für Claude Code fest
Claude Code hat keine Projekt-Auswahl, daher legen Benutzer das Projekt in einer Einstellungsdatei fest. Wenn kein Projekt festgelegt ist, wird die Claude Code-Nutzung nicht getaggt und es gibt keine Warnung. Informieren Sie daher Ihre Benutzer.
Öffnen Sie das Projekt in Claude und kopieren Sie seine ID, die der letzte Teil der URL ist: claude.ai/project/this-part.
Öffnen Sie
.claude/settings.jsonin einem Repository oder~/.claude/settings.json, um es auf alle Repositories anzuwenden.Fügen Sie die folgende Zeile hinzu und verwenden Sie Ihre Projekt-ID.
Wenn Sie die Einstellungsdatei eines Repositorys verwendet haben, vertrauen Sie dem Ordner, wenn Claude Code Sie dazu auffordert. Die Einstellung wird danach wirksam.
{ "attributionProject": "PROJECT_ID" }
Warnung: Stellen Sie sicher, dass die Datei gültiges JSON bleibt. Ein fehlplatziertes Komma kann Claude Code auf diesem Computer beschädigen.
Ausgaben nach Tag anzeigen
Primäre Eigentümer, Eigentümer und benutzerdefinierte Rollen mit Analyse- und Abrechnungszugriff können Ausgaben nach Tag anzeigen:
Navigieren Sie zu Organisationseinstellungen > Nutzung > Ausgaben nach Projekt.
Verwenden Sie das Menü "Gruppieren nach", um Ihr Tag auszuwählen.
Verwenden Sie die Menüs "Zeitraum" und "Produkt", um die Ergebnisse einzugrenzen.
Daten laufen bis zum Ende von gestern (UTC). Um die Ergebnisse herunterzuladen, klicken Sie auf "CSV exportieren".
Hinweis: Die Namen privater Projekte werden auf dieser Seite und in der CSV als "Privates Projekt" angezeigt. Das Analytics-Dashboard, die Analytics-API und die Compliance-API zeigen weiterhin ihre echten Namen.
Beachten Sie diese Punkte beim Lesen der Zahlen:
Fügen Sie Tags hinzu, bevor die Arbeit beginnt. Ausgaben werden nur dann auf ein Tag angerechnet, wenn das Tag wirksam wird, was etwa zwei Stunden dauert. Frühere Ausgaben in diesem Projekt werden nicht angerechnet.
Projekte ohne Nutzung werden nicht angezeigt. Ein Projekt wird angezeigt, nachdem es in den von Ihnen ausgewählten Daten verwendet wurde.
Die Berichterstattung beginnt, wenn Projekt-Tags für Ihre Organisation verfügbar werden. Behandeln Sie frühere Daten nicht als vollständige Historie.
Neue Tags dauern etwa zwei Stunden, um angezeigt zu werden. Die Nutzung während dieses Fensters kann unter dem vorherigen Tag oder ohne Tag bleiben.
Das Ändern eines Tags ändert nicht die bisherigen Ausgaben. Die Nutzung bleibt unter dem Tag, das das Projekt zu diesem Zeitpunkt hatte.
Ausgaben außerhalb eines Projekts werden als "Nicht in einem Projekt" angezeigt. Dies umfasst Claude Code-Sitzungen ohne festgelegtes Projekt. Ausgaben in einem Projekt ohne Wert für das Tag werden als "Kein Tag-Wert" angezeigt.
Beträge stimmen möglicherweise nicht mit Ihrer Rechnung überein. Sie werden nach Ihrem Rabatt und vor Gutschriften angezeigt, und aktuelle Zahlen können sich bis etwa eine Woche nach Monatsende ändern.
Die Nutzung, die durch Plätze abgedeckt ist, wird nicht gezählt. Ein Projekt, das hauptsächlich auf Plätzen verwendet wird, kann wenig oder gar keine Ausgaben anzeigen.
Verwalten Sie Tags und rufen Sie Ausgaben mit den APIs ab
Sie können Tags festlegen und Ausgaben aus Ihren eigenen Systemen abrufen. Beide APIs sind in der Beta-Phase, daher können sich Pfade und Namen ändern. Ihr Primärer Eigentümer erstellt API-Schlüssel in Organisationseinstellungen > Organisation > API.
Legen Sie Tags mit der Admin API fest
Erstellen Sie einen Schlüssel mit den Bereichen read:project_tags und write:project_tags. Die Admin API kann Ihre Tags auflisten, Werte zu der Tag-Liste hinzufügen und die Tags eines Projekts festlegen. Sie kann keine Tags erstellen, Werte archivieren oder Projekte erstellen.
POST /v1/organizations/apps/projects/claude_proj_.../tags
Header: anthropic-beta: ce-project-tags-2026-10-09
Body: {"tags": {"cost_code": "CC-1042"}}
Die Admin API verwendet die claude_proj_ ID, nicht die ID in der Projekt-URL. Um IDs aufzulisten, rufen Sie GET /v1/organizations/analytics/apps/chat/projects?date=YYYY-MM-DD mit einem Datum auf, das mindestens einen Tag alt ist. Es werden nur Projekte zurückgegeben, die an diesem Datum Chat-Aktivität hatten. Dieser Aufruf benötigt den Bereich read:analytics, daher aktivieren Sie die Analytics API und fügen Sie diesen Bereich zu Ihrem Schlüssel hinzu.
Rufen Sie Ausgaben mit Nutzungs- und Kostenberichten ab
Aktivieren Sie die Analytics API und erstellen Sie einen Schlüssel mit dem Bereich read:analytics. Tägliche Buckets decken bis zu 31 Tage pro Aufruf ab, daher verwenden Sie sie, um einen ganzen Monat abzurufen.
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
Beträge sind in Cent, können Bruchteile eines Cent enthalten und enthalten bereits Ihren Rabatt, stimmen aber möglicherweise nicht mit Ihrer Rechnung überein.
Jeder Aufruf gibt bis zu 1000 Zeilen zurück. Wenn
has_morewahr ist, fahren Sie mit dem Blättern fort, sonst sind Ihre Summen unvollständig.Tag-Filtertext wird in der URL übertragen, daher kann er in Anforderungsprotokollen angezeigt werden.
Aktuelle Einschränkungen
Freigabe: Tag-Namen und -Werte sind für alle Benutzer in Ihrer Organisation sichtbar, daher halten Sie vertrauliche Informationen davon fern.
Bearbeitung: Jeder, der ein Projekt bearbeiten kann, kann seine Tags ändern und eines löschen, es sei denn, es ist erforderlich. Sie können ein Tag nicht sperren.
Erforderliche Tags: Diese gelten nur für neue Projekte, die im Web erstellt werden, daher sind vorhandene Projekte nicht betroffen. Im Web kann der Wert eines erforderlichen Tags geändert, aber nicht entfernt werden. Die Admin API kann ihn trotzdem entfernen.
Zeichen: Werte können bis zu 256 Zeichen lang sein und können Leerzeichen und Kommas enthalten. Werte, die auf unsichtbare Zeichen angewiesen sind, wie kombinierte Emojis oder einige persische oder singhalesische Wörter, werden abgelehnt.
Nicht in dieser Beta enthalten: Tags auf einem einzelnen Chat oder einer Sitzung, Aufteilung der Ausgaben auf Tags, Umbenennung von Tags oder Werten und Ausgabenlimits nach Tag.
Häufig gestellte Fragen
Kann ein Projekt mehr als ein Tag haben?
Ja, mit separaten Tags wie cost_center und client_matter, bis zu 16 pro Projekt. Jedes Tag enthält einen Wert, daher können die Ausgaben eines Projekts nicht auf zwei Werte desselben Tags aufgeteilt werden.
Überprüft Claude unsere Tag-Werte?
Nein. Eine Liste begrenzt, was Benutzer wählen können, aber Werte werden nicht gegen Ihre Finanzsysteme überprüft.
Wie deaktiviere ich Projekt-Tags?
Projekt-Tags ändern nichts, bis ein Eigentümer ein Tag erstellt. Um sie auszuschalten, wenden Sie sich an Ihr Account-Team.