Saltar al contenido principal

​
Requisitos del sistema

  • Sistemas operativos: macOS 13.0+, Ubuntu 20.04+/Debian 10+, o Windows 10+ (con WSL 1, WSL 2, o Git para Windows)
  • Hardware: 4 GB+ de RAM
  • Red: Se requiere conexión a Internet (consulta configuración de red)
  • Shell: Funciona mejor en Bash o Zsh
  • Ubicación: Países soportados por Anthropic

​
Dependencias adicionales

​
Instalación

To install Claude Code, use one of the following methods: Después de que se complete el proceso de instalación, navega a tu proyecto e inicia Claude Code: 
cd your-awesome-project
claude
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.
Alpine Linux y otras distribuciones basadas en musl/uClibc: El instalador nativo requiere libgcc, libstdc++ y ripgrep. Para Alpine: apk add libgcc libstdc++ ripgrep. Establece USE_BUILTIN_RIPGREP=0.

​
Autenticación

​
Para individuos

  1. Plan Claude Pro o Max (recomendado): Suscríbete al plan Pro o Max de Claude para obtener una suscripción unificada que incluya tanto Claude Code como Claude en la web. Administra tu cuenta en un solo lugar e inicia sesión con tu cuenta de Claude.ai.
  2. Claude Console: Conéctate a través de Claude Console y completa el proceso de OAuth. Requiere facturación activa en la Consola de Anthropic. Se crea automáticamente un espacio de trabajo “Claude Code” para el seguimiento de uso y la gestión de costos. No puedes crear claves de API para el espacio de trabajo de Claude Code; está dedicado exclusivamente al uso de Claude Code.

​
Para equipos y organizaciones

  1. Claude para Teams o Enterprise (recomendado): Suscríbete a Claude para Teams o Claude para Enterprise para facturación centralizada, gestión de equipos y acceso tanto a Claude Code como a Claude en la web. Los miembros del equipo inician sesión con sus cuentas de Claude.ai.
  2. Claude Console con facturación de equipo: Configura una organización compartida de Claude Console con facturación de equipo. Invita a los miembros del equipo y asigna roles para el seguimiento de uso.
  3. Proveedores de nube: Configura Claude Code para usar Amazon Bedrock, Google Vertex AI, o Microsoft Foundry para implementaciones con tu infraestructura de nube existente.

​
Instalar una versión específica

El instalador nativo acepta un número de versión específico o un canal de lanzamiento (latest o stable). El canal que elijas en el momento de la instalación se convierte en tu predeterminado para actualizaciones automáticas. Consulta Configurar canal de lanzamiento para más información. Para instalar la versión más reciente (predeterminada): 
curl -fsSL https://claude.ai/install.sh | bash
Para instalar la versión estable: 
curl -fsSL https://claude.ai/install.sh | bash -s stable
Para instalar un número de versión específico: 
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

​
Integridad binaria y firma de código

  • Los checksums SHA256 para todas las plataformas se publican en los manifiestos de lanzamiento, actualmente ubicados en https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/{VERSION}/manifest.json (ejemplo: reemplaza {VERSION} con 2.0.30)
  • Los binarios firmados se distribuyen para las siguientes plataformas:
    • macOS: Firmado por “Anthropic PBC” y notarizado por Apple
    • Windows: Firmado por “Anthropic, PBC”

​
Instalación NPM (deprecada)

La instalación de NPM está deprecada. Usa el método de instalación nativa cuando sea posible. Para migrar una instalación npm existente a nativa, ejecuta claude install. Instalación global de npm 
npm install -g @anthropic-ai/claude-code
NO uses sudo npm install -g ya que esto puede causar problemas de permisos y riesgos de seguridad. Si encuentras errores de permisos, consulta solución de problemas de permisos para soluciones recomendadas.

​
Configuración de Windows

Opción 1: Claude Code dentro de WSL
  • Se soportan 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"

​
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 iniciar 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
Las instalaciones de Homebrew y WinGet no se actualizan automáticamente. Usa brew upgrade claude-code o winget upgrade Anthropic.ClaudeCode para actualizar manualmente.Problema conocido: Claude Code puede notificarte sobre actualizaciones antes de que la nueva versión esté disponible en estos gestores de paquetes. Si una actualización falla, espera e intenta de nuevo más tarde.

​
Configurar canal de lanzamiento

Configura qué canal de lanzamiento sigue Claude Code tanto para actualizaciones automáticas como para claude update con la configuración autoUpdatesChannel:
  • "latest" (predeterminado): Recibe nuevas características tan pronto como se lancen
  • "stable": Usa una versión que típicamente tiene aproximadamente una semana de antigüedad, omitiendo lanzamientos con regresiones mayores
Configura esto a través de /config → Canal de actualización automática, o agrégalo a tu archivo settings.json: 
{
  "autoUpdatesChannel": "stable"
}
Para implementaciones empresariales, puedes aplicar un canal de lanzamiento consistente en toda tu organización usando configuraciones administradas.

​
Desactivar 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

​
Desinstalar Claude Code

Si necesitas desinstalar Claude Code, sigue las instrucciones para tu método de instalación.

​
Instalación nativa

Elimina el binario de Claude Code y los archivos de versión: macOS, Linux, WSL: 
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
Windows PowerShell: 
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
Windows CMD: 
del "%USERPROFILE%\.local\bin\claude.exe"
rmdir /s /q "%USERPROFILE%\.local\share\claude"

​
Instalación de Homebrew

brew uninstall --cask claude-code

​
Instalación de WinGet

winget uninstall Anthropic.ClaudeCode

​
Instalación de NPM

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

​
Limpiar archivos de configuración (opcional)

Eliminar archivos de configuración borrará toda tu configuración, herramientas permitidas, configuraciones del servidor MCP e historial de sesiones.
Para eliminar la configuración y datos en caché de Claude Code: macOS, Linux, WSL: 
# Eliminar configuración de usuario y estado
rm -rf ~/.claude
rm ~/.claude.json

# Eliminar configuración específica del proyecto (ejecuta desde tu directorio de proyecto)
rm -rf .claude
rm -f .mcp.json
Windows PowerShell: 
# Eliminar configuración de usuario y estado
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# Eliminar configuración específica del proyecto (ejecuta desde tu directorio de proyecto)
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force
Windows CMD: 
REM Eliminar configuración de usuario y estado
rmdir /s /q "%USERPROFILE%\.claude"
del "%USERPROFILE%\.claude.json"

REM Eliminar configuración específica del proyecto (ejecuta desde tu directorio de proyecto)
rmdir /s /q ".claude"
del ".mcp.json"