​
Requisitos del sistema

  • Sistemas Operativos: macOS 10.15+, Ubuntu 20.04+/Debian 10+, o Windows 10+ (con WSL 1, WSL 2, o Git para Windows)
  • Hardware: 4GB+ RAM
  • Software: Node.js 18+
  • Red: Conexión a Internet requerida para autenticación y procesamiento de IA
  • Shell: Funciona mejor en Bash, Zsh o Fish
  • Ubicación: Países soportados por Anthropic

​
Dependencias adicionales

​
Instalación estándar

To install Claude Code, run the following command:

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

NO uses sudo npm install -g ya que esto puede llevar a problemas de permisos y riesgos de seguridad. Si encuentras errores de permisos, consulta configurar Claude Code para soluciones recomendadas.

Algunos usuarios pueden ser migrados automáticamente a un método de instalación mejorado. Ejecuta claude doctor después de la instalación para verificar tu tipo de instalación.

Después de que el proceso de instalación se complete, navega a tu proyecto e inicia Claude Code:

cd your-awesome-project
claude

Claude Code ofrece las siguientes opciones de autenticación:

  1. Consola de Anthropic: La opción predeterminada. Conéctate a través de la Consola de Anthropic y completa el proceso OAuth. Requiere facturación activa en console.anthropic.com.
  2. Aplicación Claude (con plan Pro o Max): Suscríbete al plan Pro o Max de Claude para una suscripción unificada que incluye tanto Claude Code como la interfaz web. Obtén más valor al mismo precio mientras administras tu cuenta en un solo lugar. Inicia sesión con tu cuenta de Claude.ai. Durante el lanzamiento, elige la opción que coincida con tu tipo de suscripción.
  3. Plataformas empresariales: Configura Claude Code para usar Amazon Bedrock o Google Vertex AI para despliegues empresariales con tu infraestructura de nube existente.

Claude Code almacena de forma segura tus credenciales. Consulta Gestión de Credenciales para más detalles.

​
Configuración de Windows

Opción 1: Claude Code dentro de WSL

  • Tanto WSL 1 como WSL 2 son soportados

Opción 2: Claude Code en Windows nativo con Git Bash

  • Requiere Git para Windows
  • Para instalaciones portátiles de Git, especifica la ruta a tu bash.exe: 
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

​
Métodos de instalación alternativos

Claude Code ofrece múltiples métodos de instalación para adaptarse a diferentes entornos.

Si encuentras algún problema durante la instalación, consulta la guía de solución de problemas.

Ejecuta claude doctor después de la instalación para verificar tu tipo de instalación y versión.

​
Instalación global de npm

Método tradicional mostrado en los pasos de instalación anteriores

​
Instalación de binario nativo (Beta)

Si tienes una instalación existente de Claude Code, usa claude install para iniciar la instalación del binario nativo.

Para una instalación nueva, ejecuta el siguiente comando:

macOS, Linux, WSL:

# Instalar versión estable (predeterminada)
curl -fsSL https://claude.ai/install.sh | bash

# Instalar última versión
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Instalar número de versión específico
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Alpine Linux y otras distribuciones basadas en musl/uClibc: La compilación nativa requiere que instales ripgrep. Instala (Alpine: apk add ripgrep) y establece USE_BUILTIN_RIPGREP=0.

Windows PowerShell:

# Instalar versión estable (predeterminada)
irm https://claude.ai/install.ps1 | iex

# Instalar última versión
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# Instalar número de versión específico
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

El instalador nativo de Claude Code es soportado en macOS, Linux y Windows.

Asegúrate de eliminar cualquier alias o enlace simbólico desactualizado. Una vez que tu instalación esté completa, ejecuta claude doctor para verificar la instalación.

​
Instalación local

  • Después de la instalación global vía npm, usa claude migrate-installer para mover a local
  • Evita problemas de permisos del actualizador automático de npm
  • Algunos usuarios pueden ser migrados automáticamente a este método

​
Ejecutar en AWS o GCP

Por defecto, Claude Code usa la API de Anthropic.

Para detalles sobre ejecutar Claude Code en AWS o GCP, consulta integraciones de terceros.

​
Actualizar Claude Code

​
Actualizaciones automáticas

Claude Code se mantiene automáticamente actualizado para asegurar que tengas las últimas características y correcciones de seguridad.

  • Verificaciones de actualización: Realizadas al inicio y periódicamente mientras se ejecuta
  • Proceso de actualización: Descarga e instala automáticamente en segundo plano
  • Notificaciones: Verás una notificación cuando las actualizaciones sean instaladas
  • Aplicar actualizaciones: Las actualizaciones toman efecto la próxima vez que inicies Claude Code

Deshabilitar actualizaciones automáticas:

# Vía configuración
claude config set autoUpdates false --global

# O vía variable de entorno
export DISABLE_AUTOUPDATER=1

​
Actualizar manualmente

claude update