Cómo entrené para mi maratón con IA conectada a mi Garmin

En vez de un coach humano armando tu plan a partir de lo que le cuentas, una IA arma y ajusta tu plan a partir de tus datos reales de recuperación todos los días: sueño, HRV, frecuencia cardíaca en reposo, body battery, estrés y disposición para entrenar. Eso es información que ni Strava te da completa.

Esto necesita dos cosas: un reloj Garmin que ya estés usando, y una IA que pueda escribir y correr código por ti para leer esos datos, no un chat normal de texto. Hay varias formas de hacerlo: Claude Code por terminal, el modo Cowork sin necesidad de terminal (así lo armé yo), o Codex CLI si usas ChatGPT. Y si no tienes reloj Garmin, más abajo te dejo también una versión que funciona con un chat normal, sin ningún reloj.

1. Qué necesitas antes de empezar

Tres cosas antes de arrancar.

Una cuenta de Garmin Connect con historial de entrenamientos.

Una de estas tres herramientas: Claude Code instalado en tu computadora (gratis, corre en tu terminal), el modo Cowork (no requiere instalar nada ni abrir terminal), o Codex CLI si prefieres ChatGPT. Ojo: esto no funciona pegando el prompt en un chat normal de claude.ai o chatgpt.com sin ninguna de estas herramientas, porque necesita poder instalar software y correr comandos.

Unos 10 minutos: la configuración se hace una sola vez.

2. El prompt que hace todo el trabajo

Pega este prompt completo en Claude Code, en Cowork, o en Codex CLI si usas ChatGPT. Tú no descargas nada, no creas carpetas ni escribes código, la IA hace todo eso por ti. Lo único que vas a escribir es tu usuario y contraseña de Garmin cuando te lo pida.

Prompt de conexión

Quiero conectar mi reloj Garmin para que puedas leer mis datos de entrenamiento y recuperación, y estoy empezando desde cero. No quiero descargar nada, crear carpetas ni escribir código yo mismo. Tú haces todo. Guíame paso a paso, en español sencillo, y detente a esperarme cuando necesites algo de mí. El objetivo: traer mis propios datos de Garmin (mis entrenamientos más mis números de recuperación: sueño, HRV, frecuencia cardíaca en reposo, body battery, estrés, y disposición para entrenar) a una carpeta en mi computadora que puedas leer cada vez que te pregunte. Es la información de recuperación que Strava no me da. Solo lectura, nunca debes escribir nada de vuelta a mi cuenta de Garmin. Esto es todo lo que necesito que hagas, de principio a fin. Hazlo tú mismo: 1. Crea una carpeta nueva en mi computadora para esto (algo como garmin-ai) y trabaja dentro de ella. Yo no debería tener que crearla. 2. Escribe el script de sincronización. Usa la librería de código abierto python-garminconnect de cyberjunky (github.com/cyberjunky/python-garminconnect). El script debe traer mis actividades recientes más mi bienestar diario (sueño, HRV, frecuencia cardíaca en reposo, body battery, estrés, pasos, disposición para entrenar) y guardarlos como una carpeta garmin/ limpia con notas en markdown en español sencillo, más un archivo data.json. Una nota de bienestar por día, una nota por entrenamiento. 3. Escribe el requirements.txt e instala lo necesario. Revisa primero si ya tengo Python instalado, y ayúdame a instalarlo si no. 4. Haz el login a Garmin, una sola vez. Detente y pídeme mi correo y contraseña de Garmin cuando llegues a este paso, eso es lo único que voy a escribir. Maneja el código de doble factor si Garmin lo pide. Mantén mi contraseña y el token de acceso fuera de este chat, nunca me los muestres de vuelta, y guarda el token para que no tenga que volver a iniciar sesión la próxima vez. 5. Pruébalo trayendo mis últimos 3 días y muéstrame los resultados para confirmar que funciona. 6. Una vez que funcione, pregúntame si quiero que corra automáticamente cada mañana, y si digo que sí, configúralo también. Ve paso a paso. No me des todo de un jalón, y no me hagas tocar archivos, carpetas o código yo mismo. Tú te encargas de eso. Cuando necesites que apruebe un comando, solo pregunta y yo digo que sí.

Con Claude Code: instálalo en tu computadora (es gratis, es el agente de código que corre en tu terminal) y pega el prompt ahí.

Con Cowork (la versión más sencilla): así lo armé yo. No necesitas instalar nada ni abrir terminal, Cowork ya trae su propio espacio donde puede escribir y correr código por ti. En la práctica, esto ha funcionado simplemente pidiéndole cada vez que quieres ver tu día: "jala mis datos de Garmin de hoy", y los trae. Si quieres que tus datos persistan de una sesión a otra, conecta una carpeta de tu computadora dentro de Cowork.

Con ChatGPT (Codex CLI): instala Codex con npm install -g @openai/codex (o brew install --cask codex en Mac), ábrelo en tu terminal, y pega el mismo prompt de arriba, palabra por palabra.

3. Si no usas Garmin: el mismo coach, con check-in manual

