Workspace

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

Cara kerja workspaces

Setiap organisasi memiliki workspace default yang tidak dapat diganti nama, diarsipkan, atau dihapus. Ketika Anda membuat workspaces tambahan, Anda dapat menetapkan anggota, akun layanan, kunci API, dan batas sumber daya untuk masing-masing.

Karakteristik utama:

• Pengidentifikasi workspace menggunakan awalan wrkspc_ (misalnya, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ).
• Maksimum 100 workspace untuk setiap organisasi secara default (workspace yang diarsipkan tidak dihitung). Hubungi tim akun Anda jika Anda membutuhkan lebih banyak.
• Workspace default memiliki ID wrkspc_ seperti workspace lainnya (dikembalikan dalam header respons anthropic-workspace-id dan diterima oleh Dapatkan WorkspacePratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali.), tetapi hanya muncul dalam hasil Daftar WorkspacePratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali. ketika Anda meneruskan include_default=true. Usage and Cost Analytics API melaporkan penggunaan dan biayanya di bawah ID tersebut, sedangkan laporan Usage and Cost API versi lama menampilkan null untuk workspace_id-nya (field scope pada kunci API memuat ID sebenarnya untuk kunci yang terikat ke workspace default).
• Kunci API dapat dibatasi cakupannya ke satu workspace. Dalam hal ini, kunci tersebut hanya dapat mengakses sumber daya di dalam workspace itu. Kunci API lainnya tidak dibatasi ke workspace. Dengan salah satu kunci ini, kirimkan header ID workspace pada setiap permintaan untuk memilih workspace. Pengguna atau akun layanan pemilik kunci tersebut harus memiliki akses ke workspace itu.

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 dan menambahkan anggota tersebut ke dalamnya. Setiap anggota berikutnya yang masuk ke Claude Code ditambahkan dengan cara yang sama.

Workspace Claude Code menjaga lalu lintas Claude Code terpisah dari beban kerja API Anda yang lain:

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

Peran dan izin workspace

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

Pewarisan peran

• Admin organisasi secara otomatis menerima akses Admin Ruang Kerja ke semua workspace.
• Anggota penagihan organisasi secara otomatis menerima akses Penagihan Ruang Kerja ke semua workspace.
• Pengguna dan developer organisasi harus ditambahkan secara eksplisit ke setiap workspace.
• Akun layanan ditambahkan ke workspace di halaman Akun layanan (platform.claude.com/settings/service-accounts) di Claude Console: pilih Tambahkan ke ruang kerja di menu akun tersebut atau di halamannya sendiri. Untuk melihat akun-akun dalam satu workspace, filter daftar berdasarkan workspace.

Mengelola workspaces

Menggunakan Console

Buat dan kelola workspace di halaman Ruang kerja di Claude Console.

Membuat workspace

1. 1

   Buka pengaturan workspace

   Di Claude Console, buka halaman Ruang kerja (platform.claude.com/settings/workspaces).

2. 2

   Buka halaman Buat ruang kerja

   Klik Buat ruang kerja untuk membuka halaman Buat ruang kerja (platform.claude.com/settings/workspaces/new) di Console.

3. 3

   Konfigurasikan workspace

   Masukkan nama workspace dan pilih warna untuk identifikasi visual.

4. 4

   Buat workspace

   Klik Buat ruang kerja untuk menyelesaikan.

Mengedit detail workspace

Untuk mengubah nama atau warna workspace:

1. Pilih workspace dari daftar.
2. Buka menu Tindakan lainnya (tiga titik) dan pilih Edit detail.
3. Perbarui nama atau warna dan simpan perubahan Anda.

Menambahkan anggota ke workspace

1. Di Claude Console, buka halaman Anggota (platform.claude.com/settings/members).
2. Klik Tambahkan ke ruang kerja.
3. Pilih workspace, anggota organisasi yang akan ditambahkan, dan peran workspace mereka.
4. Klik Tambahkan ke ruang kerja untuk mengonfirmasi.

Menghapus anggota dari workspace

1. Di halaman Anggota di Claude Console, pilih workspace dari menu dropdown Ruang kerja. Jika menu tersebut menampilkan Semua, Hapus anggota justru akan menghapus anggota tersebut dari organisasi Anda.
2. Di ujung baris anggota, buka menu Tindakan lainnya (tiga titik) dan pilih Hapus anggota.
3. Klik Hapus untuk mengonfirmasi.

Menetapkan batas workspace

Anda menetapkan batas laju dan batas pengeluaran workspace di tempat yang berbeda:

