Bienvenida

Este curso es para ti si ya programas y usas la IA en el chat: copias un trozo de código, lo pegas, copias la respuesta y la llevas a tu editor. Aquí vas a dar el paso siguiente, que es trabajar con un agente dentro de tu repositorio. Usaremos Claude Code.

Qué te llevas al terminar

Al acabar tendrás tu propia forma de trabajar con un agente, montada sobre un proyecto tuyo:

• Un CLAUDE.md con lo que el agente tiene que saber de tu proyecto en cada sesión.
• La costumbre de pedir tareas pequeñas que vienen con una prueba de que están hechas, casi siempre un test.
• Un método para revisar lo que ha hecho sin fiarte de su «listo», y para depurar con él sin aceptar el primer parche.
• Soltura para moverte por código que no conoces y cambiarlo con tests como red.
• Skills, hooks y subagentes para lo que repites cada día.
• Ramas, worktrees y pull requests con el agente, también con varias tareas a la vez.
• Herramientas externas conectadas con MCP, sabiendo qué le das al agente con cada una.
• Criterio para elegir modelo y esfuerzo, y para saber en qué se te va el uso del plan.
• Un issue de tu proyecto convertido en una pull request, de principio a fin, y tu forma de trabajar por escrito.

Lo último es el proyecto final. Lo haces sobre tu código y con una tarea que tengas pendiente de verdad.

Cómo está organizado

Son nueve módulos. Cada uno resuelve un problema que te vas a encontrar en cuanto empieces a trabajar con un agente:

Módulo	Qué resuelve
1. Del chat al agente	Instalarlo, el primer encargo, el taller y qué le dejas hacer
2. Contexto	Qué tiene que saber siempre, cómo no llenarlo de ruido y cómo volver atrás
3. Pedir bien y comprobar	Planificar, pedir con una prueba, revisar, depurar y corregir el rumbo
4. Trabajar en código que no conoces	Explorar un repositorio, leer antes de cambiar y refactorizar con red
5. Automatizar tu flujo	Skills, comandos, hooks, subagentes y plugins
6. Git, ramas y trabajo en paralelo	Commits, worktrees, revisar pull requests y Claude en GitHub
7. Conectar herramientas con MCP	Darle acceso a otras herramientas y al navegador sabiendo qué le das
8. Coste, modelos y límites	En qué se gasta el uso, qué modelo para qué y cuándo no usar el agente
9. Proyecto final	De un issue a una pull request, y tu forma de trabajar por escrito

Cada lección tiene tres partes:

• Un vídeo corto con el agente trabajando sobre un proyecto real.
• Un texto como este, para volver a él cuando necesites el comando exacto.
• Una práctica, primero en el taller y después en tu proyecto (el «Pruébalo» del final).

Las prácticas son lo que más cuenta. Las lecciones se apoyan unas en otras, así que la primera vez síguelas en orden.

El taller: un proyecto para practicar

No todos los proyectos se prestan a practicar. Puede que el tuyo no tenga tests, que sea de un cliente o que no tenga justo el tipo de fallo que toca en una lección. Por eso el curso trae un repositorio de prácticas, el taller (cuaderno-app).

Es Cuaderno, la aplicación con la que un estudio pequeño de diseño web lleva sus clientes, presupuestos y facturas. Una API en Node y TypeScript, sin framework, una web en HTML, CSS y JavaScript sin compilar, datos en ficheros JSON y tests con Vitest. No hace falta que domines TypeScript para seguirlo.

Trae nueve issues (del #42 al #50) escritos como los escribiría un compañero: un bug de búsqueda, un céntimo que no cuadra, un test que falla a veces, un módulo enredado, un fallo de seguridad, un botón que no responde en el móvil... Cada uno es el encargo de una práctica, y para cada uno hay una solución de referencia que solo miras después de intentarlo.

El método es siempre el mismo: lo pruebas en el taller, donde sabes qué debería pasar, y después lo repites en tu proyecto. En la lección 4 de este módulo lo pones en marcha.

Qué necesitas antes de empezar

• Programar con soltura en algún lenguaje. El taller está en TypeScript, pero lo que vas a ver vale para cualquier stack.
• Terminal y Git a nivel básico. Claude Code se usa desde la terminal, y vas a trabajar con ramas, diffs y commits.
• Una cuenta de Claude de pago (Pro o superior). El plan gratuito no incluye Claude Code (comprobado el 14-11-2026; mira los datos con fecha). La instalación la hacemos juntos en la lección 3.
• Node.js 22.12 o posterior, para el taller. Compruébalo con node -v.
• Un editor de código, el que uses a diario. En la lección 6 de este módulo lo conectas con Claude Code.
• jq, para los hooks del módulo 5: brew install jq en macOS o sudo apt install jq en Debian y Ubuntu. Compruébalo con jq --version. Sin él, los hooks que lo usan fallan, y el que protege ficheros bloquea todas las ediciones.
• Una cuenta de GitHub y su CLI, gh, para las pull requests de los módulos 6 y 9 y el servidor de GitHub del módulo 7: brew install gh en macOS, y en Linux los pasos de cli.github.com. Después, gh auth login. Si tu código no vive en GitHub, el proyecto final tiene un camino sin él: llegas hasta el commit y la descripción de la pull request, y la abres tú en tu plataforma.
• Google Chrome, para la práctica de navegador de la lección 4 del módulo 7.
• macOS, Linux o Windows con WSL. Los hooks y los scripts del curso son de Bash, y el sandbox de Claude Code no funciona en Windows nativo. La única práctica que no va desde WSL es la de Chrome: hazla con Claude Code instalado en Windows o sáltala.
• Un proyecto tuyo con Git para los «Pruébalo». Mejor si es uno en el que trabajas de verdad y tiene algún test. Si no tiene ninguno, no pasa nada: en el módulo 3 escribirás los primeros con el agente.

Una idea que vas a ver en todo el curso

El agente escribe código muy rápido, y justo por eso hay que vigilarlo. Él lee, cambia y ejecuta. Tú decides qué se construye y tú decides si está bien hecho.

Casi todo lo que viene después sirve para que esas dos decisiones te cuesten poco: decirle bien lo que quieres, darle una forma de comprobar su trabajo y revisar el resultado sin perderte.

Pruébalo

Prepara las dos cosas con las que vas a hacer todo el curso.

1. El taller. Descarga cuaderno-app.zip desde la ficha del curso, en el apartado «El código» (o pídeselo a tu Claude conectado al curso: en Tu Claude lo conectas en un par de minutos, y desde ahí te da las lecciones, las prácticas con su enlace y tu progreso; es opcional), y descomprímelo en tu carpeta de proyectos, por ejemplo en ~/proyectos/cuaderno-app. De momento no instales nada: en la lección 3 Claude Code lo leerá tal cual y en la lección 4 lo pones en marcha y lo conviertes en un repositorio de git.

2. Tu proyecto. Elige el repositorio y comprueba que no tiene cambios a medias:

   cd ~/proyectos/mi-proyecto
   git status
   

3. Apunta el comando con el que compruebas que todo funciona en tu proyecto: npm test, php artisan test, go test ./... o el que uses. Lo vas a necesitar en casi todas las lecciones.

4. Piensa en una tarea pequeña y real que tengas pendiente en tu proyecto, algo que harías en una tarde. En la lección 3 le pedirás al agente que te proponga cómo hacerla.