curso-claude-code / Arranque / módulo 0
Claude Code · la biblia completa

Módulo 0 — Un empleado nuevo en tu terminal

Al terminar este módulo, vas a poder explicar con tus palabras qué es Claude Code, qué no es, y decidir si es para ti.

Este es el prólogo. Hoy no vas a tocar la computadora — es el único módulo así en todo el manual. Hoy solo hay una historia, y si la entiendes bien, todo lo demás se acomoda solo.

0.1 — El cuento del empleado

Imagina que mañana llega a tu negocio un empleado nuevo. Brillante de verdad: leyó medio internet, redacta mejor que tu mejor vendedor, hace cuentas sin calculadora, no se cansa y no se ofende. Pero es su PRIMER día. No conoce a tus clientes, no sabe cómo nombras tus carpetas, no sabe que "el pedido de la señora Estela" es sagrado. Todo lo tuyo, se lo tienes que decir tú.

🧠 ANALOGÍA CLAVE

Claude Code es ese empleado nuevo brillante: un genio con manos que trabaja en tu computadora. Genio, porque piensa de verdad. Con manos, porque no solo opina — HACE. Y "nuevo" porque llega en su primer día: lo que no le cuentes de tu negocio, no lo sabe. Todo este manual cuelga de esta idea.

¿De qué está hecho ese empleado? De tres piezas — y son las tres palabras técnicas de hoy:

Cerebro + manos + ciclo = un agente. Cuando escuches "agente de IA" — en las noticias, en este manual — es esto: una IA que no solo conversa, trabaja.

¿Y tú? Tú diriges. Le pides las cosas por escrito, en español normal — a ese pedido se le llama prompt — y él lo convierte en chamba hecha. No necesitas aprender su idioma; él ya habla el tuyo.

0.2 — Lo que NO es (léelo dos veces)

No es "ChatGPT en feo". Un chat te CONTESTA; un agente te HACE. Pídele a un chat "ayúdame con mis facturas revueltas" y te da consejos para ordenarlas. Pídeselo a Claude Code y al rato tienes la carpeta ordenada y un resumen de lo que encontró. Mismo tipo de cerebro, mundos distintos.

No es magia, y no es infalible. En los foros de usuarios veteranos se repite un dato incómodo: sin estructura ni dirección, más o menos la mitad de los intentos necesita retrabajo. Y hay algo peor que equivocarse: se equivoca CON confianza — puede decirte "quedó" muy seguro de sí mismo, y no quedó. Por eso este manual no te enseña a confiar: te enseña a dirigir y a comprobar. Una agencia de software europea lo resume en una frase que vas a ver cumplirse módulo tras módulo: "el harness (arnés) importa más que el modelo" — pesa más CÓMO lo diriges que qué tan listo es.

No es solo para programadores. El equipo LEGAL de Anthropic — abogados, no ingenieros — construyó con Claude Code su propia herramienta para canalizar consultas al abogado correcto. El equipo de marketing procesa archivos con cientos de anuncios y genera variaciones nuevas en minutos, donde antes se iban horas. La frase oficial de la propia empresa: "está disolviendo la frontera entre el trabajo técnico y el no técnico." Este manual está escrito para tu lado de esa frontera.

🪤 AQUÍ SE ATORA LA GENTE

Síntoma: "Yo no soy técnico. Esto ha de ser para ingenieros."

Causa: la pantalla negra intimida, y casi todos los cursos que existen hablan de código.

Salida: vuelve a leer el párrafo de arriba: los abogados de Anthropic ya lo usan sin programar. Tú no vas a escribir código en este manual — ni una línea. Vas a DIRIGIR, por escrito y en español. Eso ya lo sabes hacer.

0.3 — Por qué vive en la terminal (y no en una página bonita)

La terminal es esa ventana de puro texto que sale en las películas de hackers. Claude Code vive ahí, y no es capricho ni castigo: es logística.

🧠 ANALOGÍA CLAVE

La terminal es la oficina del empleado. Un chat en una página web es hablarle por teléfono: te oye, te contesta, pero no está donde están tus cosas. La terminal es sentarlo en el escritorio de junto — ahí están sus manos, tus archivos y tus programas. Se trabaja donde está el trabajo.

Un dato que tranquiliza (viene del FAQ oficial y lo profundizamos en el módulo 3): Claude Code trabaja EN tu computadora. Tus archivos se leen ahí, en tu máquina; al modelo solo viaja lo necesario para la tarea en turno — no anda subiendo tus carpetas completas a ningún lado. Y antes de tocar algo tuyo, te pregunta: el producto está diseñado para pedirte permiso antes de actuar. En el módulo 1 lo vas a vivir en carne propia.

0.4 — Cuándo NO usarlo (honesto y corto)

Tres casos donde la respuesta correcta es "todavía no" o "así no":

🪤 AQUÍ SE ATORA LA GENTE

Síntoma: "¿Y si se equivoca con algo MÍO? Mejor ni le muevo."

Causa: miedo razonable — ya vimos que puede equivocarse, y con mucha seguridad de sí mismo.

Salida: el manual está ordenado exactamente para eso: tu primera chamba real (módulo 1) es de PURA lectura — no mueve ni un archivo. El riesgo llega hasta que ya tienes red de seguridad para deshacer. No necesitas valor; necesitas orden, y el orden ya está puesto.

