Administrasi dan pemantauan

Ruang Kerja

Atur kunci API, kelola akses tim, dan kontrol biaya dengan ruang kerja.

Ruang kerja menyediakan cara untuk mengatur penggunaan API Anda dalam organisasi. Gunakan ruang kerja untuk memisahkan proyek, lingkungan, atau tim yang berbeda sambil mempertahankan penagihan dan administrasi terpusat.

Cara kerja ruang kerja

Setiap organisasi memiliki Ruang Kerja Default yang tidak dapat diubah nama, diarsipkan, atau dihapus. Ketika Anda membuat ruang kerja tambahan, Anda dapat menetapkan kunci API, anggota, dan batas sumber daya untuk masing-masing.

Karakteristik utama:

Pengenal ruang kerja menggunakan awalan wrkspc_ (misalnya, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
Maksimal 100 ruang kerja per organisasi (ruang kerja yang diarsipkan tidak dihitung)
Ruang Kerja Default tidak memiliki ID dan tidak muncul di endpoint daftar
Kunci API dibatasi pada satu ruang kerja dan hanya dapat mengakses sumber daya dalam ruang kerja tersebut

Peran dan izin ruang kerja

Anggota dapat memiliki peran berbeda di setiap ruang kerja, memungkinkan kontrol akses yang terperinci.

Peran	Izin
Pengguna Ruang Kerja	Gunakan Workbench saja
Pengembang Ruang Kerja	Buat dan kelola kunci API, gunakan API
Admin Ruang Kerja	Kontrol penuh atas pengaturan dan anggota ruang kerja
Penagihan Ruang Kerja	Lihat informasi penagihan ruang kerja (diwarisi dari peran penagihan organisasi)

Pewarisan peran

Admin organisasi secara otomatis menerima akses Admin Ruang Kerja ke semua ruang kerja
Anggota penagihan organisasi secara otomatis menerima akses Penagihan Ruang Kerja ke semua ruang kerja
Pengguna dan pengembang organisasi harus ditambahkan secara eksplisit ke setiap ruang kerja

Peran Penagihan Ruang Kerja tidak dapat ditetapkan secara manual. Peran ini diwarisi dari memiliki peran penagihan organisasi.

Mengelola ruang kerja

Hanya admin organisasi yang dapat membuat ruang kerja. Pengguna dan pengembang organisasi harus ditambahkan ke ruang kerja oleh admin.

Melalui Konsol

Buat dan kelola ruang kerja di Konsol Claude.

Buat ruang kerja

Buka pengaturan ruang kerja
Di Konsol Claude, buka Pengaturan > Ruang Kerja.
Tambahkan ruang kerja baru
Klik Tambah Ruang Kerja.
Konfigurasi ruang kerja
Masukkan nama ruang kerja dan pilih warna untuk identifikasi visual.
Buat ruang kerja
Klik Buat untuk menyelesaikan.

Untuk beralih antar ruang kerja di Konsol, gunakan pemilih Ruang Kerja di sudut kiri atas.

Edit detail ruang kerja

Untuk mengubah nama atau warna ruang kerja:

Pilih ruang kerja dari daftar
Klik menu elipsis (...) dan pilih Edit detail
Perbarui nama atau warna dan simpan perubahan Anda

Ruang Kerja Default tidak dapat diubah nama atau dihapus.

Tambahkan anggota ke ruang kerja

Navigasi ke tab Anggota ruang kerja
Klik Tambah ke Ruang Kerja
Pilih anggota organisasi dan tetapkan mereka peran ruang kerja
Konfirmasi penambahan

Untuk menghapus anggota, klik ikon tempat sampah di sebelah nama mereka.

Admin organisasi dan anggota penagihan tidak dapat dihapus dari ruang kerja saat mereka memiliki peran organisasi tersebut.

Atur batas ruang kerja

Di tab Batas, Anda dapat mengonfigurasi:

Batas laju: Atur batas per tingkat model untuk permintaan per menit, token input, atau token output
Notifikasi pengeluaran: Konfigurasikan peringatan ketika pengeluaran mencapai ambang batas tertentu

Arsipkan ruang kerja

Untuk mengarsipkan ruang kerja, klik menu elipsis (...) dan pilih Arsipkan. Pengarsipan:

Menyimpan data historis untuk pelaporan
Menonaktifkan ruang kerja dan semua kunci API terkait
Tidak dapat dibatalkan

Mengarsipkan ruang kerja segera mencabut semua kunci API di ruang kerja tersebut. Tindakan ini tidak dapat dibatalkan.

Melalui Admin API

Kelola ruang kerja secara terprogram menggunakan Admin API.

Endpoint Admin API 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 Konsol Claude.

# Create a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"name": "Production"}'

# List workspaces
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Archive a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Untuk detail parameter lengkap dan skema respons, lihat referensi API Ruang Kerja.

Mengelola anggota ruang kerja

Tambahkan, perbarui, atau hapus anggota dari ruang kerja:

# Add a member to a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# Update a member's role
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"workspace_role": "workspace_admin"}'

