Configuración avanzada - Claude Code Docs

Esta página cubre requisitos del sistema, detalles de instalación específicos de plataforma, actualizaciones y desinstalación. Para un recorrido guiado de su primera sesión, consulte el inicio rápido. Si nunca ha utilizado una terminal antes, consulte la guía de terminal.

Requisitos del sistema

Claude Code se ejecuta en las siguientes plataformas y configuraciones:

Sistema operativo:
- macOS 13.0+
- Windows 10 1809+ o Windows Server 2019+
- Ubuntu 20.04+
- Debian 10+
- Alpine Linux 3.19+
Hardware: 4 GB+ de RAM
Red: se requiere conexión a Internet. Consulte configuración de red.
Shell: Bash, Zsh, PowerShell o CMD. En Windows, se requiere Git for Windows.
Ubicación: países compatibles con Anthropic

Dependencias adicionales

ripgrep: generalmente incluido con Claude Code. Si la búsqueda falla, consulte solución de problemas de búsqueda.

Instalar Claude Code

¿Prefiere una interfaz gráfica? La aplicación de escritorio le permite usar Claude Code sin la terminal. Descárguela para macOS o Windows.¿Nuevo en la terminal? Consulte la guía de terminal para obtener instrucciones paso a paso.

To install Claude Code, use one of the following methods:

Native Install (Recommended)
Homebrew
WinGet

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

If you see The token '&&' is not a valid statement separator, you’re in PowerShell, not CMD. Use the PowerShell command above instead. Your prompt shows PS C:\ when you’re in PowerShell.Windows requires Git for Windows. Install it first if you don’t have it.

Native installations automatically update in the background to keep you on the latest version.

brew install --cask claude-code

Homebrew installations do not auto-update. Run brew upgrade claude-code periodically to get the latest features and security fixes.

winget install Anthropic.ClaudeCode

WinGet installations do not auto-update. Run winget upgrade Anthropic.ClaudeCode periodically to get the latest features and security fixes.

Después de que se complete la instalación, abra una terminal en el proyecto en el que desea trabajar e inicie Claude Code:

claude

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

Configurar en Windows

Claude Code en Windows requiere Git for Windows o WSL. Puede iniciar claude desde PowerShell, CMD o Git Bash. Claude Code utiliza Git Bash internamente para ejecutar comandos. No necesita ejecutar PowerShell como Administrador. Opción 1: Windows nativo con Git Bash Instale Git for Windows y luego ejecute el comando de instalación desde PowerShell o CMD. Si Claude Code no puede encontrar su instalación de Git Bash, establezca la ruta en su archivo settings.json:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Opción 2: WSL Se admiten tanto WSL 1 como WSL 2. WSL 2 admite sandboxing para mayor seguridad. WSL 1 no admite sandboxing.

Alpine Linux y distribuciones basadas en musl

El instalador nativo en Alpine y otras distribuciones basadas en musl/uClibc requiere libgcc, libstdc++ y ripgrep. Instale estos usando el gestor de paquetes de su distribución y luego establezca USE_BUILTIN_RIPGREP=0. Este ejemplo instala los paquetes requeridos en Alpine:

apk add libgcc libstdc++ ripgrep

Luego establezca USE_BUILTIN_RIPGREP en 0 en su archivo settings.json:

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

Verificar su instalación

Después de instalar, confirme que Claude Code está funcionando:

claude --version

Para una verificación más detallada de su instalación y configuración, ejecute claude doctor:

claude doctor

Autenticar

Claude Code requiere una cuenta Pro, Max, Teams, Enterprise o Console. El plan gratuito de Claude.ai no incluye acceso a Claude Code. También puede usar Claude Code con un proveedor de API de terceros como Amazon Bedrock, Google Vertex AI o Microsoft Foundry. Después de instalar, inicie sesión ejecutando claude y siguiendo las indicaciones del navegador. Consulte Autenticación para todos los tipos de cuenta y opciones de configuración de equipo.

Actualizar Claude Code

Las instalaciones nativas se actualizan automáticamente en segundo plano. Puede configurar el canal de lanzamiento para controlar si recibe actualizaciones inmediatamente o en un cronograma estable retrasado, o deshabilitar las actualizaciones automáticas completamente. Las instalaciones de Homebrew y WinGet requieren actualizaciones manuales.

Actualizaciones automáticas

Claude Code busca actualizaciones al iniciar y periódicamente mientras se ejecuta. Las actualizaciones se descargan e instalan en segundo plano y luego surten efecto la próxima vez que inicie Claude Code.

Las instalaciones de Homebrew y WinGet no se actualizan automáticamente. Use brew upgrade claude-code o winget upgrade Anthropic.ClaudeCode para actualizar manualmente.Problema conocido: Claude Code puede notificarle sobre actualizaciones antes de que la nueva versión esté disponible en estos gestores de paquetes. Si una actualización falla, espere e intente más tarde.Homebrew mantiene versiones antiguas en el disco después de las actualizaciones. Ejecute brew cleanup claude-code periódicamente para recuperar espacio en disco.

Configurar canal de lanzamiento

Controle qué canal de lanzamiento sigue Claude Code para actualizaciones automáticas y claude update con la configuración autoUpdatesChannel:

