Lacak pengeluaran berdasarkan kode biaya dengan tag proyek

Artikel ini menjelaskan cara memberi tag pada proyek dengan kode yang sudah digunakan organisasi Anda, seperti kode work breakdown structure (WBS), kode charge, atau nomor klien-masalah. Anda kemudian dapat melihat sebagian besar pengeluaran dalam proyek tersebut berdasarkan tag, di pengaturan organisasi atau melalui API.

Tag proyek tersedia dalam beta di paket Claude Enterprise. Tidak tersedia untuk organisasi dengan konfigurasi HIPAA, kunci enkripsi yang dikelola pelanggan (CMEK), retensi data nol (ZDR), termasuk ZDR untuk Claude Code, retensi data minimal, atau data yang disimpan di luar AS. Juga tidak tersedia untuk organisasi yang merutekan Claude Desktop melalui penyedia model mereka sendiri.

Penting: Tag proyek hanya berfungsi di dalam proyek. Pekerjaan di luar proyek tidak mendapatkan tag.

Cara kerja tag proyek

Tag proyek menggunakan dua bagian:

Tag: Kategori yang Anda laporkan, seperti cost_code atau client_matter.
Nilai: Kode itu sendiri, seperti CC-1042.

Pemilik membuat tag dan nilainya, dan siapa pun yang dapat mengedit proyek dapat menetapkan nilai untuk proyek tersebut. Setiap tag menyimpan satu nilai per proyek, dan proyek dapat memiliki hingga 16 tag.

Sebelum Anda mulai

Peran yang diperlukan untuk membuat tag dan mengelola nilainya: Primary Owner, Owner, atau peran khusus dengan akses Owner
Peran yang diperlukan untuk menetapkan tag proyek: Akses "Dapat mengedit" ke proyek
Peran yang diperlukan untuk melihat pengeluaran berdasarkan tag: Primary Owner, Owner, atau peran khusus dengan akses tampilan Analytics dan tampilan Billing
Peran yang diperlukan untuk membuat kunci API: Primary Owner

Tempat tag proyek berlaku

Tempat pekerjaan terjadi	Apakah pengeluaran dilaporkan berdasarkan proyek?
Obrolan dalam proyek	Ya
Pengalaman obrolan terpadu dan Cowork dalam proyek	Ya
Tugas Cowork di komputer Anda	Ya. Perbarui ke Claude Desktop 3.6556.1 atau lebih baru dan pilih satu proyek untuk tugas tersebut.
Claude Code di terminal atau desktop Anda	Ya, setelah Anda menetapkan proyek untuk Claude Code. Memerlukan Claude Code 2.1.305 atau lebih baru, atau Claude Desktop 3.6556.1 atau lebih baru.

Tag proyek tidak berlaku untuk:

Claude Code di web
Claude untuk Office
Claude di Chrome
Claude Design
Claude di Slack dan Microsoft Teams
Artifacts
Mode suara
Claude API atau Claude Console
Claude Code melalui Amazon Bedrock, Google Cloud Vertex AI, gateway, atau kunci API

Siapkan tag proyek

Tag proyek aktif secara otomatis untuk organisasi yang memenuhi syarat, tanpa pengaturan untuk mengaktifkannya. Untuk memulai, buat tag.

Buat tag dan tambahkan nilainya

Pemilik dapat mengikuti langkah-langkah ini untuk membuat tag:

Navigasikan ke Pengaturan Organisasi > Organisasi > Tag Proyek.
Klik "Buat tag."
Masukkan nama, seperti cost_code. Nama huruf kecil tanpa spasi, dan Anda tidak dapat mengubah nama nanti.
Di bawah Nilai yang Diizinkan, pilih "Hanya nilai yang telah ditentukan sebelumnya" agar pengguna memilih dari daftar Anda, atau "Nilai apa pun" untuk membiarkan mereka memasukkan nilai mereka sendiri.
Jika Anda memilih "Hanya nilai yang telah ditentukan sebelumnya," tambahkan daftar Anda di bawah Nilai. Masukkan satu nilai per baris, atau tambahkan file CSV dengan satu kolom dengan value sebagai header.
(Opsional) Aktifkan toggle "Diperlukan" untuk membuat pengguna menetapkan nilai pada proyek baru.
Klik "Lanjutkan."

