Flussi di lavoro comuni - Claude Code Docs

Questa pagina copre flussi di lavoro pratici per lo sviluppo quotidiano: esplorare codice non familiare, eseguire il debug, effettuare refactoring, scrivere test, creare PR e gestire sessioni. Ogni sezione include prompt di esempio che puoi adattare ai tuoi progetti. Per modelli e suggerimenti di livello superiore, vedi Best practices.

Comprendere nuove basi di codice

Ottenere una rapida panoramica della base di codice

Supponiamo che tu abbia appena aderito a un nuovo progetto e debba comprendere rapidamente la sua struttura.

Navigare alla directory radice del progetto

cd /path/to/project

Avviare Claude Code

claude

Chiedere una panoramica di alto livello

give me an overview of this codebase

Approfondire componenti specifici

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?

Suggerimenti:

Inizia con domande ampie, quindi restringi a aree specifiche
Chiedi informazioni sulle convenzioni di codifica e sui modelli utilizzati nel progetto
Richiedi un glossario di termini specifici del progetto

Trovare codice rilevante

Supponiamo che tu debba individuare il codice relativo a una funzionalità o funzione specifica.

Chiedere a Claude di trovare file rilevanti

find the files that handle user authentication

Ottenere contesto su come i componenti interagiscono

how do these authentication files work together?

Comprendere il flusso di esecuzione

trace the login process from front-end to database

Suggerimenti:

Sii specifico su ciò che stai cercando
Usa il linguaggio del dominio dal progetto
Installa un plugin di code intelligence per il tuo linguaggio per dare a Claude una navigazione precisa “go to definition” e “find references”

Correggere bug in modo efficiente

Supponiamo che tu abbia riscontrato un messaggio di errore e debba trovare e correggere la sua fonte.

Condividere l'errore con Claude

I'm seeing an error when I run npm test

Chiedere raccomandazioni per la correzione

suggest a few ways to fix the @ts-ignore in user.ts

Applicare la correzione

update user.ts to add the null check you suggested

Suggerimenti:

Comunica a Claude il comando per riprodurre il problema e ottenere una stack trace
Menziona eventuali passaggi per riprodurre l’errore
Fai sapere a Claude se l’errore è intermittente o coerente

Effettuare refactoring del codice

Supponiamo che tu debba aggiornare il codice precedente per utilizzare modelli e pratiche moderne.

Identificare il codice legacy per il refactoring

find deprecated API usage in our codebase

Ottenere raccomandazioni per il refactoring

suggest how to refactor utils.js to use modern JavaScript features

Applicare le modifiche in modo sicuro

refactor utils.js to use ES2024 features while maintaining the same behavior

Verificare il refactoring

run tests for the refactored code

Suggerimenti:

Chiedi a Claude di spiegare i vantaggi dell’approccio moderno
Richiedi che le modifiche mantengano la compatibilità all’indietro quando necessario
Effettua il refactoring in piccoli incrementi testabili

Utilizzare subagent specializzati

Supponiamo che tu voglia utilizzare subagent AI specializzati per gestire attività specifiche in modo più efficace.

Visualizzare i subagent disponibili

/agents

Questo mostra tutti i subagent disponibili e ti consente di crearne di nuovi.

Utilizzare i subagent automaticamente

Claude Code delega automaticamente le attività appropriate ai subagent specializzati:

review my recent code changes for security issues

run all tests and fix any failures

Richiedere esplicitamente subagent specifici

use the code-reviewer subagent to check the auth module

have the debugger subagent investigate why users can't log in

Creare subagent personalizzati per il tuo flusso di lavoro

/agents

Quindi seleziona “Create New subagent” e segui i prompt per definire:

Un identificatore univoco che descrive lo scopo del subagent (ad esempio, code-reviewer, api-designer).
Quando Claude dovrebbe utilizzare questo agente
Quali strumenti può accedere
Un prompt di sistema che descrive il ruolo e il comportamento dell’agente

Suggerimenti:

Crea subagent specifici del progetto in .claude/agents/ per la condivisione del team
Usa campi description descrittivi per abilitare la delegazione automatica
Limita l’accesso agli strumenti a ciò di cui ogni subagent ha effettivamente bisogno
Controlla la documentazione dei subagent per esempi dettagliati

Utilizzare Plan Mode per l’analisi sicura del codice

