Recentemente, molti amici mi hanno chiesto se potessi pubblicare un tutorial per principianti su Claude Code.
Vogliono anche loro usare il prodotto Agent più potente del mondo.
In realtà, molti non si rendono conto che i prodotti Agent sono generalmente composti da un framework Agent e un modello. I modelli di Claude sono spesso bloccati in Cina e sono molto difficili da gestire; non ho modo di insegnare a tutti come risolvere questo problema.
Ma Claude Code non verrà bloccato o reso inutilizzabile perché in realtà è un framework Agent che può essere utilizzato con qualsiasi modello.
Anche se Anthropic può essere piuttosto fastidiosa con continui ban degli account e autenticazione tramite documento, devo comunque ammettere che il miglior framework Agent al mondo in questo momento è Claude Code.
Ecco perché dico sempre: se puoi fare tutto in un colpo solo, fallo. So che OpenClaw e Hermes Agent sono molto popolari ora, ma consiglio comunque di usare Claude Code. Anche se non puoi usare i modelli nativi di Claude, abbinarlo a un modello nazionale dà comunque risultati eccellenti.
Inoltre, non devi preoccuparti di ban degli account, numeri di telefono esteri, carte Visa o nemmeno di usare una VPN.
Quindi oggi, ecco un tutorial completo per principianti su Claude Code, partendo da zero. Ho preparato istruzioni per Windows e Mac, con e senza VPN, così ognuno può seguire la parte che gli serve.
Il processo di installazione che segue è stato testato su cinque o sei computer per un intero fine settimana da me e dal mio team, attraverso installazioni e disinstallazioni ripetute.
Ad esempio, negli scenari senza VPN, ci sono altri metodi di installazione come npm o l'uso di mirror nazionali tramite curl. Questi metodi funzionano, ma nei miei test non erano abbastanza stabili su computer diversi.
Quindi, alla fine, ho scelto il metodo che ritengo essere il più semplice e con meno probabilità di fallire, anche su un computer molto "pulito".
Spero solo che tutti possano usare con successo il framework Agent più potente del mondo seguendo questo articolo.
Spiegherò ogni passaggio nel modo più chiaro e dettagliato possibile. Potrebbe essere un po' prolisso, quindi per favore abbiate pazienza.
Bene, iniziamo.
I. Installazione di Claude Code
1. Mac
Diamo prima un'occhiata al Mac. Gli utenti Windows possono saltare questa parte e trovare il tutorial per Windows più sotto.
Per prima cosa, trova il Terminale nelle tue App e aprilo.
Installiamo il protagonista di oggi, Claude Code.
Ho creato un account macOS nuovo di zecca per il mio computer, che è praticamente equivalente a un computer pulito, per questa dimostrazione.
Prima, parliamo del caso con una VPN.
Il comando è solo una riga:
Incolla questo comando nel terminale e premi Invio.
Aspetta un momento e vedrai un'installazione riuscita.
Anche se è installato, potrebbe darti un prompt qui.
Significa che Claude Code è installato, ma la posizione di installazione ~/.local/bin non è stata aggiunta alla variabile d'ambiente PATH, quindi digitare claude direttamente potrebbe non trovare il comando.
Dice che per risolvere, esegui il comando fornito qui sotto.
Se non capisci, va bene. Fai come dice: copia quel lungo comando echo che ti ha dato nel terminale ed eseguilo.
Poi digita claude --version. Se viene visualizzato un numero di versione, l'installazione è riuscita.
La situazione con una VPN è molto semplice, ma so che molti studenti non ne hanno una.
Quindi, se non hai una VPN, possiamo installarlo tramite Homebrew.
Homebrew è il gestore di pacchetti da riga di comando più popolare su macOS. Ti permette di installare, aggiornare e disinstallare vari software e strumenti di sviluppo con un solo comando.
Ho preso in prestito un computer nuovo da un collega; non ha VPN e un ambiente molto pulito.
Installiamo prima brew. Potrebbe sembrare complicato, ma in realtà è molto semplice se segui le istruzioni.
Incolla il seguente comando nella riga di comando e premi Invio:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.shhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))"
Dopo il prompt, premi semplicemente Invio.
Poi verrà eseguito per un po'.
Aspetta pazientemente qualche minuto. Quando finisce e dice che l'installazione è riuscita, hai finito.
Successivamente, dobbiamo aggiungere Homebrew alle variabili di percorso in modo che il terminale possa trovare il comando quando lo usiamo.
Incolla queste poche righe di comandi nel terminale ed eseguile una volta.
Ora possiamo usare Homebrew per gestire i pacchetti Mac.
Successivamente, usa il seguente comando per installare Claude Code. Poiché l'editor potrebbe formattare automaticamente del testo, un copia-incolla diretto potrebbe causare errori. Per favore, digitarlo manualmente o chiedere a Claude di correggere la formattazione prima di incollarlo nel terminale:
brew install --cask claude-code@latest
La velocità di installazione qui è un po' lenta; puoi fare una pausa e tornare quando è finito.
Una volta apparso il messaggio di successo, digita claude nel terminale e vedrai il piccolo granchio.
Tuttavia, mostrerà che per ora è inutilizzabile. Puoi ignorarlo; ti insegnerò come collegare un modello tra un momento.
Ora che abbiamo coperto il Mac, parliamo di Windows separatamente. È leggermente diverso. Gli utenti Mac che hanno finito possono saltare questa parte.
2. Windows
Ora per Windows.
Ho usato un computer Windows appena formattato per installarlo.
Poiché Claude Code esegue comandi internamente usando Git Bash su Windows, devi installare Git prima di poter usare Claude Code su Windows.
Quindi, passo uno: installa Git.
Gli amici che lo hanno già installato possono saltare questo passaggio.
Usa WinGet per installarlo. Questo è il gestore di pacchetti ufficiale di Windows, che può essere considerato la versione Windows di Homebrew.
Cerca "Terminale" nella barra delle applicazioni e aprilo.
Incolla il seguente comando nel terminale. L'installazione sarà molto più veloce se non usi una VPN qui.
winget install Git.Git
Una volta terminato, mostrerà un'installazione riuscita.
Una volta installato Git, come al solito, parliamo del caso con una VPN.
Per gli amici con una VPN, usiamo ancora il comando di installazione nativo ufficiale.
Incolla il comando nel terminale:
Aspetta un momento e verrà installato.
Molto comodo.
Se non hai una VPN, dobbiamo usare WinGet per installarlo.
Esegui questo comando nel terminale:
winget install Anthropic.ClaudeCode
Dopo che è stato installato con successo, puoi anche digitare claude per vedere che è stato installato.
A questo punto, teoricamente, digitare claude nel terminale dovrebbe portarti alla pagina di Claude Code.
Ma.
Abbiamo solo installato il framework; non gli abbiamo ancora dato un "cervello", quindi non è utilizzabile.
Successivamente, dobbiamo collegare il suo cervello.
II. Collegamento del Modello
Se hai un account Claude, accedi direttamente. Non entrerò nei dettagli qui.
Perché teoricamente, se hai già un account Claude, non staresti leggendo questo tutorial per principianti...
Quindi, per garantire che tutti gli amici nazionali possano usarlo, userò il modello nazionale GLM-5.1 come esempio.
GLM-5.1 è attualmente il modello nazionale che ho usato e che si avvicina di più all'esperienza di Claude Opus 4.6.
Naturalmente, se non hai seguito il loro piano di codifica, anche MiniMax M2.7 e K2.5 sono buoni. Il codice K2.6 dovrebbe uscire presto, e sento che Kimi farà un balzo in avanti; consiglio di tenerlo d'occhio.
Per quanto riguarda GLM-5.1, Zhipu fornisce ufficialmente un comando di una riga per installarlo, che è molto semplice:
Tuttavia, per rendere più facile per tutti collegare altri modelli e cambiare liberamente, ti insegnerò un metodo più universale: usare CC Switch.
Ancora una volta, diviso in Mac e Windows.
1. Mac
Su Mac, l'installazione è composta da due comandi. Anche il secondo comando potrebbe dare errore se copiato e incollato direttamente a causa della formattazione. Per favore, digitarlo manualmente o chiedere a Claude di correggere la formattazione prima di incollare:
brew tap farion1231/ccswitch
brew install --cask cc-switch
Incolla nel terminale e premi Invio.
Una volta installato, sei a posto.
2. Windows
Per Windows, consiglio di scaricare il pacchetto di installazione direttamente dal link qui sotto:
https://github.com/farion1231/cc-switch/releases
Se non riesci ad accedere a GitHub, ho preparato anche un pacchetto di installazione locale. Rispondi con "cc" nel background dell'account ufficiale e ti invierà automaticamente il link per il download.
Dopo il download, fai doppio clic per eseguire e puoi fare clic su "Avanti" fino a completare l'installazione.
Le operazioni successive sono le stesse per Mac e Windows, quindi non le separerò.
Dopo l'installazione, aprilo.
Puoi vedere che questo strumento non è solo per Claude Code; anche Codex e Xiaolongxia possono usarlo.
Poiché non l'abbiamo ancora configurato, al momento ci sono solo le configurazioni ufficiali del modello Claude.
Sotto la colonna Claude, fai clic sul segno più nell'angolo in alto a destra per aggiungere una nuova configurazione del modello.
Quindi seleziona il modello che vuoi usare. Qui ho scelto la versione nazionale GLM.
Successivamente, devi solo compilare due parti: la chiave API (se non sai cos'è una chiave API, puoi chiedere a qualsiasi AI a cui hai accesso e ti aiuteranno) e la configurazione del modello. Tutto il resto verrà compilato automaticamente.
Dopo averlo compilato, fai clic su "Aggiungi" nell'angolo in basso a destra.
Passerà al modello che abbiamo configurato.
A questo punto, l'installazione di Claude Code e la connessione di GLM-5.1 sono complete.
III. Avvio di Claude Code
Torna al terminale, digita claude e premi Invio.
Ora puoi avviare Claude Code normalmente.
Al primo utilizzo, ci saranno alcune impostazioni di inizializzazione.
Ad esempio, la modalità colore. C'è un'anteprima del codice sotto le modalità; scegli in base alle tue preferenze e premi Invio.
Se vuoi cambiarlo in seguito, esegui /theme all'interno di Claude Code.
Successivamente, il prompt di sicurezza.
Due punti principali:
Uno è che Claude può commettere errori. Dovresti rivedere il codice che genera e i comandi che vuole eseguire prima di lasciarli passare.
Uno è di usare Claude Code solo in codebase di cui ti fidi per evitare attacchi di injection del prompt.
Premi Invio per passare al passaggio successivo.
Chiede se vogliamo usare le impostazioni del terminale di Claude Code.
Qui, usa semplicemente le impostazioni del terminale consigliate.
In realtà, vuole aiutarti ad abilitare due cose:
Tasti di scelta rapida per ottenere interruzioni di riga nel terminale.
L'altro è Visual Bell, un prompt visivo.
Cioè, quando Claude finisce un'attività o ha bisogno della tua conferma, la finestra del terminale lampeggerà e l'icona del Dock rimbalzerà per ricordartelo.
Il passaggio finale è confermare se la directory corrente è attendibile.
Seleziona "Sì" e premi Invio.
Siamo finalmente arrivati all'interfaccia di dialogo di Claude Code collegato a GLM-5.1.
Se vuoi cambiare modello in seguito, configurali in CC Switch e usa /model in Claude Code per cambiare.
A questo punto, tutte le operazioni di installazione e connessione sono complete.
Per un uso futuro, digita semplicemente claude nel terminale.
Consiglio di usare il seguente comando, specialmente durante lo sviluppo, altrimenti fare clic su "Consenti" ripetutamente ti farà mettere in discussione le tue scelte di vita:
claude --dangerously-skip-permissions
Quando lo avviamo, a causa del design del contesto, dobbiamo avviarlo in una cartella per mantenerlo vincolato e concentrato, invece di avviare Claude Code direttamente nella directory principale.
Ho diviso le mie directory; "Documenti" è dove faccio creazione di conoscenza.
C'è anche una cartella "codice", che contiene vari prodotti che ho sviluppato io stesso.
Avviare Claude Code per una cartella specifica nella riga di comando è anche molto semplice.
È il comando cd, che è lo stesso per Mac e Windows.
Ad esempio, se voglio entrare nella cartella "Base di Conoscenza" per creare contenuti:
Apri il terminale, digita cd, poi ricordati di premere la barra spaziatrice una volta, e poi trascina la tua cartella direttamente al suo interno.
Premi Invio e sei entrato in quella cartella.
Quindi usa il comando per avviare Claude Code.
Entrerai in quella cartella e funzionerà solo all'interno di quella cartella per impostazione predefinita, leggendo tutti i file al suo interno.
Questo in realtà si traduce in meno inquinamento del contesto e più concentrazione—in altre parole, è più intelligente.
IV. Scrivere CLAUDE.md
Dopo aver imparato come avviarlo, puoi iniziare ufficialmente il dialogo e farlo funzionare.
Ma c'è uno standard e un'abitudine molto importante che devi impostare prima di un uso approfondito. Non cadere nelle vecchie trappole in cui sono caduto io: definisci prima il tuo file CLAUDE.md.
Secondo me, questa è addirittura la prima cosa che dovresti fare dopo aver imparato come avviare Claude Code.
Prima di entrare nello stile di scrittura specifico, lascia che ti parli di cos'è CLAUDE.md.
Questa cosa non è solo un file; è un sistema di vincoli gerarchico dall'alto verso il basso.
Come questa immagine che ho usato prima.
Dopo l'installazione, i due livelli che dovremmo gestire sono il CLAUDE.md globale e il CLAUDE.md del progetto.
Il CLAUDE.md globale è posizionato nella directory principale di Claude Code nella home dell'utente: ~/.claude/CLAUDE.md.
Finché apri Claude Code, indipendentemente dal progetto in cui entri, verrà caricato e seguito automaticamente.
Questa è la sua specifica di primo livello.
Risolve problemi come chi sei, i tuoi principi di fare le cose e come vuoi che collabori con te.
Il CLAUDE.md a livello di progetto è posizionato nella directory principale di ogni progetto: project_directory/CLAUDE.md.
Viene caricato solo quando apri quel progetto.
Risolve il problema di come dovrebbe essere fatto questo progetto specifico e quali accordi speciali esistono a questo livello.
Parliamo prima del CLAUDE.md globale, che è la prima cosa che deve essere sistemata. Ma molti non hanno chiaro cosa scrivere, come scriverlo, quanto dovrebbe essere lungo o dove metterlo. Per i non sviluppatori, condividerò la mia esperienza.
Per quanto riguarda la lunghezza, CLAUDE.md non è meglio se è più lungo; invece, dovrebbe essere il più conciso possibile.
Se il tuo CLAUDE.md è troppo lungo, ignorerà semplicemente il contenuto nella seconda metà.
La linea rossa specifica è questa: oltre 80 righe, Claude inizia a perdere parte del contenuto. Al massimo, non superare mai le 200 righe.
In un articolo precedente, ti ho mostrato cosa c'è nel mio file CLAUDE.md globale.
Basandomi sul mio contenuto, ho iterato e preparato un modello per te.
Contiene cose che penso dovrebbe avere un buon CLAUDE.md globale.
Devi solo scrivere il tuo contenuto nella sezione "Chi sono"; il resto può essere fondamentalmente riutilizzato direttamente.
Chi sono [Il tuo nome / identità / background professionale, se non sei un programmatore, devi dichiararlo]. Uso Claude Code per [Uso Specifico 1] e [Uso Specifico 2].
Principi di Pensiero: Tutte le decisioni partono dall'essenza del problema, non copiare solo perché "questa è la convenzione". Torna al problema stesso: Cosa deve essere risolto? Qual è il percorso più diretto? Come sarebbe progettato da zero? Non adulare. Non lodare le mie idee, non dire "questa è un'ottima domanda", non aggiungere "naturalmente" all'inizio. Dammi giudizi reali; se c'è un problema con il piano, segnalalo direttamente. Se trovi un modo migliore, dillo direttamente senza aspettare che te lo chieda.
Vincoli Prima di Tutto: Che si tratti di un progetto di sviluppo o di un progetto di gestione della conoscenza, il primo passo è sempre stabilire le regole: scrivere CLAUDE.md per i nuovi progetti prima di tutto, e definire le convenzioni strutturali per le nuove directory (cosa va dove, come nominare, quando pulire). Non lavorare in uno spazio di lavoro senza specifiche. Per i progetti con specifiche esistenti, attenersi rigorosamente agli accordi nel loro CLAUDE.md. Quando si modificano le specifiche, cambiare prima il documento, poi la pratica, non il contrario.
Stile di Comunicazione - Predefinito in Italiano, usa l'inglese per codice, comandi e nomi di variabili - Conclusione prima, poi ragioni, non preparare il terreno con il background - Incontrando requisiti vaghi, dai prima il piano più ragionevole, poi chiedi se sono necessarie modifiche - Non chiedere "sei sicuro di volerlo fare" a meno che non si tocchino le linee rosse qui sotto
Confini Autonomi (Linee rosse, devi chiedermi prima) Le seguenti operazioni devono fermarsi e chiedermi anche in modalità di accettazione automatica: - Eliminare file, directory o cronologia git - Modificare .env, chiavi, token, configurazioni CI/CD - Modifiche allo schema del database o migrazioni di dati - git push, git rebase, git reset --hard, force push - Installare nuove dipendenze globali o modificare le configurazioni di sistema - Rilascio pubblico (npm publish, deploy in produzione, pubblicare articoli, ecc.)
Disciplina Generale di Ingegneria - Eseguire attivamente la verifica dopo le modifiche (vedere il CLAUDE.md di ogni progetto per i comandi specifici), non solo modificare senza verificare - Non commentare gli errori o aggiungere marcatori di bypass solo per far funzionare il codice; trovare la causa principale - Chiavi, token e password non entrano nel codice, nei commit o nei log - Prima di modifiche importanti, fornire un piano in Plan Mode; procedere solo dopo la mia conferma
Un totale di circa 30 righe, divise in sei parti.
Questi sei blocchi hanno una caratteristica comune: sono universali tra i progetti.
Una volta impostato il CLAUDE.md globale, abbiamo le nostre specifiche di primo livello.
Per quanto riguarda il livello successivo, il CLAUDE.md del progetto.
Prendi me come esempio.
Uso principalmente Claude Code per lo sviluppo e la gestione della conoscenza.
Ad esempio, c'è un CLAUDE.md nella mia directory code/my. Il suo ruolo è principalmente perché le cose che codifico spesso nella cartella my sono spesso cose usa e getta o sperimentali disordinate, che in realtà sono molto piccole, quindi sono davvero troppo pigro per creare una nuova cartella sotto my ogni volta.
Quindi la mia pratica comune attuale è di usare cd direttamente nella cartella my per avviare, e poi iniziare felicemente a esporre i miei requisiti per aiutarmi a codificare. Con questo file CLAUDE.md, giudicherà da solo se questo è un nuovo prodotto. Se lo è, mi aiuterà direttamente a creare una nuova cartella per iniziare, quindi l'intera gestione dei file diventa organizzata.
E non devi nemmeno scrivere questo file da solo. Basta aprire quella cartella e chattare con Claude Code. Discuti direttamente i tuoi requisiti e le cose a cui tieni con esso, e lascia che te ne scriva uno.
Ho anche lavorato sodo con il mio Claude Code in questi giorni per stabilire varie specifiche e organizzare le varie "montagne di merda" di codice che ho lasciato prima.
Se non hai niente sul tuo computer in questo momento, è ancora più comodo.
Questo è uno dei motivi per cui ho sempre enfatizzato i vincoli prima di tutto e le specifiche prima di tutto.
Una volta impostati i vincoli, puoi davvero iniziare a giocare.
Per quanto riguarda competenze, plugin, comandi comuni e funzioni.
Non mi dilungherò qui. Ho scritto molti articoli correlati; gli amici interessati possono cercare le parole chiave corrispondenti.
Parole Finali
Ho finalmente finito questo tutorial per principianti su Claude Code, che era atteso da tempo.
Claude Code è lo "strumento di laurea" dell'attuale era dell'IA che ti raccomando.
Non hai bisogno di usare tutti quegli Agent disordinati. Usa bene Claude Code e sentirai veramente cos'è l'Agent più potente.
Spero che tutti possano creare felicemente.
E realizzare opere che ti appartengono in questa era.
Le tue opere.