Untuk menambahkan nilai nanti, buka tag di halaman Tag Proyek dan klik "Tambah nilai" atau "Impor CSV."

Catatan: Nama dan nilai tag terlihat oleh semua pengguna di organisasi Anda, jadi jangan masukkan informasi sensitif ke dalamnya.

Tambahkan tag ke proyek

Siapa pun dengan akses "Dapat mengedit" dapat menambahkan tag ke proyek:

Buka proyek.
Di bawah Tag, klik "Tambah tag."
Pilih tag, lalu pilih atau masukkan nilai.

Catatan: Nama dan nilai tag terlihat oleh semua pengguna di organisasi Anda, jadi jangan masukkan informasi sensitif ke dalamnya.

Tetapkan proyek untuk Claude Code

Claude Code tidak memiliki pemilih proyek, jadi pengguna menetapkan proyek dalam file pengaturan. Jika tidak ada proyek yang ditetapkan, penggunaan Claude Code tidak diberi tag dan tidak ada peringatan, jadi beri tahu pengguna Anda.

Buka proyek di Claude dan salin ID-nya, yang merupakan bagian terakhir dari URL: claude.ai/project/bagian-ini.
Buka .claude/settings.json di repositori, atau ~/.claude/settings.json untuk menerapkannya di seluruh repositori.
Tambahkan baris di bawah, menggunakan ID proyek Anda.
Jika Anda menggunakan file pengaturan repositori, percayai folder ketika Claude Code meminta. Pengaturan berlaku setelah itu.

{ "attributionProject": "PROJECT_ID" }

Peringatan: Pastikan file tetap JSON yang valid. Koma yang tersesat dapat merusak Claude Code di komputer itu.

Lihat pengeluaran berdasarkan tag

Primary Owner, Owner, dan peran khusus dengan akses tampilan Analytics dan tampilan Billing dapat melihat pengeluaran berdasarkan tag:

Navigasikan ke Pengaturan Organisasi > Penggunaan > Pengeluaran berdasarkan proyek.
Gunakan menu "Kelompokkan berdasarkan" untuk memilih tag Anda.
Gunakan menu "Periode" dan "Produk" untuk mempersempit hasil.

Data berjalan hingga akhir kemarin (UTC). Untuk mengunduh hasil, klik "Ekspor CSV."

Catatan: Nama proyek pribadi ditampilkan sebagai "Proyek Pribadi" di halaman ini dan dalam CSV. Dashboard Analytics, API Analytics, dan API Compliance masih menampilkan nama aslinya.

Ingat poin-poin ini saat Anda membaca angkanya:

Tambahkan tag sebelum pekerjaan dimulai. Pengeluaran hanya dihitung terhadap tag setelah tag berlaku, yang membutuhkan waktu sekitar dua jam. Pengeluaran sebelumnya dalam proyek itu tidak dihitung terhadapnya.
Proyek tanpa penggunaan tidak akan muncul. Proyek muncul setelah digunakan dalam tanggal yang Anda pilih.
Pelaporan dimulai ketika tag proyek tersedia untuk organisasi Anda. Jangan perlakukan tanggal sebelumnya sebagai riwayat lengkap.
Tag baru membutuhkan waktu sekitar dua jam untuk muncul. Penggunaan selama jendela itu mungkin tetap di bawah tag sebelumnya atau tidak ada tag.
Mengubah tag tidak mengubah pengeluaran masa lalu. Penggunaan tetap di bawah tag apa pun yang dimiliki proyek pada saat itu.
Pengeluaran di luar proyek ditampilkan sebagai "Tidak dalam proyek." Ini termasuk sesi Claude Code tanpa proyek yang ditetapkan. Pengeluaran dalam proyek tanpa nilai untuk tag ditampilkan sebagai "Tidak ada nilai tag."
Jumlah mungkin tidak cocok dengan faktur Anda. Ditampilkan setelah diskon Anda dan sebelum kredit, dan angka terbaru dapat berubah hingga sekitar seminggu setelah akhir bulan.
Penggunaan yang dicakup oleh kursi tidak dihitung. Proyek yang digunakan sebagian besar di kursi mungkin menunjukkan sedikit atau tidak ada pengeluaran.

