curso-claude-code / Confianza / módulo 4
Claude Code · la biblia completa

Módulo 4 — La jornada: trabajar con Claude todos los días

Al terminar este módulo, vas a trabajar una jornada completa con Claude Code: pedir bien, aprobar planes, frenar, deshacer y no perder nada nunca.

Ya conociste al empleado (módulo 0), le abriste la oficina (módulo 1), entendiste cómo piensa (módulo 2) y sabes qué pasa con tus datos y tu dinero (módulo 3). Hoy juntamos todo eso en una jornada de trabajo completa: cómo le pides bien las cosas, cómo apruebas antes de que actúe en grande, cómo frenas a media tarea, y — lo que te va a quitar el último miedo — cómo deshacer CUALQUIER cosa que haga, sin drama.

4.1 — Cómo pedirle bien la chamba

Todo pedido que sale bien trae tres piezas: contexto (qué tiene enfrente, dónde está), objetivo (qué quieres lograr) y criterio de "quedó bien" (cómo vas a saber que ya). Sin las tres, tu empleado nuevo improvisa — y a veces improvisa bien, pero no es apuesta que quieras hacer con tu chamba de verdad.

Compara:

El segundo no es más largo por presumir: cada frase le ahorra a Claude una pregunta que, si no la sabe, va a tener que adivinar — y adivinar mal te cuesta más tiempo del que ahorraste escribiendo rápido.

Un consejo de quien construyó el producto, dicho tal cual en un foro de programadores (el principio aplica igual si tú no programas ni tantito): "sé incómodamente explícito." Y otro, de usuarios veteranos: no le pidas de un jalón más de lo que a una persona le tomaría media hora de trabajo — trocéalo. Pedirle "reorganiza todo mi negocio" en un solo mensaje es la versión moderna de "hazme todo": la documentación oficial hasta le puso nombre a este error — lo llama la sesión bote-de-basura (kitchen sink session): mezclas tres pendientes distintos de un jalón, y el resultado sale tan revuelto como entró.

Una tarea a la vez, con las tres piezas puestas, y te va a ir bien casi siempre.

4.2 — Modo plan: primero propón, no toques nada

Para chambas grandes, o cuando no estás 100% segura de cómo la quieres, hay una marcha extra: el modo plan. Le pides la chamba y, en vez de empezar a mover cosas, Claude te contesta con un PLAN por escrito — qué va a hacer, en qué orden — y espera tu luz verde antes de tocar un solo archivo.

👀 LO QUE VAS A VER

Teclea (o pega) esto dentro de Claude Code:

Shift+Tab

(pulsa la combinación hasta que la etiqueta de abajo de la pantalla diga "plan mode")

Vas a ver que el indicador de modo, abajo en pantalla, cambia a algo así:

⏸ plan mode on (shift+tab to cycle)

Qué significa: todo lo que pidas de aquí en adelante lo va a INVESTIGAR y proponer, no ejecutar. Al final te entrega el plan y pregunta si lo apruebas.

Si en vez de eso ves que sigue haciendo cambios directo: revisa la etiqueta del modo — quizás el Shift+Tab no registró; vuelve a intentar.

[CAPTURA: m04-plan-mode — Claude proponiendo un plan antes de tocar archivos]

Pide la chamba grande, lee el plan con calma (corrígelo si algo no cuadra — "sí, pero no toques los PDF" es una corrección válida) y solo entonces dile que adelante. Boris Cherny, uno de los creadores de Claude Code, lo dice sin medias tintas: usar el modo plan "fácilmente multiplica 2 o 3 veces los resultados en tareas difíciles." El propio manual oficial también te ahorra el trámite en lo chiquito: "si puedes describir el cambio en una sola frase, sáltate el plan" — es para lo grande e incierto, no para pedir un resumen de un correo.

4.3 — El volante: cómo diriges a media tarea

Ya sabes frenar en seco (Esc, desde el módulo 1). Con estos tres apuntas y navegas sin salir de la conversación:

👀 LO QUE VAS A VER

Teclea (o pega) esto:

@cotizacion_cliente_garcia_v3.docx revisa esta versión, ¿está completa?

Vas a ver algo así:

[archivo referenciado: cotizacion_cliente_garcia_v3.docx]
Sí, esta versión incluye...

Qué significa: Claude leyó ESE archivo puntual antes de contestar — no tuvo que adivinar cuál de las tres versiones querías decir.

