Vai al contenuto principale
Claude Code e open source

Claude Security e security-guidance: cercare vulnerabilità

· 7 minuti di lettura · Redazione Scrivere.AI

In breve

  • Claude Security è un plugin ufficiale che, con il comando /claude-security, scansiona un repository o un insieme di modifiche con agenti che verificano ogni risultato e propone patch da applicare a mano.
  • security-guidance lavora in sottofondo: controlla schemi pericolosi a ogni modifica, fa rivedere il diff a fine turno e analizza i commit di Claude seguendo il flusso dei dati.
  • Claude Security gira con i permessi della sessione senza isolamento proprio, quindi per repository non fidati il README consiglia di usarlo dentro sandbox-runtime.

Anthropic offre due plugin ufficiali di sicurezza per Claude Code che fanno lavori diversi: Claude Security esegue su richiesta una scansione approfondita del codice che hai già, con agenti che costruiscono un modello delle minacce e verificano ogni risultato prima di riportarlo; security-guidance lavora in sottofondo mentre Claude scrive codice e lo avvisa subito quando introduce una vulnerabilità. Il primo serve a fare un audit, il secondo a non creare nuovi problemi.

Se non sei uno sviluppatore, pensa alla differenza tra un'ispezione periodica dell'impianto elettrico e un interruttore salvavita: la prima cerca i difetti esistenti, il secondo interviene mentre lavori. Un plugin è un pacchetto che aggiunge a Claude Code comandi, agenti e controlli automatici; come si installano e gestiscono è spiegato nella guida ai plugin di Claude Code.

Che cos'è il plugin Claude Security?

Claude Security è la versione "dentro la sessione" dell'omonimo servizio di Anthropic per trovare e correggere vulnerabilità. Secondo la documentazione ufficiale di Claude Security, quando scansioni un intero repository un gruppo di agenti mappa l'architettura, costruisce un modello delle minacce, cerca le vulnerabilità componente per componente e fa verificare ogni risultato in modo indipendente prima di scrivere il report.

Il comando è uno solo, /claude-security, che apre un menu con tre lavori:

  • Scan codebase: l'intero repository o una parte delimitata;
  • Scan changes: le modifiche di un ramo, di una pull request o di un singolo commit;
  • Suggest patches: trasforma i risultati di un report in file di patch.

Puoi anche scrivere la richiesta direttamente, per esempio /claude-security scan my branch at high. I livelli di impegno sono low, che salta mappa e modello delle minacce, medium, il predefinito, e high, che cerca più a fondo. Prima di partire la scansione chiede di confermare tempo e consumo stimati.

Come si installa e cosa produce

/plugin install claude-security@claude-plugins-official
/reload-plugins
/claude-security

Servono Python 3.9 o successivo e, per le scansioni delle modifiche e le patch, un repository git. I risultati finiscono in una cartella CLAUDE-SECURITY-<timestamp>/ con un report leggibile, lo stesso elenco in formato JSONL e SARIF per gli strumenti che lo supportano, e un file che lega il report al commit esatto analizzato. La cartella ha un suo .gitignore, così un report non finisce per sbaglio in un commit.

Un risultato entra nel report solo se supera la verifica di agenti indipendenti incaricati di smentirlo: per questo i report restano brevi. Le patch suggerite vengono sviluppate in una copia separata del repository, riviste da altri agenti e salvate nella cartella patches/. Il plugin non applica, non fa commit e non pubblica nulla: decidi tu, per esempio con git apply.

Che cosa fa security-guidance?

security-guidance fa sì che Claude rilegga il proprio codice dal punto di vista della sicurezza mentre lavora, e corregga nella stessa sessione ciò che trova. Una volta installato funziona da solo: non c'è un comando da ricordare. Secondo la documentazione di security-guidance e il README del plugin, i controlli sono su tre livelli:

Quando Che cosa controlla Costo
A ogni modifica di file Confronto con circa 25 schemi pericolosi noti: esecuzione dinamica di codice, deserializzazione non sicura, innerHTML, segreti scritti nel codice, modifiche ai workflow di GitHub Nessuna chiamata al modello
Alla fine di ogni turno Revisione del diff da parte di un modello: autorizzazioni aggirate, accesso diretto a oggetti altrui, injection, SSRF, crittografia debole Consumo aggiuntivo
A ogni commit o push di Claude Un revisore agentico che legge i file collegati e segue il flusso dei dati tra più file Consumo aggiuntivo

Si installa con /plugin install security-guidance@claude-plugins-official, richiede Python e un repository git per le revisioni di fine turno e dei commit.

Per attivarlo per tutto il team basta dichiararlo in enabledPlugins nel file .claude/settings.json del progetto. Il meccanismo sfrutta gli hooks, i controlli automatici di Claude Code descritti in hooks di Claude Code.

Regole specifiche dell'azienda

Puoi aggiungere regole tue in un file claude-security-guidance.md, a livello utente in ~/.claude/ o di progetto in .claude/. Il README fa esempi concreti: "le letture sulla tabella clienti devono passare dal database replica" oppure "le chiamate verso URL forniti dall'utente devono usare il wrapper anti-SSRF". Il contenuto viene aggiunto a ogni revisione, quindi non metterci segreti.

