Qué es Claude Code y cómo funciona

Antes de instalar nada, esta lección te da el modelo mental. Es lo que separa a quien usa Claude Code con criterio de quien suelta prompts y reza. Cuando termines, sabrás exactamente qué es la herramienta, qué pasa por dentro cuando le pides algo, y por qué funciona igual en el terminal que en tu IDE.

Empecemos por un ejemplo

Imagina que abres Claude Code en tu proyecto y escribes:

"El formulario de login no valida que el email tenga formato correcto. Añade la validación y un test."

Esto es, más o menos, lo que ocurre:

1. Busca dónde está el formulario (grep por "login", abre LoginForm.tsx).
2. Lee el componente y el archivo de tests que ya existe al lado.
3. Propone un diff: añade la validación y un caso de test nuevo. Te lo enseña y espera tu OK.
4. Aceptas. Ejecuta npm test.
5. Un test falla porque el mensaje de error no coincide. Claude lo ve, ajusta el código y vuelve a correr los tests.
6. Pasan. Te avisa de que está hecho.

Fíjate en lo que no ha pasado: no te ha devuelto un bloque de código para que lo copies y pegues. Ha trabajado dentro de tu repo, ha ejecutado comandos reales y ha reaccionado a lo que veía. Eso es un agente, y es la diferencia de fondo.

Qué es (y qué no es)

Claude Code es un agente de programación que lee tu repo, escribe ficheros, ejecuta comandos, ve los errores y vuelve a intentarlo. No es un chat con autocompletado: es un proceso largo al que le das un objetivo y gestiona el camino.

La distinción frente a otras herramientas que quizá ya uses:

Cómo funciona por dentro: el agent loop

Vuelve al ejemplo del login. Lo que hiciste fue dar un objetivo; lo que Claude hizo fue recorrer un bucle una y otra vez hasta cumplirlo:

1. Piensa cuál es el siguiente paso para acercarse al objetivo.
2. Usa una herramienta: leer un fichero, buscar en el repo, escribir un cambio, correr un comando.
3. Observa el resultado: el contenido del fichero, la salida del test, el mensaje de error.
4. Repite hasta terminar o hasta que necesita preguntarte algo.

Mapeado al ejemplo: pasos 1-2 fueron pensar + usar herramienta (buscar y leer); el paso 5 —el test que falla y se corrige— es el bucle en estado puro: observó el fallo y volvió a la casilla "pensar".

Por eso se dice que Claude Code "se equivoca y se da cuenta": no es que no falle, es que ve el fallo en el paso 3 y corrige en la siguiente vuelta. Las herramientas son sus manos —leer, editar, ejecutar, buscar— y tú decides cuáles puede usar sin pedir permiso (eso lo configuras en el siguiente curso).

La consecuencia práctica: tu habilidad clave no es escribir prompts mágicos. Es dar un objetivo claro, un entorno donde pueda fallar sin romper nada importante, y revisar lo que produce.

Multi-superficie: un mismo motor en todas partes

Claude Code no es "una cosa del terminal". Es el mismo agente corriendo en cuatro superficies:

• Terminal — el CLI, donde la mayoría empieza.
• IDE — extensiones para VS Code y JetBrains.
• Desktop — app de escritorio.
• Web — en el navegador.

La clave: es el mismo motor y comparte tu configuración. Tu CLAUDE.md, tus permisos y tus servidores MCP funcionan igual en cualquiera de ellas. Aprendes el modelo mental una vez y eliges la superficie según el momento —el terminal para iterar rápido, el IDE para ver los diffs junto al código— sin reaprender nada.

Los tres hábitos que lo cambian todo

El ejemplo del login salió bien porque el listón estaba bien puesto. Estos son los tres hábitos que lo hacen posible, y que iremos construyendo en el curso:

1. Objetivo concreto. "Añade validación de email al login y un test" funciona. "Mejora el proyecto" no: el agente no sabe cuándo ha terminado.
2. Contexto curado. El repo entero no es la ventana de contexto. Tú decides qué mira; cuanto más ruido, peor trabaja.
3. Revisar el diff. El agente propone, tú apruebas. Aceptar a ciegas solo cambia a quién culpar cuando algo se rompe.

Tú conduces, el agente ejecuta. Esa frase resume todo el curso.

Errores típicos al empezar

• Tratarlo como un buscador. Le preguntas en vez de darle una tarea. Dale algo que hacer, no algo que explicar.
• Pedir tres cosas a la vez. "Refactoriza, añade tests y arregla los lints" produce un mejunje. Una tarea, ciérrala, siguiente.
• No leer el diff. Es el único paso que no puedes delegar.

Qué llevas hasta aquí

• Claude Code es un agente: trabaja en tu repo, no te devuelve texto para copiar.
• Funciona en bucle (pensar → herramienta → observar → repetir); por eso detecta y corrige sus errores.
• Es el mismo motor en terminal, IDE, desktop y web, con tu misma config.

Antes de la siguiente lección

Ten listo:

• Node.js 20+ (node --version) si vas a usar el CLI.
• Una cuenta de Anthropic (Claude Pro/Team o API con créditos).
• Un repo tuyo abierto. Ni juguetes ni forks. Tu repo.

En la siguiente lección instalamos y cerramos juntos tu primera tarea real, como la del login.

Fuente oficial: Overview · How Claude Code works