TL;DR
Il mese scorso ho condiviso con colleghi del prodotto e del business come iniziare con l'AI Coding. Insieme a un recente tweet su quanti studenti perdano strumenti di AI Coding di alto livello a causa di ostacoli di abbonamento, ho capito che metodi e abitudini si possono imparare prima gratuitamente. Ho organizzato qui la parte introduttiva. Per renderla più comprensibile, ho incluso diverse illustrazioni semplici per rendere i concetti più diretti.
Molte persone si bloccano al primo passo nell'uso di Claude Code: la riga di comando. Vedere un terminale con solo testo li fa pensare che sia solo per programmatori. In realtà, la soglia non è così alta. Chiunque sappia usare una chat AI come Doubao può iniziare con un po' di tempo; il resto è solo abituarsi a delegare l'esecuzione all'AI.
Una volta presa la mano, scoprirai che è come un assistente capace che si occupa di qualsiasi compito: eseguire backend dati, scrivere piccoli strumenti per risolvere i tuoi problemi, unire documenti disordinati in briefing, creare prototipi o organizzare report di vendita. Che tu sapessi scrivere codice prima non è la chiave. Una volta che scrivi consapevolmente il contesto del progetto in CLAUDE.md, rendi le tue richieste precise e pensi a creare "Skills" per impacchettare azioni ripetitive, hai essenzialmente varcato la soglia. Questo articolo è pensato per guidare studenti non tecnici nell'uso del mio strumento preferito, Claude Code.
Il Primo Ostacolo: La Riga di Comando
Gli studenti non programmatori sono abituati a chat AI come Doubao. La prima volta che installano Claude Code, sembra un po' strano. Prima era un processo di andata e ritorno: descrivi la necessità, genera codice, e lo copi-incolli altrove per testarlo. Ora Claude Code funziona direttamente nel terminale, saltando il passaggio di trasporto manuale.
Se non hai mai usato un terminale, ti consiglio Kaku, che ho creato appositamente per l'AI Coding. È pronto all'uso senza dover modificare colori o caratteri. Segue le modalità chiare/scure del sistema, usa Cmd + D per schermi divisi e Cmd + Shift + Y per il file manager. La cosa più importante per i principianti è che ha un'assistenza AI integrata: suggerisce correzioni per errori di comando e può generare comandi se scrivi # seguito da testo in italiano.
Installare Claude Code richiede un solo comando (vedi documentazione ufficiale), poi basta digitare claude nella cartella del progetto per iniziare a programmare.
curl -fsSL
| bash
Altamente Consigliato: Rinfresca le Conoscenze Tecniche
Per usare davvero bene Claude Code, descrivere le necessità non basta. Capire i concetti di base rende la risoluzione dei problemi molto più facile.
Sapere cosa fanno i framework comuni: Capire cosa risolvono React, Vue o Next.js ti aiuta a non sentirti perso quando guardi l'output di Claude Code.
Nozioni di base del software: Comandi del terminale, Git, VS Code e Chrome DevTools. Quando si verifica un errore, puoi aiutare a localizzarlo invece di aspettare e basta.
Idee fondamentali della programmazione: Cosa sono le funzioni, cosa sono variabili e stati, e perché il codice è suddiviso in più file. Questo rende le tue richieste più precise.
Impara a leggere codice ed errori: Questo è utile anche prima di saper scrivere codice. Dare un'occhiata a una modifica per vedere cosa fa è più veloce che chiedere una spiegazione. Niente panico per gli errori; copia tutto e chiedi "Cosa significa e come lo risolvo?" Nove volte su dieci, ti dirà esattamente quale riga è il problema.
Non devi arrivare al livello di scrivere codice da solo; basta sapere come appaiono queste cose. Passa una o due sere sulle sezioni introduttive di freeCodeCamp o MDN, o guarda un corso introduttivo come Crash Course Computer Science o Harvard CS50. Cambierà significativamente la tua efficienza di collaborazione.
Consiglio questi tre libri per una prospettiva più ampia: "Inspired" per il giudizio sul prodotto, "The Linux/Unix Design Philosophy" per la filosofia ingegneristica, e "Listening to the Wind" per la visione di un programmatore esperto.
Preparazione: Account e Abbonamenti
Account: Registrati su claude.ai usando Gmail. Usa un IP USA stabile per evitare attivazioni di controllo del rischio. Non passare direttamente a un abbonamento Max con un account nuovo per evitare blocchi.
Il modo più semplice è tramite l'App Store USA o Google Play. Abbònati a Pro nell'App Claude usando il tuo saldo. Nota che l'App Store ha tasse (un abbonamento da 100 unità potrebbe mostrarsi come 125), ma è più sicuro. Inizia con Pro e passa a Max se la quota non è sufficiente.
Per evitare blocchi: usa una rete stabile, non condividere account, usa metodi di pagamento affidabili (evita carte virtuali) e usa un account Gmail consolidato.
Quali Compiti Si Adattano a Claude Code?
Ho provato Cursor, Windsurf e Codex, ma Claude Code è il mio strumento quotidiano.
La sua capacità del modello è eccellente, e la sua implementazione del concetto di "Harness" è di alto livello. Scansiona CLAUDE.md e la struttura delle directory per capire il contesto, poi modifica file, esegue comandi, controlla errori e itera autonomamente. Poiché vive nel terminale, può chiamare direttamente git, test e script.
Claude Code è in realtà un Agente generico. I team interni di vendita e finanza di Anthropic lo usano per elaborare dati CRM ed email. Se odi il terminale, usa l'app desktop Cowork, che può leggere/scrivere le tue directory locali per fare cose come trasformare screenshot di ricevute in report di spesa.
Fondamentale: nella programmazione, la precisione è più importante della velocità. È meglio che impieghi 20 minuti e funzioni, piuttosto che 10 minuti e richieda 20 minuti di debug.
Compiti migliori: Prototipi e strumenti interni, elaborazione di CSV/report di vendita, riassunto di clausole contrattuali ed estrazione di informazioni da PDF/link.
Crea Software per Uno
Il columnist del NYT Kevin Roose ha proposto il concetto di software per uno: non hai bisogno di un'app per un milione di persone; puoi creare software solo per te stesso. Potrebbe essere uno strumento per trasformare note vocali in verbali di riunioni o un dashboard personale. Le persone del prodotto e del business sono le migliori in questo perché conoscono i propri punti dolenti.
Il Ritmo da 1 Giorno a 3 Mesi
Non cercare di costruire Notion il primo giorno. Segui questo ritmo:
Giorno 1: Modifica un file Excel o Markdown esistente. Settimana 1: Costruisci una homepage personale a pagina singola. Mese 1: Automatizza un compito settimanale ripetitivo. Mese 3: Costruisci uno strumento "software per uno".
Trasforma Azioni Web in Comandi con OpenCLI
Il personale operativo spesso passa tutto il giorno a cliccare nei browser. Questi compiti possono spesso bypassare l'interfaccia utente tramite API.
OpenCLI fornisce adattatori CLI per Xiaohongshu, X, Bilibili, ecc. Permette a Claude Code di eseguire azioni web come cliccare, inserire e fare scraping con un solo comando.
Ricerca Xiaohongshu: Fai usare a Claude Code OpenCLI per fare scraping dei dati e riassumere parole chiave calde.
Riepilogo del Sentiment: Combina adattatori per X, Reddit e HackerNews in un report giornaliero.
Claude Code ha anche una funzione Routines per automatizzare flussi di lavoro tramite Webhook o eventi GitHub.
CLAUDE.md: Definisci Prima il Contesto del Progetto
Molte persone si frustrano perché devono ripetere il contesto. La soluzione è un file CLAUDE.md nella directory principale.
Claude Code lo legge ogni volta che si avvia. Mantienilo sotto le 150 righe, usa un linguaggio imperativo e fornisci regole verificabili (es. "le funzioni devono essere sotto le 50 righe").
Regole chiave: Chiedi prima di agire, dai priorità alla semplicità, tocca solo ciò che è necessario e verifica dopo il completamento.
Richieste Precise Prevengono Deviazioni
Vago: Aiutami a creare uno strumento di follow-up clienti.
Preciso: Aiutami a creare uno strumento di follow-up vendite come pagina web locale a file singolo. La lista a sinistra mostra nome azienda, prossimo follow-up e stato. La parte destra mostra i dettagli. Aggiungi tre filtri in alto. Memorizza i dati in localStorage.
Richieste precise ottengono una versione funzionante il primo giorno. Anche se non conosci i dettagli del codice, devi descrivere le richieste in modo specifico.
Definisci l'ambito: dichiara esplicitamente cosa non fare (es. "nessun login, nessun SEO per ora"). Fornisci criteri di accettazione numerici (es. "la prima schermata si carica in 1,5s").
Modalità Plan e Auto
Per compiti complessi, usa la modalità Plan (Shift+Tab). Elenca cosa intende fare prima di eseguire. Se ti senti a tuo agio, usa la modalità Auto, che esegue automaticamente operazioni sicure e chiede solo il permesso per quelle rischiose (come eliminare file).
Come Confermare che è Corretto
Non prendere la sua parola per buona.
Snapshot Git: Esegui git status prima di grandi modifiche e fai commit dei checkpoint. Usa /rewind per annullare le modifiche.
Evita il Ciclo "Prova e Vedi": Non lasciare che applichi patch al codice senza una diagnosi. Chiedi "Quale riga è il problema e perché?" prima di permettere modifiche.
Suggerimenti Avanzati Max: Alias, Modelli e Sessioni Lunghe
Alias: Uso alias c='CLAUDE_CODE_AUTO_COMPACT_WINDOW=400000 claude --dangerously-skip-permissions' per saltare le conferme e ritardare la compressione del contesto.
Modelli: Usa /model opusplan per far gestire la pianificazione a Opus e l'esecuzione a Sonnet.
Sessioni Lunghe: Usa /clear dopo aver completato un compito. Chiedi un HANDOFF.md prima di terminare un compito lungo in modo da poter riprendere in una sessione nuova.
Waza: Trasformare Abitudini in Memoria Muscolare
Ho creato Waza, un set di 8 skill che rappresentano buone abitudini ingegneristiche.
/think per la pianificazione, /design per il design UI, /hunt per la risoluzione dei problemi e /check per le revisioni finali.
Crea le Tue Skill
Le Skill sono cartelle in .claude/skills/ con un SKILL.md. Possono essere basate su flussi di lavoro (es. riassumere riunioni), su checklist (es. controlli pre-lancio) o su esperti (es. matrici di risoluzione problemi).
Kami e Claude Design
Kami è uno strumento di layout AI per trasformare contenuti in PDF professionali. Claude Design ti permette di creare prototipi interattivi da screenshot o documenti senza scrivere codice.
Considerazioni sulla Sicurezza
Fagli spiegare i comandi prima di eseguirli. Non usare mai ambienti di produzione per fare pratica. Non incollare chiavi API direttamente nella chat; usa file .env. Per funzionalità sensibili come i pagamenti, usa servizi consolidati come Stripe invece di scrivere da zero.