# Remove a member from a workspace
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Untuk detail parameter lengkap, lihat referensi API Anggota Ruang Kerja.

Kunci API dan cakupan sumber daya

Kunci API dibatasi pada ruang kerja tertentu. Ketika Anda membuat kunci API di ruang kerja, kunci tersebut hanya dapat mengakses sumber daya dalam ruang kerja tersebut.

Sumber daya yang dibatasi pada ruang kerja meliputi:

File yang dibuat melalui Files API
Batch Pesan yang dibuat melalui Batch API
Keterampilan yang dibuat melalui Skills API

Mulai 5 Februari 2026, cache prompt juga akan diisolasi per ruang kerja (berlaku untuk Claude API dan Azure saja).

Untuk mengambil ID ruang kerja organisasi Anda, gunakan endpoint Daftar Ruang Kerja, atau temukan di Konsol Claude.

Batas ruang kerja

Anda dapat menetapkan batas pengeluaran dan laju kustom untuk setiap ruang kerja untuk melindungi dari penggunaan berlebihan dan memastikan distribusi sumber daya yang adil.

Menetapkan batas ruang kerja

Batas ruang kerja dapat ditetapkan lebih rendah dari (tetapi tidak lebih tinggi dari) batas organisasi Anda:

Batas pengeluaran: Batasi pengeluaran bulanan untuk ruang kerja
Batas laju: Batasi permintaan per menit, token input per menit, atau token output per menit

Anda tidak dapat menetapkan batas pada Ruang Kerja Default
Jika tidak ditetapkan, batas ruang kerja cocok dengan batas organisasi
Batas di seluruh organisasi selalu berlaku, bahkan jika batas ruang kerja ditambahkan melebihi

Untuk informasi terperinci tentang batas laju dan cara kerjanya, lihat Batas laju.

Pelacakan penggunaan dan biaya

Lacak penggunaan dan biaya berdasarkan ruang kerja menggunakan Usage and Cost API:

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
group_by[]=workspace_id&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Penggunaan dan biaya yang dikaitkan dengan Ruang Kerja Default memiliki nilai null untuk workspace_id.

Kasus penggunaan umum

Pemisahan lingkungan

Buat ruang kerja terpisah untuk pengembangan, staging, dan produksi:

Ruang Kerja	Tujuan
Pengembangan	Pengujian dan eksperimen dengan batas laju yang lebih rendah
Staging	Pengujian pra-produksi dengan batas seperti produksi
Produksi	Lalu lintas langsung dengan batas laju penuh dan pemantauan

Isolasi tim atau departemen

Tetapkan ruang kerja ke tim berbeda untuk alokasi biaya dan kontrol akses:

Tim teknik dengan akses pengembang
Tim ilmu data dengan kunci API mereka sendiri
Tim dukungan dengan akses terbatas untuk alat pelanggan

Organisasi berbasis proyek