Plan Mode istruisce Claude a creare un piano analizzando la base di codice con operazioni di sola lettura, perfetto per esplorare basi di codice, pianificare modifiche complesse o rivedere il codice in modo sicuro. In Plan Mode, Claude utilizza AskUserQuestion per raccogliere requisiti e chiarire i tuoi obiettivi prima di proporre un piano.

Quando utilizzare Plan Mode

Implementazione multi-step: Quando la tua funzionalità richiede di apportare modifiche a molti file
Esplorazione del codice: Quando desideri ricercare a fondo la base di codice prima di modificare qualsiasi cosa
Sviluppo interattivo: Quando desideri iterare sulla direzione con Claude

Come utilizzare Plan Mode

Attivare Plan Mode durante una sessione Puoi passare a Plan Mode durante una sessione utilizzando Shift+Tab per scorrere le modalità di autorizzazione. Se sei in Normal Mode, Shift+Tab passa prima a Auto-Accept Mode, indicato da ⏵⏵ accept edits on nella parte inferiore del terminale. Un successivo Shift+Tab passerà a Plan Mode, indicato da ⏸ plan mode on. Avviare una nuova sessione in Plan Mode Per avviare una nuova sessione in Plan Mode, usa il flag --permission-mode plan:

claude --permission-mode plan

Eseguire query “headless” in Plan Mode Puoi anche eseguire una query in Plan Mode direttamente con -p (cioè in “headless mode”):

claude --permission-mode plan -p "Analyze the authentication system and suggest improvements"

Esempio: Pianificazione di un refactoring complesso

claude --permission-mode plan

I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.

Claude analizza l’implementazione attuale e crea un piano completo. Affina con follow-up:

What about backward compatibility?

How should we handle database migration?

Premi Ctrl+G per aprire il piano nel tuo editor di testo predefinito, dove puoi modificarlo direttamente prima che Claude proceda.

Configurare Plan Mode come predefinito

// .claude/settings.json
{
  "permissions": {
    "defaultMode": "plan"
  }
}

Vedi la documentazione delle impostazioni per ulteriori opzioni di configurazione.

Lavorare con i test

Supponiamo che tu debba aggiungere test per il codice non coperto.

Identificare il codice non testato

find functions in NotificationsService.swift that are not covered by tests

Generare lo scaffolding dei test

add tests for the notification service

Aggiungere casi di test significativi

add test cases for edge conditions in the notification service

Eseguire e verificare i test

run the new tests and fix any failures

Claude può generare test che seguono i modelli e le convenzioni esistenti del tuo progetto. Quando chiedi test, sii specifico sul comportamento che desideri verificare. Claude esamina i tuoi file di test esistenti per abbinare lo stile, i framework e i modelli di asserzione già in uso. Per una copertura completa, chiedi a Claude di identificare i casi limite che potresti aver perso. Claude può analizzare i tuoi percorsi di codice e suggerire test per condizioni di errore, valori limite e input inaspettati che sono facili da trascurare.

Creare pull request

Puoi creare pull request chiedendo direttamente a Claude (“create a pr for my changes”), oppure guidare Claude attraverso i passaggi:

Riassumere le tue modifiche

summarize the changes I've made to the authentication module

Generare una pull request

create a pr

Rivedere e affinare

enhance the PR description with more context about the security improvements

Quando crei una PR utilizzando gh pr create, la sessione viene automaticamente collegata a quella PR. Puoi riprenderla in seguito con claude --from-pr <number>.

Rivedi la PR generata da Claude prima di inviarla e chiedi a Claude di evidenziare i rischi potenziali o le considerazioni.

Gestire la documentazione

Supponiamo che tu debba aggiungere o aggiornare la documentazione per il tuo codice.

Identificare il codice non documentato

find functions without proper JSDoc comments in the auth module

Generare la documentazione

add JSDoc comments to the undocumented functions in auth.js

Rivedere e migliorare

improve the generated documentation with more context and examples

Verificare la documentazione

check if the documentation follows our project standards

Suggerimenti:

Specifica lo stile di documentazione che desideri (JSDoc, docstrings, ecc.)
Chiedi esempi nella documentazione
Richiedi documentazione per API pubbliche, interfacce e logica complessa

Lavorare con le immagini

Supponiamo che tu debba lavorare con immagini nella tua base di codice e desideri l’aiuto di Claude nell’analizzare il contenuto dell’immagine.

Aggiungere un'immagine alla conversazione

