Claude Code para principiantes

Ruta Claude Code

Esta misma academia está construida con esta herramienta. Claude Code es un asistente de IA que trabaja dentro de tu editor: lee tu proyecto, escribe y edita archivos, y ejecuta comandos por ti — siempre bajo tu supervisión. No sustituye lo aprendido en las otras rutas, lo acelera.

Lección 1 — Qué es Claude Code y cómo instalarlo en VS Code

Claude Code es un asistente de programación con IA que se ejecuta dentro de tu propio proyecto: puede leer tus archivos, proponer y escribir código, ejecutar comandos en la terminal y explicarte lo que hace, todo en lenguaje natural. No es autocompletado — le puedes pedir una tarea entera ("crea una página de contacto con un formulario") y te propone cómo hacerla.

Necesitas dos cosas antes de empezar: VS Code ya instalado (ruta anterior) y una cuenta en claude.com.

La forma más sencilla de instalarlo es como extensión de VS Code:

  1. Abre VS Code y pulsa el icono de Extensiones en la barra de actividades.
  2. Busca "Claude Code" (de Anthropic) e instálala.
  3. Se abrirá un panel lateral nuevo. La primera vez te pedirá iniciar sesión con tu cuenta de Claude — sigue el proceso en el navegador que se abre solo.
  4. Abre la carpeta de tu proyecto en VS Code (igual que en la lección de interfaz de la ruta VS Code) antes de empezar a pedirle nada — Claude Code trabaja sobre esa carpeta.
panel de Claude Code
Crea un archivo index.html con un título "Hola mundo"
y un párrafo debajo que diga "Mi primera página con ayuda de IA".

Al pedirle algo así, Claude Code no cambia tus archivos a ciegas: te muestra exactamente qué va a crear o modificar (como un diff, en verde lo que añade) y te pide confirmación antes de tocar nada. Tú decides si aceptar, pedir un cambio, o rechazarlo.

También puedes usarlo sin VS Code, directamente en una terminal — es la misma herramienta por debajo, sin panel gráfico de por medio. Útil si trabajas contra un servidor remoto por SSH (como en la ruta Servidor) o simplemente prefieres la terminal.

terminal
npm install -g @anthropic-ai/claude-code
cd tu-carpeta-de-proyecto
claude

Necesita Node.js instalado. El comando claude arranca una sesión interactiva en la carpeta donde estés — igual de conversación, mismo diff antes de aceptar. La extensión de VS Code no es más que una capa visual sobre este mismo CLI.

🔒 Regla de oro: lee siempre lo que va a hacer antes de aceptar, sobre todo si te propone ejecutar un comando en la terminal. Es una herramienta muy potente y normalmente fiable, pero la responsabilidad final de lo que se ejecuta en tu ordenador es tuya — igual que con cualquier código que copies de internet sin entenderlo.
💡 Pruébalo tú mismo: instala la extensión, abre una carpeta vacía en VS Code y pégale el prompt del ejemplo de arriba en el panel de Claude Code. Revisa el archivo que propone, acéptalo y ábrelo en el navegador — acabas de completar tu primer encargo a una IA dentro de tu propio editor.

Lección 2 — Cómo pedir cambios concretos

En la lección 1 le pediste crear un archivo desde cero — el caso más fácil. La mayoría de encargos reales son sobre código que ya existe, y ahí la calidad del resultado depende sobre todo de cómo pidas el cambio. Un prompt vago da un resultado vago; uno concreto da un resultado concreto.

Tres cosas que marcan la diferencia en cualquier instrucción:

  • Nombra el archivo o la zona exacta — "cambia el color del botón" es ambiguo si hay diez botones; "cambia el color del botón .btn-primary en estilos.css" no lo es.
  • Describe el resultado, no solo la acción — no solo "añade validación al formulario", sino qué debe pasar si el email está vacío o mal escrito.
  • Da una pista de por qué, cuando la haya — "el título no debe superar 60 caracteres, es para SEO" evita que el asistente elija un límite al azar.
panel de Claude Code
Vago:
"Mejora el formulario de contacto"

Concreto:
"En contacto/index.html, añade validación al campo email:
si está vacío o no tiene forma de email, muestra un mensaje
de error en rojo debajo del campo y no dejes enviar el formulario."

