Clase 0. Instalar Claude Code — Puede que lo que usas no sea Claude Code

Consejo clave — Con saber esto, ya puedes dar instrucciones

Una línea de verificación es todo lo que necesitas.

Escribe lo siguiente en la terminal.

claude --version

Si aparece un número de versión como 2.1.x — es el verdadero Claude Code. Todo el curso, de la Clase 1 a la 11, funcionará sin problemas.

Si dice que no encuentra el comando, o si lo que estás usando ahora mismo es el chat dentro de Cursor, Antigravity o Windsurf — eso no es Claude Code. Aunque use el mismo modelo Claude, es un programa distinto. El modo autónomo de este curso no funciona en ese entorno.

La frase que debes recordar:

Agente ≠ Modelo. Aunque uses el mismo Opus, si el programa que lo ejecuta es distinto, las capacidades son distintas.

Instalación en una línea (Mac / Ubuntu / WSL):

curl -fsSL https://claude.ai/install.sh | bash

Los usuarios de Windows necesitan WSL o Docker primero. Se explica en el cuerpo del texto a continuación.

Prueba rápida

Haz la misma tarea en los dos entornos y comprueba con tus propios ojos la diferencia entre CLI e IDE. Toma 3 minutos.

En Claude Code (CLI):

“Crea un hello.py en una carpeta vacía. Pon a propósito un error de sintaxis, ejecútalo para confirmar el error, luego corrígelo tú solo y ejecútalo de nuevo. Hasta que aparezca ‘Hello’.”

El Claude Code CLI — crea el archivo, lo ejecuta directamente, lee el error, lo corrige y vuelve a ejecutar. No te pregunta en cada paso. El bucle autónomo funciona solo.

Si introduces la misma frase en el chat de extensión IDE (el chat de Cursor/Antigravity/Windsurf) — propone el código, pero tú tienes que pulsar el botón para ejecutarlo, copiar y pegar el error de nuevo, y esperar aprobación en cada paso. El bucle debe pasar por una persona para cerrarse.

Esta diferencia es todo lo que hay que saber en la Clase 0. Y todo el curso está diseñado asumiendo el primero.

Por qué debes dar instrucciones de esta manera

Probablemente ya hayas “construido algo con Claude Code”. Viste un tutorial en YouTube, le hablaste al chat y viste que salía código.

Pero quiero hacerte una pregunta. ¿Lo que usaste, era realmente Claude Code?

Si esta pregunta te parece trivial, escucha lo que pasa en los onboardings reales.

Agente ≠ Modelo

Un usuario pidió ayuda porque la app que había construido con vibe coding se había roto. Dijo que estaba “desarrollando con Claude Code”. Estuvo perdido durante días. No funcionaba lo que le indicaban, la IA le preguntaba “¿qué prefieres, la opción A, B o C?” en cada bifurcación y no avanzaba.

La causa no era su juicio. Lo que estaba usando era el chat Claude dentro del IDE Antigravity. No era el Claude Code CLI. Ambos usan el modelo Claude Opus. El modelo es el mismo. Pero el resultado era completamente distinto.

¿Por qué? Porque aunque el modelo sea el mismo, el agente es distinto.

• Modelo (Model): El cerebro, como Opus o Sonnet. La capacidad en sí de leer y escribir.
• Agente (Agent): El programa que hace funcionar ese cerebro. Qué prompt de sistema le da, qué herramientas le pone en la mano (leer/escribir archivos, ejecutar comandos), hasta dónde actúa solo sin aprobación humana — todo lo determina el agente.

Aunque sea el mismo caballo (modelo), si lo sueltas libre en el campo sin riendas o si le pones silla y arreos con un jinete encima, los lugares a los que puede ir son distintos. El agente es precisamente esa silla y esos arreos — el dispositivo que permite poner las riendas (reins). (Volveremos a esto en la Clase 5.)

Por qué no vale cualquier agente — por qué hace falta este nivel

Los agentes tienen niveles. Y el nivel que exige este curso (Clases 1–11) se distingue por un solo criterio.

El núcleo de este curso es una frase:

La IA escribe el código, la máquina verifica, y tú solo confirmas si ha pasado.

Para que esto funcione, la IA debe ejecutar las herramientas de verificación por sí sola y leer el resultado para decidir el siguiente paso. El bucle de ejecutar yongol validate, leer el error, corregir y volver a ejecutar — si una persona tiene que mediar en cada paso, eso no es autonomía, es trabajo.

Bucle autónomo posible:
  IA ejecuta validate → lee error → corrige → vuelve a validate → pasa → siguiente
  (0 intervenciones humanas)

Persona mediando en cada paso:
  IA: "Ejecuta validate así" → persona copia y ejecuta →
  persona copia el resultado → lo pega a la IA → IA propone corrección → persona ejecuta de nuevo...

Clase 3 Hurl, Clase 4 yongol, Clase 6 tsma, Clase 8 filefunc — todas son herramientas CLI. Solo tiene sentido si la IA las ejecuta de forma autónoma. Con un agente que no pueda hacer ese bucle, la mitad de este curso no funciona.

Así que el criterio de “agente insuficiente” no es la marca, sino esta única pregunta:

¿Este agente ejecuta yongol validate / hurl / tsma por sí solo, lee el resultado y decide el siguiente paso? ¿O tengo que copiar y aprobar yo en cada paso?

• Si es lo primero — es un agente al que se le pueden poner riendas. (El Claude Code CLI encaja aquí.)
• Si es lo segundo — es un agente insuficiente. Por inteligente que sea el modelo, este curso se bloquea.

Atención: “IDE = siempre no” no es lo que se dice aquí. Hay cosas como el modo agente de Cursor o Windsurf que ejecutan comandos de forma autónoma y hacen bucles. Por el contrario, el modo chat simple dentro del mismo producto requiere una persona en cada paso. No juzgues por el nombre del producto, juzga por el criterio de arriba. Lo que bloqueaba en los onboardings reales tampoco era “es un IDE”, sino que el modo chat que se usaba no podía hacer el bucle CLI de forma autónoma.

Por eso la Clase 0 es la puerta de entrada del curso. Si eliges mal la herramienta, las once clases siguientes son todas mentira.

La trampa de YouTube

El problema es este. La mayoría de los tutoriales de vibe coding en YouTube y comunidades no distinguen entre el agente que hace el bucle autónomo y el modo chat simple, y llaman a ambos “Claude Code”.

Así que un principiante no tiene forma de saber la diferencia. Le habla al chat creyendo que está “usando Claude Code”. Y culpa a su propia habilidad cuando las cosas no salen como en el tutorial.

No. Es que eligió mal la herramienta. Más exactamente, YouTube le indicó mal la herramienta. Con solo tener un criterio — “¿ejecuta el CLI por sí solo?” — no caerás en esta trampa.

Instalar Claude Code

Este curso se basa en un entorno Ubuntu (o WSL). La mayoría de los comandos también funcionan para usuarios de Mac.

Requisitos previos

1. Cuenta Anthropic: Regístrate en https://console.anthropic.com
2. Plan de suscripción: Elige entre Claude Pro ($20/mes) o Max ($100/mes o $200/mes). Max tiene límites de uso más generosos
3. Ubuntu / Mac / WSL o Docker: Los usuarios de Windows eligen una de las dos opciones a continuación

Mac · Ubuntu · dentro de WSL — Instalación nativa (recomendada)

El método más sencillo, no requiere Node.js.

curl -fsSL https://claude.ai/install.sh | bash

Verifica tras la instalación.

claude --version

Si aparece un número de versión como 2.1.x, ha sido un éxito.

Windows opción A: WSL (recomendada)

Abre Windows PowerShell como administrador y ejecuta lo siguiente.

wsl --install

Esta sola línea se encarga de activar WSL, descargar el kernel de Linux e instalar Ubuntu. Tras reiniciar, Ubuntu se abre automáticamente y te pide un nombre de usuario y contraseña. Ingresa un nombre corto en minúsculas.