Puoi utilizzare uno di questi metodi:

Trascina e rilascia un’immagine nella finestra di Claude Code
Copia un’immagine e incollala nella CLI con ctrl+v (Non usare cmd+v)
Fornisci un percorso di immagine a Claude. Ad esempio, “Analyze this image: /path/to/your/image.png”

Chiedere a Claude di analizzare l'immagine

What does this image show?

Describe the UI elements in this screenshot

Are there any problematic elements in this diagram?

Utilizzare le immagini per il contesto

Here's a screenshot of the error. What's causing it?

This is our current database schema. How should we modify it for the new feature?

Ottenere suggerimenti di codice dal contenuto visivo

Generate CSS to match this design mockup

What HTML structure would recreate this component?

Suggerimenti:

Usa le immagini quando le descrizioni di testo sarebbero poco chiare o ingombranti
Includi screenshot di errori, design dell’interfaccia utente o diagrammi per un contesto migliore
Puoi lavorare con più immagini in una conversazione
L’analisi delle immagini funziona con diagrammi, screenshot, mockup e altro
Quando Claude fa riferimento a immagini (ad esempio, [Image #1]), Cmd+Click (Mac) o Ctrl+Click (Windows/Linux) il collegamento per aprire l’immagine nel tuo visualizzatore predefinito

Fare riferimento a file e directory

Usa @ per includere rapidamente file o directory senza aspettare che Claude li legga.

Fare riferimento a un singolo file

Explain the logic in @src/utils/auth.js

Questo include il contenuto completo del file nella conversazione.

Fare riferimento a una directory

What's the structure of @src/components?

Questo fornisce un elenco di directory con informazioni sui file.

Fare riferimento alle risorse MCP

Show me the data from @github:repos/owner/repo/issues

Questo recupera i dati dai server MCP connessi utilizzando il formato @server:resource. Vedi risorse MCP per i dettagli.

Suggerimenti:

I percorsi dei file possono essere relativi o assoluti
I riferimenti ai file @ aggiungono CLAUDE.md nella directory del file e nelle directory padre al contesto
I riferimenti alle directory mostrano elenchi di file, non contenuti
Puoi fare riferimento a più file in un singolo messaggio (ad esempio, “@file1.js and @file2.js”)

Utilizzare il pensiero esteso (thinking mode)

Extended thinking è abilitato per impostazione predefinita, dando a Claude lo spazio per ragionare attraverso problemi complessi passo dopo passo prima di rispondere. Questo ragionamento è visibile in modalità verbose, che puoi attivare con Ctrl+O. Inoltre, Opus 4.6 e Sonnet 4.6 supportano il ragionamento adattivo: invece di un budget di token di pensiero fisso, il modello alloca dinamicamente il pensiero in base alla tua impostazione di livello di sforzo. Extended thinking e il ragionamento adattivo lavorano insieme per darti il controllo su quanto profondamente Claude ragiona prima di rispondere. Extended thinking è particolarmente prezioso per decisioni architettoniche complesse, bug impegnativi, pianificazione dell’implementazione multi-step e valutazione dei compromessi tra diversi approcci.

Frasi come “think”, “think hard” e “think more” sono interpretate come istruzioni di prompt regolari e non allocano token di pensiero.

Configurare la modalità di pensiero

Il pensiero è abilitato per impostazione predefinita, ma puoi regolarlo o disabilitarlo.

Ambito	Come configurare	Dettagli
Livello di sforzo	Esegui `/effort`, regola in `/model`, o imposta `CLAUDE_CODE_EFFORT_LEVEL`	Controlla la profondità del pensiero per Opus 4.6 e Sonnet 4.6. Vedi Regola il livello di sforzo
Parola chiave `ultrathink`	Includi “ultrathink” in qualsiasi punto del tuo prompt	Imposta lo sforzo su alto per quel turno su Opus 4.6 e Sonnet 4.6. Utile per attività una tantum che richiedono un ragionamento profondo senza modificare permanentemente la tua impostazione di sforzo
Scorciatoia di attivazione/disattivazione	Premi `Option+T` (macOS) o `Alt+T` (Windows/Linux)	Attiva/disattiva il pensiero per la sessione corrente (tutti i modelli). Potrebbe richiedere la configurazione del terminale per abilitare le scorciatoie da tastiera Option
Predefinito globale	Usa `/config` per attivare/disattivare la modalità di pensiero	Imposta il tuo predefinito in tutti i progetti (tutti i modelli). Salvato come `alwaysThinkingEnabled` in `~/.claude/settings.json`
Limitare il budget dei token	Imposta la variabile di ambiente `MAX_THINKING_TOKENS`	Limita il budget di pensiero a un numero specifico di token (ignorato su Opus 4.6 e Sonnet 4.6 a meno che non sia impostato su 0). Esempio: `export MAX_THINKING_TOKENS=10000`

Per visualizzare il processo di pensiero di Claude, premi Ctrl+O per attivare la modalità verbose e vedi il ragionamento interno visualizzato come testo grigio in corsivo.

Come funziona il pensiero esteso

Extended thinking controlla quanto ragionamento interno Claude esegue prima di rispondere. Più pensiero fornisce più spazio per esplorare soluzioni, analizzare casi limite e autocorreggersi gli errori. Con Opus 4.6 e Sonnet 4.6, il pensiero utilizza il ragionamento adattivo: il modello alloca dinamicamente i token di pensiero in base al livello di sforzo che selezioni. Questo è il modo consigliato per sintonizzare il compromesso tra velocità e profondità di ragionamento. Con modelli più vecchi, il pensiero utilizza un budget fisso di fino a 31.999 token dal tuo budget di output. Puoi limitare questo con la variabile di ambiente MAX_THINKING_TOKENS, o disabilitare completamente il pensiero tramite /config o l’attivazione/disattivazione Option+T/Alt+T. MAX_THINKING_TOKENS è ignorato su Opus 4.6 e Sonnet 4.6, poiché il ragionamento adattivo controlla la profondità del pensiero. L’unica eccezione: impostare MAX_THINKING_TOKENS=0 disabilita comunque completamente il pensiero su qualsiasi modello. Per disabilitare il pensiero adattivo e tornare al budget di pensiero fisso, imposta CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1. Vedi variabili di ambiente.

Ti viene addebitato per tutti i token di pensiero utilizzati, anche se i modelli Claude 4 mostrano il pensiero riassunto

Riprendere conversazioni precedenti

Quando avvii Claude Code, puoi riprendere una sessione precedente:

claude --continue continua la conversazione più recente nella directory corrente
claude --resume apre un selettore di conversazione o riprende per nome
claude --from-pr 123 riprende le sessioni collegate a una pull request specifica

Da una sessione attiva, usa /resume per passare a una conversazione diversa. Le sessioni vengono archiviate per directory di progetto. Il selettore /resume mostra le sessioni dallo stesso repository git, inclusi i worktree.

Denominare le tue sessioni

Dai alle sessioni nomi descrittivi per trovarle in seguito. Questa è una best practice quando lavori su più attività o funzionalità.

Denominare la sessione

Denomina una sessione all’avvio con -n:

claude -n auth-refactor

Oppure usa /rename durante una sessione, che mostra anche il nome sulla barra del prompt:

/rename auth-refactor

Puoi anche rinominare qualsiasi sessione dal selettore: esegui /resume, naviga a una sessione e premi R.

Riprendere per nome in seguito

Dalla riga di comando:

claude --resume auth-refactor

O da una sessione attiva:

/resume auth-refactor

Utilizzare il selettore di sessione

Il comando /resume (o claude --resume senza argomenti) apre un selettore di sessione interattivo con queste funzionalità: Scorciatoie da tastiera nel selettore:

Scorciatoia	Azione
`↑` / `↓`	Navigare tra le sessioni
`→` / `←`	Espandere o comprimere le sessioni raggruppate
`Enter`	Selezionare e riprendere la sessione evidenziata
`P`	Visualizzare l’anteprima del contenuto della sessione
`R`	Rinominare la sessione evidenziata
`/`	Cercare per filtrare le sessioni
`A`	Alternare tra la directory corrente e tutti i progetti
`B`	Filtrare le sessioni dal tuo ramo git corrente
`Esc`	Uscire dal selettore o dalla modalità di ricerca

Organizzazione della sessione: Il selettore visualizza le sessioni con metadati utili:

Nome della sessione o prompt iniziale
Tempo trascorso dall’ultima attività
Conteggio dei messaggi
Ramo Git (se applicabile)

Le sessioni fork (create con /rewind o --fork-session) sono raggruppate insieme sotto la loro sessione radice, rendendo più facile trovare conversazioni correlate.

Suggerimenti:

Denominare le sessioni in anticipo: Usa /rename quando inizi a lavorare su un’attività distinta, è molto più facile trovare “payment-integration” che “explain this function” in seguito
Usa --continue per un accesso rapido alla tua conversazione più recente nella directory corrente
Usa --resume session-name quando sai quale sessione ti serve
Usa --resume (senza un nome) quando hai bisogno di sfogliare e selezionare
Per gli script, usa claude --continue --print "prompt" per riprendere in modalità non interattiva
Premi P nel selettore per visualizzare l’anteprima di una sessione prima di riprenderla
La conversazione ripresa inizia con lo stesso modello e configurazione dell’originale

Come funziona:

Archiviazione della conversazione: Tutte le conversazioni vengono salvate automaticamente localmente con la loro cronologia completa dei messaggi
Deserializzazione dei messaggi: Quando si riprende, l’intera cronologia dei messaggi viene ripristinata per mantenere il contesto
Stato dello strumento: L’utilizzo dello strumento e i risultati della conversazione precedente vengono preservati
Ripristino del contesto: La conversazione riprende con tutto il contesto precedente intatto

Eseguire sessioni parallele di Claude Code con Git worktrees

Quando lavori su più attività contemporaneamente, hai bisogno che ogni sessione di Claude abbia la sua copia della base di codice in modo che le modifiche non si scontrino. I worktree Git risolvono questo creando directory di lavoro separate che hanno ciascuna i propri file e ramo, mentre condividono la stessa cronologia del repository e le connessioni remote. Ciò significa che puoi avere Claude che lavora su una funzionalità in un worktree mentre corregge un bug in un altro, senza che nessuna sessione interferisca con l’altra. Usa il flag --worktree (-w) per creare un worktree isolato e avviare Claude in esso. Il valore che passi diventa il nome della directory del worktree e il nome del ramo:

# Avviare Claude in un worktree denominato "feature-auth"
# Crea .claude/worktrees/feature-auth/ con un nuovo ramo
claude --worktree feature-auth

# Avviare un'altra sessione in un worktree separato
claude --worktree bugfix-123

Se ometti il nome, Claude ne genera uno casuale automaticamente:

# Genera automaticamente un nome come "bright-running-fox"
claude --worktree

I worktree vengono creati in <repo>/.claude/worktrees/<name> e si diramano dal ramo remoto predefinito. Il ramo del worktree è denominato worktree-<name>. Puoi anche chiedere a Claude di “work in a worktree” o “start a worktree” durante una sessione, e creerà uno automaticamente.

Worktree dei subagent

I subagent possono anche utilizzare l’isolamento del worktree per lavorare in parallelo senza conflitti. Chiedi a Claude di “use worktrees for your agents” o configuralo in un subagent personalizzato aggiungendo isolation: worktree al frontmatter dell’agente. Ogni subagent ottiene il suo worktree che viene automaticamente pulito quando il subagent finisce senza modifiche.

Pulizia del worktree

Quando esci da una sessione di worktree, Claude gestisce la pulizia in base al fatto che tu abbia apportato modifiche:

Nessuna modifica: il worktree e il suo ramo vengono rimossi automaticamente
Modifiche o commit esistenti: Claude ti chiede se mantenere o rimuovere il worktree. Mantenere preserva la directory e il ramo in modo da poter tornare in seguito. Rimuovere elimina la directory del worktree e il suo ramo, scartando tutte le modifiche non sottoposte a commit e i commit

Per pulire i worktree al di fuori di una sessione di Claude, usa la gestione manuale del worktree.

Aggiungi .claude/worktrees/ al tuo .gitignore per evitare che il contenuto del worktree appaia come file non tracciati nel tuo repository principale.

Gestire i worktree manualmente

Per un maggiore controllo sulla posizione del worktree e sulla configurazione del ramo, crea i worktree direttamente con Git. Questo è utile quando hai bisogno di controllare un ramo esistente specifico o posizionare il worktree al di fuori del repository.

# Creare un worktree con un nuovo ramo
git worktree add ../project-feature-a -b feature-a

# Creare un worktree con un ramo esistente
git worktree add ../project-bugfix bugfix-123

# Avviare Claude nel worktree
cd ../project-feature-a && claude

# Pulire al termine
git worktree list
git worktree remove ../project-feature-a

Scopri di più nella documentazione ufficiale di Git worktree.

Ricorda di inizializzare il tuo ambiente di sviluppo in ogni nuovo worktree secondo la configurazione del tuo progetto. A seconda del tuo stack, questo potrebbe includere l’esecuzione dell’installazione delle dipendenze (npm install, yarn), la configurazione di ambienti virtuali o il seguire il processo di configurazione standard del tuo progetto.

Controllo della versione non git

L’isolamento del worktree funziona con git per impostazione predefinita. Per altri sistemi di controllo della versione come SVN, Perforce o Mercurial, configura gli hook WorktreeCreate e WorktreeRemove per fornire logica personalizzata di creazione e pulizia del worktree. Quando configurati, questi hook sostituiscono il comportamento git predefinito quando usi --worktree. Per il coordinamento automatizzato di sessioni parallele con attività condivise e messaggistica, vedi team di agenti.

Ricevere notifiche quando Claude ha bisogno della tua attenzione

Quando avvii un’attività a lunga esecuzione e passi a un’altra finestra, puoi configurare notifiche desktop in modo da sapere quando Claude finisce o ha bisogno del tuo input. Questo utilizza l’evento Notification hook, che si attiva ogni volta che Claude è in attesa di autorizzazione, inattivo e pronto per un nuovo prompt, o completando l’autenticazione.

Aggiungere l'hook alle tue impostazioni

Apri ~/.claude/settings.json e aggiungi un hook Notification che chiama il comando di notifica nativa della tua piattaforma:

macOS
Linux
Windows

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "notify-send 'Claude Code' 'Claude Code needs your attention'"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""
          }
        ]
      }
    ]
  }
}