Cuando la tarea es grande, no hace falta metértela entera de golpe: puedes pedirla por pasos, revisando cada uno antes de seguir. Es más lento al principio, pero mucho más fácil de corregir si algo se tuerce, porque el error queda acotado a un paso concreto en vez de mezclado con todo lo demás.

panel de Claude Code
Paso 1: "Añade el campo de teléfono al formulario, sin validación todavía"
   → revisas, aceptas

Paso 2: "Ahora añade validación: solo números, mínimo 9 dígitos"
   → revisas, aceptas

Si no estás seguro de si el asistente ha entendido bien lo que quieres, pídele que te lo explique antes de tocar nada — es una instrucción tan válida como cualquier otra, y sirve para detectar un malentendido antes de que se convierta en código.

panel de Claude Code
Antes de cambiar nada, explícame en dos frases
qué vas a hacer y qué archivos vas a tocar.
💡 Pruébalo tú mismo: coge cualquier archivo que ya tengas y pídele primero un cambio vago ("mejora esto"), fíjate en qué decide por su cuenta. Deshaz el cambio y pide lo mismo pero de forma concreta, nombrando el archivo y el resultado exacto que quieres. Compara los dos resultados — se nota.

Lección 3 — Revisar y aceptar cambios con seguridad

En las lecciones 1 y 2 ya viste que Claude Code no toca ningún archivo sin mostrarte antes qué va a hacer. Esta lección es sobre esa pantalla intermedia: qué mirar exactamente antes de pulsar "aceptar", porque ahí es donde de verdad decides tú, no la IA.

Cuando propone cambiar un archivo, verás un diff — el mismo formato que ya conoces de Git (ruta VS Code, lección 4): en rojo lo que se borra, en verde lo que se añade. Antes de aceptar, comprueba tres cosas rápidas:

  • ¿Toca solo lo que pediste? — si le pediste cambiar un color y el diff incluye líneas sueltas en otra función o archivo, pregunta por qué antes de aceptar.
  • ¿Borra algo que no esperabas? — una línea en rojo que no tiene relación con tu petición es la señal más clara de que algo se ha entendido mal.
  • ¿Vas a poder deshacerlo si algo falla? — si el archivo está en Git (lección 4 de la ruta VS Code) y tienes commits recientes, siempre puedes volver atrás. Si no está versionado, piénsatelo dos veces antes de aceptar un cambio grande de golpe.
diff propuesto
  <h1>Bienvenido</h1>
- <p>Precio: 10€</p>
+ <p>Precio: 12€</p>
+ <script src="analytics.js"></script>

# Pediste cambiar el precio. La línea del <script>
# no tiene nada que ver — pregunta antes de aceptar.

No hace falta aceptar todo el diff de golpe si el editor te deja revisar por partes — y si no te convence nada, la respuesta correcta no es aceptar "total, seguro que está bien", sino escribir qué está mal y dejar que lo corrija. Es exactamente el mismo criterio de la lección 2: cuanto más concreto seas al rechazar, mejor sale el segundo intento.

panel de Claude Code
No aceptes esto. Solo pedí cambiar el precio a 12€;
quita la línea del <script> de analytics, no la pedí.

El otro caso a vigilar es cuando te propone ejecutar un comando en la terminal, no solo editar un archivo — por ejemplo, instalar algo, borrar archivos o conectarse a un servidor. Ahí el riesgo ya no es "una línea de código rara", es una acción real sobre tu ordenador o, peor, sobre un servidor en producción. La misma regla de oro de la lección 1 se aplica con más fuerza todavía: lee el comando entero antes de aceptar, y si no entiendes qué hace alguna parte, pregúntaselo primero a la propia IA — es una pregunta válida, no una pérdida de tiempo.

🔒 Señales para decir que no, siempre: un comando que borra archivos o carpetas (rm, sobre todo con -rf), cualquier cosa que toque un servidor de producción sin que lo hayas pedido tú explícitamente, o un cambio "de paso" que no tiene relación con lo que pediste. Ante la duda, pide que te lo explique antes — no cuesta nada y evita la mayoría de los sustos.
💡 Pruébalo tú mismo: pídele un cambio sencillo sobre un archivo que ya tengas versionado con Git. Antes de aceptar el diff, revísalo línea a línea con las tres preguntas de arriba. Acéptalo, y luego usa el panel de Control de versiones (ruta VS Code, lección 4) para ver exactamente qué cambió — comprobar dos veces por dos caminos distintos es buena costumbre, no desconfianza.

