I workspace forniscono un modo per organizzare l'utilizzo dell'API all'interno di un'organizzazione. Usa i workspace per separare diversi progetti, ambienti o team mantenendo una fatturazione e un'amministrazione centralizzate.
Ogni organizzazione ha un Default Workspace che non può essere rinominato, archiviato o eliminato. Quando crei workspace aggiuntivi, puoi assegnare chiavi API, membri e limiti di risorse a ciascuno di essi.
Caratteristiche principali:
wrkspc_ (ad esempio, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)Quando un membro della tua organizzazione accede per la prima volta a Claude Code con il proprio account Claude Console, Anthropic crea automaticamente un workspace Claude Code nell'organizzazione e vi aggiunge quel membro. Ogni membro successivo che accede a Claude Code viene aggiunto allo stesso modo.
Il workspace di Claude Code mantiene il traffico di Claude Code separato dagli altri carichi di lavoro API:
Archiviare il workspace di Claude Code disabilita l'accesso a Claude Code tramite la fatturazione della Console per l'intera organizzazione.
I membri possono avere ruoli diversi in ciascun workspace, consentendo un controllo degli accessi granulare.
| Ruolo | Autorizzazioni |
|---|---|
| Workspace User | Usa solo l'Anthropic Workbench |
| Workspace Limited Developer | Crea e gestisce chiavi API, usa l'API. Non può accedere alle viste di tracciamento delle sessioni né scaricare file. |
| Workspace Developer | Crea e gestisce chiavi API, usa l'API |
| Workspace Admin | Controllo completo sulle impostazioni e sui membri del workspace |
| Workspace Billing | Visualizza le informazioni di fatturazione del workspace (ereditato dal ruolo di fatturazione dell'organizzazione) |
Il ruolo Workspace Billing non può essere assegnato manualmente. Viene ereditato dal possesso del ruolo di fatturazione dell'organizzazione.
Solo gli amministratori dell'organizzazione possono creare workspace. Gli utenti e gli sviluppatori dell'organizzazione devono essere aggiunti ai workspace da un amministratore.
Crea e gestisci i workspace nella Claude Console.
Apri le impostazioni dei workspace
Nella Claude Console, vai su Settings > Workspaces.
Crea un workspace
Fai clic su Create workspace.
Configura il workspace
Inserisci un nome per il workspace e seleziona un colore per l'identificazione visiva.
Crea il workspace
Fai clic su Create per finalizzare.
Per passare da un workspace all'altro nella Console, usa il selettore Workspaces nell'angolo in alto a sinistra.
Per modificare il nome o il colore di un workspace:
Il Default Workspace non può essere rinominato o eliminato.
Per rimuovere un membro, fai clic sull'icona del cestino accanto al suo nome.
Gli amministratori dell'organizzazione e i membri di fatturazione non possono essere rimossi dai workspace finché detengono tali ruoli nell'organizzazione.
Nella scheda Limits, puoi configurare:
Per archiviare un workspace, fai clic sul menu con i puntini di sospensione (...) e seleziona Archive. L'archiviazione:
L'archiviazione di un workspace revoca immediatamente tutte le chiavi API in quel workspace. Questa azione non può essere annullata. Se archivi il workspace di Claude Code, i membri della tua organizzazione non potranno più accedere a Claude Code tramite la fatturazione della Console.
Gestisci i workspace in modo programmatico utilizzando l'Admin API.
Gli endpoint dell'Admin API richiedono una chiave Admin API (che inizia con sk-ant-admin...) diversa dalle chiavi API standard. Consulta Crea una chiave Admin API per sapere come ottenerne una.
# Crea un workspace
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-d '{"name": "Production"}'
# Elenca i workspace
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
# Archivia un workspace
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"Per i dettagli completi sui parametri e gli schemi di risposta, consulta il riferimento dell'API Workspaces.
Aggiungi, aggiorna o rimuovi membri da un workspace:
# Aggiungi un membro a un workspace
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-d '{
"user_id": "user_xxx",
"workspace_role": "workspace_developer"
}'
# Aggiorna il ruolo di un membro
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-d '{"workspace_role": "workspace_admin"}'
# Rimuovi un membro da un workspace
curl -X DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"Per i dettagli completi sui parametri, consulta il riferimento dell'API Workspace Members.
Le chiavi API hanno come ambito un workspace specifico. Quando crei una chiave API in un workspace, questa può accedere solo alle risorse all'interno di quel workspace.
Le risorse con ambito limitato ai workspace includono:
Alcune risorse non possono essere gestite con una chiave API del workspace:
workspace:manage_tunnels ottenuto tramite la Workload Identity Federation, non con una chiave API del workspace. I tunnel vengono creati in un workspace, e l'elenco MCP tunnels della Console e il selettore di server del Managed Agent mostrano solo i tunnel del workspace corrente; il limite di 10 tunnel attivi si applica a livello di organizzazione. La gestione dei tunnel richiede un ruolo con autorizzazioni di gestione dei tunnel; gli sviluppatori dell'organizzazione possono visualizzarli ma non modificarli.Anche le cache dei prompt sono isolate per workspace sulla Claude API, su Claude Platform on AWS e su Microsoft Foundry. Su Amazon Bedrock e Google Cloud, le cache dei prompt sono isolate per organizzazione.
Per recuperare gli ID dei workspace della tua organizzazione, usa l'endpoint List Workspaces, oppure trovali nella Claude Console.
Puoi impostare limiti di spesa e di velocità personalizzati per ciascun workspace per proteggerti dall'uso eccessivo e garantire un'equa distribuzione delle risorse.
Puoi impostare limiti del workspace inferiori (ma non superiori) ai limiti della tua organizzazione:
Per informazioni dettagliate sui limiti di velocità e sul loro funzionamento, consulta Limiti di velocità. Puoi anche leggere in modo programmatico i limiti di velocità correnti della tua organizzazione e dei workspace con la Rate Limits API.
Monitora l'utilizzo e i costi per workspace utilizzando la 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" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"L'utilizzo e i costi attribuiti al Default Workspace hanno un valore null per workspace_id.
Crea workspace separati per sviluppo, staging e produzione:
| Workspace | Scopo |
|---|---|
| Sviluppo | Test e sperimentazione con limiti di velocità inferiori |
| Staging | Test pre-produzione con limiti simili a quelli di produzione |
| Produzione | Traffico reale con limiti di velocità completi e monitoraggio |
Assegna workspace a team diversi per l'allocazione dei costi e il controllo degli accessi:
Crea workspace per progetti o prodotti specifici per monitorare l'utilizzo e i costi separatamente.
Pianifica la struttura dei workspace
Valuta come organizzare i workspace prima di crearli. Pensa alle esigenze di fatturazione, controllo degli accessi e monitoraggio dell'utilizzo.
Usa nomi significativi
Assegna ai workspace nomi chiari che ne indichino lo scopo (ad esempio, "Produzione - Chatbot Clienti", "Dev - Strumenti Interni").
Imposta limiti appropriati
Configura limiti di spesa e di velocità per prevenire costi imprevisti e garantire un'equa distribuzione delle risorse.
Verifica regolarmente gli accessi
Rivedi periodicamente l'appartenenza ai workspace per assicurarti che solo gli utenti appropriati abbiano accesso.
Monitora l'utilizzo
Usa la Usage and Cost API per monitorare il consumo a livello di workspace.
Was this page helpful?