curso-claude-code / Cierre / módulo 13
Claude Code · la biblia completa

Módulo 13 — Maestría: el manual del usuario pro

Al terminar este módulo, vas a operar como profesional: el ciclo de élite, el hábito de la evidencia y tu checklist personal.

Hoy no aprendes nada nuevo. Ya tienes todas las piezas: la mesa, la constitución, los puestos, las recetas, los reflejos, tu equipo de empleados, los candados y la correa. Lo que falta no es una herramienta más — es ordenar lo que ya sabes en un solo modo de trabajar. Este módulo es la cosecha.

Y hay una sola idea que amarra todo el manual. La guía oficial de mejores prácticas de Anthropic la dice en una línea: "Claude's context window fills up fast, and performance degrades as it fills" — la mesa se llena rápido, y entre más llena, peor trabaja. ¿Te acuerdas de la mesa del módulo 2? Casi todas las prácticas de los profesionales — las oficiales y las que la comunidad descubrió a golpes — son maneras distintas de cuidar esa mesa y de no creerle nada sin comprobarlo. De eso se trata ser pro.

13.1 — El ciclo de élite: explorar → planear → ejecutar → verificar → foto

La guía oficial lo llama Explore → Plan → Implement → Commit. La casa le agrega el paso que separa a los que entregan de los que prometen: verificar antes de guardar la foto. Cinco pasos, todos los conoces ya — aquí solo se forman en fila:

1. Explorar. Antes de pedir, deja que Claude LEA. Que te diga qué hay en la carpeta, cómo están los datos, qué encontró — tú no dictas a ciegas y él no inventa. Dos afinaciones de pro: si la investigación es larga, despáchala a un subagente — ¿te acuerdas? — otro empleado con su mesa limpia que te regresa el resumen, no su desorden (módulo 9). Y ponle límite al paseo: "explora SOLO la carpeta de facturas" — la exploración sin frontera es uno de los cinco patrones de falla con nombre de la guía oficial (infinite exploration: investigar sin alcance hasta llenar la mesa).

2. Planear. Para encargos gordos: plan mode (módulo 4), y no aceptes el primer plan por cortesía — corrígelo, recórtalo, hazlo tuyo. Boris Cherny, el creador de Claude Code, lo cuantifica así: ir y venir sobre el plan antes de ejecutar "easily 2-3x's results for harder tasks" — fácilmente duplica o triplica el resultado en tareas difíciles. Y la jugada fina para proyectos grandes: pídele que ÉL te entreviste ("hazme las preguntas que necesites antes de proponer el plan") y que aterrice lo acordado en un archivo de especificación — Claude hace las preguntas técnicas, tú solo contestas de tu negocio.

El matiz oficial que nadie cuenta: el plan es para lo incierto y lo grande. Textual de la guía: "If you could describe the diff in one sentence, skip the plan" — si puedes describir el cambio en una frase, sáltate el plan. Corregir un teléfono en un documento no amerita junta de consejo.

3. Ejecutar. Una tarea a la vez, en pedazos chicos — la comunidad tiene una regla de dedo: nunca pidas de un jalón más de lo que a una persona le tomaría media hora hacer. Sé incómodamente explícito ("be uncomfortably explicit", dice un usuario veterano): contexto + objetivo + cómo se ve "quedó bien". Y alimenta con material rico: señala archivos con @, pega screenshots, pega el error completo — dirigir bien es dar buenos insumos.

4. Verificar. El paso que este manual te viene sembrando desde el módulo 4 y que aquí se corona (la sección 13.2 es toda para él). El punto #1 de la guía oficial de mejores prácticas es exactamente este: dale a Claude una forma de comprobar su propio trabajo, y pídele la comprobación, no el "ya quedó". Boris Cherny otra vez: darle verificación es "another 2-3x" — otro salto de dos a tres veces en la calidad. El mismo consejo, dos veces, del creador del producto: planear y verificar son donde se gana el partido.