• Batas laju: Di bawah Batas laju di Claude Console, pilih workspace dari menu dropdown Ruang kerja dan klik Edit di samping model untuk menetapkan batas permintaan per menit, token input, atau token output.
• Batas pengeluaran: Di halaman Ruang kerja di Claude Console, pilih workspace. Di panel yang terbuka, klik Batas pengeluaran untuk membatasi pengeluaran bulanan dan mengonfigurasi peringatan ketika pengeluaran mencapai ambang batas tertentu.

Mengarsipkan workspace

Untuk mengarsipkan workspace, buka menu Tindakan lainnya (tiga titik) dan pilih Arsipkan ruang kerja. Pengarsipan:

• Mempertahankan data historis untuk pelaporan
• Menonaktifkan workspace dan mengarsipkan setiap kunci API yang dibuat untuknya
• Tidak dapat dibatalkan

Menggunakan Admin API

Kelola workspaces secara terprogram menggunakan Admin API.

Contoh SDK dan CLI berikut membuat klien default, yang membaca kunci Admin API dari variabel lingkungan ANTHROPIC_API_KEY; SDK mengekspos endpoint ini di bawah client.organization.workspaces. Metode list SDK mengambil halaman berikutnya sesuai permintaan, sehingga limit menetapkan ukuran halaman; contoh PHP, Ruby, dan curl mengembalikan satu halaman.

Membuat workspace:

client = anthropic.Anthropic()

workspace = client.organization.workspaces.create(name="Production")

print(f"id: {workspace.id}")
print(f"name: {workspace.name}")

Mendaftar workspaces:

client = anthropic.Anthropic()

workspaces = client.organization.workspaces.list(limit=10, include_archived=False)

for workspace in workspaces:
    print(f"{workspace.id}: {workspace.name}")

Mengarsipkan workspace:

client = anthropic.Anthropic()

workspace = client.organization.workspaces.archive("wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ")

print(f"id: {workspace.id}")
print(f"archived_at: {workspace.archived_at}")

Untuk detail parameter lengkap dan skema respons, lihat referensi API WorkspacesPratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali..

Mengelola anggota workspace

Menambahkan anggota ke workspace:

client = anthropic.Anthropic()

member = client.organization.workspaces.members.add(
    "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
    user_id="user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_role="workspace_developer",
)

print(f"user_id: {member.user_id}")
print(f"workspace_role: {member.workspace_role}")

Memperbarui peran anggota:

client = anthropic.Anthropic()

member = client.organization.workspaces.members.update(
    "user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_id="wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
    workspace_role="workspace_admin",
)

print(f"user_id: {member.user_id}")
print(f"workspace_role: {member.workspace_role}")

Menghapus anggota dari workspace:

client = anthropic.Anthropic()

removed_member = client.organization.workspaces.members.remove(
    "user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_id="wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
)

print(f"user_id: {removed_member.user_id}")

Untuk detail parameter lengkap, lihat referensi API anggota workspacePratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali..

Kunci API dan pencakupan sumber daya

Setiap permintaan berjalan di tepat satu workspace dan hanya dapat mengakses sumber daya dalam workspace tersebut. Workspace mana bergantung pada jenis kunci:

• Sebuah kunci workspace (kunci lama tanpa pemilik) milik workspace tempat kunci tersebut dibuat dan selalu berjalan di sana.
• Kunci pribadi atau kunci akun layanan bertindak sebagai pengguna atau akun layanannya. Kunci satu-workspace selalu berjalan di workspace yang dipilih saat kunci itu dibuat. Kunci yang tidak dibatasi ke workspace berjalan di workspace yang disebutkan oleh header anthropic-workspace-id pada setiap permintaan. Akun harus memiliki akses ke workspace untuk menggunakannya.

Sumber daya yang dicakupkan ke workspaces meliputi:

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

Beberapa sumber daya dikelola secara berbeda:

• Tunnel MCP dikelola dengan token OAuth workspace:manage_tunnels yang diperoleh melalui Workload Identity Federation, bukan kunci API. Tunnels dibuat di workspace, dan daftar Tunnel MCP Console serta pemilih server Managed Agent menampilkan tunnels di workspace saat ini saja; batas 10 tunnels aktif berlaku di seluruh organisasi. Pengelolaan tunnel memerlukan peran dengan izin pengelolaan tunnel; developer organisasi dapat melihat tetapi tidak mengubahnya.
• Ruang kerja itu sendiri dan anggota organisasi dikelola di tingkat organisasi melalui Admin API, menggunakan kunci Admin API, token OAuth org:admin, atau kunci akun pribadi atau layanan yang tidak dicakupkan ke workspace tertentu.

Untuk mencari ID workspace organisasi Anda, panggil endpoint Daftar WorkspacePratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali. (teruskan include_default=true untuk menyertakan workspace default) atau temukan di halaman Ruang kerja di Claude Console.

Mengidentifikasi workspace di balik respons API

