Formación › Programar con Claude Code en 12 horas › Hora 1

Programar con Claude Code en 12 horas · hora 1 de 12

Instalar, primera sesión y el bucle

Claude Code no es un chat que escribe código: es un agente que lee tu proyecto, ejecuta comandos y edita ficheros. En esta hora lo instalas, ves una sesión real sobre el repositorio de práctica del curso y entiendes el bucle que explica todo lo que hará después.

Al terminar sabrásInstalar Claude Code, abrir un repositorio y obtener un mapa de él sin cambiar nada, y nombrar las tres fases de su bucle con un ejemplo de cada una.

60 minutos· 1 esquema· 5 preguntas· 1 ejercicio· entregable

Antes de empezar

Comprueba Tu intuición: ¿en qué se diferencia Claude Code de pegar código en el chat de Claude?

Vocabulario

Agente: Un modelo que usa herramientas en bucle (leer, buscar, ejecutar o editar) para cumplir un objetivo.
Arnés: La capa que rodea al modelo, le da las herramientas y gestiona lo que ve. Claude Code es un arnés.
Modo plan: El modo en que Claude solo lee e investiga; no edita hasta que apruebas un plan.
Repositorio de práctica: informes-mantenimiento, el proyecto pequeño con fallos sembrados que usarás en todo el curso.
Git, commit y diff: Git guarda versiones de un proyecto; un commit es una versión guardada, y el diff, lo que cambió entre dos versiones.

Si nunca has usado la terminal ni Git: la documentación tiene una guía de terminal para principiantes (se abre en otra pestaña) y una app de escritorio (se abre en otra pestaña) para usar Claude Code sin terminal. El curso usa la terminal, pero lo que aprendes vale igual en la app.

El ejemplo: un mapa del repositorio, sin tocar nada

Descarga el repositorio de práctica. Es un proyecto de Node.js sin dependencias que genera el parte semanal de paradas, con dos fallos sembrados que irás encontrando en el curso.

informes-mantenimiento.zipRepositorio de práctica del curso (Node.js 20 o posterior, sin dependencias)

Esta es una sesión real: Claude Code en modo plan, con el mismo prompt que usarás tú, sobre una copia limpia del repositorio.

Antes y después Primera sesión en modo plan

Antes de mirar: El repositorio tiene dos fallos sembrados. ¿Crees que Claude Code los encontrará solo con leer, sin ejecutar nada?

El prompt

Primera petición

Dame una visión general de este repositorio: para qué sirve, cómo está organizado, qué comandos se usan para ejecutarlo y probarlo, y qué partes te parecen más frágiles. No cambies nada.

En la cabecera de cada sesión grabada tienes la orden para repetirla tú. Aquí: abre la terminal dentro del repositorio, escribe claude --permission-mode plan y pega el prompt.

La sesión real

Salida real Claude Sonnet 5.5 · 24 de octubre de 2026 · sin editar · Claude Code en modo plan sobre el repositorio de práctica

Para repetirla, en el repositorio: claude --permission-mode plan y pega la petición. Se grabó con claude -p, sin conversación: lo que aquí se deniega, a ti te lo preguntaría.

Lo que hizo: 10 acciones

Bash: git ls-files | head -200; echo ---; ls -la
Read: README.md
Read: package.json
Read: src/cli.js
Read: src/fechas.js
Read: src/informes/semanal.js
Read: src/paradas.js
Read: datos/paradas.csv
Read: pruebas/fechas.test.js
Read: pruebas/parte.test.js

Visión general de informes-mantenimiento

Para qué sirve

Es un repositorio de práctica, sintético y sin datos reales, del curso de MaestrIA «Programar con Claude Code en 12 horas». Lee datos/paradas.csv, con una fila por parada de un equipo, y genera el parte semanal de mantenimiento. El parte es una tabla de texto con las horas de parada por línea, con coma decimal.

Organización

