Empezar con Claude Code

3 min
Público
desarrollador curioso, principiante a intermedio
Duración
15 a 25 min
Módulo
1/5
Competencia objetivo
lanzar una primera sesión Claude Code en un proyecto real y encomendarle una pequeña tarea

En una imagen

En lugar de copiar y pegar código en una pestaña del navegador, piensa en un colega competente sentado a tu teclado. Abre tu proyecto, lee los archivos él mismo, escribe la corrección directamente en los sitios correctos, y luego espera a que mires por encima de su hombro antes de hacer cualquier cosa comprometedora. Claude Code es exactamente esa experiencia: Claude corriendo en tu terminal (o en tu IDE mediante una extensión) que manipula tus archivos reales, mientras tú observas y apruebas.

Cómo funciona

Una sesión Claude Code sigue siempre el mismo bucle: formulas una petición en lenguaje natural, Claude lee tu código para contextualizarse, propone un plan o un diff, tú apruebas (o rechazas), y luego la modificación se escribe en los archivos reales.

Lo que cambia respecto a un chatbot clásico:

  • Lectura real de los archivos — ya no hace falta pegar fragmentos; Claude abre directamente las rutas correctas de tu repositorio.
  • Edición in situ — los diffs se aplican en el disco, en el árbol que tu IDE ya vigila.
  • Ejecución de comandos — puede lanzar un pytest, un npm test o un git status según los permisos que le concedas (ver Módulo 2).

Algunas buenas costumbres de partida: ser preciso ("corrige el bug en login.py donde las contraseñas no se hashean" vale más que "corrige mi código"), enfocar un archivo o una carpeta en lugar de todo el proyecto mientras aprendes, y pedir una explicación cuando no entiendas por qué Claude ha tomado una decisión concreta.

Para probar ahora

  1. Abre una terminal en la carpeta de un proyecto de pruebas (o un scratch repo, no un proyecto crítico el primer día) y lanza claude.
  2. Escribe una petición pequeñísima y legible: "añade una función utilitaria que valide que una cadena es una dirección de correo RFC-5322 razonable, con una prueba unitaria".
  3. Observa la salida: Claude explica lo que va a leer, propone un diff, y suele esperar una confirmación antes de tocar el disco.
  4. Aprueba, y luego abre el archivo creado en tu editor para comprobarlo — la modificación real está ahí, no solo en el chat.
  5. Termina con git diff (o /status en algunas interfaces) para confirmar visualmente lo que se ha movido.

Para recordar

  • Claude Code lee y modifica tus archivos reales; no es un chatbot de solo lectura.
  • El bucle es petición → lectura → propuesta → aprobación → escritura.
  • Preciso + pequeño alcance + revisión = arranque sano.

Trampa que evitar

Soltar en la primera sesión "reescribe toda mi aplicación en TypeScript estricto" sobre un repositorio de producción. Claude Code puede hacerlo de verdad — y no entenderás los 400 archivos modificados de golpe. Empieza siempre con una tarea del tamaño de un solo commit revisable.

¿Entonces? Claude Code transforma «describe lo que quieres» en «modificaciones de código que puedes revisar». El camino más corto para familiarizarte es encomendarle hoy una pequeña tarea real en lugar de leer otro tutorial más.