Buat ruang kerja untuk proyek atau produk tertentu untuk melacak penggunaan dan biaya secara terpisah.

Praktik terbaik

Rencanakan struktur ruang kerja Anda
Pertimbangkan bagaimana Anda akan mengatur ruang kerja sebelum membuatnya. Pikirkan tentang penagihan, kontrol akses, dan kebutuhan pelacakan penggunaan.
Gunakan nama yang bermakna
Beri nama ruang kerja dengan jelas untuk menunjukkan tujuannya (misalnya, "Produksi - Chatbot Pelanggan", "Dev - Alat Internal").
Atur batas yang sesuai
Konfigurasikan batas pengeluaran dan laju untuk mencegah biaya yang tidak terduga dan memastikan distribusi sumber daya yang adil.
Audit akses secara teratur
Tinjau keanggotaan ruang kerja secara berkala untuk memastikan hanya pengguna yang sesuai yang memiliki akses.
Pantau penggunaan
Gunakan Usage and Cost API untuk melacak konsumsi tingkat ruang kerja.

FAQ

Lihat juga

Was this page helpful?

Administrasi dan pemantauan

Ruang Kerja

Atur kunci API, kelola akses tim, dan kontrol biaya dengan ruang kerja.

Cara kerja ruang kerja

Karakteristik utama:

Pengenal ruang kerja menggunakan awalan wrkspc_ (misalnya, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
Maksimal 100 ruang kerja per organisasi (ruang kerja yang diarsipkan tidak dihitung)
Ruang Kerja Default tidak memiliki ID dan tidak muncul di endpoint daftar
Kunci API dibatasi pada satu ruang kerja dan hanya dapat mengakses sumber daya dalam ruang kerja tersebut

Peran dan izin ruang kerja

Anggota dapat memiliki peran berbeda di setiap ruang kerja, memungkinkan kontrol akses yang terperinci.

Peran	Izin
Pengguna Ruang Kerja	Gunakan Workbench saja
Pengembang Ruang Kerja	Buat dan kelola kunci API, gunakan API
Admin Ruang Kerja	Kontrol penuh atas pengaturan dan anggota ruang kerja
Penagihan Ruang Kerja	Lihat informasi penagihan ruang kerja (diwarisi dari peran penagihan organisasi)

Pewarisan peran

Admin organisasi secara otomatis menerima akses Admin Ruang Kerja ke semua ruang kerja
Anggota penagihan organisasi secara otomatis menerima akses Penagihan Ruang Kerja ke semua ruang kerja
Pengguna dan pengembang organisasi harus ditambahkan secara eksplisit ke setiap ruang kerja

Peran Penagihan Ruang Kerja tidak dapat ditetapkan secara manual. Peran ini diwarisi dari memiliki peran penagihan organisasi.

Mengelola ruang kerja

Hanya admin organisasi yang dapat membuat ruang kerja. Pengguna dan pengembang organisasi harus ditambahkan ke ruang kerja oleh admin.

Melalui Konsol

Buat dan kelola ruang kerja di Konsol Claude.

Buat ruang kerja

Buka pengaturan ruang kerja
Di Konsol Claude, buka Pengaturan > Ruang Kerja.
Tambahkan ruang kerja baru
Klik Tambah Ruang Kerja.
Konfigurasi ruang kerja
Masukkan nama ruang kerja dan pilih warna untuk identifikasi visual.
Buat ruang kerja
Klik Buat untuk menyelesaikan.

Untuk beralih antar ruang kerja di Konsol, gunakan pemilih Ruang Kerja di sudut kiri atas.

Edit detail ruang kerja

Untuk mengubah nama atau warna ruang kerja:

Pilih ruang kerja dari daftar
Klik menu elipsis (...) dan pilih Edit detail
Perbarui nama atau warna dan simpan perubahan Anda

Ruang Kerja Default tidak dapat diubah nama atau dihapus.

Tambahkan anggota ke ruang kerja

Navigasi ke tab Anggota ruang kerja
Klik Tambah ke Ruang Kerja
Pilih anggota organisasi dan tetapkan mereka peran ruang kerja
Konfirmasi penambahan

Untuk menghapus anggota, klik ikon tempat sampah di sebelah nama mereka.

Admin organisasi dan anggota penagihan tidak dapat dihapus dari ruang kerja saat mereka memiliki peran organisasi tersebut.

Atur batas ruang kerja

Di tab Batas, Anda dapat mengonfigurasi:

Batas laju: Atur batas per tingkat model untuk permintaan per menit, token input, atau token output
Notifikasi pengeluaran: Konfigurasikan peringatan ketika pengeluaran mencapai ambang batas tertentu

Arsipkan ruang kerja

Untuk mengarsipkan ruang kerja, klik menu elipsis (...) dan pilih Arsipkan. Pengarsipan:

Menyimpan data historis untuk pelaporan
Menonaktifkan ruang kerja dan semua kunci API terkait
Tidak dapat dibatalkan

Mengarsipkan ruang kerja segera mencabut semua kunci API di ruang kerja tersebut. Tindakan ini tidak dapat dibatalkan.

Melalui Admin API

Kelola ruang kerja secara terprogram menggunakan Admin API.

# Create a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"name": "Production"}'

# List workspaces
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Archive a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Untuk detail parameter lengkap dan skema respons, lihat referensi API Ruang Kerja.

Mengelola anggota ruang kerja

Tambahkan, perbarui, atau hapus anggota dari ruang kerja:

# Add a member to a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# Update a member's role
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"workspace_role": "workspace_admin"}'