Nota: Todo el trabajo futuro se hace dentro de la terminal de Ubuntu. Instalar Claude Code desde PowerShell o CMD dará el error “Windows is not supported”.

A continuación ejecuta la línea de instalación nativa de arriba dentro de Ubuntu.

Consejo para WSL: Mantén siempre los proyectos en el sistema de archivos de Linux (/home/usuario/). Ponerlos en el lado de Windows (/mnt/c/) hace que la lectura de archivos sea extremadamente lenta.

Windows opción B: Docker (si WSL no funciona)

Si por política de empresa o problemas de entorno WSL no es viable, levanta un contenedor Linux con Docker y usa Claude Code dentro de él.

# Desde la carpeta del proyecto, levantar contenedor ubuntu y montar la carpeta actual
docker run -it -v "$(pwd)":/work -w /work ubuntu:24.04 bash

# Dentro del contenedor
apt update && apt install -y curl
curl -fsSL https://claude.ai/install.sh | bash
claude --version

-v "$(pwd)":/work conecta tu carpeta de proyecto a /work dentro del contenedor. Lo que trabajes dentro del contenedor queda directamente en tu carpeta.

Método complementario: Instalar vía npm

Este método es para quienes ya tienen experiencia con Node.js. Si eres nuevo, usa la instalación nativa de arriba.

# Instalar nvm y luego Node.js LTS
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install --lts

# Instalar Claude Code
npm install -g @anthropic-ai/claude-code

Nota: No uses sudo npm install -g. Causa problemas de permisos y riesgos de seguridad.

Primera ejecución y autenticación

# Ve a la carpeta del proyecto (créala si no existe)
mkdir -p ~/projects/my-first-app
cd ~/projects/my-first-app

# Ejecuta Claude Code
claude

En la primera ejecución, se abre el navegador pidiendo iniciar sesión en Anthropic. Una vez que inicias sesión, la autenticación se completa y se conecta automáticamente a partir de entonces.

Lista de verificación de instalación

Si estos tres puntos están marcados, estás listo para pasar a la Clase 1.

• ¿claude --version muestra el número de versión 2.1.x?
• ¿Ejecutar claude muestra el prompt (ventana de conversación)?
• ¿La autenticación está completa mediante el inicio de sesión en el navegador?
• En la prueba rápida de arriba, ¿la IA por sí sola creó el archivo, lo ejecutó y lo corrigió? (¿Sin pedir aprobación en cada paso?)

El último punto es el más importante. Si la IA ejecutó comandos por su cuenta y corrigió el error sola — estás usando el verdadero Claude Code.

Las extensiones IDE solo como complemento

No se dice que Cursor, Antigravity o Windsurf sean malas herramientas. Son excelentes para revisar el código línea a línea con los ojos. Para un programador son buenas herramientas.

Pero el modo autónomo de este curso se hace desde el CLI. Las extensiones IDE úsalas como ventana auxiliar para revisar el código, y delega el bucle de “construir, verificar y bloquear” al Claude Code CLI. Úsalos juntos, pero con los roles bien separados.

Ejercicio: Verificar que es el verdadero

Objetivo: Confirmar que lo que uso es el Claude Code CLI y hacer girar el bucle autónomo una vez.

Paso 1 — Verificar instalación

claude --version

Comprueba que la versión aparece como 2.1.x. Si no aparece, vuelve al procedimiento de instalación de arriba. Si usas Windows, configura primero WSL (opción A) o Docker (opción B).

Paso 2 — Observar el bucle autónomo

Ejecuta claude y en una carpeta vacía dale esta instrucción:

Crea un hello.py en una carpeta vacía. Pon a propósito un error de sintaxis,
ejecútalo para confirmar el error, luego corrígelo tú solo y ejecútalo de nuevo.
Hasta que aparezca "Hello".

Qué observar:

• ¿La IA crea el archivo directamente? (¿Sin que tú copies y pegues el código?)
• ¿La IA ejecuta python hello.py directamente?
• ¿Cuando ocurre el error, la IA lo lee y lo corrige por sí sola?
• ¿En todo este proceso lo único que hiciste tú fue escribir la primera frase y (si era necesario) aprobar la ejecución?

Si todo es “sí” — has cruzado la puerta. Ve a la Clase 1.

(Si estabas usando un chat IDE) Introduce la misma frase en el chat de tu IDE y compara en qué punto se bloquea. Si experimentas esta diferencia una vez, nunca olvidarás por qué existe la Clase 0.

Resumen

1. Agente ≠ Modelo. Aunque sea el mismo modelo Claude, si el programa que lo ejecuta (el agente) es distinto, las capacidades son completamente distintas.
2. Buena parte de lo que YouTube llama “Claude Code” es un modo chat simple que no puede hacer el bucle autónomo. El criterio de distinción no es la marca, sino “¿ejecuta el CLI por sí solo?”.
3. Este curso está diseñado asumiendo el CLI. Clase 3 Hurl, Clase 4 yongol, Clase 6 tsma, Clase 8 filefunc — todas son herramientas CLI que solo tienen sentido si la IA las ejecuta de forma autónoma.
4. La instalación es una línea. curl -fsSL https://claude.ai/install.sh | bash. En Windows, WSL o Docker primero.
5. Criterio para cruzar la puerta: claude --version devuelve 2.1.x y la IA crea, ejecuta y corrige archivos por sí sola.

Si eliges mal la herramienta, las once clases siguientes son todas mentira. La puerta de entrada del curso se cierra aquí.

Avance de la próxima clase: “Cómo dirigir la IA.” Ahora que tienes el verdadero Claude Code en la mano, aprenderás qué pedirle a la IA y cómo hacerlo, sin saber programar.

Tarea

1. Verificar la identidad de mi herramienta: Confirma si lo que creías que era “Claude Code” hasta ahora es el CLI o el chat IDE. claude --version da la respuesta.
2. Hacer girar el bucle autónomo una vez: Completa el ejercicio hello.py de arriba hasta el final y cuenta cuántos pasos procesó la IA por sí sola sin intervención humana.
3. (Usuarios de Windows) Decidir el entorno: Elige uno de los dos — WSL o Docker — que funcione en tu entorno y termina de configurarlo.

Artículos relacionados

• Por qué los agentes funcionan y por qué se rompen — Las condiciones en que funciona y las condiciones en que se rompe el bucle autónomo de verificación de un agente. El fundamento teórico del “por qué el bucle autónomo CLI” de la Clase 0.
• Reins Engineering — IA con riendas — La diferencia entre el arnés (harness) y las riendas (Reins), y el marco completo que ve al agente como substrato para las reins.

Más lecturas (externas)

• Agent Harness Engineering — Addy Osmani. “Un modelo decente con un excelente harness gana a un modelo excelente con un harness malo.” Casos en que cambiando solo el harness —con el modelo fijo— se invierten los rankings de benchmarks. La versión definitiva de Agente ≠ Modelo.
• Agents are models using tools in a loop — Simon Willison. La definición estándar de agente. El “loop” en que el resultado de la herramienta se retroalimenta al modelo es lo que distingue un agente real de un término de marketing.
• Which AI Coding Harness Actually Works Without You? — Paweł Józefiak. Clasifica las herramientas de codificación en tres categorías: Orchestrator (autónomo) / Pair Programmer (instrucciones paso a paso) / Supervised IDE (rechaza decidir solo). Confundirlas es el error fundamental — coincide exactamente con “la trampa de YouTube” de la Clase 0.

Curso completo de Reins Engineering

Fuentes

• Anthropic. “Claude Code overview.” Anthropic Documentation. link
• Anthropic. “Set up Claude Code.” Anthropic Documentation. link
• Karpathy, A. (2025). “Vibe coding” — el origen del término que describe programar por sensación, sin leer el código.