No necesitas un reloj para tener un entrenador de IA. Esta versión funciona en un chat normal de ChatGPT o Claude: en vez de leer tus datos solo, la IA te pregunta cómo amaneciste cada día y ajusta el entrenamiento con eso. Pégalo tal cual y respóndele con honestidad.

Prompt sin reloj

Quiero que seas mi entrenador para un maratón y que ajustes mi plan según cómo me siento cada día, porque no tengo un reloj que registre mi recuperación. Vamos por partes y en español sencillo. Primero, hazme preguntas una por una para conocer mi punto de partida: mi nivel actual de carrera (mi tiempo reciente de 10K o de medio maratón si lo tengo, o mi ritmo cómodo de trote si apenas empiezo); cuántos días y cuántas horas puedo entrenar por semana; la fecha de mi maratón; y cualquier lesión o límite de salud. No armes el plan hasta tener esto claro. Con eso, arma un plan por semanas hasta la carrera, explicándome el porqué de cada bloque (base, fuerza, resistencia, descanso, y la reducción de carga antes de la carrera). Después, cada mañana que te escriba, pregúntame: cómo dormí, mi energía del 1 al 10, si tengo dolor o molestias, y cuánto tiempo tengo hoy. Con mi respuesta, ajusta el entrenamiento del día: si vengo cansado o dormí mal, baja la intensidad o dame descanso; si vengo bien, aprovéchalo. Dame siempre el entrenamiento concreto (distancia, ritmo o zona de esfuerzo, y duración) y una frase de por qué hoy toca eso. Recuérdame que esto es una guía, no un diagnóstico médico: si algo duele de forma anormal, que pare y consulte a un profesional.

La diferencia con la versión de Garmin es simple: aquí tú le das el dato (cómo dormiste, cómo te sientes) en lugar de que la IA lo lea de tu reloj. Menos automático, pero funciona con lo que ya tienes.

4. Qué obtienes, y sobre tu seguridad

Con la versión de Garmin, obtienes una carpeta llamada garmin/ con tres cosas: daily/ (una nota en markdown por día con tu sueño, HRV, frecuencia cardíaca en reposo, body battery, estrés, pasos y disposición para entrenar), activities/ (una nota por cada entrenamiento) y data.json (todo tu historial, actualizado cada vez que corre). Desde ahí, tu entrenador de IA lee esa carpeta cada mañana y ajusta tu plan con tu contexto real de recuperación, no con lo que le cuentas de memoria.

Tu contraseña se escribe una sola vez en un campo oculto (no se ve en pantalla mientras escribes), nunca se guarda, nunca se pone en variables de entorno, nunca queda en tu historial de comandos, y nunca se imprime de vuelta. El token de acceso, que dura aproximadamente un año, se guarda de forma privada en tu computadora. El script solo lee tus datos, nunca escribe nada de vuelta a tu cuenta de Garmin. Está basado en la librería de código abierto python-garminconnect de cyberjunky (github.com/cyberjunky/python-garminconnect).

Nota importante: esto no reemplaza la supervisión de un médico o fisioterapeuta si tienes una lesión o condición de salud existente. Un maratón es un esfuerzo físico exigente, usa el plan de IA como estructura y guía, pero escucha a tu cuerpo y consulta a un profesional de salud antes de aumentar tu volumen o intensidad de entrenamiento.

Llévate esta guía en PDF

El sistema completo, con los tres métodos y la versión sin reloj. Gratis.

descargar PDF →

Preguntas frecuentes

¿Necesito saber programar para conectar mi Garmin a una IA?

No. Tú solo pegas un prompt y respondes cuando te pida tu usuario y contraseña de Garmin. La IA (Claude Code, Cowork, o Codex CLI si usas ChatGPT) crea la carpeta, escribe el script y hace la conexión por ti.

¿Funciona sin reloj Garmin?

Sí. Hay una versión de check-in manual que funciona en un chat normal de ChatGPT o Claude: le cuentas cada mañana cómo dormiste y cómo te sientes, y ajusta tu entrenamiento con eso, sin necesidad de ningún reloj.

¿Puedo usar este sistema con ChatGPT en vez de Claude?

Sí. El equivalente de Claude Code es Codex CLI, el agente de código de OpenAI. Se instala con npm install -g @openai/codex y acepta exactamente el mismo prompt.

¿Es seguro darle mi usuario y contraseña de Garmin a la IA?

La contraseña se escribe una sola vez en un campo oculto, nunca se guarda ni se muestra de vuelta, y el script solo lee tus datos, nunca escribe nada en tu cuenta de Garmin.

¿Este plan de IA reemplaza a un entrenador humano?

No reemplaza la supervisión de un médico o fisioterapeuta si tienes una lesión o condición existente. Úsalo como estructura y guía, pero escucha a tu cuerpo antes de aumentar volumen o intensidad.

¿Te sirvió esta guía?

Cada semana mando 1 correo de 2 minutos con lo nuevo que estoy probando en IA. Gratis, sin spam.