Claude Code: Guida completa per principianti (utilizzando modelli locali)

Parti da zero, installa Claude Code—che capisce il linguaggio naturale, scrive codice e lavora in autonomia—sul tuo computer e usalo per creare il tuo primo prodotto funzionante.

Per Iniziare

• Principianti Assoluti: Segui i Capitoli da 1 a 5 in ordine. Una volta eseguito il tuo primo strumento web, hai ufficialmente iniziato.
• In caso di Errori: Fai uno screenshot e dallo a Claude Code o Doubao. Descrivi "a che punto sono e che errore vedo". È 10 volte più efficiente che cercare su Google da soli.

Capitolo 1: Padroneggiare i Concetti di Base

Se non capisci le live streaming o i manuali, di solito non è perché non sei intelligente, ma perché i termini non sono collegati. Questo capitolo spiega le parole che appariranno ripetutamente.

1.1 Tre Concetti Fondamentali

1Modello = Cervello (Pensa e basta, non ha mani né piedi)
2Chatbot = Cervello + Bocca (Può parlare ma non agire)
3Agente = Cervello + Mani/Piedi + Cassetta degli Attrezzi (Può parlare e agire)

• Modello: GPT, Claude, Gemini, DeepSeek, Doubao, Qwen, Kimi, GLM, MiniMax... questi sono modelli, il "cervello".
• Chatbot: Web ChatGPT, App Doubao, finestra di dialogo DeepSeek. Tu chiedi, lui risponde, ma il lavoro lo devi fare tu.
• Agente: Tu dici "aiutami a creare un sito web", e lui crea cartelle, scrive codice, lo esegue e lo corregge sul tuo computer, per finalmente dirti "è fatto". Claude Code è un Agente.

Lo stesso modello in strumenti diversi ha capacità enormemente diverse. Lo stesso modello Claude in un browser è solo una chat, ma in Claude Code può scrivere codice da solo.

1.2 Token, Contesto, Imbrigliamento

• Token: L'unità più piccola che l'AI usa per comprendere il testo. 1 carattere cinese equivale a circa 1-2 Token; 1 parola inglese equivale a circa 1 Token. I Token sono la tua "bolletta elettrica". Non risparmiare Token durante la fase di apprendimento.
• Contesto: Tutto ciò che è presente in questo ciclo di conversazione. L'AI non ha memoria a lungo termine; può solo fare riferimento a ciò che ha sulla sua "scrivania".
• Finestra di Contesto: La dimensione della "scrivania" di ogni modello. Nel 2026, i modelli mainstream hanno raggiunto 1 milione di Token (circa 700.000-800.000 parole).
• Inquinamento del Contesto: Chiacchierare di cose diverse in un'unica finestra confonde l'AI. Una finestra per un compito; apri una nuova finestra per un nuovo argomento.
• Imbrigliamento / Ingegneria del Contesto: Non è un software, ma un insieme di metodi per padroneggiare l'AI—come organizzare le informazioni, gestire il contesto, guidare l'AI e verificare i risultati. Claude Code è eccezionale perché il suo Imbrigliamento è il più maturo.

1.3 Cos'è una Skill?

Una Skill è un Manuale di Procedure Standard (SOP) per Claude.

I Big Mac di McDonald's hanno lo stesso sapore in tutto il mondo non perché ogni negozio abbia uno chef stellato, ma perché ogni negozio ha un SOP. Una Skill è questo SOP per Claude—definisce "cosa fare prima, cosa fare dopo, quali strumenti usare e cosa conta come successo".

• Scrivila una volta, richiamala ripetutamente.
• Scrivere il tuo proprio SOP è come "insegnare" la tua esperienza lavorativa a Claude; diventa il tuo "dipendente virtuale".

1.4 Tre Metodi di Pagamento

La soluzione più realistica: Usa API di modelli domestici + cc-switch per un cambio immediato. Dettagli nel Capitolo 3.

1.5 Strumenti Ausiliari da Conoscere Prima dell'Installazione

1.6 MCP — Lo "Standard per Prese" degli Agenti

MCP sta per Model Context Protocol (Protocollo di Contesto del Modello).

Pensalo come uno standard per prese elettriche—che permette agli Agenti di connettersi a vari strumenti esterni e fonti di dati (Feishu, database, browser, Xiaohongshu, WeChat, ecc.).

Analogia:

• Una porta USB ti permette di collegare periferiche al computer; collega un altoparlante e il computer acquisisce la capacità di "riprodurre musica".
• MCP ti permette di collegare strumenti a Claude Code; collega Tavily e lui acquisisce la capacità di "cercare tendenze in tempo reale"; collega xiaohongshu-mcp e lui può "pubblicare su Xiaohongshu".

