Workspace menyediakan cara untuk mengatur penggunaan API Anda dalam sebuah organisasi. Gunakan workspace untuk memisahkan berbagai proyek, lingkungan, atau tim sambil mempertahankan penagihan dan administrasi terpusat.
Setiap organisasi memiliki Default Workspace yang tidak dapat diganti namanya, diarsipkan, atau dihapus. Saat Anda membuat workspace tambahan, Anda dapat menetapkan kunci API, anggota, dan batas sumber daya untuk masing-masing workspace.
Karakteristik utama:
wrkspc_ (misalnya, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)Ketika anggota organisasi Anda pertama kali masuk ke Claude Code dengan akun Claude Console mereka, Anthropic secara otomatis membuat workspace Claude Code di organisasi tersebut dan menambahkan anggota itu ke dalamnya. Setiap anggota berikutnya yang masuk ke Claude Code akan ditambahkan dengan cara yang sama.
Workspace Claude Code memisahkan lalu lintas Claude Code dari beban kerja API Anda yang lain:
Mengarsipkan workspace Claude Code akan menonaktifkan proses masuk Claude Code melalui penagihan Console untuk seluruh organisasi.
Anggota dapat memiliki peran yang berbeda di setiap workspace, memungkinkan kontrol akses yang terperinci.
| Peran | Izin |
|---|---|
| Workspace User | Hanya menggunakan Workbench |
| Workspace Limited Developer | Membuat dan mengelola kunci API, menggunakan API. Tidak dapat mengakses tampilan pelacakan sesi atau mengunduh file. |
| Workspace Developer | Membuat dan mengelola kunci API, menggunakan API |
| Workspace Admin | Kontrol penuh atas pengaturan dan anggota workspace |
| Workspace Billing | Melihat informasi penagihan workspace (diwarisi dari peran penagihan organisasi) |
Peran Workspace Billing tidak dapat ditetapkan secara manual. Peran ini diwarisi dari kepemilikan peran penagihan organisasi.
Hanya admin organisasi yang dapat membuat workspace. Pengguna dan developer organisasi harus ditambahkan ke workspace oleh admin.
Buat dan kelola workspace di Claude Console.
Buka pengaturan workspace
Di Claude Console, buka Settings > Workspaces.
Buat workspace
Klik Create workspace.
Konfigurasikan workspace
Masukkan nama workspace dan pilih warna untuk identifikasi visual.
Buat workspace
Klik Create untuk menyelesaikan.
Untuk beralih antar workspace di Console, gunakan pemilih Workspaces di sudut kiri atas.
Untuk mengubah nama atau warna workspace:
Default Workspace tidak dapat diganti namanya atau dihapus.
Untuk menghapus anggota, klik ikon tempat sampah di samping nama mereka.
Admin organisasi dan anggota penagihan tidak dapat dihapus dari workspace selama mereka memegang peran organisasi tersebut.
Di tab Limits, Anda dapat mengonfigurasi:
Untuk mengarsipkan workspace, klik menu elipsis (...) dan pilih Archive. Pengarsipan:
Mengarsipkan workspace akan segera mencabut semua kunci API di workspace tersebut. Tindakan ini tidak dapat dibatalkan. Jika Anda mengarsipkan workspace Claude Code, anggota organisasi Anda tidak dapat lagi masuk ke Claude Code melalui penagihan Console.
Kelola workspace 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 Claude Console.
# Membuat 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"}'
# Menampilkan daftar workspace
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"
# Mengarsipkan 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 Workspaces API.
Tambahkan, perbarui, atau hapus anggota dari workspace:
# Menambahkan anggota ke 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"
}'
# Memperbarui peran anggota
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"}'
# Menghapus anggota dari 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 Workspace Members API.
Kunci API terbatas pada workspace tertentu. Saat Anda membuat kunci API di sebuah workspace, kunci tersebut hanya dapat mengakses sumber daya dalam workspace itu.
Sumber daya yang terbatas pada workspace meliputi:
Beberapa sumber daya dikelola di tingkat organisasi dan tidak dapat dikelola dengan kunci API workspace:
org:manage_tunnels) yang diperoleh melalui Workload Identity Federation, bukan kunci API workspace, dan batas maksimum 10 tunnel aktif berlaku untuk seluruh organisasi. Pengelolaan tunnel memerlukan peran dengan izin pengelolaan tunnel; developer organisasi dapat melihat tetapi tidak dapat mengubahnya. Tunnel dibuat dalam sebuah workspace, dan daftar MCP tunnels di Console serta pemilih server Managed Agent hanya menampilkan tunnel di workspace saat ini.Cache prompt juga diisolasi per workspace pada Claude API, Claude Platform on AWS, dan Microsoft Foundry (di mana Claude saat ini dalam versi beta). Pada Amazon Bedrock dan Vertex AI, cache prompt diisolasi per organisasi.
Untuk mengambil ID workspace organisasi Anda, gunakan endpoint List Workspaces, atau temukan di Claude Console.
Anda dapat menetapkan batas pengeluaran dan batas laju kustom untuk setiap workspace guna melindungi dari penggunaan berlebihan dan memastikan distribusi sumber daya yang adil.
Batas workspace dapat ditetapkan lebih rendah dari (tetapi tidak lebih tinggi dari) batas organisasi Anda:
Untuk informasi terperinci tentang batas laju dan cara kerjanya, lihat Batas laju. Anda juga dapat membaca batas laju organisasi dan workspace Anda saat ini secara terprogram dengan Rate Limits API.
Lacak penggunaan dan biaya berdasarkan workspace 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: $ANTHROPIC_ADMIN_KEY"Penggunaan dan biaya yang diatribusikan ke Default Workspace memiliki nilai null untuk workspace_id.
Buat workspace terpisah untuk development, staging, dan production:
| Workspace | Tujuan |
|---|---|
| Development | Pengujian dan eksperimen dengan batas laju yang lebih rendah |
| Staging | Pengujian pra-produksi dengan batas yang menyerupai produksi |
| Production | Lalu lintas langsung dengan batas laju penuh dan pemantauan |
Tetapkan workspace ke tim yang berbeda untuk alokasi biaya dan kontrol akses:
Buat workspace untuk proyek atau produk tertentu guna melacak penggunaan dan biaya secara terpisah.
Rencanakan struktur workspace Anda
Pertimbangkan bagaimana Anda akan mengatur workspace sebelum membuatnya. Pikirkan tentang kebutuhan penagihan, kontrol akses, dan pelacakan penggunaan.
Gunakan nama yang bermakna
Beri nama workspace dengan jelas untuk menunjukkan tujuannya (misalnya, "Production - Customer Chatbot", "Dev - Internal Tools").
Tetapkan batas yang sesuai
Konfigurasikan batas pengeluaran dan batas laju untuk mencegah biaya tak terduga dan memastikan distribusi sumber daya yang adil.
Audit akses secara berkala
Tinjau keanggotaan workspace secara berkala untuk memastikan hanya pengguna yang sesuai yang memiliki akses.
Pantau penggunaan
Gunakan Usage and Cost API untuk melacak konsumsi tingkat workspace.
Was this page helpful?