Ruta	Contenido
`src/cli.js`	Punto de entrada. Lee el CSV pasado como argumento, calcula la semana ISO de la primera parada e imprime el parte.
`src/paradas.js`	`leerParadas` (parseo del CSV con `;`) y `horasPorLinea` (suma de horas por línea).
`src/fechas.js`	`horasEntre("HH:MM","HH:MM")` y `semanaIso("AAAA-MM-DD")`.
`src/informes/semanal.js`	`parteSemanal`: formatea la tabla, con líneas ordenadas y formato `es-ES`.
`datos/paradas.csv`	Datos de ejemplo, 8 filas.
`pruebas/*.test.js`	Pruebas con `node:test` para fechas, suma por línea y formato del parte.

El proyecto usa ES modules, no tiene dependencias y necesita Node 20 o posterior.

Comandos

npm test ejecuta node --test "pruebas/*.test.js".
npm run parte ejecuta node src/cli.js datos/paradas.csv.

No he ejecutado ninguno de los dos, porque en este modo no cambio ni ejecuto nada.

Partes frágiles

Paradas que cruzan medianoche. horasEntre asume que ambas horas son del mismo día. En datos/paradas.csv, la fila P-104 va de 23:30 a 01:15, así que da −22,25 h en lugar de 1,75 h. Ese valor negativo resta de las horas de L2.
Fila duplicada. P-106 aparece dos veces en el CSV, y nada deduplica por id. Las horas de L3 quedan infladas en 2,5 h.
La semana sale solo de la primera fila. cli.js usa paradas[0].fecha y no filtra las paradas por semana. Si el CSV abarca varias semanas, el parte las suma todas bajo una sola etiqueta de semana. Con un CSV vacío, paradas[0] lanza una excepción.
Parseo de CSV ingenuo. split(";") no admite campos entrecomillados ni ; dentro de un valor. Tampoco valida cabeceras, columnas faltantes ni formatos de hora o fecha, y una entrada mala produce NaN sin avisar.
CLI sin manejo de errores. Si falta el argumento o el archivo no existe, falla con un stack trace.
Cobertura de pruebas insuficiente. No hay pruebas para los casos de los puntos 1 a 3, que son justo los que fallan con los datos de ejemplo. Tampoco hay pruebas del CLI. La prueba de formato depende del soporte de ICU para es-ES en Node.
semanaIso es poco legible. Es aritmética densa en una sola línea. Tiene pruebas, pero solo para dos fechas, y ninguna cerca de los cambios de año.

Los puntos 1 y 2 hacen que el parte de ejemplo ya salga con cifras incorrectas.

Fíjate en tres cosas. Primero, en lo que hizo, en el desplegable de acciones: listó los ficheros (con Git, un comando de solo lectura) y los leyó uno a uno, sin ejecutar las pruebas ni editar nada. Después, en que encontró los dos fallos sembrados (la parada que cruza la medianoche y la fila duplicada) solo leyendo. Y por último, en que dice qué no ha comprobado: no ejecutó las pruebas, así que lo que cuenta de ellas sale de leer el código. Esa honestidad es la que tienes que pedir siempre. (Ojo con su frase «no ejecuto nada»: sí ejecutó dos comandos de lectura, git ls-files y ls. El modo plan no edita, pero puede ejecutar comandos para explorar.)

Qué es Claude Code

En un chat, tú copias código, lo pegas y vuelves a preguntar. Claude Code trabaja dentro de tu proyecto:

Lee tus ficheros, tu historial de Git y tu CLAUDE.md.
Ejecuta lo que tú podrías ejecutar en la terminal: pruebas, builds, Git y scripts.
Edita varios ficheros a la vez, de forma coordinada.

El bucle: reunir contexto, actuar y verificar

Según la documentación oficial, todo lo que hace Claude Code sigue un bucle de tres fases que se mezclan entre sí:

Reunir contexto: busca y lee ficheros para entender tu código.
Actuar: edita ficheros y ejecuta comandos.
Verificar: ejecuta las pruebas o el build para comprobar el resultado.

El bucle de trabajo. Tú puedes interrumpirlo en cualquier momento con Esc o escribir una corrección mientras trabaja.

Una pregunta sobre tu código, como la del ejemplo, solo necesita la primera fase. Arreglar un fallo recorre las tres varias veces. Fíjate en la última frase del esquema: es la idea más importante del curso. Sin una forma de comprobar su trabajo, Claude para cuando le parece que ha terminado. Lo verás a fondo en la hora 5.

