Loading...
    • Guida per sviluppatori
    • Riferimento API
    • MCP
    • Risorse
    • Note di rilascio
    Search...
    ⌘K
    Primi passi
    Introduzione a ClaudeAvvio rapido
    Modelli e prezzi
    Panoramica dei modelliScelta di un modelloNovità in Claude 4.5Migrazione a Claude 4.5Deprecazioni dei modelliPrezzi
    Costruisci con Claude
    Panoramica delle funzionalitàUtilizzo dell'API MessagesFinestre di contestoBest practice per i prompt
    Capacità
    Prompt cachingModifica del contestoExtended thinkingSforzoStreaming di messaggiElaborazione batchCitazioniSupporto multilingueConteggio dei tokenEmbeddingsVisioneSupporto PDFAPI FilesRisultati di ricercaOutput strutturatiComponente aggiuntivo Google Sheets
    Strumenti
    PanoramicaCome implementare l'uso degli strumentiUso efficiente dei token con gli strumentiStreaming granulare degli strumentiStrumento BashStrumento di esecuzione del codiceChiamata programmatica degli strumentiStrumento Computer useStrumento Editor di testoStrumento Web fetchStrumento Web searchStrumento MemoryStrumento Tool search
    Agent Skills
    PanoramicaAvvio rapidoBest practiceUtilizzo di Skills con l'API
    Agent SDK
    PanoramicaTypeScript SDKPython SDKGuida alla migrazione
    Guide
    Streaming InputGestione dei permessiGestione delle sessioniOutput strutturati nell'SDKHosting dell'Agent SDKModifica dei prompt di sistemaMCP nell'SDKStrumenti personalizzatiSubagent nell'SDKSlash Commands nell'SDKAgent Skills nell'SDKTracciamento dei costi e dell'utilizzoElenchi di attivitàPlugin nell'SDK
    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)Precompila la risposta di ClaudeConcatena prompt complessiSuggerimenti per il contesto lungoSuggerimenti per extended thinking
    Test e valutazione
    Definisci i 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'Admin APIAPI di utilizzo e costiAPI Claude Code Analytics
    Console
    Log in
    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

    Panoramica dell'API Admin

    The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.

    L'API Admin ti consente di gestire programmaticamente le risorse della tua organizzazione, inclusi i membri dell'organizzazione, gli spazi di lavoro e le chiavi API. Questo fornisce controllo programmatico su attività amministrative che altrimenti richiederebbero configurazione manuale nella Console Claude.

    L'API Admin richiede accesso speciale

    L'API Admin richiede una chiave API Admin speciale (che inizia con sk-ant-admin...) che differisce dalle chiavi API standard. Solo i membri dell'organizzazione con ruolo admin possono fornire chiavi API Admin attraverso la Console Claude.

    Come funziona l'API Admin

    Quando usi l'API Admin:

    1. Fai richieste usando la tua chiave API Admin nell'header x-api-key
    2. L'API ti consente di gestire:
      • Membri dell'organizzazione e i loro ruoli
      • Inviti dei membri dell'organizzazione
      • Spazi di lavoro e i loro membri
      • Chiavi API
    • Come funziona l'API Admin
    • Ruoli e permessi dell'organizzazione
    • Concetti chiave
    • Membri dell'Organizzazione
    • Inviti dell'Organizzazione
    • Spazi di Lavoro
    • Membri dello Spazio di Lavoro
    • Chiavi API
    • Accesso alle informazioni dell'organizzazione
    • Accesso ai report di utilizzo e costi
    • Accesso alle analisi di Claude Code
    • Migliori pratiche
    • FAQ

    Questo è utile per:

    • Automatizzare l'onboarding/offboarding degli utenti
    • Gestire programmaticamente l'accesso agli spazi di lavoro
    • Monitorare e gestire l'utilizzo delle chiavi API

    Ruoli e permessi dell'organizzazione

    Ci sono cinque ruoli a livello di organizzazione. Vedi maggiori dettagli qui.

    RuoloPermessi
    userPuò usare Workbench
    claude_code_userPuò usare Workbench e Claude Code
    developerPuò usare Workbench e gestire le chiavi API
    billingPuò usare Workbench e gestire i dettagli di fatturazione
    adminPuò fare tutto quanto sopra, più gestire gli utenti

    Concetti chiave

    Membri dell'Organizzazione

    Puoi elencare i membri dell'organizzazione, aggiornare i ruoli dei membri e rimuovere membri.

    Shell
    # Elenca membri dell'organizzazione
