Loading...
    • Guida per sviluppatori
    • Riferimento API
    • MCP
    • Risorse
    • Note sulla versione
    Search...
    ⌘K
    Primi passi
    Introduzione a ClaudeAvvio rapido
    Modelli e prezzi
    Panoramica dei modelliScelta di un modelloNovità in Claude 4.6Guida alla migrazioneDeprecazioni dei modelliPrezzi
    Crea con Claude
    Panoramica delle funzioniUtilizzo dell'API MessagesGestione dei motivi di arrestoBest practice per i prompt
    Capacità del modello
    Extended thinkingAdaptive thinkingEffortFast mode (anteprima di ricerca)Output strutturatiCitazioniStreaming dei messaggiElaborazione batchSupporto PDFRisultati di ricercaSupporto multilingueEmbeddingsVision
    Strumenti
    PanoramicaCome implementare l'uso degli strumentiStrumento di ricerca webStrumento di recupero webStrumento di esecuzione del codiceStrumento di memoriaStrumento BashStrumento Computer useStrumento editor di testo
    Infrastruttura degli strumenti
    Ricerca strumentiChiamata programmatica degli strumentiStreaming granulare degli strumenti
    Gestione del contesto
    Finestre di contestoCompattazioneModifica del contestoPrompt cachingConteggio dei token
    File e risorse
    API Files
    Agent Skills
    PanoramicaAvvio rapidoBest practiceSkills per l'aziendaUtilizzo di Skills con l'API
    Agent SDK
    PanoramicaAvvio rapidoTypeScript SDKTypeScript V2 (anteprima)Python SDKGuida alla migrazione
    MCP nell'API
    Connettore MCPServer MCP remoti
    Claude su piattaforme di terze parti
    Amazon BedrockMicrosoft FoundryVertex AI
    Prompt engineering
    PanoramicaGeneratore di promptUsa modelli di promptMiglioratore di promptSii chiaro e direttoUsa esempi (multishot prompting)Lascia che Claude pensi (CoT)Usa tag XMLDai a Claude un ruolo (prompt di sistema)Concatena prompt complessiSuggerimenti per il contesto lungoSuggerimenti per extended thinking
    Test e valutazione
    Definisci criteri di successoSviluppa casi di testUtilizzo dello strumento di valutazioneRiduzione della latenza
    Rafforza i guardrail
    Riduci le allucinazioniAumenta la coerenza dell'outputMitiga i jailbreakStreaming dei rifiutiRiduci la perdita di promptMantieni Claude nel personaggio
    Amministrazione e monitoraggio
    Panoramica dell'API AdminResidenza dei datiWorkspaceAPI di utilizzo e costiAPI Claude Code AnalyticsZero Data Retention
    Console
    Log in
    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
    • Catalog
    • 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
    • Catalog
    • 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
    Amministrazione e monitoraggio

    Spazi di lavoro

    Organizza le chiavi API, gestisci l'accesso del team e controlla i costi con gli spazi di lavoro.

    Gli spazi di lavoro forniscono un modo per organizzare l'utilizzo dell'API all'interno di un'organizzazione. Utilizza gli spazi di lavoro per separare diversi progetti, ambienti o team mantenendo la fatturazione e l'amministrazione centralizzate.

    Come funzionano gli spazi di lavoro

    Ogni organizzazione ha uno Spazio di lavoro predefinito che non può essere rinominato, archiviato o eliminato. Quando crei spazi di lavoro aggiuntivi, puoi assegnare chiavi API, membri e limiti di risorse a ciascuno.

    Caratteristiche principali:

    • Gli identificatori dello spazio di lavoro utilizzano il prefisso wrkspc_ (ad esempio, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
    • Massimo 100 spazi di lavoro per organizzazione (gli spazi di lavoro archiviati non contano)
    • Lo spazio di lavoro predefinito non ha un ID e non appare negli endpoint dell'elenco
    • Le chiavi API sono limitate a un singolo spazio di lavoro e possono accedere solo alle risorse all'interno di quello spazio di lavoro

    Ruoli e autorizzazioni dello spazio di lavoro

    I membri possono avere ruoli diversi in ogni spazio di lavoro, consentendo un controllo di accesso granulare.

    Was this page helpful?

    • Come funzionano gli spazi di lavoro
    • Ruoli e autorizzazioni dello spazio di lavoro
    • Eredità dei ruoli
    • Gestione degli spazi di lavoro
    • Tramite la Console
    • Tramite l'Admin API
    • Gestione dei membri dello spazio di lavoro
    • Chiavi API e ambito delle risorse
    • Limiti dello spazio di lavoro
    • Impostazione dei limiti dello spazio di lavoro
    • Tracciamento dell'utilizzo e dei costi
    • Casi d'uso comuni
    • Separazione dell'ambiente
    • Isolamento del team o del dipartimento
    • Organizzazione basata su progetti
    • Best practice
    • FAQ
    • Vedi anche
    RuoloAutorizzazioni
    Utente dello spazio di lavoroUtilizza solo il Workbench
    Sviluppatore dello spazio di lavoroCrea e gestisci le chiavi API, utilizza l'API
    Amministratore dello spazio di lavoroControllo completo sulle impostazioni dello spazio di lavoro e sui membri
    Fatturazione dello spazio di lavoroVisualizza le informazioni di fatturazione dello spazio di lavoro (ereditate dal ruolo di fatturazione dell'organizzazione)

    Eredità dei ruoli

    • Gli amministratori dell'organizzazione ricevono automaticamente l'accesso come Amministratore dello spazio di lavoro a tutti gli spazi di lavoro
    • I membri della fatturazione dell'organizzazione ricevono automaticamente l'accesso come Fatturazione dello spazio di lavoro a tutti gli spazi di lavoro
    • Gli utenti e gli sviluppatori dell'organizzazione devono essere aggiunti esplicitamente a ogni spazio di lavoro

    Il ruolo Fatturazione dello spazio di lavoro non può essere assegnato manualmente. Viene ereditato dal ruolo di fatturazione dell'organizzazione.

    Gestione degli spazi di lavoro

    Solo gli amministratori dell'organizzazione possono creare spazi di lavoro. Gli utenti e gli sviluppatori dell'organizzazione devono essere aggiunti agli spazi di lavoro da un amministratore.

    Tramite la Console

    Crea e gestisci gli spazi di lavoro nella Claude Console.

    Crea uno spazio di lavoro

    1. 1

      Apri le impostazioni dello spazio di lavoro

      Nella Claude Console, vai a Impostazioni > Spazi di lavoro.

    2. 2

      Aggiungi un nuovo spazio di lavoro

      Fai clic su Aggiungi spazio di lavoro.

    3. 3

      Configura lo spazio di lavoro

      Inserisci un nome dello spazio di lavoro e seleziona un colore per l'identificazione visiva.

    4. 4

      Crea lo spazio di lavoro

      Fai clic su Crea per finalizzare.

    Per passare da uno spazio di lavoro all'altro nella Console, utilizza il selettore Spazi di lavoro nell'angolo in alto a sinistra.

    Modifica i dettagli dello spazio di lavoro

    Per modificare il nome o il colore di uno spazio di lavoro:

    1. Seleziona lo spazio di lavoro dall'elenco
    2. Fai clic sul menu con i tre puntini (...) e scegli Modifica dettagli
    3. Aggiorna il nome o il colore e salva le modifiche

    Lo spazio di lavoro predefinito non può essere rinominato o eliminato.

    Aggiungi membri a uno spazio di lavoro

    1. Vai alla scheda Membri dello spazio di lavoro
    2. Fai clic su Aggiungi allo spazio di lavoro
    3. Seleziona un membro dell'organizzazione e assegnagli un ruolo dello spazio di lavoro
    4. Conferma l'aggiunta

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

    Gli amministratori dell'organizzazione e i membri della fatturazione non possono essere rimossi dagli spazi di lavoro mentre mantengono questi ruoli dell'organizzazione.

    Imposta i limiti dello spazio di lavoro

    Nella scheda Limiti, 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

    Archivia uno spazio di lavoro

    Per archiviare uno spazio di lavoro, fai clic sul menu con i tre puntini (...) e seleziona Archivia. L'archiviazione:

    • Conserva i dati storici per la segnalazione
    • Disattiva lo spazio di lavoro e tutte le chiavi API associate
    • Non può essere annullata

    L'archiviazione di uno spazio di lavoro revoca immediatamente tutte le chiavi API in quello spazio di lavoro. Questa azione non può essere annullata.

    Tramite l'Admin API

    Gestisci gli spazi di lavoro a livello di programmazione utilizzando l'Admin API.

    Gli endpoint dell'Admin API richiedono una chiave Admin API (che inizia con sk-ant-admin...) che differisce dalle chiavi API standard. Solo i membri dell'organizzazione con il ruolo di amministratore possono fornire le chiavi Admin API tramite la Claude Console.

    # Create a 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"}'

# List workspaces
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"

# Archive a 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 dei parametri e gli schemi di risposta, consulta il riferimento API Spazi di lavoro.

    Gestione dei membri dello spazio di lavoro

    Aggiungi, aggiorna o rimuovi membri da uno spazio di lavoro:

    # Add a member to a 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"
  }'

# Update a member's role
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"}'

# Remove a member from a 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 dei parametri, consulta il riferimento API Membri dello spazio di lavoro.

    Chiavi API e ambito delle risorse

    Le chiavi API sono limitate a uno spazio di lavoro specifico. Quando crei una chiave API in uno spazio di lavoro, può accedere solo alle risorse all'interno di quello spazio di lavoro.

    Le risorse limitate agli spazi di lavoro includono:

    • File creati tramite l'API File
    • Batch di messaggi creati tramite l'API Batch
    • Competenze create tramite l'API Competenze

    A partire dal 5 febbraio 2026, le cache dei prompt saranno isolate anche per spazio di lavoro (si applica all'API Claude e ad Azure).

    Per recuperare gli ID degli spazi di lavoro della tua organizzazione, utilizza l'endpoint Elenca spazi di lavoro o trovali nella Claude Console.

    Limiti dello spazio di lavoro

    Puoi impostare limiti di spesa e velocità personalizzati per ogni spazio di lavoro per proteggere dall'uso eccessivo e garantire una distribuzione equa delle risorse.

    Impostazione dei limiti dello spazio di lavoro

    I limiti dello spazio di lavoro possono essere impostati inferiori a (ma non superiori a) i limiti della tua organizzazione:

    • Limiti di spesa: Limita la spesa mensile per uno spazio di lavoro
    • Limiti di velocità: Limita le richieste al minuto, i token di input al minuto o i token di output al minuto
    • Non puoi impostare limiti sullo spazio di lavoro predefinito
    • Se non impostati, i limiti dello spazio di lavoro corrispondono ai limiti dell'organizzazione
    • I limiti a livello di organizzazione si applicano sempre, anche se i limiti dello spazio di lavoro si sommano a più

    Per informazioni dettagliate sui limiti di velocità e su come funzionano, consulta Limiti di velocità.

    Tracciamento dell'utilizzo e dei costi

    Traccia l'utilizzo e i costi per spazio di lavoro utilizzando l'API Utilizzo e costi:

    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: $ADMIN_API_KEY"

    L'utilizzo e i costi attribuiti allo spazio di lavoro predefinito hanno un valore null per workspace_id.

    Casi d'uso comuni

    Separazione dell'ambiente

    Crea spazi di lavoro separati per sviluppo, staging e produzione:

    Spazio di lavoroScopo
    SviluppoTest e sperimentazione con limiti di velocità inferiori
    StagingTest pre-produzione con limiti simili alla produzione
    ProduzioneTraffico live con limiti di velocità completi e monitoraggio

    Isolamento del team o del dipartimento

    Assegna spazi di lavoro a diversi team per l'allocazione dei costi e il controllo dell'accesso:

    • 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 spazi di lavoro per progetti o prodotti specifici per tracciare l'utilizzo e i costi separatamente.

    Best practice

    1. 1

      Pianifica la struttura dello spazio di lavoro

      Considera come organizzerai gli spazi di lavoro prima di crearli. Pensa alle esigenze di fatturazione, controllo dell'accesso e tracciamento dell'utilizzo.

    2. 2

      Utilizza nomi significativi

      Nomina gli spazi di lavoro chiaramente per indicare il loro scopo (ad esempio, "Produzione - Chatbot cliente", "Dev - Strumenti interni").

    3. 3

      Imposta limiti appropriati

      Configura limiti di spesa e velocità per prevenire costi imprevisti e garantire una distribuzione equa delle risorse.

    4. 4

      Controlla l'accesso regolarmente

      Rivedi periodicamente l'appartenenza allo spazio di lavoro per assicurarti che solo gli utenti appropriati abbiano accesso.

    5. 5

      Monitora l'utilizzo

      Utilizza l'API Utilizzo e costi per tracciare il consumo a livello di spazio di lavoro.

    FAQ

    Vedi anche

    • Panoramica dell'Admin API
    • Riferimento dell'Admin API
    • Limiti di velocità
    • API Utilizzo e costi