◆ Panatex S.p.A. · Guida interna

Claude Code
per il team commerciale

Un manuale pratico per chi gestisce clienti, ordini e operazioni nel tessile — senza dover sapere programmare.

per Riccardo · Giuliano
livello zero → operativo
settore tessile commerciale
← torna alla home formazione
capitolo 01

Cos'è Claude Code?

Claude Code è un assistente AI che si usa dal terminale del Mac — una finestra dove scrivi comandi in italiano normale, come in una chat. Ma a differenza di una chat, può agire davvero sul tuo computer: leggere file, creare documenti, connettersi a Gmail, Todoist, e molto altro.

In una frase

È come avere un assistente molto capace sul Mac: gli dai un compito in italiano, lui lo esegue — legge file, scrive documenti, cerca informazioni, manda email.

La differenza con claude.ai (la chat nel browser)

Claude.ai — chat nel browserClaude Code — terminale Mac
Risponde a domande, scrive testi✓ Fa tutto quello + agisce sul computer
Non può leggere i tuoi file✓ Legge file, cartelle, database aziendali
Non può creare documenti reali✓ Crea, modifica, sposta file
Non si connette a sistemi esterni✓ Si connette a Gmail, Todoist, Drive…
Devi rispiegare il contesto ogni volta✓ Ha memoria del tuo lavoro (con le Skill)

Come si installa — 4 passi una-tantum