Instalar e iniciar sesión

Según la documentación (consultada el 24/10/2026), el método recomendado es el instalador nativo, que se actualiza solo:

macOS, Linux o WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell: la línea empieza por PS C:\)

irm https://claude.ai/install.ps1 | iex

Windows (CMD: la línea empieza por C:\, sin PS)

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

No mezcles las dos de Windows: si ves «'irm' is not recognized», estás en CMD; si ves que «&&» no es válido, estás en PowerShell. También se puede instalar con Homebrew (brew install --cask claude-code) o WinGet (winget install Anthropic.ClaudeCode), aunque estas dos vías no se actualizan solas. Después, abre una terminal nueva y comprueba la instalación con claude --version.

Claude Code necesita un plan Pro, Max, Team o Enterprise de Claude, o una cuenta de la Consola de Anthropic. El plan gratuito de claude.ai no lo incluye. En empresa también puede ir por Amazon Bedrock, Google Cloud o Microsoft Foundry.

Para empezar, entra en la carpeta del proyecto y escribe claude. La primera vez te pedirá iniciar sesión en el navegador. En Windows conviene instalar Git para Windows, para que Claude Code pueda usar Bash; si no está, usa PowerShell.

Antes de tu primera sesión en un proyecto propio: guarda una versión (un commit) o haz una copia. Desde la versión 2.1.283, Claude Code arranca en modo automático, el que menos pregunta (lo verás en la hora 7). Para explorar sin riesgo, lánzalo con claude --permission-mode plan o cambia de modo con Mayús+Tab hasta ver el indicador del modo plan. Esc lo detiene en cualquier momento.

Practica

Ordena Ordena lo que hace Claude Code cuando le pides «arregla las pruebas que fallan»

Lee la salida del error
Edita el código para corregir la causa
Ejecuta las pruebas para ver cuáles fallan
Busca y lee los ficheros relacionados
Vuelve a ejecutar las pruebas para verificar

Comprueba lo que has aprendido

Comprueba Abres Claude Code por primera vez en un proyecto de tu empresa. ¿Cuál es la primera petición más prudente?

Comprueba Claude Code edita dos ficheros y dice «hecho» sin ejecutar nada. ¿Qué fase del bucle falta?

Comprueba En la sesión real, ¿por qué es valioso que Claude dijera que no había ejecutado las pruebas?

Comprueba En modo plan, ¿qué puede hacer Claude Code?

Entregable El mapa de tu repositorio

Instala Claude Code y ábrelo en modo plan en el repositorio de práctica o en uno tuyo que ya tengas en Git. Pide el mapa con el prompt del ejemplo y haz dos preguntas más. Pega aquí el mapa resumido, los comandos de prueba que encontró (y si funcionan) y un ejemplo de cada fase del bucle que hayas observado.

Está bien si: el mapa dice cómo ejecutar y probar el proyecto; has comprobado tú al menos un comando que propuso; y separas lo que Claude leyó de lo que ejecutó. Tiempo: unos 20 minutos, sin contar la instalación.

Tu entregable: El mapa de tu repositorio

Lo esencial

Claude Code es un agente dentro de tu proyecto: lee, ejecuta y edita con tus permisos.
Su bucle: reunir contexto, actuar y verificar. Sin verificación, «hecho» es una opinión.
Empieza en modo plan, pidiendo un mapa sin cambios, y fíjate en qué ha comprobado y qué no.
Necesita un plan de pago de Claude o una cuenta de la Consola.

Fuentes y para seguir

Cómo funciona Claude Code (se abre en otra pestaña) (documentación oficial, consultada el 24/10/2026).
Instalación y requisitos (se abre en otra pestaña) y visión general (se abre en otra pestaña).
En MaestrIA: programar con IA y chuleta de Claude Code.

← CursoProgramar con Claude Code en 12 horas Hora 2 →La ventana de contexto y las sesiones

Lección revisada el 24/10/2026 con la documentación oficial enlazada en sus fuentes. Revisamos los cursos cada trimestre.