Tu primera sesión: pregúntale algo a una tabla real

En la página anterior leíste el registro de una sesión ya corrida; ahora te toca correrla en tu propia computadora. Vas a pedirle a Claude Code que descargue el catálogo de exoplanetas de la NASA desde el internet y que calcule qué porcentaje de los planetas confirmados se descubrió por el método de tránsito.

Trabajar con esta tabla tiene dos ventajas para estrenarte. Primero, es pública, así que practicas sin exponer archivos privados ni contraseñas de tu trabajo. Segundo, tiene más de 40,000 filas (40,350 el 31 de octubre de 2026), un tamaño que ya pide usar código en lugar de contar a ojo.

Cómo llega Claude Code a tus datos

En un chat común subes un archivo a mano en el navegador. Un agente instalado en tu computadora llega a los datos a través de las herramientas que le da su arnés:

• Archivos locales: lee los archivos que ya están en tu directorio de trabajo y guarda archivos nuevos ahí mismo, como el archivo CSV que vas a descargar hoy.
• Comandos: usa la terminal para traer datos desde una dirección en el internet, inspeccionar las primeras líneas de un archivo o correr un script en Python que haga las cuentas.
• Conectores y credenciales: en entornos de trabajo también puede consultar bases de datos o sistemas internos mediante conectores y tus credenciales de acceso. En tu primera sesión dejamos fuera contraseñas y sistemas internos: trabajas solo con una carpeta dedicada y una dirección abierta al público.

Por eso importa desde qué carpeta abres la sesión. Si abres Claude Code dentro de tu carpeta exoplanetas, ese es su directorio de trabajo y ahí guardará planetas.csv. Si lo abres desde Descargas o desde tu escritorio, dejará los archivos regados en ese otro lugar.

Arranca tu sesión en la carpeta exoplanetas

Abre Claude Code dentro de tu carpeta exoplanetas, tal como la dejaste lista en el Módulo 1. Si usas la app de escritorio, verifica que el modo de permisos esté en Manual; si usas la terminal, quédate en el modo normal en el que te pregunta antes de ejecutar cada acción. Para esta práctica evita cualquier modo que apruebe pasos en automático.

Copia esta petición completa, pégala en Claude Code y presiona Enter:

Lee antes de aprobar

Después de enviar tu petición, Claude Code hace una pausa antes de contestar y te muestra un aviso de permiso. Ese aviso es tu punto de control: te muestra qué herramienta quiere usar y con qué instrucciones exactas.

En la sesión de prueba que corrimos el 31 de octubre de 2026 con Claude Code 2.1.314 en una carpeta vacía, lo primero que pidió aprobar fue este comando en tres partes:

curl -sS -o planetas.csv "https://exoplanetarchive.ipac.caltech.edu/TAP/sync?query=select+pl_name,hostname,disc_year,discoverymethod,default_flag+from+ps&format=csv"; ls -l planetas.csv; head -3 planetas.csv

Aunque no escribas comandos de terminal, puedes leer qué hace cada parte antes de darle permiso:

• curl -sS -o planetas.csv "https://exoplanetarchive..." se conecta a la dirección de la NASA que le diste y guarda el resultado en el archivo planetas.csv dentro de tu carpeta actual.
• ls -l planetas.csv comprueba que el archivo se creó y muestra cuánto pesa (1,816,982 bytes en la sesión de prueba).
• head -3 planetas.csv muestra las primeras tres líneas del archivo para ver los nombres de las columnas (pl_name,hostname,disc_year,discoverymethod,default_flag).

Antes de aprobar cualquier paso en tu sesión, hazte dos preguntas:

1. ¿Corresponde a lo que le pedí? Descargar la dirección que le diste, mirar el encabezado del archivo o correr un conteo sobre planetas.csv son pasos directos para responder tu pregunta.
2. ¿Toca solo mi carpeta de práctica? El comando solo debe crear o leer archivos dentro de exoplanetas.

Si ambas respuestas son sí, selecciona la opción para aprobarlo. Tu sesión puede proponer el paso con otras herramientas: en Windows a veces usa un comando de PowerShell como Invoke-WebRequest en vez de curl, o separa la descarga y la lectura en avisos distintos. Después de descargar el archivo, te pedirá permiso para correr un programa en Python que haga el conteo, o incluso para instalar Python o pandas si no los tienes; también puedes aprobarlo. Si te pide permiso para algo que no entiendes, copia el aviso y pregúntale a tu Maestro antes de aprobarlo.

Qué deberías ver al terminar

Cuando apruebes el paso que cuenta los datos, Claude Code te dará su respuesta final. En la sesión de prueba del 31 de octubre de 2026 respondió 74.2% (4,785 de 6,451 planetas) y mencionó que el archivo tenía 40,350 filas.

La NASA actualiza este catálogo cada semana conforme se confirman nuevos descubrimientos, así que es normal que en tu pantalla aparezcan unas cuantas filas más, algunos planetas adicionales y una variación mínima en el decimal. Si en cambio te dio un resultado cercano a 89.8% (alrededor de 90%), la descarga funcionó bien, pero tu sesión contó las filas de la tabla en vez de contar planetas únicos. Guarda ese número, porque en la página 2.3 vas a ver por qué ocurre esa diferencia.

Revisa también tu carpeta exoplanetas en el explorador de archivos de tu computadora: ahí debe estar el archivo nuevo planetas.csv. Consérvalo, porque trabajaremos con él en el resto del curso. Si la descarga falla o aparece un mensaje de error, pégalo en el chat con tu Maestro para resolverlo paso a paso.

Inténtalo

Corre la sesión completa en tu computadora aprobando cada paso después de leerlo. Cuando Claude Code termine, escribe aquí abajo qué te respondió. Tu Maestro comparará tus números con los de la sesión de prueba para decirte si tu sesión contó planetas o filas.