Respons Claude API menyertakan header anthropic-workspace-id bersama dengan header respons request-id dan anthropic-organization-id. Nilainya adalah ID berawalan wrkspc_ dari workspace yang diselesaikan oleh kunci API atau token akses permintaan, termasuk ketika workspace tersebut adalah workspace default. Misalnya, respons yang berhasil menyertakan header seperti ini:

HTTP/1.1 200 OK
request-id: req_018EeWyXxfu5pfWkrYcMdjWG
anthropic-organization-id: 0d0e7a3b-52f1-4c7e-9a51-3f6f2f7c1b9e
anthropic-workspace-id: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ

Header tidak ada ketika kredensial tidak diselesaikan ke workspace (misalnya, pada permintaan Admin API) atau ketika permintaan gagal sebelum autentikasi selesai, seperti kesalahan 401.

Contoh berikut mengirim permintaan Messages API dan membaca ID workspace dari header respons:

client = anthropic.Anthropic()

response = client.messages.with_raw_response.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)
workspace_id = response.headers.get("anthropic-workspace-id")
print(f"Workspace ID: {workspace_id}")

Workspace ID: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ

Accessor yang sama membaca header dari endpoint Claude API lainnya juga, termasuk API Claude Managed Agents. Misalnya, baca anthropic-workspace-id dari respons yang membuat sesi untuk mencatat workspace mana yang menjadi milik sesi tersebut.

Dengan ID workspace dari respons, Anda dapat:

• Mengonfirmasi penggunaan, biaya, dan batas laju workspace mana yang dihitung oleh permintaan tersebut
• Mencocokkannya dengan field workspace_id pada baris Usage and Cost Analytics API, yang memuat ID yang sama ini untuk workspace default, dan dengan field scope pada kunci API di Admin API, yang memuat ID sebenarnya dari workspace tempat kunci terikat, termasuk workspace default
• Memeriksa apakah itu ID workspace default Anda dengan meneruskannya ke Dapatkan WorkspacePratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali. menggunakan kunci Admin API: workspace default dikembalikan dengan "name": "Default", meskipun Daftar WorkspacePratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali. menghilangkannya kecuali Anda meneruskan include_default=true
• Membuka workspace tersebut di Console untuk menemukan sumber daya permintaan, seperti sesi, file, batch pesan, dan skills

Batas workspace

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

Menetapkan batas workspace

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

• Batas pengeluaran: Batasi pengeluaran bulanan untuk sebuah workspace. Untuk menetapkannya, buka halaman Ruang kerja (platform.claude.com/settings/workspaces) di Claude Console dan pilih workspace. Di panel yang terbuka, klik Batas pengeluaran.
• Batas laju: Membatasi permintaan per menit, token input per menit, atau token output per menit. Untuk menetapkannya, buka Batas laju di Claude Console, pilih workspace dari menu dropdown Ruang kerja, dan klik Edit di samping model.

Untuk informasi terperinci tentang “rate limit” (batas laju) dan cara kerjanya, lihat Batas laju. Anda juga dapat membaca batas laju organisasi dan workspace Anda saat ini serta menetapkan batas laju workspace secara terprogram dengan Rate Limits API, yang menyimpan nilai di atas batas organisasi tetapi tetap memberlakukan yang lebih rendah dari keduanya.

Pelacakan penggunaan dan biaya

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

client = anthropic.Anthropic()

rows = client.beta.organization.analytics.usage.list(
    starting_at="2026-09-01T00:00:00Z",
    ending_at="2026-09-08T00:00:00Z",
    time_bucket_width="1d",
    workspace_ids=["wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"],
    group_by=["workspace_id"],
)

for row in rows:
    print(f"{row.starting_at} {row.group.workspace_id}: {row.usage.total_tokens}")

Penggunaan dan biaya di workspace default dilaporkan di bawah ID milik workspace default itu sendiri.

Kasus penggunaan umum

Pemisahan lingkungan

Buat workspaces terpisah untuk pengembangan, staging, dan produksi:

Isolasi tim atau departemen

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

• Tim engineering dengan akses developer
• Tim ilmu data dengan kunci API mereka sendiri
• Tim dukungan dengan akses terbatas untuk alat pelanggan

Organisasi berbasis proyek

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

Praktik terbaik

1. 1

   Rencanakan struktur workspace Anda

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

2. 2

   Gunakan nama yang bermakna

   Beri nama workspaces dengan jelas untuk menunjukkan tujuannya (misalnya, “Production - Customer Chatbot” atau “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 teratur

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

5. 5

   Pantau penggunaan

   Gunakan Usage and Cost Analytics API untuk melacak konsumsi di tingkat workspace.

FAQ

Lihat juga

• Admin API
• Referensi Admin API
• Batas laju
• Usage and Cost Analytics API dan Usage and Cost API lama