Cara Menggunakan Claude Code Analytics via API

Kecerdasan Buatan mengubah cara tim melakukan coding, dan memiliki visibilitas yang jelas terhadap penggunaan alat serta produktivitas adalah terobosan besar. Di sinilah Claude Code Analytics API, alat canggih dari Anthropic, membuka wawasan mendalam tentang bagaimana sebuah organisasi memanfaatkan Claude Code, asisten coding bertenaga AI mereka. API ini bukan hanya tentang angka—tetapi tentang memberdayakan tim untuk melacak aktivitas pengembang, mengoptimalkan alur kerja, dan mengelola biaya dengan presisi. Baik Anda seorang pemimpin proyek yang memastikan tim Anda memaksimalkan alat AI atau seorang CTO yang membenarkan investasi, Claude Code Analytics API memberikan data yang dapat ditindaklanjuti untuk membuat keputusan yang tepat. Dalam panduan ini, kita akan menjelajahi apa yang dilakukan API ini, fitur-fitur intinya, cara menggunakannya, dan mengapa ini adalah keharusan bagi organisasi yang meningkatkan coding berbantuan AI. Mari kita selami dan lihat bagaimana Claude Code Analytics API dapat mengubah produktivitas tim Anda!

💡

Ingin alat Pengujian API hebat yang menghasilkan Dokumentasi API yang indah?

Ingin platform All-in-One terintegrasi untuk Tim Pengembang Anda bekerja sama dengan produktivitas maksimum?

Apidog memenuhi semua permintaan Anda, dan menggantikan Postman dengan harga yang jauh lebih terjangkau!

tombol

Apa Itu Claude Code Analytics API

Claude Code Analytics API bagaikan jendela ke dalam penggunaan Claude Code oleh organisasi Anda, asisten coding AI dari Anthropic. API ini menyediakan akses terprogram ke analitik penggunaan dan metrik produktivitas yang terperinci, memberi Anda gambaran yang jelas tentang bagaimana pengembang berinteraksi dengan Claude Code. Baik itu melacak baris kode yang dihasilkan, memantau penggunaan API, atau menganalisis biaya, API ini adalah pilihan utama Anda untuk transparansi. Tersedia sebagai endpoint khusus di bawah platform Anthropic (/v1/organizations/usage_report/claude_code), API ini dirancang untuk organisasi yang menggunakan Claude Code untuk meningkatkan upaya pengembangan mereka. Dengan Claude Code Analytics API, Anda dapat menjawab pertanyaan-pertanyaan penting seperti: Apakah pengembang sepenuhnya memanfaatkan Claude Code? Alat mana yang paling sering mereka gunakan? Berapa banyak yang kita belanjakan untuk model AI? Tingkat wawasan ini sangat berharga untuk menyelaraskan adopsi AI dengan tujuan bisnis.

Fitur dan Kemampuan Inti Claude Analytics API

Apa yang membuat Claude Code Analytics API menonjol? API ini dilengkapi dengan fitur-fitur yang memenuhi kebutuhan teknis dan bisnis. Berikut ringkasannya:

Analitik Agregat Harian: API memberikan metrik untuk hari tertentu, yang ditentukan melalui parameter starting_at. Anda mendapatkan data per pengguna dan seluruh organisasi, sehingga mudah untuk memperbesar atau memperkecil tampilan.
Metrik Produktivitas Pengembang: Lacak sesi, baris kode yang ditambahkan atau dihapus, commit, pull request, dan penggunaan alat (seperti fitur Edit atau Write Claude). Ini membantu Anda melihat bagaimana Claude Code meningkatkan hasil kerja tim Anda.
Wawasan Token dan Biaya: Pantau konsumsi token dan perkiraan biaya, dipecah berdasarkan varian model Claude (misalnya, Claude 3.7 Sonnet). Sempurna untuk menjaga anggaran tetap terkendali.
Paginasi Berbasis Kursor: Tangani kumpulan data besar secara efisien dengan kursor buram, memastikan pengambilan data yang stabil dan terukur.
Kesegaran Data: Metrik tersedia dengan penundaan sekitar satu jam, memastikan konsistensi tanpa tekanan waktu nyata.

Fitur-fitur ini menjadikan Claude Code Analytics API alat yang tangguh untuk memahami dan mengoptimalkan penggunaan Claude Code, baik Anda mengelola tim kecil maupun perusahaan besar.

Detail Teknis dan Penggunaan

Siap untuk mencoba Claude Code Analytics API? Ini adalah API REST, jadi mudah digunakan jika Anda terbiasa dengan permintaan HTTP. Endpoint-nya adalah /v1/organizations/usage_report/claude_code, dan Anda memerlukan kunci API Admin (dimulai dengan sk-ant-admin...) untuk mengaksesnya. Anda dapat membuat kunci ini di Anthropic Console di bawah Settings > API Keys, tetapi hanya admin yang dapat melakukannya—jadi pastikan organisasi Anda telah diatur di Console > Settings > Organization.

Berikut adalah contoh singkat untuk mengambil analitik untuk hari tertentu menggunakan curl:

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2025-09-08&limit=20" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY" \
  --header "User-Agent: MyApp/1.0.0 (https://myapp.com)"

Mari kita uraikan:

Endpoint: /v1/organizations/usage_report/claude_code
Parameter: Gunakan starting_at untuk menentukan tanggal (misalnya, 2025-09-08) dan limit untuk mengontrol hasil per permintaan (misalnya, 20 catatan).
Header: Sertakan anthropic-version untuk versi API, x-api-key untuk autentikasi, dan User-Agent untuk membantu Anthropic melacak pola penggunaan.
Paginasi: Jika Anda berurusan dengan tim besar, API menggunakan paginasi berbasis kursor. Responsnya menyertakan bidang next_cursor untuk mengambil batch berikutnya.

Responsnya adalah objek JSON dengan bidang seperti user_id, sessions, lines_added, lines_removed, commits, tool_usage, dan cost_usd, memberi Anda gambaran rinci tentang aktivitas. Untuk detail skema lengkap, periksa referensi API Anthropic di docs.anthropic.com.

Menguji Endpoint API dengan Apidog

Sebelum mengintegrasikan Claude Code Analytics API ke dalam alur kerja Anda, ada baiknya untuk menguji endpoint API Anda untuk memastikan semuanya berjalan lancar. Di sinilah Apidog berperan—alat fantastis untuk merancang, menguji, dan men-debug API. Apidog sangat membantu bagi pengembang yang mengerjakan proyek yang mengandalkan API seperti Claude Code Analytics. Berikut cara Anda dapat menggunakannya:

Mulai: Unduh Apidog dari apidog.com/download atau gunakan versi web.
Siapkan Pengujian: Buat proyek baru di Apidog dan tambahkan endpoint Claude Code Analytics (/v1/organizations/usage_report/claude_code). Jika Anthropic menyediakan spesifikasi OpenAPI, impor; jika tidak, definisikan endpoint secara manual.
Jalankan Pengujian: Gunakan modul pengujian Apidog untuk mengirim permintaan dengan kunci API dan parameter Anda (misalnya, starting_at). Verifikasi skema respons, kode status (harapkan 200 OK), dan akurasi data.
Debug Masalah: Antarmuka visual Apidog membantu Anda menemukan kesalahan, seperti header yang hilang atau tanggal yang tidak valid, memastikan panggilan API Anda siap produksi.

tombol

gunakan apidog untuk menguji endpoint api

Pengujian dengan Apidog memastikan integrasi Claude Code Analytics API Anda kokoh, menyelamatkan Anda dari kejutan saat melakukan penskalaan ke dashboard atau alat pelaporan. Ini adalah keharusan untuk setiap proyek yang melibatkan analitik berbasis API.

Dashboard Buatan Komunitas dengan Claude Code Analytics API

Claude Code Analytics API telah memicu kreativitas di komunitas pengembang, menghasilkan dashboard kustom untuk memvisualisasikan penggunaan. Contoh utama adalah proyek Claude Code Templates, sebuah dashboard open-source yang berjalan secara lokal untuk memantau semua sesi Claude Code Anda secara real-time.

Mulai: Instal dan jalankan langsung dengan perintah npx claude-code-templates@latest --analytics. Ini akan memunculkan dashboard lokal di localhost:3333—memastikan tidak ada data yang meninggalkan mesin Anda. Dashboard ini menampilkan grafik penggunaan token, rincian aktivitas proyek, dan kemampuan ekspor. Ini adalah alat yang ampuh bagi pengembang untuk mendapatkan wawasan langsung dan pribadi tentang pola alur kerja dan biaya AI mereka.

Dashboard Buatan Komunitas dengan Claude Code Analytics API

Proyek-proyek komunitas ini menunjukkan betapa serbagunanya Claude Code Analytics API. Anda dapat menyebarkan dashboard ini di server Anda atau platform cloud seperti Vercel atau Render, memberikan tim Anda wawasan real-time tentang penggunaan Claude Code.

Integrasi dan Pengalaman Pengembang

Claude Code Analytics API dirancang untuk integrasi yang mulus. Sifat RESTful-nya dan respons JSON yang konsisten membuatnya mudah untuk dihubungkan ke dashboard, sistem penagihan, atau alat kustom. Berikut cara Anda dapat membuatnya bekerja untuk Anda:

Mulai Cepat dengan Curl: Contoh curl di atas sempurna untuk pembuatan prototipe. Uji di terminal Anda untuk melihat aliran data secara instan.
Bangun Dashboard: Integrasikan dengan alat seperti Grafana atau Power BI. Masukkan respons API ke dalam visualisasi untuk melacak KPI seperti jumlah sesi atau tren biaya.
Otomatiskan Pelaporan: Gunakan skrip (misalnya, Python dengan requests) untuk menarik data setiap hari dan menghasilkan laporan untuk pemangku kepentingan.
Pengambilan Skalabel: Paginasi berbasis kursor memastikan Anda dapat menangani data untuk tim besar tanpa hambatan kinerja.

Misalnya, skrip Python untuk mengambil dan memproses data mungkin terlihat seperti ini:

import requests

def fetch_claude_analytics(api_key, date, limit=20, cursor=None):
    url = "https://api.anthropic.com/v1/organizations/usage_report/claude_code"
    headers = {
        "anthropic-version": "2023-06-01",
        "x-api-key": api_key,
        "User-Agent": "MyApp/1.0.0 (https://myapp.com)"
    }
    params = {"starting_at": date, "limit": limit}
    if cursor:
        params["cursor"] = cursor
    
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json()

# Contoh penggunaan
api_key = "kunci-api-admin-anda"
data = fetch_claude_analytics(api_key, "2025-09-08")
for record in data["records"]:
    print(f"Pengguna: {record['user_id']}, Sesi: {record['sessions']}, Biaya: ${record['cost_usd']:.2f}")

Skrip ini mengambil data untuk tanggal tertentu dan mencetak metrik utama. Anda dapat mengembangkannya untuk menyimpan hasil dalam database atau menghasilkan grafik untuk tim Anda.

Keterbatasan dan Pertimbangan Claude Analytics API

Meskipun Claude Code Analytics API sangat kuat, ada beberapa hal yang perlu diingat:

Akses Admin Diperlukan: Hanya anggota organisasi dengan peran admin yang dapat mengakses API, jadi pastikan akun Anda memiliki izin yang benar.
Privasi Data: Tangani data penggunaan dengan hati-hati, karena itu termasuk metrik spesifik pengguna. Ikuti kebijakan privasi organisasi Anda untuk tetap patuh.
Batasan Lingkup: API ini berfokus pada penggunaan Claude Code, bukan API Claude lainnya (misalnya, endpoint percakapan). Jika Anda memerlukan analitik yang lebih luas, Anda akan memerlukan alat tambahan.

Pertimbangan-pertimbangan ini tidak mengurangi nilai API tetapi membantu Anda merencanakan penggunaannya secara efektif.

Kesimpulan

Claude Code Analytics API adalah keharusan bagi organisasi yang merangkul coding berbantuan AI dengan Claude Code. API ini menawarkan visibilitas tak tertandingi ke dalam aktivitas pengembang, produktivitas, dan biaya, menjadikannya landasan untuk keputusan berbasis data. Baik Anda membangun dashboard, mengoptimalkan anggaran, atau membenarkan investasi AI, API ini memberikan wawasan yang Anda butuhkan. Komitmen Anthropic terhadap transparansi terlihat jelas, dan dengan potensi peningkatan di masa depan—seperti data real-time atau integrasi yang lebih dalam—Claude Code Analytics API siap untuk berkembang lebih jauh. Jadi, ambil kunci API Anda, jalankan perintah curl, dan mulailah membuka potensi penuh penggunaan Claude Code tim Anda hari ini!

tombol