5. Foto. Cierras guardando: checkpoint o commit con etiqueta (tu máquina del tiempo del módulo 4). La comunidad lo repite en todos los tonos: commits frecuentes en cada hito son tu red real — si la siguiente chamba sale mal, regresas a la última foto buena en vez de llorar sobre archivos rotos.

🪤 AQUÍ SE ATORA LA GENTE

Síntoma: "Ese ciclo es mucha ceremonia — yo nada más quiero cambiar una palabra en un documento."

Causa: aplicar el protocolo completo a chambas de una frase. El ciclo es para lo gordo, no para el mandado.

Salida: usa el matiz oficial: si puedes describir el cambio en UNA frase, pídelo directo y verifica el resultado — dos pasos, no cinco. El ciclo completo se reserva para lo que toca muchos archivos, lo que no sabes cómo se hace, o lo que duele si sale mal.

13.2 — Evidencia, no promesas: el hábito que separa pros de turistas

Los foros están llenos de la misma queja, con las mismas palabras: "code contains bugs despite confident claims of correctness" — Claude afirma con toda seguridad que quedó, y no quedó. La guía oficial le puso nombre al hoyo: trust-then-verify gap — el resultado se ve plausible, tú confías, y el detalle roto aparece una semana después. Y remata con la regla que deberías tatuarte: "If you can't verify it, don't ship it" — si no lo puedes verificar, no lo entregues.

🧠 ANALOGÍA CLAVE

Pedir evidencia, no promesas. Lo vienes haciendo desde el módulo 4 sin ponerle nombre; hoy se vuelve tu hábito de jefe. A un empleado nuevo no le aceptas "ya quedó, jefe" — le dices "enséñamelo": ábreme el archivo, corre el reporte, muéstrame la pantalla. Con Claude es igual, con la ventaja de que enseñarte la evidencia le cuesta tres segundos y cero orgullo.

Frases listas para tu repertorio — cópialas tal cual:

La última frase tiene historia en la casa. La constitución de SmartProcess obliga al agente a etiquetar cada afirmación en una de tres: verificado (lo probé), inferido (se deduce de X) o hipótesis (suena bien, sin evidencia aún) — y "jamás te vendo la tercera como la primera". No necesitas implementar el sistema completo: necesitas la pregunta. Cuando Claude te afirme algo que importa, pregúntale de cuál de las tres es. La respuesta honesta te dice cuánto pesa la afirmación — y pedirla te convierte en el tipo de jefe al que no se le cuelan promesas disfrazadas de hechos.

⚠️ REGLA QUE NUNCA DEBES OLVIDAR

Si no lo puedes verificar, no lo entregues. Antes de dar una chamba por cerrada — tuya o de Claude — responde: ¿QUÉ evidencia tengo de que quedó? Si la respuesta es "me dijo que sí", no tienes evidencia: tienes una promesa.

🪤 AQUÍ SE ATORA LA GENTE

Síntoma: "Le pido evidencia y me suelta un párrafo explicando por qué SÍ debería funcionar."

Causa: pediste comprobación y te dio argumento. Explicar no es verificar.

Salida: exige el acto, no el razonamiento: "no me expliques por qué funciona — CÓRRELO y pégame lo que salga, tal cual". Si el resultado corrido no existe o da error, acabas de ahorrarte descubrirlo el viernes a las 6.

🚀 NIVEL PRO

Si esto te suena a chino, bríncatelo: no lo necesitas para seguir. La guía oficial describe el patrón Writer/Reviewer: una sesión escribe el trabajo y OTRA sesión —con mesa limpia, sin el cariño del que lo hizo— lo revisa como auditor externo. Es el Perito de la casa en versión de a pie: abres una segunda sesión (o despachas un subagente revisor) con el encargo "revisa esto buscando qué está mal, no qué está bien". Para volumen, la misma guía documenta correr claude -p en modo headless sobre listas de archivos con herramientas restringidas (--allowedTools) — el módulo 12 te dio esas llaves.

