SpyBara
Go Premium

setup.md 2026-06-16 21:57 UTC to 2026-06-17 17:02 UTC

26 added, 4 removed.

2026
Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

Configuración avanzada

Requisitos del sistema, instalación específica de plataforma, gestión de versiones y desinstalación para Claude Code.

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, procesador x64 o ARM64
  • Red: se requiere conexión a Internet. Consulte configuración de red.
  • Shell: Bash, Zsh, PowerShell o CMD.
  • Ubicación: países compatibles con Anthropic

Dependencias adicionales

Instalar Claude Code

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

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. If you see 'irm' is not recognized as an internal or external command, you're in CMD, not PowerShell. Your prompt shows PS C:\ when you're in PowerShell and C:\ without the PS when you're in CMD.

Git for Windows is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.

You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine.

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 Solucionar problemas de instalación e inicio de sesión.

Configurar en Windows

Puede ejecutar Claude Code de forma nativa en Windows o dentro de WSL. Elija según dónde se encuentren sus proyectos y qué características necesite:

Opción Requiere Sandboxing Cuándo usar
Windows nativo Ninguno; Git for Windows es opcional No compatible Proyectos y herramientas nativas de Windows
WSL 2 WSL 2 habilitado Compatible Cadenas de herramientas de Linux o ejecución de comandos en sandbox
WSL 1 WSL 1 habilitado No compatible Si WSL 2 no está disponible

Opción 1: Windows nativo

Ejecute el comando de instalación desde PowerShell o CMD. No necesita ejecutar como Administrador. Instalar Git for Windows es opcional. Habilita la herramienta Bash proporcionando Git Bash.

Ya sea que instale desde PowerShell o CMD solo afecta qué comando de instalación ejecuta. Su indicador muestra PS C:\Users\YourName> en PowerShell y C:\Users\YourName> sin el PS en CMD. Si es nuevo en la terminal, la guía de terminal le guía a través de cada paso.

Después de la instalación, inicie claude desde cualquier terminal.

  • Sin Git for Windows, Claude Code ejecuta comandos de shell a través de la herramienta PowerShell.

  • Con Git for Windows, Claude Code utiliza Git Bash para la herramienta Bash. Si Claude Code no puede encontrar Git Bash, establezca la ruta en su archivo settings.json:

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

Cuando Git for Windows está instalado, la herramienta PowerShell se está implementando progresivamente como una opción adicional junto a Bash. Establezca CLAUDE_CODE_USE_POWERSHELL_TOOL=1 para participar o 0 para no participar. Consulte herramienta PowerShell para configuración y limitaciones.

Opción 2: WSL

Abra su distribución de WSL y ejecute el instalador de Linux desde las instrucciones de instalación anteriores. Instala e inicia claude dentro del terminal de WSL, no desde PowerShell o CMD.

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

Si esto falla con command not found u otro error, consulte Solucionar problemas de instalación e inicio de sesión.

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, Team, 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, WinGet y gestor de paquetes de Linux requieren actualizaciones manuales de forma predeterminada.

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.

Ejecute claude doctor para ver el resultado del intento de actualización más reciente.

Si una instalación global de npm no puede actualizarse automáticamente porque el directorio global de npm no es escribible, Claude Code muestra un aviso único al iniciar, y claude doctor enumera las correcciones disponibles. Consulte errores de permisos durante la instalación para obtener detalles.

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 /configCanal de actualización automática, 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.

Las instalaciones de Homebrew eligen un canal por nombre de cask en lugar de esta configuración: claude-code rastrea estable y claude-code@latest rastrea latest.

Fijar una versión mínima

La configuración minimumVersion establece un piso. Las actualizaciones automáticas en segundo plano y claude update se niegan a instalar cualquier versión por debajo de este valor, por lo que cambiar al canal "stable" no lo degrada si ya está en una compilación "latest" más nueva.

Cambiar de "latest" a "stable" a través de /config le solicita que permanezca en la versión actual o permita la degradación. Elegir permanecer establece minimumVersion en esa versión. Cambiar de nuevo a "latest" lo borra.

Agréguelo a su archivo settings.json para fijar un piso explícitamente:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

En configuración administrada, esto aplica un mínimo en toda la organización que la configuración de usuario y proyecto no puede anular.

El pin minimumVersion solo restringe las actualizaciones. Para hacer que Claude Code se niegue a iniciar fuera de un rango de versión, use la configuración administrada requiredMinimumVersion y requiredMaximumVersion en su lugar. Las actualizaciones también respetan el techo requiredMaximumVersion. Consulte configuración disponible.

Deshabilitar actualizaciones automáticas

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

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

DISABLE_AUTOUPDATER solo detiene la verificación en segundo plano; claude update e claude install aún funcionan. Para bloquear todas las rutas de actualización, incluidas las actualizaciones manuales, establezca DISABLE_UPDATES en su lugar. Úselo cuando distribuya Claude Code a través de sus propios canales y necesite que los usuarios permanezcan en la versión que proporciona.

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, gestores de paquetes de Linux, 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):

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 2.1.89

Instalar con gestores de paquetes de Linux

