Tutorial de Claude Code 5: ¿Cómo instalar Claude Code?

Cómo instalar Claude Code

La instalación de Claude Code no tiene un "siguiente" en una interfaz gráfica; todo se hace en la línea de comandos. Si usas npm habitualmente, todo el proceso no te llevará más de dos minutos.

Requisitos previos

Antes de empezar, asegúrate de tener lo siguiente:

Node.js 18 o superior
Cómo verificarlo: ejecuta node -v en la terminal. Si la versión es inferior a 18, actualiza con nvm, fnm o directamente desde nodejs.org.
Una cuenta de Anthropic
Regístrate en https://console.anthropic.com. La cuenta te proporcionará una clave de API, que necesitarás después de la instalación. El registro es gratuito; el costo real depende del uso.
Acceso de red al endpoint de la API de Anthropic
El dominio predeterminado es api.anthropic.com. Si tu entorno necesita un proxy, asegúrate de configurar HTTP_PROXY o HTTPS_PROXY en la terminal.

Método de instalación 1: Instalación global con npm

Esta es la forma más común: instalas una vez y funciona en cualquier lugar.

npm install -g @anthropic-ai/claude-code

Una vez finalizado, ejecuta claude --version. Si muestra un número de versión, la instalación fue exitosa. Con la instalación global, el comando claude se puede usar directamente desde cualquier directorio.

Si encuentras un error de permisos (común en /usr/local/lib de macOS), tienes dos opciones:

Usar sudo para instalar (más fácil, pero con implicaciones de seguridad).
Configurar npm para que use un directorio de usuario y evitar sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Luego agrega ~/.npm-global/bin a tu PATH y reinicia la terminal.

Método de instalación 2: Usar npx sin instalar

Si no quieres instalar nada globalmente, o solo quieres probarlo temporalmente, usa npx directamente.

npx @anthropic-ai/claude-code

npx descargará temporalmente el paquete más reciente, lo ejecutará y no dejará ningún comando global. Cada vez que lo uses, verificará actualizaciones, por lo que siempre tendrás la última versión. La desventaja es que es un poco más lento (descarga cada vez) y no es adecuado para scripts automatizados que se ejecutan con frecuencia.

Ideal para: una primera prueba, usarlo en la máquina de otra persona, o usarlo esporádicamente.

Verificar que se inicia correctamente

Después de instalar, no te apresures a autenticarte. Ejecuta un comando simple para ver si la herramienta se inicia:

claude --help

Si muestra la ayuda, el binario funciona. El siguiente paso es conectar tu cuenta, que se explicará más adelante.

El binario es el mismo después de instalar con cualquiera de los dos métodos; la autenticación y el uso posteriores son idénticos. Elige el que te resulte más cómodo.

Preguntas frecuentes

Versión de Node demasiado baja
Si es inferior a 18, dará un error directo, no una advertencia. Actualizar Node es la solución más directa.
Tiempo de espera de red
Tanto al descargar con npm como al conectar con la API, puede bloquearse por un proxy o firewall. Primero verifica que curl https://api.anthropic.com funcione antes de continuar.
Usar cmd nativo en Windows
Aunque es teóricamente posible, se recomienda usar Git Bash, WSL2 o Windows Terminal para evitar problemas extraños con la interpretación de rutas.