0.5 — El mapa del viaje

El manual son cinco arcos. Sin tecnicismos, esto es lo que vas a poder hacer al final de cada uno:

  1. Arranque (módulos 0-2): lo instalas, haces tu primera chamba real, y entiendes cómo piensa — por qué a veces "olvida" y qué hacer al respecto.
  2. Confianza (módulos 3-6): sabes qué pasa con tus datos y tu dinero sin letras chiquitas; trabajas a diario sin miedo — frenar, corregir, deshacer; dejas las reglas de TU negocio por escrito para no repetirlas; y eliges qué cerebro conviene para cada chamba.
  3. Superpoderes (módulos 7-9): le enseñas tus chambas repetitivas para que salgan a TU manera todas las veces; pones avisos y candados que se cumplen solos; y dejas de trabajar en solitario — varios agentes a la vez, tú de jefe.
  4. Correa larga (módulos 10-12): decides cuánta libertad darle y con qué protecciones; lo conectas a más sistemas de tu negocio; y le sueltas encargos que corren sin ti, con límites que tú pusiste.
  5. Cierre (módulos 13-14): el hábito que separa a los que le sacan jugo de los que se frustran — comprobar en lugar de confiar — y tu plan para aplicarlo en tu negocio desde el lunes.

Guarda este mapa. Cuando a media instalación te preguntes "¿para qué tanto lío?", la respuesta está en esta lista.

ASÍ LO USAMOS EN SPAI

🫘 ASÍ LO USAMOS EN SPAI

Alejandro, el fundador de SmartProcess AI, es artista de animación 3D. Programar lo derrotó — no una vez: cada vez que lo intentó. Su cabeza veía perfectamente qué construir; sus manos no hablaban ese idioma. Hoy dirige una agencia de software con IA, y su "empleado" es un agente con nombre propio — Neto —, con voz propia y con las reglas de la casa por escrito. Lleva más de un año dirigiéndolo a diario sin escribir código: Alejandro decide y aprueba; Neto teclea. Este manual es la prueba viviente de la tesis: lo produjo un no-programador dirigiendo agentes.

HAZLO TÚ — El organigrama de tu chamba

🔧 HAZLO TÚ

Qué vas a lograr: la lista de las 5 tareas que le vas a delegar primero a tu empleado nuevo. Este papel es el combustible de TODOS los ejercicios del manual — lo vas a usar en cada módulo.

Qué necesitas: papel y pluma, o las notas del teléfono. Hoy no se prende la computadora.

Pasos:

  1. Piensa en tu semana típica y anota 5 tareas repetitivas que hoy haces tú. Pistas para encontrarlas: pasan cada semana (o cada mes), no requieren tu criterio completo — requieren tu TIEMPO — y te dan flojera de solo pensarlas.
  2. Etiqueta cada una con UNA de estas cuatro categorías: archivos (ordenar, renombrar, buscar, depurar), reportes (juntar información y resumirla), contenido (redactar, adaptar, responder), análisis (comparar, revisar números, encontrar raro).
  3. Subraya la que más flojera te dé. Esa va a ser de las primeras en caer.

¿LO LOGRASTE?

  • Tienes 5 tareas escritas, cada una con su etiqueta.
  • Al menos una es de "archivos" o "reportes" — por ahí empezamos en el módulo 1.
  • Releíste la lista y pensaste "si esto se hiciera solo, mi semana cambia". Esa es la señal de que elegiste bien.
✓ ¿TE LO LLEVAS?
  1. ¿Cómo le explicarías a tu socia la diferencia entre un chat de IA y un agente, usando al empleado nuevo?
  2. De tus 5 tareas del organigrama, ¿cuál NO le darías todavía a Claude Code — y por qué?
  3. ¿Qué significa que el empleado "llegue cada vez en su primer día"? No sabes aún cómo se arregla — esa es, palabra por palabra, la pregunta que el resto del manual contesta.
📖 GLOSARIO

agente — un modelo de IA con manos (herramientas) que trabaja en ciclos hasta terminar el encargo.

modelo / IA — el cerebro entrenado que piensa; Claude es la familia de modelos de Anthropic.

herramienta (tool) — cada "mano" del agente: leer archivos, escribir, teclear comandos, buscar en internet.

terminal — la ventana de texto donde vive Claude Code: tú escribes, él trabaja.

prompt — lo que le pides por escrito.

🎓 CÓMO LO ENSEÑAS

La demo de 5 minutos: NO expliques nada primero. Proyecta una carpeta hecha un desastre (50 archivos revueltos), abre Claude Code en vivo y pídele en español que la analice y proponga cómo ordenarla. Deja que el grupo lo vea trabajar en pasos. Luego pregunta: "¿qué acaban de ver?" — y con sus respuestas construyes entre todos la definición de agente. La teoría después del asombro, nunca antes.

El error que el alumno VA a cometer: tratarlo como buscador — pedirle "consejos" e "ideas" en vez de encargarle la chamba. Capitalízalo: cuando alguien diga "pídele tips para ordenar archivos", contesta "no le pidas el consejo: pídele la chamba" y demuéstralo en vivo. Es EL clic mental del módulo.

La pregunta de arranque: "Si mañana llegara a tu negocio un empleado brillante que no sabe NADA de cómo trabajas tú, ¿qué le encargarías la primera semana — y qué todavía no?"


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