Se il tuo file di impostazioni ha già una chiave hooks, unisci la voce Notification in essa piuttosto che sovrascrivere. Puoi anche chiedere a Claude di scrivere l’hook per te descrivendo ciò che desideri nella CLI.

Facoltativamente restringere il matcher

Per impostazione predefinita l’hook si attiva su tutti i tipi di notifica. Per attivarsi solo per eventi specifici, imposta il campo matcher su uno di questi valori:

Matcher	Si attiva quando
`permission_prompt`	Claude ha bisogno che tu approvi un utilizzo dello strumento
`idle_prompt`	Claude ha finito ed è in attesa del tuo prossimo prompt
`auth_success`	L’autenticazione si completa
`elicitation_dialog`	Claude ti sta facendo una domanda

Verificare l'hook

Digita /hooks e seleziona Notification per confermare che l’hook appare. Selezionarlo mostra il comando che verrà eseguito. Per testarlo end-to-end, chiedi a Claude di eseguire un comando che richiede autorizzazione e passa a un’altra finestra, oppure chiedi a Claude di attivare una notifica direttamente.

Per lo schema completo dell’evento e i tipi di notifica, vedi il riferimento Notification.

Utilizzare Claude come utilità di tipo unix

Aggiungere Claude al tuo processo di verifica

