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
    Streaming InputStreaming delle risposte in tempo realeGestione dei motivi di arrestoGestione dei permessiApprovazioni utente e inputControllare l'esecuzione con hookGestione della sessioneCheckpoint dei fileOutput strutturati nell'SDKHosting dell'Agent SDKDistribuzione sicura degli agenti AIModifica dei prompt di sistemaMCP nell'SDKStrumenti personalizzatiSubagenti 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)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
    Guide

    Configura i permessi

    Controlla come il tuo agente utilizza gli strumenti con modalità di permesso, hook e regole dichiarative di consentimento/negazione.

    Claude Agent SDK fornisce controlli di permesso per gestire come Claude utilizza gli strumenti. Utilizza modalità di permesso e regole per definire cosa è consentito automaticamente, e il callback canUseTool per gestire tutto il resto in fase di esecuzione.

    Questa pagina copre le modalità di permesso e le regole. Per creare flussi di approvazione interattivi in cui gli utenti approvano o negano le richieste di strumenti in fase di esecuzione, vedi Gestisci approvazioni e input dell'utente.

    Come vengono valutati i permessi

    Quando Claude richiede uno strumento, l'SDK controlla i permessi in questo ordine:

    1. 1

      Hook

      Esegui hook per primo, che può consentire, negare o continuare al passaggio successivo

    2. 2

      Regole di permesso

      Controlla le regole definite in settings.json in questo ordine: regole deny per prime (blocca indipendentemente da altre regole), poi regole allow (consenti se corrispondente), poi regole ask (richiedi approvazione). Queste regole dichiarative ti permettono di pre-approvare, bloccare o richiedere approvazione per strumenti specifici senza scrivere codice.

    3. 3

      Modalità di permesso

      Applica la modalità di permesso attiva (bypassPermissions, acceptEdits, dontAsk, ecc.)

    4. 4

      callback canUseTool

      Se non risolto da regole o modalità, chiama il tuo callback canUseTool per una decisione

    Diagramma del flusso di valutazione dei permessi

    Questa pagina si concentra sulle modalità di permesso (passaggio 3), la configurazione statica che controlla il comportamento predefinito. Per gli altri passaggi:

    • Hook: esegui codice personalizzato per consentire, negare o modificare le richieste di strumenti. Vedi Controlla l'esecuzione con hook.
    • Regole di permesso: configura regole dichiarative di consentimento/negazione in settings.json. Vedi Impostazioni di permesso.
    • callback canUseTool: richiedi agli utenti l'approvazione in fase di esecuzione. Vedi Gestisci approvazioni e input dell'utente.

    Modalità di permesso

    Le modalità di permesso forniscono un controllo globale su come Claude utilizza gli strumenti. Puoi impostare la modalità di permesso quando chiami query() o cambiarla dinamicamente durante le sessioni di streaming.

    Modalità disponibili

    L'SDK supporta queste modalità di permesso:

    ModalitàDescrizioneComportamento dello strumento
    defaultComportamento di permesso standardNessuna auto-approvazione; gli strumenti non corrispondenti attivano il tuo callback canUseTool
    acceptEditsAuto-accetta modifiche ai fileLe modifiche ai file e le operazioni del filesystem (mkdir, rm, mv, ecc.) vengono approvate automaticamente
    bypassPermissionsIgnora tutti i controlli di permessoTutti gli strumenti vengono eseguiti senza prompt di permesso (usa con cautela)
    planModalità di pianificazioneNessuna esecuzione di strumenti; Claude pianifica senza apportare modifiche

    Ereditarietà dei subagent: quando si utilizza bypassPermissions, tutti i subagent ereditano questa modalità e non può essere sovrascritta. I subagent possono avere prompt di sistema diversi e comportamenti meno vincolati rispetto al tuo agente principale. L'abilitazione di bypassPermissions concede loro accesso completo e autonomo al sistema senza alcun prompt di approvazione.

    Imposta la modalità di permesso

    Puoi impostare la modalità di permesso una volta all'inizio di una query, o cambiarla dinamicamente mentre la sessione è attiva.

    Dettagli della modalità

    Modalità di accettazione modifiche (acceptEdits)

    Auto-approva le operazioni sui file in modo che Claude possa modificare il codice senza richiedere conferma. Altri strumenti (come i comandi Bash che non sono operazioni del filesystem) richiedono comunque i permessi normali.

    Operazioni auto-approvate:

    • Modifiche ai file (strumenti Edit, Write)
    • Comandi del filesystem: mkdir, touch, rm, mv, cp

    Usa quando: ti fidi delle modifiche di Claude e desideri un'iterazione più veloce, ad esempio durante la prototipazione o quando lavori in una directory isolata.

    Modalità di bypass dei permessi (bypassPermissions)

    Auto-approva tutti gli usi degli strumenti senza prompt. Gli hook vengono comunque eseguiti e possono bloccare le operazioni se necessario.

    Usa con estrema cautela. Claude ha accesso completo al sistema in questa modalità. Usa solo in ambienti controllati in cui ti fidi di tutte le operazioni possibili.

    Modalità di pianificazione (plan)

    Impedisce completamente l'esecuzione degli strumenti. Claude può analizzare il codice e creare piani ma non può apportare modifiche. Claude può utilizzare AskUserQuestion per chiarire i requisiti prima di finalizzare il piano. Vedi Gestisci approvazioni e input dell'utente per gestire questi prompt.

    Usa quando: desideri che Claude proponga modifiche senza eseguirle, ad esempio durante la revisione del codice o quando hai bisogno di approvare le modifiche prima che vengano apportate.

    Risorse correlate

    Per gli altri passaggi nel flusso di valutazione dei permessi:

    • Gestisci approvazioni e input dell'utente: prompt di approvazione interattivi e domande di chiarimento
    • Guida agli hook: esegui codice personalizzato nei punti chiave del ciclo di vita dell'agente
    • Regole di permesso: regole dichiarative di consentimento/negazione in settings.json

    Was this page helpful?

    • Come vengono valutati i permessi
    • Modalità di permesso
    • Modalità disponibili
    • Imposta la modalità di permesso
    • Dettagli della modalità
    • Risorse correlate