Collega il tuo Garmin all'AI

Cosa ti serve

• Un orologio Garmin e il tuo account Garmin Connect
• Un computer, Mac o Windows
• Claude con un abbonamento a pagamento, per usare Claude Code, oppure ChatGPT con un abbonamento a pagamento, per usare Codex
• Una decina di minuti

La chat normale nel browser non basta, né con Claude né con ChatGPT. Per leggere i dati l'AI deve collegarsi a Garmin dal tuo computer, e questo lo fanno Claude Code e Codex: sono le versioni che lavorano sui file e sul computer invece che solo in chat.

Passo 1: crea la tua chiave su Garmin Connect

Dal computer vai su connect.garmin.com e accedi. Nelle impostazioni del tuo account trovi la pagina della chiave personale (Personal API); se non la trovi, l'indirizzo diretto è connect.garmin.com/app/settings/personalApiToken.

Crea una chiave nuova, accetta le condizioni e scegli quanto deve durare: 30, 90 o 180 giorni, oppure un anno. Copiala subito, perché Garmin te la mostra una volta sola. Se la perdi non succede niente di grave: la cancelli e ne crei un'altra.

Passo 2: salva la chiave in un file

La chiave è una riga lunga di lettere e numeri. La mettiamo in un file di testo dentro una cartella nuova, Corsa, che sarà anche la cartella in cui lavora l'AI: così la trova da sola e tu non devi mai incollarla in chat.

Su Mac

1. Apri il Finder, vai in Documenti e crea una cartella nuova dal menu Archivio › Nuova cartella. Chiamala Corsa.
2. Apri TextEdit: premi Cmd e la barra spaziatrice, scrivi TextEdit e premi Invio. Se si apre l'elenco dei documenti, clicca Nuovo documento.
3. Trasforma il foglio in testo semplice dal menu Formato › Converti in formato solo testo (oppure Maiusc+Cmd+T). Se salti questo passaggio il file si salva in un formato che l'AI legge male.
4. Incolla la chiave con Cmd+V. Nel foglio deve esserci solo la chiave, su una riga, senza spazi prima o dopo e senza andare a capo.
5. Salva con Cmd+S. Come nome scrivi garmin-chiave.txt, come posizione scegli la cartella Corsa in Documenti (se non la vedi, clicca la freccetta accanto al nome per aprire la finestra completa), lascia la codifica Unicode (UTF-8) e clicca Salva.

Su Windows

1. Apri Esplora file, vai in Documenti e crea una cartella nuova: tasto destro in uno spazio vuoto › Nuovo › Cartella. Chiamala Corsa.
2. Apri il Blocco note: clicca Start, scrivi Blocco note e premi Invio.
3. Incolla la chiave con Ctrl+V. Deve esserci solo la chiave, su una riga, senza spazi prima o dopo e senza andare a capo.
4. Dal menu File scegli Salva con nome. Apri la cartella Corsa in Documenti, come nome scrivi garmin-chiave.txt, lascia il tipo Documenti di testo (*.txt) e la codifica UTF-8, poi clicca Salva.

Per controllare, chiudi il file e riaprilo: devi vedere solo la chiave. Se c'è altro, una seconda riga o qualche carattere strano, cancella tutto, incolla di nuovo e salva.

Hai chiuso la pagina di Garmin prima di copiarla? Nessun problema: torna al Passo 1, cancella quella chiave e creane una nuova.

Perché un file e non la chat? La chiave è come una password: in un file sul tuo computer non finisce nella conversazione e non rischi di ritrovarla in uno screenshot. Per lo stesso motivo non mandare a nessuno la cartella Corsa così com'è, perché dentro c'è la chiave.

Passo 3: apri Claude Code o Codex

Se usi Claude, apri l'app di Claude sul computer, vai nella sezione Code e scegli come cartella di lavoro la cartella Corsa che hai appena creato in Documenti. Se usi ChatGPT, fai lo stesso con Codex, entrando con il tuo account ChatGPT.

Durante il lavoro ti chiederà il permesso di eseguire comandi o di collegarsi a internet: rispondi di sì, è così che parla con Garmin. Leggi sempre cosa ti chiede prima di confermare.

Passo 4: chiedi la tua dashboard

Incolla questo prompt così com'è: il file della chiave è già nella cartella Corsa, quindi non devi cambiare niente. Ci vuole qualche minuto: prima scambia la chiave con un accesso valido 24 ore, poi scarica le corse e costruisce la pagina.

Ho una chiave della Garmin Personal API salvata nel file garmin-chiave.txt in questa cartella. Usala per leggere le mie corse da Garmin Connect, solo in lettura: scambia la chiave con il token di accesso e scarica l'elenco delle mie attività. Non mostrarmi mai la chiave e non scriverla nei file che crei.

Poi creami una dashboard per chi corre, in italiano, che si legga bene anche sul telefono, con:
- l'ultima corsa, con distanza, passo, frequenza cardiaca e minuti in ogni zona cardio
- i km di ogni mese nell'ultimo anno
- il mio passo corsa dopo corsa
- un calendario dell'anno con i giorni in cui ho corso
- i miei record: 5 km, 10 km, mezza maratona se c'è
- i km anno per anno

Non mostrare mappe né posizioni GPS. Se trovi corse con dati impossibili, per esempio un errore del GPS, toglile e dimmelo. Alla fine dimmi tre cose che noti nei miei dati.

In più: un piano di corsa su misura

La parte più utile arriva dopo. Nella stessa conversazione l'AI ha già letto tutte le tue corse, quindi può costruirti un piano che parte dal tuo passo e dai tuoi chilometri di oggi, non da una tabella uguale per tutti.

Guarda le mie corse degli ultimi tre mesi: distanze, passo, frequenza cardiaca e quante volte corro a settimana. Preparami un piano di [8] settimane per [correre 10 km senza fermarmi] con [3] uscite a settimana.

Parti da come corro adesso, non da un piano standard, e non aumentare i chilometri settimanali più del 10% alla volta. Per ogni uscita scrivi il tipo di allenamento, i minuti o i km e il passo indicativo.

Mettilo in una tabella compatta, settimana per settimana, e aggiungilo alla dashboard.