Claude Security o security-guidance: quale usare?

  • Vuoi sapere quali vulnerabilità ha già il tuo applicativo: Claude Security, scansione dell'intero repository.
  • Stai per unire un ramo con modifiche importanti: Claude Security in modalità Scan changes, con impegno high per modifiche di una certa dimensione.
  • Usi Claude Code ogni giorno per scrivere codice: security-guidance sempre attivo, così i problemi vengono corretti prima di arrivare alla pull request.
  • Ti serve un controllo rapido e occasionale del ramo: il comando integrato /security-review.

I due plugin non si escludono: la documentazione li presenta come strati di una difesa in profondità, insieme alla revisione delle pull request e agli strumenti di analisi statica che già usi. Per la revisione del codice in generale, non solo di sicurezza, vedi i plugin ufficiali di revisione del codice.

Un esempio concreto

Immagina, come caso ipotetico, una piccola software house che mantiene un portale clienti. Il responsabile tecnico installa security-guidance per tutto il team tramite il file di progetto e aggiunge due regole interne su autenticazione e accesso ai dati. Una volta al mese, prima di un rilascio, lancia /claude-security con Scan codebase, legge il report con il collega più esperto, chiede le patch solo per i risultati di gravità alta e le applica dopo averle provate in un ambiente di test.

Quali limiti e cautele considerare?

Il primo punto riguarda dove gira Claude Security: nella tua sessione, con i tuoi permessi, senza un isolamento proprio. Le impostazioni, gli hooks e il CLAUDE.md del repository si applicano come in qualsiasi altra sessione. Per questo il README lo indica come adatto al codice che controlli, e per repository non fidati, come una dipendenza di terzi o un progetto sconosciuto, suggerisce di eseguire l'intera sessione dentro sandbox-runtime, il sandbox open source di Anthropic. Il tema dell'isolamento è approfondito in isolare Claude Code.

Il secondo punto riguarda i dati: security-guidance invia al modello i percorsi dei file modificati, le porzioni di diff e i contenuti dei file coinvolti; il revisore dei commit anche i file che legge per seguire il flusso dei dati. Con l'API di Anthropic o un abbonamento finiscono su api.anthropic.com, con un gateway o un provider cloud valgono le condizioni di quel fornitore. Le revisioni consumano uso o crediti in più rispetto alla sessione, e ogni livello si può spegnere con variabili d'ambiente come ENABLE_STOP_REVIEW=0 o SECURITY_GUIDANCE_DISABLE=1.

Infine, entrambi sono strumenti di supporto, non garanzie: possono mancare vulnerabilità o segnalare falsi positivi, e le scansioni non sono deterministiche, quindi due esecuzioni possono dare risultati diversi. Non sostituiscono la revisione umana, i test di penetrazione o l'analisi delle dipendenze. Claude Security invia anche contatori d'uso tramite la telemetria di Claude Code, che si disattiva con le impostazioni di Claude Code stesso. Per i rischi generali dei plugin di terze parti vale quanto spiegato in sicurezza dei plugin di Claude Code.

Per chi ha senso?

Claude Security ha senso per chi sviluppa o mantiene applicativi propri, dal gestionale interno al sito con area riservata, e vuole un audit documentato senza attendere una revisione esterna. Richiede un piano a pagamento, l'accesso all'API di Anthropic o un provider cloud, perché usa i workflow dinamici per coordinare gli agenti: sul piano Pro vanno attivati dalla voce dedicata in /config.

security-guidance è utile a chiunque faccia scrivere codice a Claude con regolarità, anche a chi non è esperto di sicurezza, perché porta i controlli nel momento in cui il problema nasce. Per un titolare che affida lo sviluppo a terzi, chiedere che entrambi siano attivi è una richiesta concreta da inserire nel capitolato.

Cosa fare adesso

Installa security-guidance su un progetto in cui usi Claude Code ogni giorno e guarda per una settimana cosa segnala. Poi lancia una scansione Claude Security a impegno low su un repository tuo, leggi il report e solo dopo decidi se passare a medium o high. Se il codice da analizzare non è tuo, prepara prima un ambiente isolato.

Domande frequenti

Che differenza c'è tra Claude Security e security-guidance?

Claude Security esegue su richiesta un audit del codice esistente o di un ramo; security-guidance controlla automaticamente il codice mentre Claude lo scrive e lo fa correggere nella stessa sessione.

Claude Security applica le correzioni da solo?

No. Le patch vengono salvate come file nella cartella patches del report e il plugin non applica, non fa commit e non pubblica nulla: decidi tu se e quando applicarle.

security-guidance invia il codice all'esterno?

Le revisioni di fine turno e dei commit inviano al modello diff e contenuti dei file coinvolti, verso l'API di Anthropic o il provider configurato. Il controllo a ogni modifica invece non chiama alcun modello.

Si può usare Claude Security su un repository di terzi?

Il README lo sconsiglia senza isolamento, perché il plugin gira con i permessi della sessione: per codice non fidato suggerisce di eseguire tutta la sessione dentro sandbox-runtime.

Continua a leggere