13.3 — La economía del pro (y cuándo NO usar Claude Code)

¿Te acuerdas de la pregunta de los foros: "¿por qué se pone tonto después de horas?"? Ya sabes la respuesta: la mesa. La economía del pro empieza ahí:

Y el cierre del par que te acompaña desde el módulo 1: la renta y el taxímetro. La pregunta del pro no es "¿cuánto cuesta Claude?" — eso ya lo decidiste al elegir plan (módulo 3). Es "¿cuánto vale ESTA chamba?": antes de arrancar algo gordo, ponle presupuesto de tiempo y de consumo ("esto vale 40 minutos y una sesión"), y al cerrar, /cost te dice si saliste tablas. Con renta el límite es tu cuota de uso; con taxímetro son pesos — en ambos, la disciplina es la misma: chamba con presupuesto no se desborda.

Cuándo NO usar Claude Code. En el módulo 0 te prometí esta lista completa; con todo el manual encima, ya la puedes leer como operador y no como acto de fe:

  1. La decisión que firma un humano. Contratos, diagnósticos, despidos, precios: Claude prepara el expediente como nadie — la firma es tuya. En la casa es ley: dinero y publicación los decide el humano, siempre.
  2. Datos rojos sin política. Si todavía no decides tu regla del semáforo (módulo 3) para nómina, salud o datos de clientes, primero decide — la herramienta no sustituye la política.
  3. Lo irreversible sin gate humano. Borrar en masa, mandar correos, cobrar, publicar: jamás dentro de un flujo automático sin tu firma en medio (módulos 10 y 12).
  4. La tarea de dos clics. Abrir un archivo y corregir una palabra: hacerlo tú tarda menos que explicarlo. Delegar también cuesta.
  5. Lo que no puedes verificar. Si no existe manera de comprobar que quedó bien — ni comando, ni archivo, ni ojo experto disponible — no lo sueltes ahí. La regla de oro de arriba aplica doble.
  6. Lo que requiere TU criterio de negocio. A quién contratar, qué cliente aceptar, cuánto arriesgar: Claude informa la decisión con datos y escenarios; tomarla es tu chamba, no la suya.

Un dato honesto para calibrar expectativas: usuarios veteranos reportan que SIN estructura — sin constitución, sin ciclo, sin verificación — la tasa de éxito ronda el 50%, y la mitad mala cuesta más limpiarla que hacer el trabajo a mano. Con estructura, la historia cambia por completo. La estructura es todo lo que este manual te dio.

13.4 — Los 10 errores de novato (y en qué módulo se cura cada uno)