Lección 4 — Automatizar tareas repetitivas

La lección 2 iba de pedir un cambio concreto. Pero a veces el mismo cambio hay que hacerlo muchas veces seguidas: la misma corrección en diez archivos, el mismo ajuste en cada producto de una lista. Pedirlo uno a uno es lento y es fácil que a la décima vez se te olvide algún detalle. La alternativa es describir la regla una sola vez y dejar que se aplique sola a todos los casos:

panel de Claude Code
Añade loading="lazy" a todas las etiquetas <img>
de los archivos .html que hay dentro de la carpeta galeria/.
No toques ninguna imagen que ya lo tenga.

La parte que marca la diferencia es el alcance: decir exactamente qué archivos entran ("dentro de la carpeta galeria/") y qué hacer con los casos que no encajan del todo ("no toques las que ya lo tengan"). Un alcance impreciso — "pon esto en todas las imágenes" sin más — puede acabar tocando archivos que no querías, o dejando fuera alguno que sí.

Para una tarea de varios pasos que solo vas a hacer una vez (no repetida, pero sí con partes encadenadas), funciona igual de bien describirla como una lista numerada en un único mensaje, en vez de ir pidiendo paso a paso:

panel de Claude Code
1. Crea un archivo nuevo productos/zapatillas.html
   copiando la estructura de productos/camiseta.html.
2. Cambia el título y la descripción para unas zapatillas.
3. Añade el enlace a esa página nueva en el índice,
   index.html, junto a los demás productos.

Con una tarea así, de varios archivos a la vez, el diff que verás antes de aceptar también será más largo — y por eso la lección 3 importa todavía más aquí: revisa cada archivo que haya cambiado, no solo el primero. Cuantos más sitios toca una petición, más vale asegurarse de que cada uno hace exactamente lo que pediste.

💡 Pruébalo tú mismo: crea tres archivos de prueba casi idénticos (por ejemplo, copiando el mismo párrafo tres veces) y pídele en un solo mensaje que cambie la misma palabra en los tres. Revisa el diff de cada archivo por separado antes de aceptar — comprueba que ha tocado exactamente los tres y nada más.

Lección 5 — Deshacer cambios y volver atrás sin miedo

Tarde o temprano aceptarás un cambio y, al verlo con más calma, decidirás que no era lo que querías. Es normal, y no pasa nada: siempre hay manera de volver atrás. La más directa es pedírselo a la propia IA, describiendo qué quieres recuperar:

panel de Claude Code
Deshaz el último cambio que hiciste en index.html.
Quiero el archivo tal y como estaba antes, sin el banner
que acabas de añadir.

Esto funciona bien para cambios recientes y sencillos, pero ten presente que la IA está rehaciendo el archivo a partir de lo que recuerda de la conversación, no aplicando un "deshacer" mecánico como Ctrl+Z. Si el archivo está versionado con Git (ruta VS Code, lección 4), tienes una forma de volver atrás mucho más exacta: Git guarda el contenido real de cada versión, así que recuperarlo no depende de que nadie "se acuerde" de cómo era.

terminal
git diff index.html
# te enseña exactamente qué ha cambiado desde el último commit

git checkout -- index.html
# descarta esos cambios y deja el archivo como estaba
# en el último commit — solo funciona si aún no has
# hecho commit del cambio que quieres deshacer

Por eso en la lección 3 ya salía la recomendación de tener commits recientes antes de aceptar un cambio grande: con un commit de por medio, "volver atrás" es un comando de un segundo. Sin él, dependes de que la IA reconstruya el archivo de memoria — funciona casi siempre para cambios pequeños y recientes, pero no es una red de seguridad tan sólida como un commit.

💡 Pruébalo tú mismo: en un archivo versionado con Git, haz un commit primero, luego pídele un cambio y acéptalo. Ejecuta git diff archivo para ver qué cambió, y después git checkout -- archivo para volver a como estaba. Comprueba que el archivo ha recuperado exactamente el contenido anterior.