Guida operativa

Setup collaboratore:
Claude Code sul tuo Mac

Cinque passi per avere Claude collegato alle cartelle di lavoro, alle skill e agli strumenti. Non serve saper programmare: si copia e si incolla.

⏱ circa 30 minuti, una volta sola
0Cosa ti serve prima di iniziare 1Installare VS Code e Claude Code 2Collegare Google Drive 3Il comando che collega tutto 4Autorizzare gli strumenti 5La prova finale ?Se qualcosa non va

0 · Cosa ti serve prima di iniziare

Da qui in avanti si lavora dentro VS Code. L'app Claude sul telefono o sul browser resta per le chat normali: il lavoro vero si fa qui.

1

Installare VS Code e Claude Code

  1. Vai su code.visualstudio.com e clicca Download for macOS.
  2. Apri il file scaricato e trascina Visual Studio Code nella cartella Applicazioni.
  3. Apri l'app. Se ti chiede di collegare un account GitHub e non ce l'hai, creane uno gratuito su github.com/signup: bastano mail e password.
  4. Nella barra laterale sinistra clicca l'icona con i quattro quadratini (Extensions), cerca Claude Code e installa il primo risultato: “Claude Code for VS Code” di Anthropic. Quando chiede, dai Trust.
  5. Nella barra laterale comparirà il simbolo di Claude. Cliccaci: si apre “Welcome to Claude Code”. Scegli il pulsante arancione Claude.ai Subscription.
  6. Si apre il browser: clicca Authorize e accedi col tuo account claude.ai. Fatto: torna su VS Code.
Devi anche installare gli strumenti da terminale. Apri Terminale (Spotlight ⌘+spazio → “Terminale”) e incolla questo blocco: installa Homebrew se manca, poi git, node e gli altri. Ti chiederà la password del Mac.
command -v brew >/dev/null || /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
[ -x /opt/homebrew/bin/brew ] && eval "$(/opt/homebrew/bin/brew shellenv)"
brew install git gh node jq ripgrep
npm install -g @anthropic-ai/claude-code

Al termine scrivi claude nel Terminale e fai il login con il TUO account. Va fatto adesso: il passo 3 ha bisogno che Claude esista già.

2

Collegare Google Drive

  1. Installa Google Drive per desktop da google.com/drive/download e accedi col TUO account Google.
  2. Apri le mail di condivisione. Per ognuna clicca “Aggiungi scorciatoia al Drive” e mettila dentro My Drive (o “Il mio Drive”).
  3. Apri il Finder → Google Drive → My Drive e apri le cartelle una volta: serve a far partire la sincronizzazione.

Il passaggio che salta sempre

Nel Finder, tasto destro su ogni cartella condivisa → “Rendi disponibile offline”.

Senza questo Drive tiene solo dei segnaposto vuoti e Claude non riesce a leggere i file: è il motivo numero uno per cui sembra che “non veda la cartella”.

3

Il comando che collega tutto

Questo comando trova da solo lo script di setup dentro il tuo Drive e lo esegue. Collega le skill, le cartelle-progetto condivise con te e gli strumenti. Puoi rilanciarlo quante volte vuoi: non rompe niente.

Incollalo nel Terminale (o in Claude Code)

bash "$(find -L ~/Library/CloudStorage ~/"My Drive" ~/"Il mio Drive" -maxdepth 4 -name _setup-collaboratore.sh 2>/dev/null | head -1)"

Alla fine deve dirti SETUP COMPLETATO e l'elenco dei progetti collegati.

Se preferisci farti accompagnare, apri Claude Code e incolla invece questo: fa gli stessi passi e ti spiega cosa sta succedendo.

Devo collegarti alle cartelle di lavoro che Gianluca ha condiviso con me su Google Drive. Fai tu i passi e spiegami in italiano semplice cosa succede.

1. Cerca lo script di setup con:
find -L ~/Library/CloudStorage ~/"My Drive" ~/"Il mio Drive" -maxdepth 4 -name _setup-collaboratore.sh 2>/dev/null | head -1

2. Se lo trovi, eseguilo con: bash "<percorso trovato>" e mostrami tutto quello che stampa.

3. Se NON lo trovi, non inventare percorsi: vuol dire che Google Drive non ha ancora sincronizzato. Dimmi cosa devo fare a mano e ripartiamo dal punto 1.

4. Poi verifica che i file si leggano davvero: elenca ~/Desktop/Claude/Brain/02-Progetti/ e apri un file a caso di un progetto per controllare che non sia un segnaposto vuoto.

5. Chiudi con il riepilogo: quali skill sono collegate, quali progetti vedo, cosa devo ancora fare io.

Dopo lo script troverai le tue cartelle in ~/Desktop/Claude/Brain/02-Progetti/: è da lì che si lavora.

4

Autorizzare gli strumenti

Gli strumenti (Google Drive, Calendar, Gmail, Make, Notion, Canva…) sono gli stessi di Gianluca, ma collegati ai TUOI account: lui non vede le tue cose e tu non vedi le sue.

  1. Apri Claude Code e scrivi /mcp.
  2. Autorizzali uno per uno, accedendo con i tuoi account.
Make fa eccezione. È lo spazio di lavoro aziendale: finché Gianluca non ti invita, l'autorizzazione da sola non basta. Se ti serve, chiediglielo.
5

La prova finale

Apri Claude Code dentro la tua cartella di progetto e chiedigli qualcosa che sta davvero nei file. Per esempio:

Leggi il README di questo progetto e dimmi di cosa si occupa.

Se ti risponde con dettagli veri — nomi, numeri, cose scritte nei file — sei operativo. Se risponde in modo generico o dice che non trova niente, il problema è quasi sempre Drive: vai al riquadro qui sotto.

Se qualcosa non va

“Il comando non trova lo script”

Drive non ha ancora la cartella. Controlla di aver fatto Aggiungi scorciatoia al Drive mettendola in My Drive (non basta che sia in “Condivisi con me”), poi apri la cartella dal Finder e aspetta che finisca di scaricare.

“Claude non legge i file”

Sono segnaposto: tasto destro sulla cartella → Rendi disponibile offline. Poi rilancia il comando del passo 3.

“Vedo una cartella che non mi aspettavo (o me ne manca una)”

Lo script collega solo quello che Gianluca ha condiviso con te. Scrivigli: si sistema dal suo lato in un minuto.

“Si è rotto qualcosa e non capisco”

Mandagli uno screenshot del Terminale con il comando lanciato e l'errore. Con quello si capisce sempre.