Detrás de casi toda queja de principiante en los foros viven tres preguntas: "¿por qué se pone tonto?" (mesa llena), "¿por qué rompió lo que ya jalaba?" (sin fotos) y "¿por qué dice que quedó y no jala?" (sin verificación). Estos son los diez errores concretos, cosechados de las listas de la comunidad y de los patrones de falla oficiales — con su síntoma, su antídoto y el módulo donde ya lo curaste:

  1. Pedirle todo en un solo prompt. Síntoma: encargo de diez cosas, resultado revuelto que no sirve para ninguna. Antídoto: pedazos de media hora, una tarea a la vez. (Se cura en M4.)
  2. Ser vago. Síntoma: "mejóralo" produce cambios aleatorios que nadie pidió. Antídoto: incómodamente explícito — contexto, objetivo y cómo se ve "quedó bien". (M4.)
  3. Trabajar sin constitución. Síntoma: cada sesión le repites quién eres y cómo trabajas; los resultados salen sin tu estilo. Antídoto: CLAUDE.md — y consuelo de élite: el propio creador de Claude Code confiesa que agrega cosas al suyo "varias veces por semana". (M5.)
  4. El documento-basurero. Síntoma: tiene constitución de 400 líneas y Claude ignora justo las reglas importantes. Antídoto: podar con el test oficial de una línea: "¿quitar esto haría que se equivocara? Si no, fuera" — la advertencia oficial es textual: un CLAUDE.md inflado hace que Claude ignore tus instrucciones reales. (M5.)
  5. La sesión bote-de-basura (kitchen sink session — la nombraste en el módulo 4). Síntoma: facturas, luego el post de Instagram, luego un contrato — todo en la misma sesión, y a las dos horas "se puso tonto". Antídoto: /clear entre chambas que no se tocan; decisiones importantes a un archivo antes de limpiar. (M2 y M4.)
  6. Corregir sobre corregido (correcting over and over). Síntoma: seis intentos fallidos apilados en la misma conversación — la comunidad le dice "the death spiral". Antídoto: la regla de las dos correcciones y sesión nueva con mejor prompt. (M2 y M4.)
  7. Creerle el "ya quedó". Síntoma: lo confiado del tono te convenció; el lunes no jalaba nada. Antídoto: evidencia, no promesas — el hábito de este módulo. (M13 — aquí mismo.)
  8. Trabajar sin fotos. Síntoma: algo se rompió y no hay a dónde regresar; adiós tarde de viernes. Antídoto: checkpoint antes de tocar en masa, commit en cada hito. (M4.)
  9. Esconderle el error. Síntoma: "no jala" — sin pegar el mensaje de error, sin screenshot, sin decir qué esperabas. Antídoto: pega el error COMPLETO y la pantalla; Claude lee stack traces mejor que tú y que yo. (M4.)
  10. Pelearle en vez de dirigirlo. Síntoma: frustración, gritos al monitor, borrar todo y empezar de cero a cada rato. Antídoto: el primer intento es un borrador de tu empleado nuevo, no la entrega final — se dirige con ajustes, no con demoliciones. (M0 — y todo el manual.)

Si reconociste tres o más tuyos: felicidades por la honestidad — ahora ya saben dónde vive su cura.

13.5 — El checklist del usuario pro

Media página. Imprímela, pégala junto al monitor — o mejor: pídele a Claude que te la deje en checklist-pro.md con tus ajustes. Es la cosecha del manual entero en formato de casilla:

Antes de arrancar la chamba

Al pedir

Durante

Al cerrar

Y un último dato para que no camines solo: el directorio comunitario más grande de recursos de Claude Code (awesome-claude-code) rebasa las 49 mil estrellas en GitHub. Ser usuario pro también es esto: saber que hay una comunidad enorme puliendo las mismas mañas que tú.

ASÍ LO USAMOS EN SPAI

🫘 ASÍ LO USAMOS EN SPAI

El no-negociable #3 de la constitución de la casa, textual: "No declaro éxito sin probar. No le digo que algo jala hasta probarlo de verdad. Si falló, se lo digo con el output crudo." No es un consejo del agente hacia el humano — es una LEY que el humano le impuso al agente por escrito, después de aprenderla a la mala. Y el mismo principio a escala de proyecto se llama la Brújula: en la agencia, ningún proyecto serio nace sin sus 6 documentos de plan — el "planear antes de construir" del ciclo de élite, institucionalizado. Todo lo que este módulo te enseñó como hábito personal, en SmartProcess está escrito como regla de operación.

HAZLO TÚ — El examen sin examen

🔧 HAZLO TÚ

Qué vas a lograr: una chamba real tuya, de punta a punta, con el ciclo completo y presupuesto — la prueba de que ya no eres turista. Nadie te la califica: la evidencia habla sola.

Qué necesitas: tu organigrama del módulo 0 (aquel papel con tus 5 tareas repetitivas) y una carpeta de trabajo con máquina del tiempo activa (M4). Sin seeds: hoy es TU chamba de verdad.