Per impostazione predefinita, Claude Code elabora solo le informazioni che gli fornisci e non cercherà attivamente su internet. Hai bisogno di MCP per cercare, leggere database o chiamare API esterne.

1.7 Multimodalità — L'AI Fa Più Che "Leggere Testo"

Modalità è il tipo di informazione. Il testo è una modalità; immagini, suono e video sono altre.

• Unimodale: Può elaborare solo testo.
• Multimodale: Può elaborare simultaneamente testo, immagini, audio, video, file e schermate.

Supporto dei modelli mainstream nel 2026:

Input ≠ Output

Il fatto che l'AI possa "vedere" una modalità non significa che possa "generarla".

• Immagini: Quasi tutti i modelli mainstream possono vedere le immagini; solo alcuni possono disegnarle (GPT Image, Gemini, Doubao Seedance, Jimeng, Nano Banana, ecc.).
• Video: Gemini, Doubao e Kimi possono guardare video; ma gli LLM non creano video direttamente; usano strumenti specializzati (Wan, Seaweed Dance, Jimeng).

Punti di Forza dei Modelli:

Consiglio pratico per i principianti: Non limitarti a digitare; impara a lanciare screenshot, registrazioni e video direttamente all'AI per aumentare l'efficienza.

1.8 Panoramica degli Strumenti AI (Chi è Chi)

Una mappa per chiarire la confusione sui diversi strumenti.

Strumenti Agente (Ti aiutano a lavorare)
``text
Strumenti Agente
├── Riga di Comando (Basato su terminale, il più potente)
│ ├── Claude Code —— Di Anthropic, attualmente il più forte, la star di questa guida
│ └── Codex CLI —— Di OpenAI, open source
│
├── GUI (Interfaccia visiva, facile da usare)
│ ├── Codex Desktop/Web —— Di OpenAI
│ ├── Claude Cowork —— Di Anthropic, per utenti non tecnici
│ ├── Trae Solo —— Di ByteDance, nazionale, ha modalità Code e MTC
│ ├── WorkBuddy —— Di Tencent, nazionale, per lavoro d'ufficio non dev
│ └── Kiro —— Di AWS, IDE guidato da specifiche (fork di VS Code)
│
├── Autonomi (Eseguono in background)
│ ├── OpenClaw —— Ex Clawdbot, open source, controllo remoto tramite WeChat/TG
│ └── Hermes —— Di Nous Research, open source, memoria persistente
│
└── Orchestrazione del Flusso di Lavoro (Automazione a blocchi)
└── COZE —— Di ByteDance, flussi di lavoro drag-and-drop
``