"latest", el predeterminado: reciba nuevas características tan pronto como se lancen
"stable": use una versión que típicamente tiene aproximadamente una semana de antigüedad, omitiendo lanzamientos con regresiones importantes

Configure esto a través de /config → Auto-update channel, o agréguelo a su archivo settings.json:

{
  "autoUpdatesChannel": "stable"
}

Para implementaciones empresariales, puede aplicar un canal de lanzamiento consistente en toda su organización usando configuración administrada.

Deshabilitar actualizaciones automáticas

Establezca DISABLE_AUTOUPDATER en "1" en la clave env de su archivo settings.json:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Actualizar manualmente

Para aplicar una actualización inmediatamente sin esperar la próxima verificación en segundo plano, ejecute:

claude update

Opciones de instalación avanzadas

Estas opciones son para fijación de versiones, migración desde npm y verificación de integridad binaria.

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 elija en el momento de la instalación se convierte en su predeterminado para actualizaciones automáticas. Consulte configurar canal de lanzamiento para más información. Para instalar la versión más reciente (predeterminada):

macOS, Linux, WSL
Windows PowerShell
Windows CMD

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Para instalar la versión estable:

macOS, Linux, WSL
Windows PowerShell
Windows CMD

curl -fsSL https://claude.ai/install.sh | bash -s stable

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd

Para instalar un número de versión específico:

macOS, Linux, WSL
Windows PowerShell
Windows CMD

curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd

Instalación npm obsoleta

La instalación con npm está obsoleta. El instalador nativo es más rápido, no requiere dependencias y se actualiza automáticamente en segundo plano. Use el método de instalación nativa cuando sea posible.

Migrar de npm a nativo

Si instaló previamente Claude Code con npm, cambie al instalador nativo:

# Instalar el binario nativo
curl -fsSL https://claude.ai/install.sh | bash

# Eliminar la instalación anterior de npm
npm uninstall -g @anthropic-ai/claude-code

También puede ejecutar claude install desde una instalación npm existente para instalar el binario nativo junto a ella y luego eliminar la versión npm.

Instalar con npm

Si necesita instalación con npm por razones de compatibilidad, debe tener Node.js 18+ instalado. Instale el paquete globalmente:

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

NO use sudo npm install -g ya que esto puede causar problemas de permisos y riesgos de seguridad. Si encuentra errores de permisos, consulte solución de problemas de errores de permisos.

Integridad binaria y firma de código

Puede verificar la integridad de los binarios de Claude Code usando sumas de verificación SHA256 y firmas de código.

Las sumas de verificación SHA256 para todas las plataformas se publican en los manifiestos de lanzamiento en https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/{VERSION}/manifest.json. Reemplace {VERSION} con un número de versión como 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”

Desinstalar Claude Code

Para eliminar Claude Code, siga las instrucciones para su método de instalación.

Instalación nativa

Elimine el binario de Claude Code y los archivos de versión:

macOS, Linux, WSL
Windows PowerShell

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Instalación de Homebrew

Elimine el cask de Homebrew:

brew uninstall --cask claude-code

Instalación de WinGet

Elimine el paquete de WinGet:

winget uninstall Anthropic.ClaudeCode

npm

Elimine el paquete npm global:

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

Eliminar archivos de configuración

Eliminar archivos de configuración eliminará toda su configuración, herramientas permitidas, configuraciones de servidor MCP e historial de sesiones.

Para eliminar la configuración y datos en caché de Claude Code:

macOS, Linux, WSL
Windows PowerShell

# Eliminar configuración de usuario y estado
rm -rf ~/.claude
rm ~/.claude.json

# Eliminar configuración específica del proyecto (ejecutar desde su directorio de proyecto)
rm -rf .claude
rm -f .mcp.json

# 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 (ejecutar desde su directorio de proyecto)
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force

Administración

​Requisitos del sistema

​Dependencias adicionales

​Instalar Claude Code

​Configurar en Windows

​Alpine Linux y distribuciones basadas en musl

​Verificar su instalación

​Autenticar

​Actualizar Claude Code

​Actualizaciones automáticas

​Configurar canal de lanzamiento

​Deshabilitar actualizaciones automáticas

​Actualizar manualmente

​Opciones de instalación avanzadas

​Instalar una versión específica

​Instalación npm obsoleta

​Migrar de npm a nativo

​Instalar con npm

​Integridad binaria y firma de código

​Desinstalar Claude Code

​Instalación nativa

​Instalación de Homebrew

​Instalación de WinGet

​npm

​Eliminar archivos de configuración

Requisitos del sistema

Dependencias adicionales

Instalar Claude Code

Configurar en Windows

Alpine Linux y distribuciones basadas en musl

Verificar su instalación

Autenticar

Actualizar Claude Code

Actualizaciones automáticas

Configurar canal de lanzamiento

Deshabilitar actualizaciones automáticas

Actualizar manualmente

Opciones de instalación avanzadas

Instalar una versión específica

Instalación npm obsoleta

Migrar de npm a nativo

Instalar con npm

Integridad binaria y firma de código

Desinstalar Claude Code

Instalación nativa

Instalación de Homebrew

Instalación de WinGet

npm

Eliminar archivos de configuración