Saltar al contenido principal

​
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+ de RAM
  • Software: Node.js 18+ (solo requerido para instalación NPM)
  • Red: Se requiere conexión a Internet 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, use one of the following methods:
Algunos usuarios pueden ser migrados automáticamente a un método de instalación mejorado.
Después de que se complete el proceso de instalación, navega a tu proyecto e inicia Claude Code: 
cd your-awesome-project
claude
Claude Code ofrece las siguientes opciones de autenticación:
  1. Claude Console: La opción predeterminada. Conéctate a través de Claude Console y completa el proceso OAuth. Requiere facturación activa en console.anthropic.com. Un espacio de trabajo “Claude Code” se creará automáticamente para el seguimiento de uso y la gestión de costos. Ten en cuenta que no puedes crear claves API para el espacio de trabajo de Claude Code - está dedicado exclusivamente para el uso de Claude Code.
  2. Claude App (con plan Pro o Max): Suscríbete al plan Pro o Max de Claude para obtener una suscripción unificada que incluya 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 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 implementaciones empresariales con tu infraestructura en la nube existente.
Claude Code almacena de forma segura tus credenciales. Consulta Gestión de credenciales para obtener detalles.

​
Configuración de Windows

Opción 1: Claude Code dentro de WSL
  • Se admiten tanto WSL 1 como WSL 2
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.

​
Opciones de instalación nativa

La instalación nativa es el método recomendado y ofrece varios beneficios:
  • Un ejecutable independiente
  • Sin dependencia de Node.js
  • Estabilidad mejorada del actualizador automático
Si tienes una instalación existente de Claude Code, usa claude install para migrar a la instalación binaria nativa. Para opciones de instalación avanzadas con el instalador nativo: 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 libgcc, libstdc++, y ripgrep. Instala (Alpine: apk add libgcc libstdc++ ripgrep) y establece USE_BUILTIN_RIPGREP=0.
Claude Code instalado a través de Homebrew se actualizará automáticamente fuera del directorio brew a menos que se deshabilite explícitamente con la variable de entorno DISABLE_AUTOUPDATER (consulta la sección Actualizaciones automáticas).
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
Windows CMD: 
REM Instalar versión estable (predeterminada)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

REM Instalar última versión
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd

REM Instalar número de versión específico
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd
Asegúrate de eliminar cualquier alias u enlace simbólico obsoleto antes de instalar.

​
Instalación NPM

Para entornos donde NPM es preferido o requerido: 
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 obtener soluciones recomendadas.

​
Ejecutar en AWS o GCP

Por defecto, Claude Code utiliza la API de Claude. Para obtener detalles sobre cómo 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: Se realizan 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 se instalen las actualizaciones
  • Aplicar actualizaciones: Las actualizaciones surten efecto la próxima vez que inicies Claude Code
Deshabilitar actualizaciones automáticas: Establece la variable de entorno DISABLE_AUTOUPDATER en tu shell o archivo settings.json: 
export DISABLE_AUTOUPDATER=1

​
Actualizar manualmente

claude update