Si en vez de eso ves una lista de sugerencias al escribir @: mejor — es autocompletado; elige de la lista con las flechas y Enter.

Y una sorpresa para tu primera semana: puede VER imágenes. Pega un screenshot directo en el mensaje (Cmd+V en Mac, Ctrl+V en Windows) — una captura de un error, la foto de un documento en papel, el diseño de un cliente — y Claude lo analiza como parte de tu pedido. No necesitas describir lo que se ve: enséñaselo.

4.4 — Higiene de sesiones: nombrar, retomar, limpiar

Ya conoces /clear (mesa nueva) y /compact (resumir sin perder el hilo) desde el módulo 2. Para una jornada completa te faltan dos hábitos.

Ponle nombre a lo que vas a retomar. Si una sesión es de las que vas a seguir mañana — un proyecto, no una pregunta de 30 segundos — nómbrala:

👀 LO QUE VAS A VER

Teclea (o pega) esto:

/rename la-gran-limpieza

Vas a ver algo así:

✔ Session renamed to "la-gran-limpieza"

Qué significa: esta conversación ya no es "la de ayer a las 4" — es "la-gran-limpieza", y la vas a encontrar por nombre.

Si en vez de eso ves que el nombre no aparece luego: revisa que lo tecleaste ANTES de cerrar la sesión, no después.

Y para volver a ella:

👀 LO QUE VAS A VER

Teclea (o pega) esto (dentro de Claude Code, parada en la misma carpeta):

/resume

Vas a ver algo así:

❯ la-gran-limpieza          hace 2 horas
  inventario-descargas      ayer
  (sesión sin nombre)       hace 3 días

Qué significa: un picker con tus sesiones recientes de esta carpeta. Elige con flechas y Enter, y sigues exactamente donde la dejaste, con toda la memoria de esa conversación.

Si en vez de eso ves la lista vacía: estás parada en otra carpeta — /resume retoma sesiones DE la carpeta donde estás.

Regla simple para el resto de tu jornada: chamba nueva → /clear. Misma chamba, mesa llena → /compact. Chamba que vas a retomar mañana → nómbrala.

🚀 NIVEL PRO

Si esto te suena a chino, bríncatelo: no lo necesitas para seguir. Existen además /branch, que abre una RAMA de la conversación actual — un experimento en paralelo que no toca la sesión original — y /export, que saca toda la conversación a un archivo de texto plano por si la quieres archivar o mandarla a alguien. Ninguno es indispensable para tu jornada normal; están ahí cuando los necesites.

4.5 — La máquina del tiempo: fotos a las que siempre puedes volver

Aquí está la pieza que faltaba para soltarte de verdad — y no es casualidad que llegue justo antes de tu primer HAZLO TÚ que sí toca archivos reales de tu compu. Hasta hoy, todo lo que hiciste en este manual fue leer. Se acaba la excusa: mientras Claude trabaja, va dejando fotos del estado de tu carpeta — se llaman checkpoints. No necesitas saber cómo las guarda por dentro; necesitas saber DOS cosas: que existen, y cómo pedirlas de vuelta.

🧠 ANALOGÍA CLAVE

La máquina del tiempo. Cada tanto, mientras trabaja, tu empleado deja una foto de cómo estaba tu carpeta en ese momento — un checkpoint. Si algo sale mal, no hay que reconstruir a mano ni entrar en pánico: le pides que te regrese a la foto de antes, tal como le pedirías a una máquina del tiempo "llévame a las 4 de la tarde, antes de que la regara". No es magia de programador — es una función del producto, y la pides en español.

La manera más simple de usarla es de palabra: le dices "regrésame a como estaba antes de X" y Claude ubica la foto correcta. Si prefieres el atajo directo, existe un comando dedicado:

👀 LO QUE VAS A VER

Teclea (o pega) esto — o presiona Esc dos veces, con el campo de escribir VACÍO:

/rewind

Vas a ver algo así (estructura tomada de la doc oficial; la pantalla exacta la cotejamos en la prueba humana):

❯ "mueve las cotizaciones viejas a anteriores/"   hace 2 min
  "crea las subcarpetas por cliente"              hace 5 min
  "haz un checkpoint: antes de la gran limpieza"  hace 12 min

  (y al elegir un punto, el menú de acciones:)
❯ Restaurar código y conversación
  Restaurar solo la conversación
  Restaurar solo el código

