Cómo aprender Claude Code desde cero, en español (la guía práctica para empezar)

Escuchaste hablar de Claude Code, viste a alguien programar "hablándole" a un agente de IA desde la terminal y pensaste: quiero aprender a hacer eso. Bien. Pero antes de buscar el comando mágico, conviene entender algo que casi nadie te dice: Claude Code no se aprende como una herramienta, se aprende como una forma de trabajar. Y esa forma de trabajar es lo que de verdad se te queda.

En esta guía te explico qué es en realidad, cuál es el cambio de mentalidad que hay que hacer y un método concreto para tu primera sesión. Al final tienes un ejercicio que puedes ejecutar aquí mismo para practicar la habilidad que más importa.

Qué es Claude Code (y qué no es)

Claude Code es un agente de IA que trabaja junto a ti dentro de tu proyecto: lee tus archivos, propone cambios, escribe código y ejecuta tareas mientras tú le das la dirección. No es un buscador que te devuelve un fragmento suelto para copiar y pegar; es más parecido a tener a alguien programando a tu lado, al que le explicas qué quieres y luego revisas lo que hizo.

Ese matiz cambia todo. Con un buscador, la habilidad clave es encontrar. Con un agente, la habilidad clave es describir bien y verificar mejor. Si aprendes solo a pedir cosas y no a comprobar el resultado, no estás programando con IA: estás confiando a ciegas. Y eso, tarde o temprano, se paga.

El cambio de mentalidad: de escribir a dirigir

Cuando programas solo, tú escribes cada línea. Cuando programas con un agente, tu trabajo se corre un escalón hacia arriba: dejas de teclear cada detalle y pasas a decidir qué se hace, revisar cómo se hizo y corregir el rumbo. Es un rol más parecido al de quien dirige que al de quien ejecuta.

Esto no te hace prescindible; te hace más responsable. El agente puede escribir cien líneas en segundos, pero no sabe qué es "correcto" para tu proyecto: eso lo sabes tú. Por eso aprender Claude Code de verdad no es memorizar sus comandos (que además cambian), sino entrenar tres cosas que no caducan: describir con precisión, leer código ajeno y verificar que funciona.

El método para tu primera sesión, en 4 pasos

Sirve para tu primer arreglo de un bug y para una función entera. Es siempre el mismo ciclo:

1. Describe el resultado, no los pasos. Dile qué quieres lograr y con qué restricciones ("agrega una función que valide emails y no acepte los que no tengan @"), no cómo teclearlo.
2. Deja que trabaje y lee el diff. El agente propone cambios. Antes de aceptar, lee lo que cambió. Este es el paso que la mayoría se salta, y es el más importante.
3. Verifica ejecutando. No basta con que "se vea bien". Córrelo con un caso normal y con un caso raro. Si falla, ya sabes qué pedir después.
4. Itera con precisión. En lugar de "no funciona", dile exactamente qué caso falla y qué esperabas. Cuanto más concreto tu feedback, mejor la siguiente versión.

Fíjate que tres de los cuatro pasos son tuyos, no del agente. Ahí vive tu valor.

Un ejemplo real: no confíes, verifica

Nada de teoría abstracta. Imagina que le pediste al agente una función que te diga si una contraseña es "fuerte" (al menos 8 caracteres). Te devuelve esto, y se ve perfectamente razonable. Tu trabajo no es aceptarlo: es probarlo.

Ejecuta el código tal como está y mira los resultados. ¿Están todos bien? Hay un caso, justo en el borde, donde la función se equivoca. Encuéntralo cambiando los ejemplos, y después arréglalo tú (pista: mira el >).

¿Lo viste? Pediste "al menos 8 caracteres", pero la función usa > en vez de >=, así que una contraseña de exactamente 8 la rechaza. El agente escribió algo casi correcto, y "casi correcto" en código es un bug esperando a aparecer. Cámbialo a >=, vuelve a ejecutar y comprueba que ahora la de 8 caracteres pasa.

Esa mirada —leer el código, encontrar el caso del borde, corregirlo— es la habilidad central de trabajar con un agente. No la aprendes leyendo sobre Claude Code: la aprendes ejecutando y equivocándote, como acabas de hacer.

Cómo aprenderlo de verdad (y que se te quede)

Ver tutoriales de Claude Code te da la sensación de que ya sabes. Programar con él te da la habilidad. La diferencia entre las dos cosas es la práctica que se corrige sola: escribir, ejecutar, ver qué falla y volver a intentar hasta que salga.

En Resumate Club aprendes tecnología haciéndola, no mirándola. El curso Claude Code: programa junto a un agente de IA está pensado con ese ciclo: pequeños retos donde describes, revisas diffs de verdad y verificas resultados, con un validador que comprueba tu trabajo al instante. Y no es una academia de una sola herramienta: es una plataforma amplia —Python, lógica, bases de datos, IA, ciberseguridad— para que lo que aprendas se sostenga cuando la herramienta de moda cambie.

Si de este artículo te llevas una sola idea, que sea esta: con un agente, tu valor no está en escribir más rápido, sino en verificar mejor. Entrénalo, y Claude Code deja de ser magia para volverse una herramienta que dominas.

← Volver al blog