• Pesan
  • Managed Agents
  • Admin
Search...
⌘K
Organisasi
Admin APIWorkspace
Autentikasi
IkhtisarWorkload Identity FederationReferensi WIF
Pemantauan
Usage and Cost APIRate Limits APIClaude Code Analytics API
Data & kepatuhan
Residensi dataAPI dan retensi data
Compliance API
IkhtisarDapatkan aksesFeed AktivitasObrolan, file, dan proyekOrganisasi, pengguna, peran, dan grupRancang integrasi AndaKesalahanFAQ
Log in
Workspace
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Amazon Bedrock
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
Admin/Organisasi

Workspace

Atur kunci API, kelola akses tim, dan kendalikan biaya dengan workspace.

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.

Cara kerja workspace

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:

  • Pengidentifikasi workspace menggunakan prefiks wrkspc_ (misalnya, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
  • Maksimum 100 workspace per organisasi (workspace yang diarsipkan tidak dihitung)
  • Default Workspace tidak memiliki ID dan tidak muncul di endpoint daftar
  • Kunci API terbatas pada satu workspace dan hanya dapat mengakses sumber daya dalam workspace tersebut

Workspace Claude Code

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:

  • Claude Code membuat kunci API per pengguna di workspace ini saat masuk. Anda tidak dapat membuat kunci di dalamnya secara manual dari Console.
  • Kunci Claude Code berhenti berfungsi jika pemiliknya dihapus dari workspace atau organisasi, tidak seperti kunci workspace standar.
  • Penggunaan Claude Code dibatasi lajunya secara terpisah, dan admin dapat membatasi bagiannya dari batas organisasi di Settings > Workspaces.
  • Ini adalah satu-satunya workspace yang mendukung batas pengeluaran bulanan per pengguna.

Mengarsipkan workspace Claude Code akan menonaktifkan proses masuk Claude Code melalui penagihan Console untuk seluruh organisasi.

Peran dan izin workspace

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

PeranIzin
Workspace UserHanya menggunakan Workbench
Workspace Limited DeveloperMembuat dan mengelola kunci API, menggunakan API. Tidak dapat mengakses tampilan pelacakan sesi atau mengunduh file.
Workspace DeveloperMembuat dan mengelola kunci API, menggunakan API
Workspace AdminKontrol penuh atas pengaturan dan anggota workspace
Workspace BillingMelihat informasi penagihan workspace (diwarisi dari peran penagihan organisasi)

Pewarisan peran

  • Admin organisasi secara otomatis menerima akses Workspace Admin ke semua workspace
  • Anggota penagihan organisasi secara otomatis menerima akses Workspace Billing ke semua workspace
  • Pengguna dan developer organisasi harus ditambahkan secara eksplisit ke setiap workspace

Peran Workspace Billing tidak dapat ditetapkan secara manual. Peran ini diwarisi dari kepemilikan peran penagihan organisasi.

Mengelola workspace

Hanya admin organisasi yang dapat membuat workspace. Pengguna dan developer organisasi harus ditambahkan ke workspace oleh admin.

Menggunakan Console

Buat dan kelola workspace di Claude Console.

Membuat workspace

  1. 1

    Buka pengaturan workspace

    Di Claude Console, buka Settings > Workspaces.

  2. 2

    Buat workspace

    Klik Create workspace.

  3. 3

    Konfigurasikan workspace

    Masukkan nama workspace dan pilih warna untuk identifikasi visual.

  4. 4

    Buat workspace

    Klik Create untuk menyelesaikan.

Untuk beralih antar workspace di Console, gunakan pemilih Workspaces di sudut kiri atas.

Mengedit detail workspace

Untuk mengubah nama atau warna workspace:

  1. Pilih workspace dari daftar
  2. Klik menu elipsis (...) dan pilih Edit details
  3. Perbarui nama atau warna dan simpan perubahan Anda

Default Workspace tidak dapat diganti namanya atau dihapus.

Menambahkan anggota ke workspace

  1. Buka tab Members di workspace tersebut
  2. Klik Add to Workspace
  3. Pilih anggota organisasi dan tetapkan peran workspace kepada mereka
  4. Konfirmasi penambahan

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.

Mengatur batas workspace

Di tab Limits, Anda dapat mengonfigurasi:

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

Mengarsipkan workspace

Untuk mengarsipkan workspace, klik menu elipsis (...) dan pilih Archive. Pengarsipan:

  • Mempertahankan data historis untuk pelaporan
  • Menonaktifkan workspace dan semua kunci API yang terkait
  • Tidak dapat dibatalkan

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.

Menggunakan Admin API

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.

cURL
# 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.

Mengelola anggota workspace

Tambahkan, perbarui, atau hapus anggota dari workspace:

cURL
# 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 dan cakupan sumber daya

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:

  • File yang dibuat melalui Files API
  • Message Batch yang dibuat melalui Batch API
  • Skill yang dibuat melalui Skills API

Beberapa sumber daya dikelola di tingkat organisasi dan tidak dapat dikelola dengan kunci API workspace:

  • MCP tunnel dikelola dengan token OAuth bercakupan organisasi (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.
  • Workspace itu sendiri dan anggota organisasi dikelola melalui Admin API, yang memerlukan kunci Admin API.

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.

Batas workspace

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

Menetapkan batas workspace

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

  • Batas pengeluaran: Membatasi pengeluaran bulanan untuk sebuah workspace
  • Batas laju: Membatasi permintaan per menit, token input per menit, atau token output per menit
  • Anda tidak dapat menetapkan batas pada Default Workspace
  • Jika tidak ditetapkan, batas workspace akan sama dengan batas organisasi
  • Batas tingkat organisasi selalu berlaku, meskipun jumlah batas workspace melebihinya

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.

Pelacakan penggunaan dan biaya

Lacak penggunaan dan biaya berdasarkan workspace menggunakan Usage and Cost API:

cURL
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.

Kasus penggunaan umum

Pemisahan lingkungan

Buat workspace terpisah untuk development, staging, dan production:

WorkspaceTujuan
DevelopmentPengujian dan eksperimen dengan batas laju yang lebih rendah
StagingPengujian pra-produksi dengan batas yang menyerupai produksi
ProductionLalu lintas langsung dengan batas laju penuh dan pemantauan

Isolasi tim atau departemen

Tetapkan workspace ke tim yang berbeda untuk alokasi biaya dan kontrol akses:

  • Tim engineering dengan akses developer
  • Tim data science dengan kunci API mereka sendiri
  • Tim support dengan akses terbatas untuk alat pelanggan

Organisasi berbasis proyek

Buat workspace untuk proyek atau produk tertentu guna melacak penggunaan dan biaya secara terpisah.

Praktik terbaik

  1. 1

    Rencanakan struktur workspace Anda

    Pertimbangkan bagaimana Anda akan mengatur workspace sebelum membuatnya. Pikirkan tentang kebutuhan penagihan, kontrol akses, dan pelacakan penggunaan.

  2. 2

    Gunakan nama yang bermakna

    Beri nama workspace dengan jelas untuk menunjukkan tujuannya (misalnya, "Production - Customer Chatbot", "Dev - Internal Tools").

  3. 3

    Tetapkan batas yang sesuai

    Konfigurasikan batas pengeluaran dan batas laju untuk mencegah biaya tak terduga dan memastikan distribusi sumber daya yang adil.

  4. 4

    Audit akses secara berkala

    Tinjau keanggotaan workspace secara berkala untuk memastikan hanya pengguna yang sesuai yang memiliki akses.

  5. 5

    Pantau penggunaan

    Gunakan Usage and Cost API untuk melacak konsumsi tingkat workspace.

FAQ

Lihat juga

  • Admin API
  • Referensi Admin API
  • Batas laju
  • Usage and Cost API

Was this page helpful?

  • Cara kerja workspace
  • Workspace Claude Code
  • Peran dan izin workspace
  • Pewarisan peran
  • Mengelola workspace
  • Menggunakan Console
  • Menggunakan Admin API
  • Mengelola anggota workspace
  • Kunci API dan cakupan sumber daya
  • Batas workspace
  • Menetapkan batas workspace
  • Pelacakan penggunaan dan biaya
  • Kasus penggunaan umum
  • Pemisahan lingkungan
  • Isolasi tim atau departemen
  • Organisasi berbasis proyek
  • Praktik terbaik
  • FAQ
  • Lihat juga