The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
Claude Code Analytics Admin API menyediakan akses terprogram ke metrik penggunaan harian yang diagregasi untuk pengguna Claude Code, memungkinkan organisasi untuk menganalisis produktivitas pengembang dan membangun dashboard kustom. API ini menjembatani kesenjangan antara dashboard Analytics dasar kami dan integrasi OpenTelemetry yang kompleks. API ini memungkinkan Anda untuk lebih baik memantau, menganalisis, dan mengoptimalkan adopsi Claude Code Anda:
  • Analisis Produktivitas Pengembang: Lacak sesi, baris kode yang ditambahkan/dihapus, commit, dan pull request yang dibuat menggunakan Claude Code
  • Metrik Penggunaan Tool: Pantau tingkat penerimaan dan penolakan untuk berbagai tool Claude Code (Edit, MultiEdit, Write, NotebookEdit)
  • Analisis Biaya: Lihat perkiraan biaya dan penggunaan token yang dipecah berdasarkan model Claude
  • Pelaporan Kustom: Ekspor data untuk membangun dashboard eksekutif dan laporan untuk tim manajemen
  • Justifikasi Penggunaan: Berikan metrik untuk membenarkan dan memperluas adopsi Claude Code secara internal
Kunci API admin diperlukanAPI ini adalah bagian dari Admin API. Endpoint ini memerlukan kunci Admin API (dimulai dengan sk-ant-admin...) yang berbeda dari kunci API standar. Hanya anggota organisasi dengan peran admin yang dapat menyediakan kunci Admin API melalui Anthropic Console.

​
Mulai cepat