Claude Code publica repositorios apt, dnf y apk firmados. Cada repositorio ofrece dos canales: stable sirve una versión que típicamente tiene aproximadamente una semana de antigüedad, omitiendo lanzamientos con regresiones mayores, y latest sirve cada lanzamiento tan pronto como se envía. Los comandos a continuación configuran el canal stable, que se ajusta a la mayoría de usuarios; cada pestaña también muestra la URL del repositorio latest. Las instalaciones del gestor de paquetes no se actualizan automáticamente a través de Claude Code; las actualizaciones llegan a través de su flujo de trabajo de actualización del sistema normal.

Todos los repositorios están firmados con la clave de firma de lanzamiento de Claude Code. Antes de confiar en la clave, verifíquela como se describe en cada pestaña.

Para Debian y Ubuntu. Los siguientes comandos configuran el canal stable:

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
-o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

Para usar el canal latest en su lugar, tanto la ruta de URL como el nombre de la suite cambian. Use esta línea deb:

echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list

Verifique la huella digital de la clave GPG antes de confiar en ella: gpg --show-keys /etc/apt/keyrings/claude-code.asc debe reportar 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.

Para actualizar más tarde, ejecute sudo apt update && sudo apt upgrade claude-code.

Instalar con npm

También puede instalar Claude Code como un paquete npm global. El paquete requiere Node.js 18 o posterior.

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

El paquete npm instala el mismo binario nativo que el instalador independiente. npm extrae el binario a través de una dependencia opcional por plataforma como @anthropic-ai/claude-code-darwin-arm64, y un paso postinstall lo vincula en su lugar. El binario claude instalado no invoca Node en sí mismo.

Las plataformas de instalación npm compatibles son darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 y win32-arm64. Su gestor de paquetes debe permitir dependencias opcionales. Consulte solución de problemas si falta el binario después de la instalación.

Para actualizar una instalación de npm, ejecute npm install -g @anthropic-ai/claude-code@latest. Evite npm update -g, que respeta el rango semver de la instalación original y puede no llevarlo a la versión más reciente.

Integridad binaria y firma de código

Cada lanzamiento publica un manifest.json que contiene sumas de verificación SHA256 para cada binario de plataforma. El manifiesto está firmado con una clave GPG de Anthropic, por lo que verificar la firma en el manifiesto verifica transitivamente cada binario que enumera.

Verificar la firma del manifiesto

Los pasos 1-3 requieren un shell POSIX con gpg y curl. En Windows, ejecútelos en Git Bash o WSL. El paso 4 incluye una opción de PowerShell.

1

Descargar e importar la clave pública

La clave de firma de lanzamiento se publica en una URL fija.

curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import

Muestre la huella digital de la clave importada.

gpg --fingerprint security@anthropic.com

Confirme que la salida incluye esta huella digital:

31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE
2

Descargar el manifiesto y la firma

Establezca VERSION en el lanzamiento que desea verificar.

REPO=https://downloads.claude.ai/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"
3

Verificar la firma

Verifique la firma separada contra el manifiesto.

gpg --verify manifest.json.sig manifest.json

Un resultado válido reporta Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>".

gpg también imprime WARNING: This key is not certified with a trusted signature! para cualquier clave recién importada. Esto es esperado. La línea Good signature confirma que la verificación criptográfica pasó. La comparación de huella digital en el Paso 1 confirma que la clave en sí es auténtica.

4

Verificar el binario contra el manifiesto

Compare la suma de verificación SHA256 de su binario descargado con el valor listado bajo platforms.<platform>.checksum en manifest.json.

sha256sum claude

Firmas de código de plataforma

Además del manifiesto firmado, los binarios individuales llevan firmas de código nativas de plataforma donde se admiten.

  • macOS: firmado por "Anthropic PBC" y notarizado por Apple. Verifique con codesign --verify --verbose ./claude.
  • Windows: firmado por "Anthropic, PBC". Verifique con Get-AuthenticodeSignature .\claude.exe.
  • Linux: los binarios no están firmados individualmente con código. Si descarga directamente del bucket claude-code-releases o usa el instalador nativo, verifique la integridad con la firma de manifiesto anterior. Si instala con apt, dnf o apk, su gestor de paquetes verifica las firmas automáticamente usando la clave de firma del repositorio.

Desinstalar Claude Code

Para eliminar Claude Code, siga las instrucciones para su método de instalación. Si claude aún se ejecuta después, probablemente tenga una segunda instalación o un alias de shell residual de un instalador anterior. Consulte Verificar instalaciones conflictivas para encontrarlo y eliminarlo.

Instalación nativa

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

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

Instalación de Homebrew

Elimine el cask de Homebrew que instaló. Si instaló el cask estable:

brew uninstall --cask claude-code

Si instaló el cask latest:

brew uninstall --cask claude-code@latest

Instalación de WinGet

Elimine el paquete de WinGet:

winget uninstall Anthropic.ClaudeCode

apt / dnf / apk

Elimine el paquete y la configuración del repositorio:

sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

npm

Elimine el paquete npm global:

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

Eliminar archivos de configuración

La extensión de VS Code, el plugin de JetBrains y la aplicación de escritorio también escriben en ~/.claude/. Si alguno de ellos aún está instalado, el directorio se recrea la próxima vez que se ejecuta. Para eliminar Claude Code completamente, desinstale la extensión de VS Code, el plugin de JetBrains y la aplicación de escritorio antes de eliminar estos archivos.

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

# 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