Kelola tag dan tarik pengeluaran dengan API

Anda dapat menetapkan tag dan menarik pengeluaran dari sistem Anda sendiri. Kedua API dalam beta, jadi jalur dan nama mungkin berubah. Primary Owner Anda membuat kunci API di Pengaturan Organisasi > Organisasi > API.

Tetapkan tag dengan Admin API

Buat kunci dengan cakupan read:project_tags dan write:project_tags. Admin API dapat mencantumkan tag Anda, menambahkan nilai ke daftar tag, dan menetapkan tag proyek. Tidak dapat membuat tag, mengarsipkan nilai, atau membuat proyek.

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 menggunakan ID claude_proj_, bukan ID di URL proyek. Untuk mencantumkan ID, panggil GET /v1/organizations/analytics/apps/chat/projects?date=YYYY-MM-DD dengan tanggal setidaknya satu hari yang lalu. Hanya mengembalikan proyek yang memiliki aktivitas obrolan pada tanggal itu. Panggilan ini memerlukan cakupan read:analytics, jadi aktifkan Analytics API dan tambahkan cakupan itu ke kunci Anda.

Tarik pengeluaran dengan laporan penggunaan dan biaya

Aktifkan Analytics API dan buat kunci dengan cakupan read:analytics. Bucket harian mencakup hingga 31 hari per panggilan, jadi gunakan untuk menarik bulan penuh.

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

Jumlah dalam sen, dapat mencakup fraksi sen, dan sudah termasuk diskon Anda, tetapi mungkin tidak cocok dengan faktur Anda.
Setiap panggilan mengembalikan hingga 1000 baris. Jika has_more benar, terus halaman atau total Anda akan kurang.
Teks filter tag berjalan di URL, jadi mungkin muncul dalam log permintaan.

Batasan saat ini

Berbagi: Nama dan nilai tag terlihat oleh semua pengguna di organisasi Anda, jadi jangan masukkan informasi sensitif ke dalamnya.
Pengeditan: Siapa pun yang dapat mengedit proyek dapat mengubah tagnya, dan dapat menghapus satu kecuali jika diperlukan. Anda tidak dapat mengunci tag.
Tag yang diperlukan: Ini hanya berlaku untuk proyek baru yang dibuat di web, jadi proyek yang ada tidak terpengaruh. Di web, nilai tag yang diperlukan dapat diubah tetapi tidak dapat dihapus. Admin API masih dapat menghapusnya.
Karakter: Nilai dapat mencapai 256 karakter dan dapat mencakup spasi dan koma. Nilai yang bergantung pada karakter tak terlihat, seperti emoji gabungan atau beberapa kata Persia atau Sinhala, ditolak.
Tidak termasuk dalam beta ini: Tag pada obrolan atau sesi tunggal, membagi pengeluaran di seluruh tag, mengganti nama tag atau nilai, dan batas pengeluaran berdasarkan tag.

Pertanyaan yang sering diajukan

Bisakah proyek memiliki lebih dari satu tag?

Ya, menggunakan tag terpisah seperti cost_center dan client_matter, hingga 16 per proyek. Setiap tag menyimpan satu nilai, jadi pengeluaran proyek tidak dapat dibagi di seluruh dua nilai tag yang sama.

Apakah Claude memeriksa nilai tag kami?

Tidak. Daftar membatasi apa yang dapat dipilih pengguna, tetapi nilai tidak diperiksa terhadap sistem keuangan Anda.

Bagaimana cara mematikan tag proyek?

Tag proyek tidak mengubah apa pun sampai Pemilik membuat tag. Untuk mematikannya, hubungi tim akun Anda.