Claude Community Workshop

Il tuo server di casa con Claude Code

Torino · giovedì 12 novembre 2026

Grazie

Grazie a Feat. House per ospitarci stasera

Volete conoscerli o scrivergli? Inquadrate il QR.

featventures.com

Claude Community

Accoglienza

Ciao, Torino!

Mentre aspettiamo gli ultimi, controllate queste quattro cose.

Wi-Fi

Feat.House Guest

password #venturingtogether

Docker

docker ps

se non risponde, aprite Docker Desktop

Claude Code

claude --version

deve uscire la versione. Da desktop: tab Code, con il login fatto

Git

git --version

su Mac, se manca, vi propone di installarlo: accettate

Claude Community

Evento organizzato dalla community

I prompt di stasera

Le slide di stasera

Step 1

La cartella-progetto, con le regole nel CLAUDE.md

Step 2

Traefik, Portainer e la API key nel .env

Step 3

Un servizio da git, tramite l'API di Portainer

Step 4

"Vorrei…": Claude propone, voi scegliete

Debug

"Non risponde": prima la causa, poi il fix

Skill

Le skill da creare, proposte da Claude

Tutte le slide, con i prompt da copiare:
claude-community-torino-workshop.surge.sh

Claude Community

Agenda

19:00

Chi siamo e cosa costruiamo

19:20

La cartella-progetto

19:35

Traefik e Portainer

19:55

AdGuard Home, direttamente da git

20:15

Il servizio che volete voi

20:40

Skill, domande e prompt da portarvi a casa

Claude Community

Chi siamo

Gabriele Partiti

Claude Community Ambassador
Solution Architect AI
Senior Backend Engineer

Emanuele Beffa

Mobile · Backend · Web · Agenti AI

Claude Community

Alzi la mano chi…

ha già usato Docker

usa Claude Code tutti i giorni

ha già un server a casa, anche solo un vecchio portatile

Claude Community

Il tema di stasera

E se il server di casa diventasse un progetto Claude Code?

Claude Community

Come gira il tutto

Claude Community

Perché lo facciamo così

Una cartella, un progetto

Nel CLAUDE.md ci sono le regole del vostro server, così Claude lavora sempre allo stesso modo, anche tra sei mesi.

I segreti nel .env

Claude legge la API key da lì: non la incollate mai in chat e non finisce mai su git.

Tutto passa da git

Portainer si sincronizza col repo, ogni modifica ha la sua storia e se sbagliate tornate indietro.

Claude Community

Step 1

La cartella-progetto

Claude Community

Aprite Claude Code in una cartella vuota

Voglio gestire il mio server di casa con Docker, partendo da questa cartella. Crea un CLAUDE.md con queste regole: - ogni servizio è uno stack in stacks/<nome>/docker-compose.yml - i dati di uno stack stanno in una cartella con il suo nome, mai su git - tutti i servizi stanno sulla rete "homelab" e si espongono solo tramite Traefik, su <nome>.localhost - immagini con versione fissa, mai latest - segreti solo nel .env, mai nei file versionati Poi crea .gitignore e .env.example, inizializza git e collega il repo [url del tuo repo GitHub]. Alla fine spiegami in breve cosa hai fatto.

Da terminale: mkdir homelab && cd homelab && claude. Da desktop: tab Code e scegliete la cartella.

Claude Community

Step 2

Traefik e Portainer

Claude Community

Prima le fondamenta, poi tutto il resto

Crea gli stack traefik e portainer seguendo il CLAUDE.md e avviali in locale. Traefik è l'unico ingresso, con la dashboard su traefik.localhost. Portainer deve rispondere su portainer.localhost. Quando funziona, spiegami il primo accesso a Portainer, compreso il setup token che chiede, e come creare la API key. La metto io nel .env: tu leggila solo da lì.

Quando risponde, aprite portainer.localhost, create l'utente admin e la API key. La chiave va nel .env, mai in chat.

Claude Community

Step 3

AdGuard Home, da git

Claude Community

AdGuard Home lo installa Portainer, dal vostro repo

Aggiungi AdGuard Home come nuovo stack, con l'interfaccia su adguard.localhost. Al primo avvio la configurazione guidata gira sulla porta 3000: falla raggiungere da adguard.localhost. Poi: 1. fai commit e push 2. usa l'API di Portainer (URL e chiave nel .env) per creare lo stack direttamente dal repo git. Se il repo è privato, prima dimmi come creare un token GitHub di sola lettura: lo metto io nel .env 3. verifica che adguard.localhost risponda e guidami nella prima configurazione

Claude Community

Step 4

Il vostro servizio

Claude Community

Cosa vi piacerebbe avere a casa?

una to-do listle ricettele fotoi conti di casai segnalibrila musica…

Vorrei [cosa vuoi fare a casa]. Proponimi due o tre servizi self-hosted adatti, con pro e contro di ognuno. Aspetta che io scelga, poi installalo seguendo il CLAUDE.md, come abbiamo fatto con AdGuard Home.

Claude Community

Non funziona? Chiedetelo a Claude

Lo stack [nome] non risponde su [nome].localhost. Controlla container, log e configurazione di Traefik. Dimmi qual è la causa e proponi il fix, ma non applicarlo finché non ti dico ok.

Claude Community

Così la prossima volta non ripartite da zero

Rileggi questa conversazione e proponimi le skill che varrebbe la pena creare, così la prossima volta non riparto da zero. Per ognuna dimmi nome, a cosa serve e quando si dovrebbe attivare. Poi crea solo quelle che scelgo io.

Vale per qualsiasi cosa: quando vi accorgete di rifare sempre gli stessi passaggi, chiedete a Claude la skill.

Claude Community

I prompt di stasera

Le slide di stasera

Step 1

La cartella-progetto, con le regole nel CLAUDE.md

Step 2

Traefik, Portainer e la API key nel .env

Step 3

Un servizio da git, tramite l'API di Portainer

Step 4

"Vorrei…": Claude propone, voi scegliete

Debug

"Non risponde": prima la causa, poi il fix

Skill

Le skill da creare, proposte da Claude

Tutte le slide, con i prompt da copiare:
claude-community-torino-workshop.surge.sh

Claude Community

Domande?

Claude Community

Chiusura

Grazie, Torino

claudetorino.dev/links

Claude Community