Cómo instalar Claude Code paso a paso

Claude Code se distribuye como paquete de npm, así que necesitas Node.js 18 o superior. Abre tu terminal y comprueba la versión instalada. Si el comando devuelve un número igual o mayor que 18, puedes pasar al siguiente paso. Si no tienes Node o tu versión es antigua, descárgalo desde nodejs.org (elige la versión LTS) o, si usas macOS, instálalo con Homebrew (`brew install node`). En Windows la recomendación oficial es trabajar sobre WSL2 (Ubuntu), porque Claude Code está pensado para entornos tipo Unix y evitarás problemas de rutas. En LATAM y España la descarga LTS es la opción más estable para empezar sin sorpresas. Verifica también que npm está disponible, ya que viene incluido con Node.

node --version
npm --version

Con Node listo, instala Claude Code de forma global usando npm. El flag `-g` lo deja disponible como comando `claude` en todo tu sistema, sin tener que instalarlo proyecto por proyecto. El paquete oficial es `@anthropic-ai/claude-code`. La instalación tarda menos de un minuto según tu conexión. Una vez termine, comprueba que el binario quedó registrado consultando su versión. Si ves un número de versión, la instalación fue correcta. Evita instalarlo con `sudo` salvo que sea estrictamente necesario: en macOS y Linux lo ideal es que tu usuario tenga permisos sobre la carpeta global de npm para no arrastrar problemas de permisos más adelante.

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

# Comprobar que quedó instalado
claude --version

Ahora sitúate en la carpeta de un proyecto (puede ser cualquier carpeta con código, aunque sea un ejemplo pequeño) y ejecuta el comando `claude`. La primera vez que lo inicies te pedirá autenticarte. Tienes dos caminos: iniciar sesión con tu cuenta de Claude (Pro o Max), que abre el navegador para autorizar, o usar una API key de la consola de Anthropic. Para empezar sin complicarte, la opción de suscripción es la más directa: pulsa la opción de login, se abrirá tu navegador, aceptas y vuelves a la terminal ya autenticado. Claude Code guarda las credenciales de forma segura para que no tengas que repetir el proceso en cada sesión.

# Entra en tu proyecto
cd ~/mis-proyectos/mi-app

# Inicia Claude Code
claude

Con la sesión abierta ya estás hablando con Claude dentro del contexto de tu carpeta. Prueba a pedirle algo concreto sobre tu código: por ejemplo, que te explique la estructura del proyecto o que encuentre dónde se define una función. Claude Code lee los archivos necesarios por sí mismo, propone cambios y te pide confirmación antes de modificar nada. Escribe tu petición en lenguaje natural, en español, y observa cómo razona y actúa. Este es el flujo básico: tú describes qué quieres, Claude investiga el código y ejecuta. Para salir de la sesión en cualquier momento escribe `/exit` o pulsa Ctrl+C dos veces.

# Dentro de la sesión de Claude Code, escribe por ejemplo:
> Explícame la estructura de este proyecto y qué hace cada carpeta

> Busca dónde se gestiona la autenticación de usuarios

Dentro de Claude Code tienes comandos que empiezan por `/` para controlar la sesión. Vale la pena memorizar unos pocos desde el principio. `/help` muestra todos los disponibles. `/clear` limpia el contexto de la conversación cuando cambies de tarea, lo que ahorra tokens y mantiene a Claude centrado. `/init` crea el archivo de memoria del proyecto. `/model` te deja ver o cambiar el modelo en uso (por defecto trabaja con claude-opus-4-8). `/cost` te informa del consumo si usas API key. Dominar estos atajos marca la diferencia entre pelearte con la herramienta y sacarle partido real desde el primer día.

# Comandos útiles dentro de la sesión
/help      # lista todos los comandos
/clear     # reinicia el contexto
/init      # crea CLAUDE.md con contexto del proyecto
/model     # ver o cambiar el modelo (por defecto claude-opus-4-8)
/cost      # consumo estimado (si usas API key)
/exit      # salir de la sesión

Para confirmar que todo quedó bien, ejecuta `claude doctor`: es un diagnóstico que revisa versión, autenticación y entorno, y te avisa de cualquier problema de configuración. Es el primer comando que deberías correr si algo no funciona. Claude Code se actualiza con frecuencia, así que conviene mantenerlo al día reinstalando el paquete global de vez en cuando. Si en algún momento quieres empezar de cero (por ejemplo, para cambiar de cuenta), puedes desinstalarlo y volver a instalarlo limpiamente. Con esto ya tienes un flujo de instalación, verificación y mantenimiento completo para trabajar con tranquilidad.

# Diagnóstico de la instalación
claude doctor

# Actualizar a la última versión
npm install -g @anthropic-ai/claude-code

# Desinstalar si necesitas empezar de cero
npm uninstall -g @anthropic-ai/claude-code