1
Apri il Terminale sul Mac
Si trova in Applicazioni → Utility → Terminale. È la finestra nera con il cursore lampeggiante.
2
Installa Node.js (se non ce l'hai)
Vai su nodejs.org e scarica la versione LTS. Si installa come qualsiasi app, una volta sola.
3
Installa Claude Code
Nel terminale digita: npm install -g @anthropic-ai/claude-code e premi Invio.
4
Lancia Claude Code
Nella cartella di lavoro digita claude e premi Invio. Sei pronto.
Nota pratica

Se hai dubbi sull'installazione, chiedi a Iacopo — ci vogliono 5 minuti. Questa procedura si fa una volta sola, poi ogni giorno lanci Claude Code con un solo comando.

capitolo 02

Uso base: cosa puoi fare subito

Questi esempi funzionano subito, senza configurazioni speciali. Basta avere Claude Code aperto nella tua cartella di lavoro.

Scrivere email commerciali professionali

◆ esempio — comunicazione ritardo a cliente
Tu
Scrivi una email professionale a Roberto Marini di Tessuti Marini Srl. Dobbiamo comunicargli che il suo ordine di 500 metri di lino grezzo ref. LG-2204 è in ritardo di 10 giorni per problemi alla tintoria. Tono formale ma cordiale, offriamo uno sconto del 3% come compensazione.
Claude
Oggetto: Aggiornamento spedizione — ordine LG-2204

Gentile sig. Marini,

con riferimento al Suo ordine n. LG-2204 (500 mt. lino grezzo), ci teniamo a informarLa tempestivamente che, a causa di un imprevisto tecnico presso la nostra tintoria di riferimento, la consegna prevista subirà un ritardo stimato di 10 giorni lavorativi.

In segno di scuse per il disagio arrecato, applicheremo uno sconto del 3% sull'importo dell'ordine. Rimaniamo a Sua disposizione per concordare la nuova data di consegna.

Cordiali saluti,
Panatex S.p.A.
Tu
Bene. Aggiungi che possiamo anticipare 200 mt entro la data originale, e il resto entro i 10 giorni.
Claude
Modificato — ho inserito la consegna parziale: 200 mt alla data originale, 300 mt entro i 10 giorni aggiuntivi. Vuoi che salvi la bozza come file .docx?

Analizzare un listino prezzi o un file Excel

◆ esempio — analisi variazioni listino fornitori
Tu
Leggi il file listino_fornitori_2025.xlsx e dimmi: quali tessuti hanno avuto il maggiore aumento di prezzo rispetto al 2024? Voglio la top 5.
Claude
Ho letto il file. Top 5 per aumento 2024→2025:

1. Cachemire pettinato 140g — +18,2% (da €42 a €49,60)
2. Lino belga naturale — +14,7%
3. Cotone egiziano 200 fili — +11,3%
4. Tweed lana vergine — +9,8%
5. Seta grezza 12mm — +8,1%

Il driver principale è il costo delle materie prime naturali. Vuoi che prepari una slide di sintesi?

Strutturare gli appunti di una call commerciale

◆ esempio — note post-call cliente
Tu
Ho appena finito una call con Giacomelli SpA. Appunti: campionario A/I entro 15 maggio, interessati al bouclé melange colore corda, vogliono prezzi per 1000-3000 mt, decisore Luciana Ferretti. Richiamare martedì prossimo.
Claude
NOTE CALL — Giacomelli SpA
Contatto decisore: Luciana Ferretti

Richieste:
— Campionario A/I entro 15 maggio
— Interesse: Bouclé melange, colore corda
— Quantità da quotare: 1.000 / 2.000 / 3.000 mt

Azioni:
☐ Preparare offerta con 3 fasce di quantità
☐ Richiamare Luciana Ferretti — martedì prossimo

Vuoi che aggiunga un promemoria su Todoist?
Regola d'oro

Più contesto dai, meglio lavora. Invece di "scrivi una email al cliente", di' chi è il cliente, cosa vuoi comunicare, che tono usare. Con il contesto giusto il risultato è professionale al primo colpo.

capitolo 03

Ricerca e Obsidian

Obsidian è un'app per prendere note che salva tutto come semplici file di testo sul tuo Mac. Claude Code può leggere e scrivere in quelle note — diventando la tua memoria commerciale: ricorda ogni cliente, ogni call, ogni trattativa.

Perché usare Obsidian + Claude Code

Ogni nota cliente che scrivi in Obsidian diventa consultabile da Claude. Puoi chiedergli: "Cosa ha chiesto Giacomelli nell'ultimo anno?" e Claude legge tutte le note e ti risponde in pochi secondi.

Ricerca di mercato tessile su internet

◆ esempio — trend stagione A/I 2026
Tu
Cerca le tendenze colore e tessuto per la stagione A/I 2026. Voglio sapere cosa sarà dominante secondo Première Vision e Milano Unica.
Claude
Ho cercato i trend A/I 2026. Principali filoni:

Colori dominanti: Blu notte profondo, terra siena, verde muschio, bianco calce, vinaccia.
Texture: Bouclé strutturato, velluto a coste fine, lana boiled, effetti waxed.
Macro-trend: "Nuova artigianalità" — tessuti con aspetto lavorato a mano.

Vuoi che prepari un documento di sintesi da condividere con i clienti strategici?

Leggere la storia di un cliente da Obsidian

◆ esempio — brief pre-call da note Obsidian
Tu
Leggi tutte le note in Obsidian/Clienti/Giacomelli e dimmi: storia del rapporto commerciale, cosa hanno ordinato, richieste pendenti.
Claude
Ho letto 8 note su Giacomelli SpA (2023–2025):

Storico: Cliente dal 2021. Ordini A/I: lana vergine e tessuti strutturati. Volume medio annuo circa €85.000.
Preferenze: Qualità alta, lead time rispettati. Decisore: Luciana Ferretti.
Pendenti: Campionario A/I entro 15 maggio.
Nota: Nel 2024 ci fu un ritardo — gestito bene, da non ripetere.

Vuoi che prepari un brief per la call di martedì?

Aggiornare Obsidian dopo una call

◆ esempio — salvataggio automatico note cliente
Tu
Aggiungi una nota in Obsidian/Clienti/Giacomelli con le info della call di oggi: campionario A/I entro 15 maggio, bouclé corda, prezzi 1k-3k mt, richiamano martedì con Luciana Ferretti.
Claude
Ho creato la nota 2025-04-16 Call Giacomelli.md con data, contatto, richieste, prezzi da preparare e promemoria martedì. Collegata alla scheda cliente principale. Aggiungo anche il task su Todoist?
Il valore concreto

Smetti di cercare email vecchie o ricordare a memoria cosa ha chiesto un cliente 6 mesi fa. Chiedi a Claude — lui ha letto tutto, ricorda tutto, ti risponde con un brief pronto per la call.

capitolo 04

Le Skill: insegnare a Claude il tuo lavoro

Una Skill è un file di testo che spiega a Claude come svolgere un compito ricorrente — con il tuo stile, la tua terminologia, le tue regole. La scrivi una volta sola, poi la usi ogni giorno con un solo comando.

Analogia semplice

La Skill è il manuale operativo che consegni a un nuovo impiegato il primo giorno: "Nel nostro settore si fa così, usiamo questi termini, le offerte hanno questo formato." Dopo quel manuale, non devi più spiegare ogni volta da zero.

Dove si mettono le Skill

struttura cartelle sul Mac
# La tua cartella di lavoro Panatex ~/panatex/ ├── .claude/ │ └── commands/ # ← le Skill stanno qui │ ├── offerta.md # Skill per fare offerte │ ├── nota-cliente.md # Skill per note post-call │ └── report-sett.md # Skill per il report settimanale ├── clienti/ ├── offerte/ └── listini/

Esempio reale: Skill Offerta Commerciale Panatex

.claude/commands/offerta.mdskill
--- description: Prepara un'offerta commerciale Panatex per un cliente --- ## Contesto Panatex Siamo Panatex S.p.A., azienda tessile italiana, Monsummano Terme (PT). Produciamo tessuti per abbigliamento qualità medio-alta. Punto di forza: qualità costante, tempi rispettati, servizio consulenziale. ## Compito Crea un'offerta commerciale professionale per: $ARGUMENTS ## Formato offerta 1. Intestazione: Panatex S.p.A. — data — numero offerta 2. Destinatario con ragione sociale e indirizzo 3. Tabella: codice | descrizione | composizione | peso | disponibilità | prezzo/mt 4. Note: tempi consegna, campionature, pagamento 60gg DF 5. Validità offerta: 30 giorni ## Regole di stile - Tono professionale e caldo, mai freddo o burocratico - Menzionare sempre la disponibilità a inviare campioni - Quantità > 2.000 mt: proporre produzione su misura - Valuta Euro, IVA esclusa indicata esplicitamente ## Output Salva come offerta_[CLIENTE]_[DATA].docx in ~/panatex/offerte/

Come si usa nella pratica

◆ uso del comando /offerta
Tu
/offerta Cliente: Tessuti Rossi Srl, Milano. 800 mt flanella grigio medio a €18/mt e 400 mt tweed spigato tortora a €24/mt. Hanno già il campionario.
Claude
Offerta salvata come offerta_TessRossi_2025-04-16.docx.

Flanella 800 mt × €18 = €14.400 | Tweed 400 mt × €24 = €9.600 | Totale: €24.000 + IVA
Consegna: 3–4 settimane | Validità: 16 maggio 2025.

Ho incluso nota su campionature stagione successiva. Vuoi modificare qualcosa?

Altre Skill utili

📞
Skill: nota-cliente
uso: /nota-cliente [appunti call]
Trasforma gli appunti grezzi di una call in una nota strutturata su Obsidian: cliente, contatto, richieste, azioni da fare, data follow-up.
📈
Skill: report-clienti
uso: /report-clienti settimana
Legge le note della settimana in Obsidian e genera un riepilogo: clienti contattati, offerte aperte, ordini confermati, follow-up in sospeso.
🎨
Skill: scheda-tessuto
uso: /scheda-tessuto [codice articolo]
Legge dal database le specifiche tecniche di un articolo e genera una scheda commerciale pronta da inviare al cliente.
La potenza delle Skill

Una volta che la Skill è scritta — da Iacopo — tu non devi sapere niente di tecnico. Scrivi /offerta e descrivi cosa ti serve in italiano. Il formato professionale Panatex viene fuori automaticamente, ogni volta.

capitolo 05

Gli Agenti AI: il salto successivo

Le Skill sono istruzioni che tu lanci manualmente. Gli agenti invece lavorano da soli, in automatico, senza che tu faccia niente — partono all'ora programmata, fanno il loro lavoro, ti consegnano il risultato.

Definizione pratica

Un agente è un programma che riceve un obiettivo e decide autonomamente quali azioni fare per raggiungerlo — legge dati, li elabora, manda email, aggiorna file — e si ferma solo quando ha finito.

La differenza in un'analogia tessile

Skill — tu la lanciAgente — parte da solo
Come un catalogo: lo apri quando ti serveCome un agente di zona: lavora in autonomia e ti aggiorna
Tu avvii il comando, lui esegueParte automaticamente all'ora programmata
Un compito alla volta, su tua richiestaPiù compiti concatenati, senza supervisione
Risultato immediato in chatRisultato consegnato via email, file o notifica

Come funziona: il loop dell'agente

T
Ragiona (Thought)
L'AI analizza l'obiettivo e decide il primo passo: "Devo leggere gli ordini aperti di questa settimana."
A
Agisce (Action)
Esegue davvero l'azione: legge il file Excel, interroga il database, chiama un'API esterna.
O
Osserva (Observation)
Vede il risultato: "3 ordini in ritardo, 1 cliente non ha risposto alla nostra offerta."
✓
Consegna il risultato
Manda le email, aggiorna Obsidian, ti invia il riepilogo. Si ferma.

I 4 agenti più utili per il commerciale Panatex

📬
Agente Briefing Mattutino
automatico ogni mattina alle 7:45
Prima che arrivi in ufficio, l'agente ha già preparato la tua giornata.
Legge Gmail → email non lette da clienti nelle ultime 12 ore
Legge Todoist → follow-up da fare oggi, offerte in scadenza
Legge Obsidian → clienti da richiamare oggi
Genera e invia "Briefing commerciale [data]" nella tua inbox
⏰
Agente Monitor Offerte Scadute
automatico ogni lunedì mattina
Le offerte Panatex scadono a 30 giorni. L'agente monitora e prepara i solleciti.
Trova offerte inviate da più di 25 giorni senza risposta
Prepara email di sollecito personalizzata per ognuna
Ti manda le bozze per approvazione
Dopo approvazione invia e aggiorna stato in Obsidian
📊
Agente Report Commerciale Settimanale
automatico ogni venerdì pomeriggio
Genera il report della settimana pronto per la direzione — senza che tu scriva una riga.
Legge tutte le note Obsidian della settimana
Calcola: clienti contattati, offerte, ordini, valore totale
Genera Word "Report Commerciale Sett. [n]" e carica su Drive
Notifica a Iacopo con il link al documento
🔔
Agente Radar Tessile Settimanale
automatico ogni martedì
Cerca notizie rilevanti per il mercato tessile e ti aggiorna sulle opportunità.
Web → Première Vision, Milano Unica, trend stagionali
Web → notizie sui tuoi clienti e mercati principali
Web → variazioni prezzi materie prime (cotone, lana, lino)
Newsletter interna "Radar Tessile" al team

Skill o Agente: quando usare cosa?

SituazioneUsa SkillUsa Agente
Devo fare un'offerta adesso✓ /offerta—
Voglio il briefing ogni mattina—✓ Agente automatico
Appunti call → nota strutturata✓ /nota-cliente—
Monitor offerte scadute ogni lunedì—✓ Agente settimanale
Scheda tecnica per un articolo✓ /scheda-tessuto—
Report commerciale settimanale—✓ Agente venerdì
Come si attiva

Gli agenti li configura una volta Iacopo sul Mac Studio. Voi ricevete le email di briefing, i report, gli alert — senza fare nulla. L'unica cosa che cambia per voi è avere meno lavoro ripetitivo e più informazioni pronte ogni mattina.

Il messaggio finale

Claude Code non cambia il tuo lavoro — toglie le parti noiose. Le email di aggiornamento, i report, il recupero di informazioni da vecchie note, i solleciti: tutto in automatico. Tu rimani a fare ciò che conta: le relazioni, le trattative, le decisioni commerciali.