Supponiamo che tu voglia utilizzare Claude Code come linter o revisore del codice. Aggiungere Claude al tuo script di build:

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
    }
}

Suggerimenti:

Usa Claude per la revisione automatica del codice nella tua pipeline CI/CD
Personalizza il prompt per verificare i problemi specifici rilevanti per il tuo progetto
Considera di creare più script per diversi tipi di verifica

Pipe in, pipe out

Supponiamo che tu voglia inviare dati a Claude e ottenere dati in un formato strutturato. Inviare dati attraverso Claude:

cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

Suggerimenti:

Usa i pipe per integrare Claude negli script shell esistenti
Combina con altri strumenti Unix per flussi di lavoro potenti
Considera di utilizzare —output-format per output strutturato

Controllare il formato di output

Supponiamo che tu abbia bisogno dell’output di Claude in un formato specifico, specialmente quando integri Claude Code in script o altri strumenti.

Utilizzare il formato testo (predefinito)

cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt

Questo restituisce solo la risposta di testo semplice di Claude (comportamento predefinito).

Utilizzare il formato JSON

cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json

Questo restituisce un array JSON di messaggi con metadati inclusi costo e durata.

Utilizzare il formato JSON in streaming

cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json

Questo restituisce una serie di oggetti JSON in tempo reale mentre Claude elabora la richiesta. Ogni messaggio è un oggetto JSON valido, ma l’intero output non è JSON valido se concatenato.

Suggerimenti:

Usa --output-format text per integrazioni semplici dove hai solo bisogno della risposta di Claude
Usa --output-format json quando hai bisogno del registro completo della conversazione
Usa --output-format stream-json per l’output in tempo reale di ogni turno di conversazione

Chiedere a Claude delle sue capacità

Claude ha accesso integrato alla sua documentazione e può rispondere a domande sulle sue stesse funzionalità e limitazioni.

Domande di esempio

can Claude Code create pull requests?

how does Claude Code handle permissions?

what skills are available?

how do I use MCP with Claude Code?

how do I configure Claude Code for Amazon Bedrock?

what are the limitations of Claude Code?

Claude fornisce risposte basate sulla documentazione a queste domande. Per esempi eseguibili e dimostrazioni pratiche, fai riferimento alle sezioni di flusso di lavoro specifiche sopra.

Suggerimenti:

Claude ha sempre accesso alla documentazione più recente di Claude Code, indipendentemente dalla versione che stai utilizzando
Fai domande specifiche per ottenere risposte dettagliate
Claude può spiegare funzionalità complesse come integrazione MCP, configurazioni aziendali e flussi di lavoro avanzati

Passaggi successivi

Best practices

Modelli per ottenere il massimo da Claude Code

Come funziona Claude Code