# Remove a member from a workspace
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Untuk detail parameter lengkap, lihat referensi API Anggota Ruang Kerja.

Kunci API dan cakupan sumber daya

Kunci API dibatasi pada ruang kerja tertentu. Ketika Anda membuat kunci API di ruang kerja, kunci tersebut hanya dapat mengakses sumber daya dalam ruang kerja tersebut.

Sumber daya yang dibatasi pada ruang kerja meliputi:

File yang dibuat melalui Files API
Batch Pesan yang dibuat melalui Batch API
Keterampilan yang dibuat melalui Skills API

Mulai 5 Februari 2026, cache prompt juga akan diisolasi per ruang kerja (berlaku untuk Claude API dan Azure saja).

Untuk mengambil ID ruang kerja organisasi Anda, gunakan endpoint Daftar Ruang Kerja, atau temukan di Konsol Claude.

Batas ruang kerja

Anda dapat menetapkan batas pengeluaran dan laju kustom untuk setiap ruang kerja untuk melindungi dari penggunaan berlebihan dan memastikan distribusi sumber daya yang adil.

Menetapkan batas ruang kerja

Batas ruang kerja dapat ditetapkan lebih rendah dari (tetapi tidak lebih tinggi dari) batas organisasi Anda:

Batas pengeluaran: Batasi pengeluaran bulanan untuk ruang kerja
Batas laju: Batasi permintaan per menit, token input per menit, atau token output per menit

Anda tidak dapat menetapkan batas pada Ruang Kerja Default
Jika tidak ditetapkan, batas ruang kerja cocok dengan batas organisasi
Batas di seluruh organisasi selalu berlaku, bahkan jika batas ruang kerja ditambahkan melebihi

Untuk informasi terperinci tentang batas laju dan cara kerjanya, lihat Batas laju.

Pelacakan penggunaan dan biaya

Lacak penggunaan dan biaya berdasarkan ruang kerja menggunakan Usage and Cost API:

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
group_by[]=workspace_id&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Penggunaan dan biaya yang dikaitkan dengan Ruang Kerja Default memiliki nilai null untuk workspace_id.

Kasus penggunaan umum

Pemisahan lingkungan

Buat ruang kerja terpisah untuk pengembangan, staging, dan produksi:

