Home / Glossary / CLAUDE.md

Definition

CLAUDE.md

CLAUDE.md è un file di configurazione markdown posizionato nella root del tuo progetto che fornisce a Claude Code istruzioni persistenti e specifiche del progetto. Indica all'agente le tue convenzioni di codice, architettura, comandi comuni e regole—agendo come una forma di memoria a lungo termine che si applica a ogni sessione in quel progetto.

Come funziona CLAUDE.md

Quando Claude Code avvia una sessione, legge automaticamente il file CLAUDE.md nella root del tuo progetto (e qualsiasi file CLAUDE.md nelle directory genitori o sottodirectory). I contenuti diventano parte del contesto di sistema dell'agente, così segue le tue istruzioni senza dover essere ricordato a ogni sessione. Questo rende il comportamento dell'agente coerente con le convenzioni del tuo team.

Cosa includere in CLAUDE.md

  • +Panoramica dell'architettura del progetto e posizioni dei file chiave
  • +Convenzioni di codice (naming, formattazione, pattern da usare o evitare)
  • +Comandi comuni per testing, build e deployment
  • +Regole come "scrivi sempre test per le nuove funzioni" o "non modificare mai il modulo auth direttamente"
  • +Dettagli sullo stack tecnologico di cui l'agente dovrebbe essere consapevole
markdown
# CLAUDE.md

## Project
Next.js 14 app with App Router, TypeScript, Tailwind CSS.

## Commands
- `npm run dev` — start dev server
- `npm test` — run Jest tests
- `npm run lint` — ESLint check

## Conventions
- Use server components by default
- Client components go in `components/client/`
- All API routes must validate input with Zod
- Write tests for every new utility function

## Do NOT
- Modify files in `lib/core/` without explicit approval
- Use `any` type in TypeScript
- Add new dependencies without justification

Mantieni CLAUDE.md conciso. L'agente lo legge a ogni sessione, quindi includi solo informazioni rilevanti per più task. Sposta i dettagli specifici del task nei tuoi prompt.

Dove devo posizionare il file CLAUDE.md?+
Posizionalo nella root della directory del tuo progetto. Claude Code supporta anche file CLAUDE.md nelle sottodirectory per istruzioni specifiche del modulo, e nelle directory genitori per regole a livello di organizzazione. Tutti i file applicabili vengono uniti insieme.
CLAUDE.md funziona con altri strumenti AI?+
CLAUDE.md è specifico per Claude Code. Tuttavia, alcuni altri strumenti hanno adottato concetti simili. Cursor usa .cursorrules e altri agenti possono leggere file di configurazione personalizzati. Il concetto di istruzioni AI a livello di progetto sta diventando un pattern comune.
Quanto dovrebbe essere lungo CLAUDE.md?+
Mantienilo sotto le 500 righe. Concentrati sulle convenzioni e regole più importanti. L'agente può sempre leggere singoli file per i dettagli—CLAUDE.md dovrebbe fornire il contesto di alto livello che si applica tra i task.

Related terms

Coding AgenticoClaude CodePrompt Engineering per il Codice

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS