Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Questa pagina raccoglie brevi ricette per lo sviluppo quotidiano. Per una guida di livello superiore sulla formulazione di prompt e la gestione del contesto, vedi Best practices. Questa pagina copre:

​
Ricette di prompt

Questi sono modelli di prompt per compiti quotidiani come esplorare codice non familiare, eseguire il debug, effettuare refactoring, scrivere test e creare PR. Ognuno funziona su qualsiasi superficie di Claude Code; adatta la formulazione al tuo progetto.

​
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.
1

Navigare alla directory radice del progetto

cd /path/to/project
2

Avviare Claude Code

claude
3

Chiedere una panoramica di alto livello

give me an overview of this codebase
4

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.
1

Chiedere a Claude di trovare file rilevanti

find the files that handle user authentication
2

Ottenere contesto su come i componenti interagiscono

how do these authentication files work together?
3

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.
1

Condividere l'errore con Claude

I'm seeing an error when I run npm test
2

Chiedere raccomandazioni per la correzione

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

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.
1

Identificare il codice legacy per il refactoring

find deprecated API usage in our codebase
2

Ottenere raccomandazioni per il refactoring

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

Applicare le modifiche in modo sicuro

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

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

​
Lavorare con i test

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

Identificare il codice non testato

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

Generare lo scaffolding dei test

add tests for the notification service
3

Aggiungere casi di test significativi

add test cases for edge conditions in the notification service
4

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:
1

Riassumere le tue modifiche

summarize the changes I've made to the authentication module
2

Generare una pull request

create a pr
3

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. Per tornare a essa in seguito, esegui claude --from-pr <number> o incolla l’URL della PR nel selettore /resume.
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.
1

Identificare il codice non documentato

find functions without proper JSDoc comments in the auth module
2

Generare la documentazione

add JSDoc comments to the undocumented functions in auth.js
3

Rivedere e migliorare

improve the generated documentation with more context and examples
4

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 in note e cartelle non di codice

Claude Code funziona in qualsiasi directory. Eseguilo all’interno di un vault di note, una cartella di documentazione o qualsiasi raccolta di file markdown per cercare, modificare e riorganizzare il contenuto nello stesso modo in cui faresti con il codice. La directory .claude/ e CLAUDE.md si trovano insieme alle directory di configurazione di altri strumenti senza conflitti. Claude legge i file freschi ad ogni chiamata dello strumento, quindi vede le modifiche che fai in un’altra applicazione la prossima volta che legge quel file.

​
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.
1

Aggiungere un'immagine alla conversazione

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

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?
3

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?
4

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.
1

Fare riferimento a un singolo file

Explain the logic in @src/utils/auth.js
Questo include il contenuto completo del file nella conversazione.
2

Fare riferimento a una directory

What's the structure of @src/components?
Questo fornisce un elenco di directory con informazioni sui file.
3

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”)

​
Eseguire Claude su una pianificazione

Supponiamo che tu voglia che Claude gestisca un’attività automaticamente su base ricorrente, come rivedere le PR aperte ogni mattina, controllare le dipendenze settimanalmente o verificare i fallimenti di CI durante la notte. Scegli un’opzione di pianificazione in base a dove desideri che l’attività venga eseguita:
OpzioneDove viene eseguitaMigliore per
RoutinesInfrastruttura gestita da AnthropicAttività che dovrebbero essere eseguite anche quando il tuo computer è spento. Possono anche attivarsi su chiamate API o eventi GitHub oltre a una pianificazione. Configura su claude.ai/code/routines.
Attività pianificate desktopLa tua macchina, tramite l’app desktopAttività che hanno bisogno di accesso diretto a file locali, strumenti o modifiche non sottoposte a commit.
GitHub ActionsLa tua pipeline CIAttività legate a eventi del repository come PR aperte, o pianificazioni cron che dovrebbero vivere insieme alla tua configurazione del flusso di lavoro.
/loopLa sessione CLI correntePolling rapido mentre una sessione è aperta. Le attività si fermano quando inizi una nuova conversazione; --resume e --continue ripristinano quelle non scadute.
Quando scrivi prompt per attività pianificate, sii esplicito su cosa significhi il successo e cosa fare con i risultati. L’attività viene eseguita autonomamente, quindi non può fare domande di chiarimento. Ad esempio: “Review open PRs labeled needs-review, leave inline comments on any issues, and post a summary in the #eng-reviews Slack channel.”

​
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 dimostrazioni pratiche, esegui /powerup per lezioni interattive con demo animate, o 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

​
Riprendere conversazioni precedenti

Quando un’attività dura più sessioni, riprendi da dove hai lasciato invece di rispiegare il contesto. Claude Code salva ogni conversazione localmente. 
claude --continue
Questo riprende la sessione più recente nella directory corrente; se non ce n’è ancora una, stampa No conversation found to continue ed esce. Usa claude --resume per scegliere da un elenco, o /resume da una sessione in esecuzione. Vedi Gestire le sessioni per denominazione, branching e il riferimento completo del selettore.

​
Eseguire sessioni parallele con worktrees

Lavora su una funzionalità in un terminale mentre Claude corregge un bug in un altro, senza che le modifiche si scontrino. Ogni worktree è un checkout separato sul suo ramo. 
claude --worktree feature-auth
Esegui lo stesso comando con un nome diverso in un secondo terminale per avviare una sessione parallela isolata. Vedi Worktrees per pulizia, .worktreeinclude e supporto VCS non-git. Per monitorare sessioni parallele da uno schermo invece di terminali separati, vedi agenti in background.

​
Pianificare prima di modificare

Per le modifiche che desideri rivedere prima che tocchino il disco, passa a plan mode. Claude legge i file e propone un piano ma non apporta modifiche finché non approvi. 
claude --permission-mode plan
Puoi anche premere Shift+Tab durante una sessione per attivare/disattivare plan mode. Vedi Plan mode per il flusso di approvazione e la modifica del piano nell’editor di testo.

​
Delegare la ricerca ai subagent

Esplorare una base di codice grande riempie il tuo contesto con letture di file. Delega l’esplorazione in modo che solo i risultati tornino indietro. 
use a subagent to investigate how our auth system handles token refresh
Il subagent legge i file nel suo proprio contesto e segnala un riassunto. Vedi Subagent per definire agenti personalizzati con i loro strumenti e prompt.

​
Inviare Claude negli script

Esegui Claude in modo non interattivo per CI, hook pre-commit o elaborazione batch. Stdin e stdout funzionano come qualsiasi strumento Unix. 
git log --oneline -20 | claude -p "summarize these recent commits"
Vedi Modalità non interattiva per formati di output, flag di autorizzazione e modelli fan-out.

​
Passaggi successivi

Best practices

Modelli per ottenere il massimo da Claude Code

Gestire le sessioni

Riprendere, denominare e dirammare conversazioni

Worktrees

Eseguire sessioni parallele isolate

Estendere Claude Code

Aggiungere skills, hooks, MCP, subagent e plugin