Dapatkan analitik Claude Code organisasi Anda untuk hari tertentu: 
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"
Atur header User-Agent untuk integrasiJika Anda membangun integrasi, atur header User-Agent Anda untuk membantu kami memahami pola penggunaan:
User-Agent: YourApp/1.0.0 (https://yourapp.com)

​
Claude Code Analytics API

Lacak penggunaan Claude Code, metrik produktivitas, dan aktivitas pengembang di seluruh organisasi Anda dengan endpoint /v1/organizations/usage_report/claude_code.

​
Konsep kunci

  • Agregasi harian: Mengembalikan metrik untuk satu hari yang ditentukan oleh parameter starting_at
  • Data tingkat pengguna: Setiap record mewakili aktivitas satu pengguna untuk hari yang ditentukan
  • Metrik produktivitas: Lacak sesi, baris kode, commit, pull request, dan penggunaan tool
  • Data token dan biaya: Pantau penggunaan dan perkiraan biaya yang dipecah berdasarkan model Claude
  • Paginasi berbasis cursor: Tangani dataset besar dengan paginasi stabil menggunakan cursor opaque
  • Kesegaran data: Metrik tersedia dengan penundaan hingga 1 jam untuk konsistensi
Untuk detail parameter lengkap dan skema respons, lihat referensi Claude Code Analytics API.

​
Contoh dasar

​
Dapatkan analitik untuk hari tertentu

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​
Dapatkan analitik dengan paginasi

# Permintaan pertama
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"

# Permintaan berikutnya menggunakan cursor dari respons
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
page=page_MjAyNS0wNS0xNFQwMDowMDowMFo=" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​
Parameter permintaan

ParameterTipeWajibDeskripsi
starting_atstringYaTanggal UTC dalam format YYYY-MM-DD. Mengembalikan metrik hanya untuk hari tunggal ini
limitintegerTidakJumlah record per halaman (default: 20, maks: 1000)
pagestringTidakToken cursor opaque dari field next_page respons sebelumnya

​
Metrik yang tersedia

Setiap record respons berisi metrik berikut untuk satu pengguna pada satu hari:

​
Dimensi

  • date: Tanggal dalam format RFC 3339 (timestamp UTC)
  • actor: Pengguna atau kunci API yang melakukan tindakan Claude Code (baik user_actor dengan email_address atau api_actor dengan api_key_name)
  • organization_id: UUID organisasi
  • customer_type: Jenis akun pelanggan (api untuk pelanggan API, subscription untuk pelanggan Pro/Team)
  • terminal_type: Jenis terminal atau lingkungan tempat Claude Code digunakan (misalnya, vscode, iTerm.app, tmux)

​
Metrik inti

  • num_sessions: Jumlah sesi Claude Code yang berbeda yang dimulai oleh aktor ini
  • lines_of_code.added: Total jumlah baris kode yang ditambahkan di semua file oleh Claude Code
  • lines_of_code.removed: Total jumlah baris kode yang dihapus di semua file oleh Claude Code
  • commits_by_claude_code: Jumlah commit git yang dibuat melalui fungsionalitas commit Claude Code
  • pull_requests_by_claude_code: Jumlah pull request yang dibuat melalui fungsionalitas PR Claude Code

​
Metrik tindakan tool

Rincian tingkat penerimaan dan penolakan tindakan tool berdasarkan jenis tool:
  • edit_tool.accepted/rejected: Jumlah proposal Edit tool yang diterima/ditolak pengguna
  • multi_edit_tool.accepted/rejected: Jumlah proposal MultiEdit tool yang diterima/ditolak pengguna
  • write_tool.accepted/rejected: Jumlah proposal Write tool yang diterima/ditolak pengguna
  • notebook_edit_tool.accepted/rejected: Jumlah proposal NotebookEdit tool yang diterima/ditolak pengguna

​
Rincian model

Untuk setiap model Claude yang digunakan:
  • model: Identifier model Claude (misalnya, claude-3-5-sonnet-20241022)
  • tokens.input/output: Jumlah token input dan output untuk model ini
  • tokens.cache_read/cache_creation: Penggunaan token terkait cache untuk model ini
  • estimated_cost.amount: Perkiraan biaya dalam sen USD untuk model ini
  • estimated_cost.currency: Kode mata uang untuk jumlah biaya (saat ini selalu USD)

​
Struktur respons

API mengembalikan data dalam format berikut: 
{
  "data": [
    {
      "date": "2025-09-01T00:00:00Z",
      "actor": {
        "type": "user_actor",
        "email_address": "developer@company.com"
      },
      "organization_id": "dc9f6c26-b22c-4831-8d01-0446bada88f1",
      "customer_type": "api",
      "terminal_type": "vscode",
      "core_metrics": {
        "num_sessions": 5,
        "lines_of_code": {
          "added": 1543,
          "removed": 892
        },
        "commits_by_claude_code": 12,
        "pull_requests_by_claude_code": 2
      },
      "tool_actions": {
        "edit_tool": {
          "accepted": 45,
          "rejected": 5
        },
        "multi_edit_tool": {
          "accepted": 12,
          "rejected": 2
        },
        "write_tool": {
          "accepted": 8,
          "rejected": 1
        },
        "notebook_edit_tool": {
          "accepted": 3,
          "rejected": 0
        }
      },
      "model_breakdown": [
        {
          "model": "claude-3-5-sonnet-20241022",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 1025
          }
        }
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

​
Paginasi

API mendukung paginasi berbasis cursor untuk organisasi dengan jumlah pengguna yang besar:
  1. Buat permintaan awal Anda dengan parameter limit opsional
  2. Jika has_more adalah true dalam respons, gunakan nilai next_page dalam permintaan berikutnya
  3. Lanjutkan sampai has_more adalah false
Cursor mengkodekan posisi record terakhir dan memastikan paginasi stabil bahkan ketika data baru tiba. Setiap sesi paginasi mempertahankan batas data yang konsisten untuk memastikan Anda tidak melewatkan atau menduplikasi record.

​
Kasus penggunaan umum

  • Dashboard eksekutif: Buat laporan tingkat tinggi yang menunjukkan dampak Claude Code pada kecepatan pengembangan
  • Perbandingan tool AI: Ekspor metrik untuk membandingkan Claude Code dengan tool coding AI lainnya seperti Copilot dan Cursor
  • Analisis produktivitas pengembang: Lacak metrik produktivitas individu dan tim dari waktu ke waktu
  • Pelacakan dan alokasi biaya: Pantau pola pengeluaran dan alokasikan biaya berdasarkan tim atau proyek
  • Pemantauan adopsi: Identifikasi tim dan pengguna mana yang mendapatkan nilai paling banyak dari Claude Code
  • Justifikasi ROI: Berikan metrik konkret untuk membenarkan dan memperluas adopsi Claude Code secara internal

​
Pertanyaan yang sering diajukan

​
Seberapa segar data analitik?

Data analitik Claude Code biasanya muncul dalam 1 jam setelah penyelesaian aktivitas pengguna. Untuk memastikan hasil paginasi yang konsisten, hanya data yang lebih lama dari 1 jam yang disertakan dalam respons.

​
Bisakah saya mendapatkan metrik real-time?

Tidak, API ini hanya menyediakan metrik harian yang diagregasi. Untuk pemantauan real-time, pertimbangkan menggunakan integrasi OpenTelemetry.

​
Bagaimana pengguna diidentifikasi dalam data?

Pengguna diidentifikasi melalui field actor dalam dua cara:
  • user_actor: Berisi email_address untuk pengguna yang mengautentikasi melalui OAuth (paling umum)
  • api_actor: Berisi api_key_name untuk pengguna yang mengautentikasi melalui kunci API
Field customer_type menunjukkan apakah penggunaan dari pelanggan api (API PAYG) atau pelanggan subscription (paket Pro/Team).

​
Berapa periode retensi data?

Data analitik Claude Code historis disimpan dan dapat diakses melalui API. Tidak ada periode penghapusan yang ditentukan untuk data ini.

​
Deployment Claude Code mana yang didukung?

API ini hanya melacak penggunaan Claude Code pada Anthropic API (pihak pertama). Penggunaan pada Amazon Bedrock, Google Vertex AI, atau platform pihak ketiga lainnya tidak disertakan.

​
Berapa biaya menggunakan API ini?

Claude Code Analytics API gratis digunakan untuk semua organisasi dengan akses ke Admin API.

​
Bagaimana cara menghitung tingkat penerimaan tool?

Tingkat penerimaan tool = accepted / (accepted + rejected) untuk setiap jenis tool. Misalnya, jika edit tool menunjukkan 45 diterima dan 5 ditolak, tingkat penerimaannya adalah 90%.

​
Zona waktu apa yang digunakan untuk parameter tanggal?

Semua tanggal dalam UTC. Parameter starting_at harus dalam format YYYY-MM-DD dan mewakili tengah malam UTC untuk hari tersebut.

​
Lihat juga

Claude Code Analytics API membantu Anda memahami dan mengoptimalkan alur kerja pengembangan tim Anda. Pelajari lebih lanjut tentang fitur terkait: