Kunci API dan proyek

Setiap permintaan dibuat dengan kunci API, dan setiap kunci termasuk dalam sebuah proyek. Proyek adalah cara Anda memisahkan penggunaan berbagai aplikasi, tim, atau environment dalam satu organisasi: masing-masing punya kunci, log dan analitik sendiri, dan semuanya memakai satu saldo yang sama milik organisasi.

Membuat kunci

1. Buka Kunci API.
2. Masukkan nama yang menunjukkan di mana kunci digunakan — "Backend produksi", "Staging", "Claude Code di laptop saya".
3. Pilih proyek tempat permintaan kunci ini dihitung.
4. Klik Create key dan salin secret-nya.

Secret lengkap hanya ditampilkan sekali, tepat setelah kunci dibuat. Simpan saat itu juga di secret manager atau environment variable; secret tidak dapat ditampilkan lagi. Panduan integrasi berisi contoh siap salin dengan kunci baru Anda.

Setiap kartu kunci menampilkan proyeknya, kapan kunci dibuat, dan kapan terakhir digunakan, sehingga kunci yang sudah tidak terpakai mudah dikenali.

Merotasi kunci

Rotasi mengganti secret sebuah kunci dengan tetap mempertahankan nama, proyek, dan riwayat penggunaannya. Secret lama langsung berhenti berfungsi, jadi segera perbarui semua yang memakainya. Hanya orang yang membuat kunci yang dapat merotasinya.

Rotasi kunci kapan pun kunci itu mungkin bocor — ditempel di chat, di-commit ke repository, atau tertinggal di log.

Menghapus kunci

Menghapus kunci membuat setiap klien yang memakainya langsung gagal melakukan autentikasi. Riwayat penggunaannya tetap ada di analitik Anda, ditandai sebagai kunci yang dihapus.

Setiap orang mengelola kunci yang mereka buat. Owner dan admin dapat melihat dan menghapus kunci milik siapa pun di organisasi.

Saat seseorang dikeluarkan dari organisasi, semua kunci yang mereka buat di sana ikut dihapus.

Proyek

Setiap organisasi dimulai dengan proyek bernama default. Tambahkan proyek lain di pengaturan proyek, dan beralih di antaranya dengan pemilih proyek di sidebar konsol; halaman kunci, log, dan analitik menampilkan proyek yang dipilih.

• Ganti nama proyek kapan saja; kuncinya tetap berfungsi.
• Owner dan admin dapat menghapus proyek. Organisasi selalu memiliki setidaknya satu proyek.
• Pembagian yang baik adalah satu proyek per produk dan environment: web-production, web-staging, internal-tools.

Kunci Token Plan

Token Plan memiliki workspace sendiri dengan satu kuota bersama. Anda dapat membuat kunci bernama sebanyak yang Anda mau di sana — satu per aplikasi atau agent adalah kebiasaan yang baik — dan semuanya memakai kredit bulanan dari Token Plan tersebut. Workspace Token Plan tidak memiliki pemilih proyek.

Praktik yang baik

• Satu kunci per aplikasi, environment, dan orang. Jika terjadi kebocoran, Anda cukup merotasi satu kunci, bukan semuanya.
• Simpan kunci di server. Jangan pernah menyertakan kunci dalam bundle browser atau aplikasi mobile.
• Hapus kunci yang sudah berbulan-bulan tidak digunakan.