Pasos:

  1. Elige la pieza. Del organigrama de M0, la tarea que sigas debiendo (el reporte mensual es la clásica). Escríbete el presupuesto en un papel: "esta chamba vale ___ minutos y una sesión".
  2. Explora. Sesión nueva (/clear) parado en la carpeta correcta. Antes de pedir nada: "lee esta carpeta y dime qué hay, qué está incompleto y qué te llama la atención — no cambies nada todavía".
  3. Planea. Plan mode. Pídele el plan, recórtale lo que sobre, exígele que te pregunte lo que le falte saber. Apruébalo hasta que sea TU plan.
  4. Ejecuta. Checkpoint primero. Luego el plan, una pieza a la vez — con @archivo y material concreto, no de memoria.
  5. Verifica. Antes de aceptar el "terminé": pide la evidencia — el archivo abierto, el número comparado contra la fuente, el comando corrido con su resultado pegado tal cual. Al menos UNA comprobación la haces tú con tus ojos.
  6. Foto y cuenta. Pídele la foto final ("haz commit con la etiqueta reporte-listo") y corre el taxímetro:
👀 LO QUE VAS A VER

Teclea (o pega) esto (dentro de Claude Code):

/cost

Vas a ver algo así (cuenta de API — cita oficial):

Total cost: $0.55
Total duration (API): 6m 19.7s

o así (con suscripción Pro/Max/Team):

Session      ████████░░░░░░  52% used · resets 6:00pm
Weekly       ███░░░░░░░░░░░  23% used

Qué significa: el consumo de ESTA sesión — el formato exacto varía según tu plan. Con API, es un costo real en dólares. Con suscripción (Pro/Max/Team), la documentación oficial es tajante: "el número de costo de sesión no es relevante para tu facturación" — ya pagaste tu renta; lo que ves son barras de tu plan, no un cobro. Lo que importa hoy no es el número: es compararlo contra el presupuesto que TÚ escribiste en el paso 1.

Si en vez de eso ves que no reconoce el comando: estás en la terminal normal, no dentro de Claude Code — abre claude primero; /cost (o su nombre moderno, /usage) vive adentro.

¿LO LOGRASTE?

  • El entregable existe y lo verificaste con evidencia (archivo abierto, números comparados) — no con un "ya quedó".
  • Hubo plan aprobado ANTES de ejecutar, y foto (checkpoint/commit) al cerrar.
  • El /cost final quedó dentro del presupuesto que te pusiste — y si no, sabes exactamente en qué paso se fue.

Si marcaste las tres: eso era el examen. No hubo calificación porque los pros no coleccionan diplomas — coleccionan chambas entregadas con evidencia.

✓ ¿TE LO LLEVAS?
  1. De los cinco pasos del ciclo, ¿cuál te has estado saltando más — y qué te ha costado ya ese brinco?
  2. ¿Cómo le pedirías evidencia a Claude en tu chamba de la semana, con tus palabras? Escribe las dos frases que de verdad usarías.
  3. ¿Cuál de las 6 situaciones de "cuándo NO usar Claude Code" es la más tentadora de violar en tu negocio?
📖 GLOSARIO

verificación / evidencia — pedir el resultado corrido (el archivo, el comando con su output, el número comparado), no la promesa de que quedó.

ciclo de élite (explorar→planear→ejecutar→verificar→foto) — el orden de trabajo de los profesionales con agentes; el plan se salta solo cuando el cambio cabe en una frase.

🎓 CÓMO LO ENSEÑAS

La demo de 5 minutos: el engaño en vivo. Pídele a Claude una chamba con truco (un resumen de datos con un error sembrado por ti), deja que declare éxito, y pregúntale al grupo: "¿le creemos?". Luego pide la evidencia frente a todos y deja que el error aparezca solo. Nadie que vea ESO vuelve a aceptar un "ya quedó" a secas.

El error que el alumno VA a cometer: en el examen sin examen, saltarse el paso 5 e irse directo a la foto — porque el resultado "se ve bien". Déjalo pasar y pídele en frío: "¿qué evidencia tienes?". El silencio incómodo enseña más que tu slide.

La pregunta de arranque: "De las últimas 10 cosas que Claude (o cualquier persona) te dijo que ya estaban listas… ¿cuántas comprobaste? — hoy salimos siendo del otro tipo de jefe."


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