Comprendi il ciclo agentico e la gestione del contesto

Estendere Claude Code

Aggiungi skills, hooks, MCP, subagent e plugin

Implementazione di riferimento

Clona la nostra implementazione di riferimento del contenitore di sviluppo

Guida introduttiva

Concetti fondamentali

Usa Claude Code

Piattaforme e integrazioni

​Comprendere nuove basi di codice

​Ottenere una rapida panoramica della base di codice

​Trovare codice rilevante

​Correggere bug in modo efficiente

​Effettuare refactoring del codice

​Utilizzare subagent specializzati

​Utilizzare Plan Mode per l’analisi sicura del codice

​Quando utilizzare Plan Mode

​Come utilizzare Plan Mode

​Esempio: Pianificazione di un refactoring complesso

​Configurare Plan Mode come predefinito

​Lavorare con i test

​Creare pull request

​Gestire la documentazione

​Lavorare con le immagini

​Fare riferimento a file e directory

​Utilizzare il pensiero esteso (thinking mode)

​Configurare la modalità di pensiero

​Come funziona il pensiero esteso

​Riprendere conversazioni precedenti

​Denominare le tue sessioni

​Utilizzare il selettore di sessione

​Eseguire sessioni parallele di Claude Code con Git worktrees

​Worktree dei subagent

​Pulizia del worktree

​Gestire i worktree manualmente

​Controllo della versione non git

​Ricevere notifiche quando Claude ha bisogno della tua attenzione

​Utilizzare Claude come utilità di tipo unix

​Aggiungere Claude al tuo processo di verifica

​Pipe in, pipe out

​Controllare il formato di output

​Chiedere a Claude delle sue capacità

​Domande di esempio

​Passaggi successivi

Best practices

Come funziona Claude Code

Estendere Claude Code

Implementazione di riferimento

Comprendere nuove basi di codice

Ottenere una rapida panoramica della base di codice

Trovare codice rilevante

Correggere bug in modo efficiente

Effettuare refactoring del codice

Utilizzare subagent specializzati

Utilizzare Plan Mode per l’analisi sicura del codice

Quando utilizzare Plan Mode

Come utilizzare Plan Mode

Esempio: Pianificazione di un refactoring complesso

Configurare Plan Mode come predefinito

Lavorare con i test

Creare pull request

Gestire la documentazione

Lavorare con le immagini

Fare riferimento a file e directory

Utilizzare il pensiero esteso (thinking mode)

Configurare la modalità di pensiero

Come funziona il pensiero esteso

Riprendere conversazioni precedenti

Denominare le tue sessioni

Utilizzare il selettore di sessione

Eseguire sessioni parallele di Claude Code con Git worktrees

Worktree dei subagent

Pulizia del worktree

Gestire i worktree manualmente

Controllo della versione non git

Ricevere notifiche quando Claude ha bisogno della tua attenzione

Utilizzare Claude come utilità di tipo unix

Aggiungere Claude al tuo processo di verifica

Pipe in, pipe out

Controllare il formato di output

Chiedere a Claude delle sue capacità

Domande di esempio

Passaggi successivi