Formación › Programar con Claude Code en 12 horas › Hora 4
Programar con Claude Code en 12 horas · hora 4 de 12
Explorar, planificar y pedir un cambio
El error más caro con un agente no es un fallo de código: es resolver muy bien el problema equivocado. Verás el plan real que hizo Claude Code para exportar el parte a CSV, qué corregirías antes de aprobarlo y cuándo no hace falta planificar.
Al terminar sabrásPedir un cambio de varios ficheros en modo plan, revisar y corregir el plan antes de aprobarlo, y decidir cuándo saltarse el plan porque el cambio cabe en una frase.
60 minutos· 1 esquema· 6 preguntas· 1 ejercicio· laboratorio· entregable
Repaso
Comprueba De la hora 3: ¿qué pregunta recomienda la guía oficial para decidir si una línea sigue en CLAUDE.md?
Correcto. Si quitarla no haría que Claude se equivocara, es ruido.
No. El lector es Claude, que ya sabe lo estándar.
No. Las buenas prácticas conocidas son evidentes para Claude y sobran.
Comprueba De la hora 3: ¿qué le faltaba al CLAUDE.md que generó /init?
Correcto. Es lo que Claude no puede deducir del código.
No. Lo traía, y es de lo más útil del fichero.
No. La traía, y sobraba casi entera.
Comprueba De la hora 2: acabas un arreglo y vas a empezar algo que no tiene nada que ver. ¿Qué haces?
No. El proyecto lo recuerda por CLAUDE.md; arrastrar tareas viejas añade ruido.
No. Resumes algo que ya no necesitas: mejor vaciar.
Correcto. Contexto limpio y relevante para lo siguiente.
Vocabulario
- Modo plan
- Claude lee e investiga sin editar; termina proponiendo un plan.
- Plan
- Qué ficheros cambian, cómo, qué riesgos hay y cómo se probará.
- Petición con ámbito
- Una petición que dice qué fichero, qué caso y qué no tocar.
El ejemplo: un plan real
Pedimos en modo plan exportar el parte también a CSV para Excel. Es un cambio que toca varios ficheros, justo cuando la guía recomienda planificar.
Antes y después Un plan de Claude Code, antes de tocar nada
La petición
Quiero exportar el parte semanal también a un fichero CSV que se pueda abrir en Excel. ¿Qué ficheros hay que cambiar, cómo lo harías sin añadir dependencias y cómo lo probarías? Haz un plan; no cambies nada todavía.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: 11 acciones
Glob: **/*Bash: git ls-filesRead: src/informes/semanal.jsRead: src/cli.jsRead: src/paradas.jsRead: src/fechas.jsRead: pruebas/parte.test.jsRead: package.jsonRead: README.mdRead: datos/paradas.csvWrite: ~/.claude/plans/quiero-exportar-el-parte-encapsulated-widget.md
Este es el plan. No he cambiado nada del proyecto. Solo he guardado el plan en ~\.claude\plans\quiero-exportar-el-parte-encapsulated-widget.md.
Qué ficheros cambiar
src/informes/semanal.js: añadirparteSemanalCsv(paradas, semana)junto aparteSemanal. ReutilizahorasPorLineay el mismo orden por línea. Sacaría las filas ordenadas a una función interna para no duplicar lógica.src/cli.js: aceptar--csv <ruta>y escribir el fichero conwriteFileSync. Sin esa opción, el comportamiento actual no cambia.package.json: un script opcionalparte:csv.pruebas/parte.test.js: pruebas nuevas.README.md: una línea de uso.
Cómo, sin dependencias
Basta con node:fs y cadenas. Para que Excel en español lo abra bien:
- Separador
;, igual quedatos/paradas.csv. - Coma decimal (
1,5) para que Excel lo reconozca como número. No reutilizaríaformatotal cual, porquetoLocaleStringpone punto de miles a partir de 1.000 h. Le pasaríauseGrouping: false. - BOM UTF-8 (
\uFEFF) al inicio, para que «Línea» no salga con caracteres rotos. - Saltos de línea
\r\ny escape de campos que contengan;,"o saltos de línea. Hoy no hace falta, pero cuesta tres líneas. - Cabecera
Línea;Horas de parada. La semana iría en el nombre del fichero (parte-semana-10.csv) y no en una fila, para que la tabla quede limpia.
Cómo probarlo
npm testcon casos nuevos. Deben comprobar el BOM y la cabecera, las filasL1;1,5yL2;2, el\r\n, el escape de un campo con;o"y el orden estable.- A mano:
node src/cli.js datos/paradas.csv --csv parte.csvy abrirlo en Excel. Hay que mirar que las tildes salgan bien y que las horas se alineen a la derecha como números. - Regresión:
npm run partedebe seguir dando la misma salida de texto.
Dos problemas en los datos que afectarán al CSV
P-104cruza la medianoche (23:30 → 01:15).horasEntredevuelve un valor negativo, así que L2 sale mal (unas −22 h en esa fila).P-106está duplicada endatos/paradas.csv, así que L3 suma 2,5 h de más.
Ninguno de los dos es parte de esta tarea, pero el CSV exportará esos números erróneos. ¿Los corrijo antes o lo dejamos para otra tarea?
Qué ha pasado
Un plan de calidad, y con detalles que muchos programadores olvidarían: separador ; y coma decimal para el Excel en español, la marca BOM para que las tildes salgan bien, sin separador de miles y saltos de línea \r\n. Además, no amplía el alcance por su cuenta: avisa de los dos fallos de los datos (la medianoche y el duplicado) y pregunta si los corrige antes o en otra tarea.
Lo que tú decides antes de aprobar: si aceptas el nombre de fichero con la semana, si te sobra el escape de campos «que hoy no hace falta» y qué hacer con los dos fallos. Para corregirlo, en una sesión interactiva pulsas Ctrl+G y editas el plan en tu editor.
Explorar, planificar, implementar y confirmar
La guía de buenas prácticas propone cuatro fases para cualquier cambio que no sea trivial:
- Explorar: en modo plan, Claude lee e investiga sin cambiar nada. Se activa con
Shift+Tabhasta ver el indicador de modo plan, o arrancando conclaude --permission-mode plan. - Planificar: le pides un plan con los ficheros, el flujo y los riesgos. Con
Ctrl+Glo abres en tu editor y lo corriges. - Implementar: apruebas el plan y Claude programa contrastando con él, con las pruebas.
- Confirmar: le pides el commit con un mensaje descriptivo y, si procede, la pull request.
Cuándo saltarse el plan: la guía da una regla clara: si puedes describir el cambio en una frase, sáltate el plan y pídelo directamente. Planificar compensa cuando no tienes claro el enfoque, el cambio toca varios ficheros o no conoces el código.
Peticiones con contexto específico
| Estrategia | Antes | Después |
|---|---|---|
| Acotar | «añade pruebas a parte.js» | «escribe una prueba para parte.js con una semana sin paradas; sin mocks» |
| Señalar la fuente | «¿por qué esta función es tan rara?» | «revisa el historial de Git de semanaIso y resume por qué quedó así» |
| Citar un patrón | «añade un parte mensual» | «sigue cómo está hecho el semanal en src/informes/semanal.js» |
| Describir el síntoma | «arregla las fechas» | «la parada P-104 sale con horas negativas; mira src/fechas.js, reprodúcelo con una prueba y arréglalo» |
Usa @ para citar ficheros (@src/fechas.js): Claude los lee antes de responder.
Practica
Clasifica ¿Modo plan o directamente?
- Corregir una errata en el título del parteCabe en una frase y en una línea de código.
- Exportar el parte a CSV, que toca el generador, el CLI y las pruebasVarios ficheros y decisiones de formato: conviene acordarlas antes.
- Renombrar una variable dentro de un ficheroEs un cambio acotado y fácil de revisar.
- Cambiar cómo se calcula la semana ISO en un código que no conocesNo conoces el código y el error tendría consecuencias: primero, entender.
- Añadir una línea de registro de errores en una función concretaEl diff se describe en una frase.
Laboratorio Convierte una petición vaga en una profesional
Reescribe la petición para un cambio real del repositorio de práctica o de tu proyecto.
- Pendiente: Describe el síntoma concreto
- Pendiente: Señala dónde mirar (fichero, carpeta o @)
- Pendiente: Pide reproducirlo con una prueba
- Pendiente: Dice cómo verificar el arreglo
- Pendiente: Pone un límite
- Empieza por el síntoma: qué sale mal, con un ejemplo concreto (la fila, el valor).
- Di dónde mirar con @ o la ruta, y pide primero una prueba que reproduzca el fallo.
- Cierra con cómo verificar y qué no tocar.
La parada P-104 (23:30 a 01:15) sale con -22,25 horas en el parte.
Mira @src/fechas.js.
Primero escribe una prueba que reproduzca el fallo y comprueba que falla.
Después arregla la causa y ejecuta npm test hasta que pase.
No cambies ni borres pruebas existentes.Comprueba lo que has aprendido
Comprueba En el plan real, Claude avisa de dos fallos de los datos y pregunta si los corrige. ¿Por qué es buena señal?
No. Justo lo contrario: te deja la decisión a ti.
No. La longitud no es el valor; la decisión que te deja a ti, sí.
Correcto. Corregirlos por su cuenta mezclaría dos tareas en un mismo cambio.
Comprueba El plan propone una dependencia nueva para algo que ya resuelve una existente. ¿Qué haces?
Correcto. Para eso sirve: cambiar el enfoque antes de que exista código.
No. Corregir un diff grande cuesta mucho más que una línea del plan.
No. Pierdes la investigación que ya ha hecho.
Comprueba ¿Qué cambio no necesita modo plan?
No. Toca varios ficheros: compensa planificar.
No. No conocer el código es motivo para explorar primero.
Correcto. Cabe en una frase: se pide directamente.
Entregable Tu cambio con plan
Elige un cambio de varios ficheros en el repositorio de práctica o en tu proyecto. Pídelo en modo plan, corrige el plan antes de aprobarlo y ejecútalo. Pega aquí tu petición, la corrección que hiciste al plan y por qué, y cómo verificaste el resultado.
Está bien si: la petición tiene síntoma o ámbito, fuente y límite; corregiste al menos una línea del plan y dices por qué; y el resultado pasó las pruebas. Tiempo: unos 30 minutos.
Lo esencial
- Explorar, planificar, implementar y confirmar: en modo plan, Claude investiga sin tocar nada.
- Corrige el plan antes de aprobarlo: es la revisión más barata que existe.
- Un buen plan no amplía el alcance: te pregunta.
- Si el cambio cabe en una frase, sáltate el plan.
- Peticiones con ámbito, fuente, patrón y síntoma, y con cómo verificar.
Fuentes y para seguir
- Buenas prácticas: explorar, planificar y programar (se abre en otra pestaña) (documentación oficial, consultada el 24/10/2026).
- Modos de permiso: modo plan (se abre en otra pestaña).
- Flujos de trabajo habituales (se abre en otra pestaña) (documentación oficial).
Lección revisada el 24/10/2026 con la documentación oficial enlazada en sus fuentes. Revisamos los cursos cada trimestre.