Qué significa: la lista son los mensajes que TÚ mandaste — cada uno dejó su foto automática. Eliges el punto y luego QUÉ regresar: los archivos, la plática, o ambos. Lo hecho después de esa foto, se deshace.

Si en vez de eso ves que el doble-Esc te borró lo que estabas escribiendo: así se comporta con texto en el campo (tu texto queda en el historial — flecha arriba lo recupera). Escribe /rewind directo y listo. Y si prefieres cero comandos: "deshaz lo último que hiciste", en español, siempre funciona.

[CAPTURA: m04-rewind — el picker de /rewind mostrando las fotos disponibles]

Y para las fotos que TÚ quieres dejar marcadas a propósito — no automáticas, con tu propia etiqueta — pídele: "guarda un checkpoint aquí, con el nombre 'antes de la gran limpieza'". A esa foto etiquetada a propósito se le llama, en la jerga de estas máquinas, un commit — una palabra que vas a seguir viendo y que jamás necesitas escribir a mano: se la pides a Claude en español.

La letra chica que un pro sí se sabe (viene tal cual de la doc oficial): las fotos automáticas del /rewind rastrean lo que Claude EDITA dentro de los archivos — pero NO lo que se mueve o se borra con comandos de terminal. Un archivo que se movió de carpeta no "regresa" con rewind. Por eso la gran limpieza de abajo lleva DOBLE red: el commit etiquetado del inicio (esa foto sí aguanta movimientos y borrados — es la máquina del tiempo permanente), y para deshacer un movimiento puntual, se lo pides en español — "regresa los archivos que moviste" — y Claude los regresa él mismo. La doc lo resume bonito: el rewind es el "deshacer local"; el commit es la historia permanente.

⚠️ REGLA QUE NUNCA DEBES OLVIDAR

Antes de cualquier chamba que toque MUCHOS archivos a la vez, pide un checkpoint primero. Es una frase — "haz un checkpoint antes de esto" — y te compra la tranquilidad de saber que, pase lo que pase, hay una foto de regreso.

🪤 AQUÍ SE ATORA LA GENTE

Síntoma: "Le pedí la chamba en modo plan y no hizo nada — ¿se descompuso?"

Causa: sigues en modo plan (4.2): a propósito no toca nada hasta que apruebes.

Salida: revisa la etiqueta del modo abajo en pantalla. Si el plan te convence, apruébalo (Enter o "adelante"); si quieres salir del modo plan, Shift+Tab de nuevo.

🪤 AQUÍ SE ATORA LA GENTE

Síntoma: "Ya sé que existe el deshacer y aun así me da miedo usarlo."

Causa: nunca lo has probado a propósito — solo te lo imaginas en una emergencia real, y ahí sí da nervios.

Salida: ensáyalo hoy, sin emergencia de por medio (está en tu HAZLO TÚ de abajo): deshaz algo chiquito a propósito, comprueba que sí regresó, y vuelve a hacerlo. El miedo se quita usando la máquina en frío, no leyendo que existe.

ASÍ LO USAMOS EN SPAI

🫘 ASÍ LO USAMOS EN SPAI

Dos leyes de la casa son, en el fondo, estas mismas herramientas ya convertidas en hábito diario. "Propongo, él aprueba": en SmartProcess, antes de tocar algo que cuesta o que es difícil de deshacer, el agente propone primero — exactamente lo que acabas de aprender a pedir con el modo plan. Y "todo siempre respaldado": la regla de la casa es que "nunca hay trabajo sin respaldar" — la versión profesional, todo el tiempo, de dejar checkpoints antes de tocar en masa. La tranquilidad de un no-programador dirigiendo agentes todos los días no viene de tenerle miedo al teclado — viene de que SIEMPRE hay una foto de regreso.

HAZLO TÚ — La gran limpieza

🔧 HAZLO TÚ

Qué vas a lograr: ordenar de verdad una carpeta revuelta — con plan aprobado, checkpoint de por medio, y un /rewind que ensayas a propósito para perderle el miedo para siempre. Si en tu organigrama del módulo 0 marcaste una tarea de "archivos", hoy es ese día: esta es esa tarea, hecha en serio.

Qué necesitas: tu carpeta de Descargas real (si ya te animas) o el seed ejercicios/m04/carpeta-desordenada/ — más de 50 archivos revueltos de un negocio ficticio (CVs, fotos, cotizaciones con varias versiones, un backup viejo, hasta un audio de junta) para practicar sin arriesgar nada tuyo. Si trabajaste el inventario del módulo 1, ábrelo — es tu mapa de dónde está cada cosa.

Pasos:

  1. Copia el seed a ~/Curso-Claude/carpeta-desordenada (o párate en tu Descargas real, si ya te sientes lista) y abre Claude Code ahí.
  2. Pide el checkpoint primero — la regla de oro de este módulo, en acción: "antes de tocar nada, deja un checkpoint con el nombre 'antes de la gran limpieza'."
  3. Entra a modo plan (Shift+Tab) y pide el criterio de orden completo: agrupar por cliente, quedarte solo con la versión más reciente de cada cotización visible (las viejas a una subcarpeta "anteriores", nunca borradas), separar fotos de documentos, y un resumen al final.
  4. Lee el plan. Si algo no te gusta, corrígelo ahí mismo — es gratis corregir un plan, cuesta corregir un desorden ya hecho. Cuando esté bien, aprueba.
  5. Deja que ejecute. Cuando termine, ábrete la carpeta y compara contra el resumen que te dio.
  6. Ahora el ensayo a propósito, en DOS sabores (cada uno prueba una red distinta): (a) pídele EN ESPAÑOL "regresa las cotizaciones viejas a donde estaban" — comprueba que volvieron (los movimientos los deshace él; el rewind no los ve) — y luego que las vuelva a acomodar; (b) abre /rewind (o doble-Esc), mira tus fotos listadas, y restaura SOLO el código a antes de que escribiera el resumen — comprueba que el archivo del resumen desapareció, y vuelve a pedirle que lo rehaga.

¿LO LOGRASTE?

  • Existe un checkpoint con nombre ANTES de que se moviera un solo archivo.
  • La carpeta quedó ordenada según TU criterio aprobado en el plan — y nada se perdió (las versiones viejas siguen ahí, solo movidas).
  • Probaste los DOS deshacer a propósito — movimientos en español y ediciones con /rewind — viste ambos funcionar, y los rehiciste sin drama.
✓ ¿TE LO LLEVAS?
  1. ¿En qué momento de TU semana usarías el modo plan en vez de pedir la chamba directo?
  2. ¿Qué le dirías a un colega que te dice "no uso Claude para nada importante, me da miedo que rompa algo"?
  3. Nombra una sesión que ya llevas varios días retomando sin nombre — ¿qué /rename le pondrías HOY?
📖 GLOSARIO

plan mode — modo "primero propón el plan, no toques nada"; se activa y se cicla con Shift+Tab.

checkpoint — foto del estado de tu carpeta a la que puedes regresar.

git / repositorio — el mecanismo detrás de la máquina del tiempo de una carpeta de trabajo; no necesitas saber usarlo, solo que existe.

commit — una foto guardada a propósito, con su etiqueta.

/rewind — el menú para regresar en el tiempo (doble-Esc también lo abre): restaura archivos editados, la conversación, o ambos. Lo movido/borrado con comandos no lo ve — eso se deshace pidiéndolo en español, o con el commit.

@archivo / !comando / # — señalar un archivo puntual · mandar una línea directo a la terminal · apuntar algo a la memoria del agente.

🎓 CÓMO LO ENSEÑAS

La demo de 5 minutos: en vivo, pide una chamba mediana en modo plan sobre una carpeta desordenada del grupo (o el seed), deja que el plan salga en pantalla, pide que alguien del público lo apruebe o lo corrija en voz alta, ejecuta, y CIERRA deshaciendo una parte con /rewind frente a todos. Ver el "deshacer" funcionar de verdad vale más que cualquier promesa de que "es seguro".

El error que el alumno VA a cometer: aprobar el plan sin leerlo (el reflejo de "sí, sí, dale" de cualquier cuadro de diálogo). Provócalo a propósito: mete un plan con un detalle mal puesto y pregunta "¿alguien lo notó?" — nadie, la primera vez. Es la lección: leer el plan es el trabajo, no un trámite.

La pregunta de arranque: "¿Qué tendría que pasar para que confiaras en deshacer CUALQUIER cosa que hiciste en tu compu? Hoy esa función ya existe, y la vamos a probar a propósito, sin que nada esté en riesgo."


Verificado contra documentación oficial el 2026-07-12.