⬛ Qué es una terminal
¿Eres nuevo aquí? Uno terminal es solo una caja de texto que da órdenes directas a la computadora, sin hacer clic en ningún ícono. Escribes un comando (una instrucción en texto, como una frase corta que la computadora entiende), presiona Enter, y la computadora la ejecuta de inmediato. Es la misma lógica que una calculadora: escribes, presionas "=", recibes el resultado. No tiene misterio ni es como un "hacker de película": es otra forma de hablar con la máquina, con texto en lugar de clics.
Todos los módulos de aquí en adelante te pedirán que abras la terminal y pegues un comando. Si nunca abriste una antes, el miedo más común es «voy a romper algo». En la práctica, los comandos que usa este curso (instalar, entrar en una carpeta, listar archivos, abrir el agente) no borran nada ni cambian la configuración del sistema: se limitan a la carpeta en la que estás trabajando.
Cada comando es un ciclo corto y cerrado: nada queda «pendiente» esperando; o el terminal responde en el momento o muestra un mensaje de error que explica qué faltó.
💡 Concepto principal
- •En Windows: la app «Terminal» o «PowerShell».
- •En Mac: la app «Terminal», ya instalada.
- •En Linux: generalmente, un acceso directo en el escritorio o «Ctrl+Alt+T».
😰 Error común: "cerré la terminal sin querer"
Cerrar la ventana de la terminal no rompe nada: solo desaparece. Ábrela de nuevo (el mismo ícono, la misma app) y vuelve a navegar hasta la carpeta con cd (tema 4). Ningún trabajo guardado en un archivo se pierde; solo la "conversación" de la sesión de esa ventana.
🪟 Instalar en Windows (vía WSL)
¿Eres nuevo aquí? WSL (Windows Subsystem for Linux) es un "Linux dentro de Windows" oficial de Microsoft: evita el 90% de los problemas de compatibilidad que aparecen al intentar instalar herramientas de terminal directamente en Windows. Y instalar aquí significa simplemente "instalar un programa en la computadora": lo mismo que descargar y configurar cualquier app, solo que desde la línea de comandos en vez de usar un instalador con botones.
Ejecutar como Administrador quiere decir abrir PowerShell con permisos elevados: haz clic derecho en el ícono y elige «Ejecutar como administrador». Sin eso, Windows bloquea la instalación por seguridad (por el mismo motivo por el que tu celular te pide la contraseña antes de instalar una app fuera de la tienda oficial).
Objetivo: instalar WSL. Cómo verificar: reinicia la computadora; al encenderla de nuevo, debería abrirse sola una ventana de Ubuntu que solicite un usuario/contraseña nuevos (son solo locales de este entorno).
Abrir PowerShell como administrador.
Pegar wsl --install y presionar Enter.
Reiniciar la computadora cuando te lo pidan.
Crear el usuario y la contraseña de Ubuntu en la ventana que se abre automáticamente.
😰 Error común: "wsl no se reconoce"
Aparece en versiones antiguas de Windows 10 (anteriores a la actualización de mayo de 2020). Ve a Configuración → Windows Update → Buscar actualizaciones, actualiza el sistema e inténtalo de nuevo. Si el comando te pide activar manualmente la «Plataforma de máquina virtual», sigue el enlace que muestra el propio error: es una pantalla de configuración de Windows, no algo del curso.
✓ Hacer
- ✓Ejecutar PowerShell como Administrador
- ✓Reiniciar cuando te lo pidan
✗ Evitar
- ✗Instalar en un símbolo del sistema común (sin ser Admin)
- ✗Ignorar la solicitud de reinicio
🍎 Instalar en Mac y Linux, directamente desde la Terminal
En Mac y Linux no hay una capa adicional: abre la app Terminal y pega el comando oficial de instalación de Claude Code (disponible en la documentación de Anthropic).
¿Eres nuevo aquí? Este comando tiene dos partes conectadas por un pipe
(el símbolo |): la primera (curl -fsSL <endereço>) descarga un pequeño
script (un archivo de texto con instrucciones) directamente desde el sitio oficial de Anthropic; la
segunda (sh) ejecuta ese script de inmediato. Es el mismo principio que descargar un instalador y
hacer doble clic, pero sin pasar por el Finder/Explorador de archivos.
Objetivo: descargar e instalar Claude Code. Cómo verificar: la terminal debe mostrar "instalado con éxito" (o un mensaje equivalente) al final, sin errores en rojo.
🔍 Por dentro
El instalador coloca el programa en una carpeta propia de tu usuario (no modifica carpetas del sistema) y descarga unos pocos megabytes: no requiere espacio relevante en el disco. En este paso específico no se envían datos tuyos a internet, aparte de la descarga; la instalación es gratuita, pero el uso del agente puede tener un costo después (créditos de uso, según tu plan).
✓ Hacer
- ✓Copiar el comando completo, sin partirlo en medio de una línea
- ✓Pegar con Cmd+V (Mac) o Ctrl+Shift+V (Linux)
✗ Evitar
- ✗Escribir el comando manualmente (es fácil equivocarse en un carácter)
- ✗Copiar de fuentes que no sean la documentación oficial
😰 Error común: "permission denied" o pantalla de bloqueo de Mac
En Linux, «permission denied» casi siempre significa que faltan permisos en una carpeta protegida; rara vez pasa con este comando específico, pero, si ocurre, verifica que hayas escrito el comando exactamente como aparece aquí. En Mac, Gatekeeper (la protección de seguridad predeterminada) puede pedir una confirmación adicional en «Preferencias del Sistema → Privacidad y seguridad» la primera vez; es normal, solo tienes que permitirlo.
💡 Consejo práctico
Si te pide la contraseña de tu usuario de Mac/Linux, es normal: es la misma que usas para desbloquear la computadora. Al escribirla, la terminal no muestra ningún carácter en pantalla (ni siquiera puntos); parece que se trabó, pero la está registrando normalmente. Solo escríbela y presiona Enter.
📂 Los cuatro comandos que necesitas saber
No necesitas memorizar decenas de comandos: con solo cuatro cosas resuelves el 90% del día a día en la terminal.
¿Eres nuevo aquí? Una carpeta (o “directorio”)
en la terminal es la misma carpeta que ya conoces en el Explorador de archivos/Finder — solo que, en vez de hacer
doble clic para entrar, escribes su nombre después de cd.
cd nome-da-pasta
Entra en una carpeta («change directory»). cd .. vuelve una carpeta atrás.
ls (Mac/Linux) o dir (Windows)
Enumera lo que hay dentro de la carpeta actual.
Enter
Confirma el comando escrito: si no presionas Enter, no pasa nada.
claude
Abre Claude Code en la carpeta actual: el comando que usarás durante todo el curso.
💡 Consejo práctico
No hace falta escribir el nombre completo de la carpeta: empieza a escribir las primeras letras y presiona Tab — la terminal completa el texto automáticamente (se llama "autocompletado"). Funciona en Windows, Mac y Linux y evita errores de escritura, sobre todo en nombres largos o con acentos.
😰 Error común: "No such file or directory"
Significa que la carpeta que escribiste no existe donde estás — por lo general, el nombre tiene un error tipográfico o la carpeta está un nivel más arriba o más abajo de lo esperado. Ejecuta ls (o dir en Windows) primero para ver los nombres exactos y usa Tab para evitar errores. Los nombres con espacios necesitan comillas: cd "minha pasta".
✅ Verificar que la instalación funcionó
Antes de continuar, confirma que todo esté bien. Un comando de versión devuelve un número: luz verde.
¿Eres nuevo aquí? La flag --version (dos guiones antes de la palabra)
es una solicitud estándar que casi todos los programas de terminal entienden: «dime qué versión tienes instalada,
sin hacer nada más». Es una forma segura de probar si la instalación funcionó sin ejecutar el programa de verdad.
Objetivo: confirmar que el programa se instaló. Cómo verificar: debería aparecer algo como 1.x.x — un número de versión, no un mensaje de error que diga "comando no encontrado".
✓ Señal de que salió bien
- ✓Aparece un número de versión (p. ej.,
1.4.2) - ✓No hay texto en rojo en la respuesta
✗ Señal de que algo falló
- ✗"comando no encontrado" / "command not found"
- ✗La ventana se queda bloqueada sin respuesta por más de 1 minuto
⚠️ Atención
Si aparece «comando no encontrado», cierra y vuelve a abrir la terminal (a veces necesita recargar la configuración, llamada PATH — la lista de ubicaciones donde la terminal busca los programas instalados) antes de sospechar algo más grave. Si el problema persiste después de volver a abrirla, repite el comando de instalación del tema 2 o 3: instalar de nuevo encima no causa ningún problema.
🚀 Tu primera conversación con el agente
Llegó la hora del «hello world» del curso: crear una carpeta de prueba, entrar en ella y enviar el primer mensaje.
¿Eres nuevo aquí? mkdir significa crear un directorio ("make directory"): crea una carpeta
nueva y vacía. Usar una carpeta de prueba separada (en vez de modificar directamente archivos importantes) es la forma más
segura de experimentar sin ningún riesgo esta primera vez.
Objetivo: abrir tu primera sesión. Cómo verificar: aparece una pantalla de bienvenida de Claude Code con un cursor esperando que escribas. Escribe «hola, ¿qué puedes hacer?» y presiona Enter.
🔍 Por dentro
Cada vez que ejecutas claude en una carpeta, empieza una nueva sesión — el agente "olvida" las conversaciones anteriores, pero sigue viendo los archivos de esa carpeta (tema del módulo 0.3 y 0.4). Lo que se envía a internet en este primer mensaje es solo el texto que escribiste (y, cuando se solicita, el contenido de los archivos de esa carpeta): no se envía nada más de tu computadora. Y la instalación no tiene costo: lo que genera costo es el uso, que se cobra según el plan de tu cuenta.
😰 Error común: "escribí antes de que cargara la pantalla"
Si escribes demasiado rápido, antes de que termine de aparecer la pantalla de bienvenida, el texto puede perderse o aparecer entrecortado. Espera a que el cursor parpadee por sí solo antes de empezar a escribir: solo tarda 1 o 2 segundos después del comando claude.
💡 Consejo práctico
Para salir de una sesión en cualquier momento, escribe /exit o presiona Ctrl+C dos veces seguidas. Ninguno de los dos borra la carpeta ni los archivos; solo termina la conversación con el agente.