Gestione dei Permessi

Modalità	Descrizione	Comportamento Strumento
`default`	Comportamento standard dei permessi	Si applicano i controlli normali dei permessi
`plan`	Modalità pianificazione - nessuna esecuzione	Claude può utilizzare solo strumenti di sola lettura; presenta un piano prima dell'esecuzione (Attualmente non supportato nell'SDK)
`acceptEdits`	Accetta automaticamente le modifiche ai file	Le modifiche ai file e le operazioni del filesystem vengono approvate automaticamente
`bypassPermissions`	Bypassa tutti i controlli dei permessi	Tutti gli strumenti vengono eseguiti senza richieste di permesso (usa con cautela)

import { query } from "@anthropic-ai/claude-agent-sdk";

const result = await query({
  prompt: "Aiutami a refactorizzare questo codice",
  options: {
    permissionMode: 'default'  // Modalità permesso standard
  }
});

import { query } from "@anthropic-ai/claude-agent-sdk";

// Crea un generatore asincrono per l'input streaming
async function* streamInput() {
  yield { 
    type: 'user',
    message: { 
      role: 'user', 
      content: "Iniziamo con i permessi predefiniti" 
    }
  };
  
  // Più tardi nella conversazione...
  yield {
    type: 'user',
    message: {
      role: 'user',
      content: "Ora acceleriamo lo sviluppo"
    }
  };
}

const q = query({
  prompt: streamInput(),
  options: {
    permissionMode: 'default'  // Inizia in modalità predefinita
  }
});

// Cambia modalità dinamicamente
await q.setPermissionMode('acceptEdits');

// Elabora i messaggi
for await (const message of q) {
  console.log(message);
}

import { query } from "@anthropic-ai/claude-agent-sdk";

async function promptForToolApproval(toolName: string, input: any) {
  console.log("\n🔧 Richiesta Strumento:");
  console.log(`   Strumento: ${toolName}`);
  
  // Visualizza i parametri dello strumento
  if (input && Object.keys(input).length > 0) {
    console.log("   Parametri:");
    for (const [key, value] of Object.entries(input)) {
      let displayValue = value;
      if (typeof value === 'string' && value.length > 100) {
        displayValue = value.substring(0, 100) + "...";
      } else if (typeof value === 'object') {
        displayValue = JSON.stringify(value, null, 2);
      }
      console.log(`     ${key}: ${displayValue}`);
    }
  }
  
  // Ottieni l'approvazione dell'utente (sostituisci con la tua logica UI)
  const approved = await getUserApproval();
  
  if (approved) {
    console.log("   ✅ Approvato\n");
    return {
      behavior: "allow",
      updatedInput: input
    };
  } else {
    console.log("   ❌ Negato\n");
    return {
      behavior: "deny",
      message: "L'utente ha negato il permesso per questo strumento"
    };
  }
}

// Usa il callback di permesso
const result = await query({
  prompt: "Aiutami ad analizzare questa codebase",
  options: {
    canUseTool: async (toolName, input) => {
      return promptForToolApproval(toolName, input);
    }
  }
});

Gestione dei Permessi

Permessi SDK

Panoramica

Gestione dei Permessi

Permessi SDK

Panoramica

Diagramma del Flusso dei Permessi

Modalità di Permesso

Modalità Disponibili

Impostazione della Modalità di Permesso

1. Configurazione Iniziale

2. Cambiamenti Dinamici della Modalità (Solo Streaming)

Comportamenti Specifici delle Modalità

Modalità Accetta Modifiche (`acceptEdits`)

Modalità Bypassa Permessi (`bypassPermissions`)

Priorità della Modalità nel Flusso dei Permessi

Migliori Pratiche

canUseTool

Risorse Correlate

Permessi SDK

Panoramica

Permessi SDK

Panoramica

Diagramma del Flusso dei Permessi

Modalità di Permesso

Modalità Disponibili

Impostazione della Modalità di Permesso

1. Configurazione Iniziale

2. Cambiamenti Dinamici della Modalità (Solo Streaming)

Comportamenti Specifici delle Modalità

Modalità Accetta Modifiche (acceptEdits)

Modalità Bypassa Permessi (bypassPermissions)

Priorità della Modalità nel Flusso dei Permessi

Migliori Pratiche

canUseTool

Risorse Correlate

Modalità Accetta Modifiche (`acceptEdits`)

Modalità Bypassa Permessi (`bypassPermissions`)