curl "https://api.anthropic.com/v1/organizations/users?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Aggiorna ruolo membro
curl "https://api.anthropic.com/v1/organizations/users/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"role": "developer"}'

# Rimuovi membro
curl --request DELETE "https://api.anthropic.com/v1/organizations/users/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

    Inviti dell'Organizzazione

    Puoi invitare utenti alle organizzazioni e gestire quegli inviti.

    Shell
    # Crea invito
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "email": "[email protected]",
    "role": "developer"
  }'

# Elenca inviti
curl "https://api.anthropic.com/v1/organizations/invites?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Elimina invito
curl --request DELETE "https://api.anthropic.com/v1/organizations/invites/{invite_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

    Spazi di Lavoro

    Crea e gestisci spazi di lavoro (console) per organizzare le tue risorse:

    Shell
    # Crea spazio di lavoro
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 spazi di lavoro
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 spazio di lavoro
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"

    Membri dello Spazio di Lavoro

    Gestisci l'accesso degli utenti a spazi di lavoro specifici:

    Shell
    # Aggiungi membro allo spazio di lavoro
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"
  }'

# Elenca membri dello spazio di lavoro
curl "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Aggiorna ruolo 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 membro dallo spazio di lavoro
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"

    Chiavi API

    Monitora e gestisci chiavi API:

    Shell
    # Elenca chiavi API
curl "https://api.anthropic.com/v1/organizations/api_keys?limit=10&status=active&workspace_id=wrkspc_xxx" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Aggiorna chiave API
curl --request POST "https://api.anthropic.com/v1/organizations/api_keys/{api_key_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "status": "inactive",
    "name": "New Key Name"
  }'

    Accesso alle informazioni dell'organizzazione

    Ottieni informazioni sulla tua organizzazione programmaticamente con l'endpoint /v1/organizations/me.

    Per esempio:

    curl "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"
    {
  "id": "12345678-1234-5678-1234-567812345678",
  "type": "organization",
  "name": "Organization Name"
}

    Questo endpoint è utile per determinare programmaticamente a quale organizzazione appartiene una chiave API Admin.

    Per dettagli completi sui parametri e schemi di risposta, vedi il riferimento API delle Informazioni dell'Organizzazione.

    Accesso ai report di utilizzo e costi

    Per accedere ai report di utilizzo e costi per la tua organizzazione, usa gli endpoint dell'API Utilizzo e Costi:

    • L'endpoint Utilizzo (/v1/organizations/usage_report/messages) fornisce dati dettagliati sull'utilizzo, inclusi conteggi di token e metriche di richiesta, raggruppati per varie dimensioni come spazio di lavoro, utente e modello.
    • L'endpoint Costi (/v1/organizations/cost_report) fornisce dati sui costi associati all'utilizzo della tua organizzazione, permettendoti di tracciare le spese e allocare i costi per spazio di lavoro o descrizione.

    Questi endpoint forniscono approfondimenti dettagliati sull'utilizzo della tua organizzazione e sui costi associati.

    Accesso alle analisi di Claude Code

    Per le organizzazioni che usano Claude Code, l'API di Analisi di Claude Code fornisce metriche dettagliate di produttività e approfondimenti sull'utilizzo:

    • L'endpoint di Analisi di Claude Code (/v1/organizations/usage_report/claude_code) fornisce metriche aggregate giornaliere per l'utilizzo di Claude Code, incluse sessioni, righe di codice, commit, pull request, statistiche di utilizzo degli strumenti e dati sui costi suddivisi per utente e modello.

    Questa API ti consente di tracciare la produttività degli sviluppatori, analizzare l'adozione di Claude Code e costruire dashboard personalizzate per la tua organizzazione.

    Migliori pratiche

    Per usare efficacemente l'API Admin:

    • Usa nomi e descrizioni significativi per spazi di lavoro e chiavi API
    • Implementa gestione appropriata degli errori per operazioni fallite
    • Controlla regolarmente i ruoli e permessi dei membri
    • Pulisci spazi di lavoro inutilizzati e inviti scaduti
    • Monitora l'utilizzo delle chiavi API e ruota le chiavi periodicamente

    FAQ