Strumenti Chatbot (Parlano con te)
``text
Chatbot
├── Estero
│ ├── ChatGPT (modello GPT)
│ ├── Claude.ai (modello Claude)
│ ├── Gemini (modello Google)
│ └── Grok (xAI/Elon Musk, per compiti legati a X)
│
└── Nazionale
├── Doubao (ByteDance)
├── DeepSeek (Alto rapporto qualità-prezzo)
├── Qwen (Alibaba)
├── Kimi (Moonshot AI)
├── WeChat Yuanbao (Tencent, forti dati dell'ecosistema WeChat)
└── GLM / Zhipu Qingyan (Zhipu AI)
``

"Gergo" Comune nei Commenti:

1.9 Riepilogo in una Frase della Relazione

1Tu (Umano)
2  ↕ Linguaggio Naturale
3Claude Code (Agente) —— Si connette a strumenti esterni tramite MCP
4  ↕ Chiamate
5Modello (Claude / GLM / MiniMax / Kimi…)
6  ↕ Consuma
7Token (Bolletta elettrica)

Capitolo 2: Configurazione dell'Ambiente

Installa 4 cose in ordine: Git → Node.js → VS Code → Claude Code.

2.1 Conferma il Tipo di Chip

• Mac: Icona Apple -> Informazioni su questo Mac. M1/M2/M3/M4 è ARM; Intel è x86_64.
• Windows: Tasto destro su "Questo PC" -> Proprietà. Intel/AMD è x86_64.

2.2 Installa Git

• Mac: Apri Terminale, incolla: /bin/zsh -c "$(curl -fsSL https://gitee.com/happyaicoder/HomebrewCN/raw/master/Homebrew.sh)". Verifica con git --version.
• Windows: Scarica da https://git-scm.com/https://git-scm.com/). Usa le impostazioni predefinite.

2.3 Installa Node.js (18+, 20 o 22 consigliati)

• Mac: Incolla: /bin/bash -c "$(curl -fsSL https://gitee.com/iamzhihuix/nvm-install-cn/raw/main/install.sh)". Verifica con node -v.
• Windows: Scarica LTS da https://nodejs.org/https://nodejs.org/). Se npm -v fallisce in PowerShell, esegui: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.

2.4 Installa VS Code

Scarica da https://code.visualstudio.com/https://code.visualstudio.com/). Su Windows, spunta le opzioni "Aggiungi al PATH" e "Apri con Code".

2.5 Installa Claude Code

• Mac: npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com. Usa sudo se l'autorizzazione è negata.
• Windows: Esegui PowerShell come Amministratore, poi: npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com.

2.6 Risoluzione degli Errori Comuni

Capitolo 3: Configurare Claude Code con Modelli Nazionali

Claude Code è la shell; ha bisogno di un modello (cervello). I modelli Claude ufficiali richiedono carte di credito estere e rischiano ban. La soluzione più realistica per gli utenti nazionali è usare cc-switch con modelli nazionali.

3.1 Scegli un Modello

Raccomandazione per Principianti: Piano Coding MiniMax (29 RMB/mese).

3.2 Installa cc-switch

Scarica da GitHub o Gitee Mirror.

3.3 Ottieni la Chiave API (Esempio: MiniMax)

1. Registrati su Piattaforma MiniMax.
2. Acquista un Piano Coding.
3. Copia la Chiave del Piano Coding (non la normale Chiave API).

3.4 Configura in cc-switch

1. Apri cc-switch, clicca sull'icona di Claude.
2. Clicca +, seleziona il provider (es. MiniMax), incolla la Chiave e clicca Aggiungi.
3. Sposta il mouse sul modello e clicca "Abilita".

3.5 Verifica

Nel terminale, digita claude. Chiedi: "Che modello sei?" Se risponde MiniMax/GLM, sei a posto.

Capitolo 4: Operazioni di Base di Claude Code

4.1 Due Modi per Avviare

• Terminale: Apri una cartella in VS Code, apri il terminale, digita claude.
• Plugin: Installa l'estensione "Claude Code" di Anthropic in VS Code.

4.2 Scorciatoie Essenziali

4.3 Tre Modalità di Lavoro

La modalità Plan è cruciale—Claude riflette sui passaggi prima di agire. Usala per funzionalità complesse.

4.4 Pensiero Normale vs. Profondo (ultrathink)

4.5 Modalità YOLO (Mani Libere)

Salta le richieste di autorizzazione per ogni modifica al file. Usa: claude --dangerously-skip-permissions.

4.6 CLAUDE.md per le Preferenze

Scrivi le tue preferenze in un file CLAUDE.md nella radice del tuo progetto (es. "Usa l'italiano per i commenti").

Capitolo 5: Costruire uno "Strumento di Lettura Anticipata"

5.1 Crea Directory e PRD

Crea prd.md in VS Code con i requisiti per un'app HTML/JS che genera animali emoji quando il volume del microfono supera una soglia.

5.2 Implementazione

Nel terminale, esegui claude --dangerously-skip-permissions e digita: @prd.md implementa questa funzionalità.

5.3 Risultato

Apri index.html in un browser, consenti l'accesso al microfono e parla per vedere apparire gli animali.

Capitolo 6: Padroneggiare le Abilità del Flusso di Lavoro

Le Skill sono SOP riutilizzabili. Una Skill include un SKILL.md (configurazione), script e template.

6.2 Usare npx skills

Installa le skill con un comando: npx skills add jimliu/baoyu-skills. Seleziona la skill e la destinazione (Claude Code).

6.3 Repository di Skill

6.5 Creare una Skill Personalizzata: Auto-Illustrazione

Usa l'API Nano Banana 2 di APImart per creare una skill che genera 3 illustrazioni in stile disegnato a mano per qualsiasi articolo tu scriva.

6.6 Skill vs MCP vs Hooks vs Plugin

• Skill: Ricetta (Passaggi per lo chef).
• MCP: Servizi (Acqua/Elettricità/Gas per la cucina).

Capitolo 7: Hardware e Rete

• Mac è migliore per l'AI grazie alla memoria unificata, ma Windows funziona bene.
• Usa la modalità TUN nel tuo proxy (es. clash.verge) se riscontri errori di rete con MCP o la generazione di immagini.

Appendice A: Prontuario dei Comandi

claude, /skills list, /clear, /compact, /doctor, /model.

Appendice B: Errori Comuni

Appendice C: Terminologia

Parole Finali

Mettiti prima in strada, poi parla di abilità di guida. Inizia con i Capitoli 2-5. L'AI è un moltiplicatore di produttività da 10x a 100x. Inizia oggi.