Ruang Kerja	Tujuan
Pengembangan	Pengujian dan eksperimen dengan batas laju yang lebih rendah
Staging	Pengujian pra-produksi dengan batas seperti produksi
Produksi	Lalu lintas langsung dengan batas laju penuh dan pemantauan

Isolasi tim atau departemen

Tetapkan ruang kerja ke tim berbeda untuk alokasi biaya dan kontrol akses:

Tim teknik dengan akses pengembang
Tim ilmu data dengan kunci API mereka sendiri
Tim dukungan dengan akses terbatas untuk alat pelanggan

Organisasi berbasis proyek

Buat ruang kerja untuk proyek atau produk tertentu untuk melacak penggunaan dan biaya secara terpisah.

Praktik terbaik

Rencanakan struktur ruang kerja Anda
Pertimbangkan bagaimana Anda akan mengatur ruang kerja sebelum membuatnya. Pikirkan tentang penagihan, kontrol akses, dan kebutuhan pelacakan penggunaan.
Gunakan nama yang bermakna
Beri nama ruang kerja dengan jelas untuk menunjukkan tujuannya (misalnya, "Produksi - Chatbot Pelanggan", "Dev - Alat Internal").
Atur batas yang sesuai
Konfigurasikan batas pengeluaran dan laju untuk mencegah biaya yang tidak terduga dan memastikan distribusi sumber daya yang adil.
Audit akses secara teratur
Tinjau keanggotaan ruang kerja secara berkala untuk memastikan hanya pengguna yang sesuai yang memiliki akses.
Pantau penggunaan
Gunakan Usage and Cost API untuk melacak konsumsi tingkat ruang kerja.

FAQ

Lihat juga

Was this page helpful?

Cara kerja ruang kerja

Peran dan izin ruang kerja

Pewarisan peran

Mengelola ruang kerja

Melalui Konsol

Buat ruang kerja

Edit detail ruang kerja

Tambahkan anggota ke ruang kerja

Atur batas ruang kerja

Arsipkan ruang kerja

Melalui Admin API

Mengelola anggota ruang kerja

Kunci API dan cakupan sumber daya

Batas ruang kerja

Menetapkan batas ruang kerja

Pelacakan penggunaan dan biaya

Kasus penggunaan umum

Pemisahan lingkungan

Isolasi tim atau departemen

Organisasi berbasis proyek

Praktik terbaik

FAQ

Apa itu Ruang Kerja Default?

Apakah ada batasan pada ruang kerja?

Bagaimana peran organisasi mempengaruhi akses ruang kerja?

Peran mana yang dapat ditetapkan di ruang kerja?

Dapatkah peran ruang kerja admin atau anggota penagihan organisasi diubah?

Apa yang terjadi pada akses ruang kerja ketika peran organisasi berubah?

Apa yang terjadi pada kunci API ketika pengguna dihapus dari ruang kerja?

Lihat juga

Cara kerja ruang kerja

Peran dan izin ruang kerja

Pewarisan peran

Mengelola ruang kerja

Melalui Konsol

Buat ruang kerja

Edit detail ruang kerja

Tambahkan anggota ke ruang kerja

Atur batas ruang kerja

Arsipkan ruang kerja

Melalui Admin API

Mengelola anggota ruang kerja

Kunci API dan cakupan sumber daya

Batas ruang kerja

Menetapkan batas ruang kerja

Pelacakan penggunaan dan biaya

Kasus penggunaan umum

Pemisahan lingkungan

Isolasi tim atau departemen

Organisasi berbasis proyek

Praktik terbaik

FAQ

Apa itu Ruang Kerja Default?

Apakah ada batasan pada ruang kerja?

Bagaimana peran organisasi mempengaruhi akses ruang kerja?

Peran mana yang dapat ditetapkan di ruang kerja?

Dapatkah peran ruang kerja admin atau anggota penagihan organisasi diubah?

Apa yang terjadi pada akses ruang kerja ketika peran organisasi berubah?

Apa yang terjadi pada kunci API ketika pengguna dihapus dari ruang kerja?

Lihat juga