Workspace

I workspace offrono un modo per organizzare l'utilizzo dell'API all'interno di un'organizzazione. Usa i workspace per separare diversi progetti, ambienti o team mantenendo al contempo fatturazione e amministrazione centralizzate.

Come funzionano i workspace

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:

• Gli identificatori dei workspace usano il prefisso wrkspc_ (ad esempio, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
• Massimo 100 workspace per organizzazione (i workspace archiviati non vengono conteggiati)
• Il Default Workspace non ha un ID e non appare negli endpoint di elenco
• Le chiavi API sono limitate a un singolo workspace e possono accedere solo alle risorse all'interno di quel workspace

Workspace Claude Code

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 Claude Code mantiene il traffico di Claude Code separato dagli altri carichi di lavoro API:

• Claude Code genera una chiave API per utente in questo workspace al momento dell'accesso. Non puoi creare chiavi manualmente al suo interno dalla Console.
• Una chiave Claude Code smette di funzionare se il suo proprietario viene rimosso dal workspace o dall'organizzazione, a differenza delle chiavi standard dei workspace.
• L'utilizzo di Claude Code è soggetto a limiti di velocità separati, e gli amministratori possono limitare la sua quota dei limiti dell'organizzazione in Settings > Workspaces.
• È l'unico workspace che supporta limiti di spesa mensili per utente.

Ruoli e autorizzazioni dei workspace

I membri possono avere ruoli diversi in ciascun workspace, consentendo un controllo degli accessi granulare.

Ereditarietà dei ruoli

• Gli amministratori dell'organizzazione ricevono automaticamente l'accesso Workspace Admin a tutti i workspace
• I membri con ruolo di fatturazione dell'organizzazione ricevono automaticamente l'accesso Workspace Billing a tutti i workspace
• Gli utenti e gli sviluppatori dell'organizzazione devono essere aggiunti esplicitamente a ciascun workspace

Gestione dei workspace

Utilizzo della Console

Crea e gestisci i workspace nella Claude Console.

Creare un workspace

Modificare i dettagli del workspace

Per modificare il nome o il colore di un workspace:

1. Seleziona il workspace dall'elenco
2. Fai clic sul menu con i puntini di sospensione (...) e scegli Edit details
3. Aggiorna il nome o il colore e salva le modifiche

Aggiungere membri a un workspace

1. Vai alla scheda Members del workspace
2. Fai clic su Add to Workspace
3. Seleziona un membro dell'organizzazione e assegnagli un ruolo del workspace
4. Conferma l'aggiunta

Per rimuovere un membro, fai clic sull'icona del cestino accanto al suo nome.

Impostare i limiti del workspace

Nella scheda Limits, puoi configurare:

• Limiti di velocità: Imposta limiti per livello di modello per richieste al minuto, token di input o token di output
• Notifiche di spesa: Configura avvisi quando la spesa raggiunge determinate soglie

Archiviare un workspace

Per archiviare un workspace, fai clic sul menu con i puntini di sospensione (...) e seleziona Archive. L'archiviazione:

• Conserva i dati storici per la reportistica
• Disattiva il workspace e tutte le chiavi API associate
• Non può essere annullata

Utilizzo dell'Admin API

Gestisci i workspace in modo programmatico utilizzando l'Admin API.

# Crea un 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"}'

# Elenca i 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"

# Archivia un 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"

Per i dettagli completi sui parametri e gli schemi di risposta, consulta il riferimento dell'API Workspaces.

Gestione dei membri del workspace

Aggiungi, aggiorna o rimuovi membri da un workspace:

# Aggiungi un membro a un 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"
  }'

# Aggiorna il ruolo di un membro
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"}'

# Rimuovi un membro da un 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"

Per i dettagli completi sui parametri, consulta il riferimento dell'API Workspace Members.

Chiavi API e ambito delle risorse

Le chiavi API sono limitate a 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:

• File creati tramite la Files API
• Message Batch creati tramite la Batch API
• Skill create tramite la Skills API

Alcune risorse sono gestite a livello di organizzazione e non possono essere gestite con una chiave API del workspace:

• I tunnel MCP sono gestiti con un token OAuth con ambito di organizzazione (org:manage_tunnels) ottenuto tramite Workload Identity Federation, non con una chiave API del workspace, e 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. I tunnel vengono creati in un workspace, e l'elenco MCP tunnels della Console e il selettore di server Managed Agent mostrano solo i tunnel nel workspace corrente.
• I workspace stessi e i membri dell'organizzazione sono gestiti tramite l'Admin API, che richiede una chiave Admin API.

Limiti dei workspace

Puoi impostare limiti personalizzati di spesa e di velocità per ciascun workspace per proteggerti dall'uso eccessivo e garantire una distribuzione equa delle risorse.

Impostazione dei limiti del workspace

I limiti del workspace possono essere impostati a valori inferiori (ma non superiori) rispetto ai limiti della tua organizzazione:

• Limiti di spesa: Limita la spesa mensile per un workspace
• Limiti di velocità: Limita le richieste al minuto, i token di input al minuto o i token di output al minuto

Per informazioni dettagliate sui limiti di velocità e sul loro funzionamento, consulta Limiti di velocità. Puoi anche leggere i limiti di velocità correnti della tua organizzazione e dei workspace in modo programmatico con la Rate Limits API.

Monitoraggio di utilizzo e costi

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

L'utilizzo e i costi attribuiti al Default Workspace hanno un valore null per workspace_id.

Casi d'uso comuni

Separazione degli ambienti

Crea workspace separati per sviluppo, staging e produzione:

Isolamento per team o reparto

Assegna workspace a team diversi per l'allocazione dei costi e il controllo degli accessi:

• Team di ingegneria con accesso da sviluppatore
• Team di data science con le proprie chiavi API
• Team di supporto con accesso limitato per gli strumenti dei clienti

Organizzazione basata su progetti

Crea workspace per progetti o prodotti specifici per monitorare separatamente utilizzo e costi.

Best practice

FAQ

Vedi anche

• Admin API
• Riferimento Admin API
• Limiti di velocità
• Usage and Cost API