Antes de empezar
Claude Code se ejecuta en la terminal de tu ordenador; esa ventana de texto donde escribes comandos. También necesitarás un plan de Claude de pago (Pro o Max); el plan gratuito no incluye Claude Code.
La buena noticia: con el instalador oficial, no necesitas instalar Node.js. Es un solo comando.
Algo que debes hacer primero si estás en Windows: Claude Code necesita una herramienta gratuita llamada Git para Windows para funcionar (la usa en segundo plano; no te hará falta aprender a usarla ni usar Git tú mismo). Si estás en Windows y aún no lo tienes, instálalo antes de seguir:
Ve a git-scm.com/downloads/win y descarga el instalador.
Ejecuta el instalador. Haz clic en Siguiente en cada pantalla para aceptar la configuración predeterminada; no necesitas cambiar nada, aunque haya varias pantallas.
Si te pregunta qué editor usar, deja el predeterminado y haz clic en Siguiente.
Cuando llegues a la pantalla titulada "Adjusting your PATH environment", mantén la opción que ya está seleccionada.
¿No estás seguro de si tienes Git? Instálalo de todas formas; reinstalarlo no causa problemas. Los usuarios de Mac pueden saltarse esto; no se necesita nada más.
Paso 1 — Abre tu terminal
Abre la terminal en tu ordenador. La forma de hacerlo depende de tu sistema:
Windows 10: Pulsa la tecla de Windows + R, escribe
cmdy pulsa Enter. Se abrirá el Símbolo del sistema.Windows 11: Haz clic en la barra de búsqueda de la barra de tareas (o pulsa la tecla de Windows), escribe
Terminaly haz clic en Terminal en los resultados. Como alternativa, haz clic derecho en el botón de Inicio y selecciona Terminal.Mac: Pulsa Cmd + Barra espaciadora para abrir Spotlight, escribe
Terminaly pulsa Enter.
Aparecerá una ventana con una línea en blanco donde puedes escribir. Aquí es donde irán todos los comandos de abajo.
Paso 2 — Ejecuta el instalador
Copia el comando para tu sistema, pégalo en la terminal y pulsa Enter.
Mac:
curl -fsSL https://claude.ai/install.sh | bash
Windows 11 (y Windows 10 usando Terminal/PowerShell):
irm https://claude.ai/install.ps1 | iex
Windows 10 (si has abierto el Símbolo del sistema con cmd en el Paso 1):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Verás cómo pasa texto mientras funciona. Cuando termine, verás un mensaje confirmando que Claude Code se ha instalado correctamente. Si ves un error en su lugar, consulta la sección de Solución de problemas al final.
Paso 3 — Abre una ventana de terminal nueva
Este paso es fácil de saltarse, pero es importante. Cierra completamente tu ventana de terminal y abre una nueva (usando el mismo método del Paso 1).
El instalador añade Claude Code a tu sistema, pero tu terminal solo nota el cambio cuando inicias una ventana nueva. Omitir esto es la razón más común por la que el siguiente paso parece "no funcionar".
Paso 4 — Inicia Claude Code e inicia sesión
En tu nueva ventana de terminal, escribe:
claude
La primera vez que lo ejecutes, te preguntará cómo quieres iniciar sesión. Elige iniciar sesión con tu cuenta de Claude (no con una clave API). Se abrirá una ventana del navegador donde iniciarás sesión en tu cuenta de Claude. Una vez que hayas iniciado sesión, puedes volver a la terminal; tu suscripción Pro o Max ahora funciona en Claude Code.
Eso es todo. Ahora puedes escribir preguntas o peticiones directamente en la terminal.
Solución de problemas
Los pasos de instalación son los mismos en todos los sistemas, pero si algo sale mal, la solución puede variar dependiendo de lo que estés usando. Aquí están los problemas más comunes.
"claude no se reconoce" o "comando no encontrado" después de instalar
Esto casi siempre significa que te saltaste el Paso 3. Cierra completamente la terminal, abre una ventana totalmente nueva y escribe claude de nuevo. La terminal solo detecta los comandos recién instalados cuando inicias una sesión fresca.
Windows: "irm no se reconoce" (estás en el Símbolo del sistema, no en PowerShell)
Si el comando irm da un error como "no se reconoce como un comando interno o externo", estás en el Símbolo del sistema (CMD) en lugar de en PowerShell. Puedes saber en cuál estás mirando al principio de la línea: PowerShell muestra PS C:\... mientras que el Símbolo del sistema solo muestra C:\....
Usa la versión del comando para el Símbolo del sistema en su lugar:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows 10: "No se pudo crear un canal seguro SSL/TLS"
Esto puede ocurrir en sistemas Windows 10 más antiguos. En PowerShell, ejecuta la línea de abajo primero y luego vuelve a ejecutar el comando del instalador:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 irm https://claude.ai/install.ps1 | iex
Windows: "Claude Code en Windows requiere git-bash"
Esto significa que Git para Windows no está instalado (o Claude Code no puede encontrarlo). Vuelve a la sección "Antes de empezar" de arriba e instala Git para Windows, luego cierra tu terminal, abre una nueva y ejecuta claude de nuevo.
Mac: un mensaje de seguridad o "permiso"
Como el instalador oficial pone Claude Code en una carpeta que te pertenece (dentro de tu propio directorio de inicio), los errores de permisos que causaron métodos de instalación anteriores no ocurren aquí. Si tu Mac muestra una ventana emergente de seguridad la primera vez que ejecutas claude diciendo que no pudo verificar la aplicación, abre Ajustes del Sistema → Privacidad y Seguridad, desplázate hacia abajo hasta el mensaje sobre claude y haz clic en Permitir de todas formas. Luego vuelve a ejecutar claude en la terminal.
¿Sigues atascado?
Después de instalar, puedes ejecutar este comando para que Claude Code se revise a sí mismo y señale lo que está mal:
claude doctor
Examina tu instalación y la configuración común y generalmente te dice exactamente qué solucionar.