Para instalar Claude Code, el agente de programación en terminal de Anthropic, ejecuta el instalador nativo en una máquina que cumpla los mínimos de sistema operativo documentados, tenga 4 GB de RAM, un procesador x64 o ARM64, Bash, Zsh, PowerShell o CMD, conexión a internet y esté en un país admitido por Anthropic. En macOS, Linux y WSL ese comando es curl -fsSL https://claude.ai/install.sh | bash; Windows PowerShell usa install.ps1 y el símbolo del sistema usa install.cmd.

Anthropic documenta el instalador nativo como el método recomendado. En macOS, Linux y Windows Subsystem for Linux (WSL), se envía https://claude.ai/install.sh por una tubería a bash. Windows PowerShell usa install.ps1; el símbolo del sistema usa install.cmd. Las compilaciones stable y fijadas usan argumentos propios de cada shell: bash -s en Unix, un scriptblock de PowerShell e install.cmd <channel-or-version> en CMD. Cuando el binario ya está en disco, claude --version debe imprimir un número de versión seguido de (Claude Code), y después claude abre el inicio de sesión en el navegador. Si ANTHROPIC_API_KEY está definida, Claude Code pide una sola aprobación de esa clave en lugar de abrir el navegador.

Las instalaciones nativas descargan las actualizaciones en segundo plano. Homebrew, WinGet, apt, dnf y apk reciben las actualizaciones a través de esos gestores de paquetes. npm distribuye el mismo binario nativo como paquete global mediante dependencias opcionales, y se actualiza solo salvo que el directorio global de npm no sea escribible. Usa los comandos de actualización y desinstalación que correspondan al método que elegiste.

Qué tiene que cumplirse antes de instalar

Una instalación correcta te deja un binario claude que funciona, una cuenta que Claude Code acepta, un canal de publicación que elegiste y una vía de desinstalación que coincide con el instalador. Claude Code es el agente de programación en terminal de Anthropic: un programa de línea de comandos que se abre en un directorio de proyecto, lee los archivos que necesita y te ayuda a escribir y cambiar código desde el shell. La aplicación Desktop de Anthropic es una opción gráfica de Claude Code. Este artículo cubre el instalador de terminal, las actualizaciones y la desinstalación.

La página de setup de Anthropic enumera estos mínimos de sistema operativo: macOS 13.0+, Windows 10 1809+ o Windows Server 2019+, Ubuntu 20.04+, Debian 10+ y Alpine Linux 3.19+. El hardware es 4 GB de RAM o más y un procesador x64 o ARM64. Se requiere conexión a internet. Los shells documentados son Bash, Zsh, PowerShell y CMD. El requisito de ubicación de la página de setup es un país admitido por Anthropic.

Claude Code requiere una cuenta Pro, Max, Team, Enterprise o Console, o Amazon Bedrock, Agent Platform de Google Cloud o Microsoft Foundry. La documentación de Anthropic indica que el plan gratuito de claude.ai no incluye acceso a Claude Code. Usa las páginas de setup de esos productos en la nube para las credenciales del proveedor.

Cuando claude ya se ejecuta, inicia sesión. Las primeras indicaciones de programación están en el quickstart de Anthropic. Para command not found, problemas de PATH, EACCES, errores de TLS o un curl 403 durante la instalación, usa la página Troubleshoot installation and login de Anthropic. Los bucles de inicio de sesión, los errores de OAuth y un 403 Forbidden de inicio de sesión corresponden a la sección login and authentication de esa misma página.

Configuración de Claude Code

Países admitidos por Anthropic

Solución de problemas de instalación e inicio de sesión

Instalador nativo, el método recomendado

Anthropic documenta el instalador nativo como el método recomendado. En macOS, Linux y Windows Subsystem for Linux (WSL), envía el script de instalación por una tubería a bash. Las instalaciones nativas se actualizan en segundo plano.

Windows PowerShell usa irm https://claude.ai/install.ps1 | iex. Windows CMD usa curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Si ves The token '&&' is not a valid statement separator, estás en PowerShell. Si ves 'irm' is not recognized as an internal or external command, estás en CMD. Los símbolos de PowerShell empiezan por PS C:\; los de CMD muestran C:\ sin PS.

En macOS y Linux el lanzador es ~/.local/bin/claude, un symlink hacia ~/.local/share/claude/versions/. Cuando termina el instalador, abre una terminal en tu proyecto y ejecuta claude.

El instalador nativo acepta latest, stable o una versión como 2.1.89 (el ejemplo de fijación de Anthropic). El canal que eliges al instalar pasa a ser el predeterminado de la actualización automática. Cada shell tiene su sintaxis: bash usa bash -s, PowerShell usa un scriptblock y CMD pasa el argumento a install.cmd.

  • macOS, Linux, WSL (latest): curl -fsSL https://claude.ai/install.sh | bash
  • Windows PowerShell (latest): irm https://claude.ai/install.ps1 | iex
  • Windows CMD (latest): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  • Stable, macOS/Linux/WSL: curl -fsSL https://claude.ai/install.sh | bash -s stable
  • Stable, PowerShell: & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable
  • Stable, CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd
  • Ejemplo fijado 2.1.89, macOS/Linux/WSL: curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
  • Ejemplo fijado 2.1.89, PowerShell: & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89
  • Ejemplo fijado 2.1.89, CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 2.1.89 && del install.cmd
curl -fsSL https://claude.ai/install.sh | bash

Homebrew, WinGet, repositorios de Linux y npm

Homebrew se instala con brew install --cask claude-code, que sigue el canal stable (normalmente alrededor de una semana por detrás y omite las publicaciones con regresiones importantes). brew install --cask claude-code@latest sigue latest. Actualiza con el cask brew upgrade que corresponda. Homebrew conserva las versiones antiguas en disco; brew cleanup recupera espacio.

WinGet se instala con winget install Anthropic.ClaudeCode y se actualiza con winget upgrade Anthropic.ClaudeCode.

Claude Code publica repositorios firmados de apt, dnf y apk, cada uno con canales stable y latest. Stable suele tener alrededor de una semana y omite las publicaciones con regresiones importantes; latest entrega cada publicación en cuanto sale. Los comandos de abajo configuran stable, que la página de setup dice que encaja con la mayoría de los usuarios. Las instalaciones por gestor de paquetes reciben las actualizaciones por el flujo normal de actualización del sistema.

En Debian y Ubuntu, instala curl y gnupg si faltan (sudo apt install curl gnupg). Los comandos del bloque de código crean /etc/apt/keyrings, descargan la clave de firma, la muestran para comprobar la huella, escriben /etc/apt/sources.list.d/claude-code.list e instalan el paquete. La huella debe ser 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Si falla la descarga de la clave, apt update falla después con NO_PUBKEY BAA929FF1A7ECACE. Para latest cambian tanto la ruta de la URL como el nombre de la suite: deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main. Más adelante se actualiza con sudo apt update && sudo apt upgrade claude-code.

En Fedora y RHEL, los comandos del bloque de código escriben /etc/yum.repos.d/claude-code.repo e instalan el paquete. Para latest, establece baseurl=https://downloads.claude.ai/claude-code/rpm/latest. dnf descarga la clave en la primera instalación y pide la huella; confirma 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE antes de aceptarla. Más adelante se actualiza con sudo dnf upgrade claude-code.

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

En Alpine, descarga https://downloads.claude.ai/keys/claude-code.rsa.pub en /etc/apk/keys/claude-code.rsa.pub, añade https://downloads.claude.ai/claude-code/apk/stable a /etc/apk/repositories y después ejecuta apk add claude-code. Para latest, ejecuta sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories y añade https://downloads.claude.ai/claude-code/apk/latest. sha256sum /etc/apk/keys/claude-code.rsa.pub debe informar 395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6. Más adelante se actualiza con apk update && apk upgrade claude-code.

npm instala el mismo binario nativo: npm install -g @anthropic-ai/claude-code. npm trae ese binario mediante una dependencia opcional por plataforma, como @anthropic-ai/claude-code-darwin-arm64, así que el gestor de paquetes debe permitir dependencias opcionales. A partir de v2.1.198 el paquete requiere Node.js 22 o posterior. En un Node más antiguo, npm imprime EBADENGINE y la instalación aún puede completarse porque la CLI descarga un binario nativo y no se ejecuta sobre Node en tiempo de ejecución. El paquete de npm se actualiza solo salvo que el directorio global de npm no sea escribible; en ese caso el arranque muestra un aviso una sola vez y claude doctor enumera correcciones. Actualiza con npm install -g @anthropic-ai/claude-code@latest. Anthropic advierte contra npm update -g, que puede quedarse dentro del rango semver original, y contra sudo npm install -g, que puede causar problemas de permisos y riesgos de seguridad. Las plataformas de npm admitidas son darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 y win32-arm64.

  • brew install --cask claude-code
  • brew install --cask claude-code@latest
  • winget install Anthropic.ClaudeCode
  • npm install -g @anthropic-ai/claude-code
  • Línea de suite apt latest: deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main
  • baseurl dnf latest: https://downloads.claude.ai/claude-code/rpm/latest
  • Repositorio apk latest: https://downloads.claude.ai/claude-code/apk/latest

Vía de actualización documentada según el método de instalación

Método Actualización automática en segundo plano Comando de actualización
Nativo Sí, al arrancar y mientras se ejecuta claude update
Homebrew Manual de forma predeterminada; CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 brew upgrade claude-code o brew upgrade claude-code@latest
WinGet Manual de forma predeterminada; CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 winget upgrade Anthropic.ClaudeCode
apt Manual (privilegios elevados) sudo apt update && sudo apt upgrade claude-code
dnf Manual (privilegios elevados) sudo dnf upgrade claude-code
apk Manual (privilegios elevados) apk update && apk upgrade claude-code
npm Sí, salvo que el directorio global de npm no sea escribible npm install -g @anthropic-ai/claude-code@latest 
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
gpg --show-keys /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

Windows nativo frente a WSL, y extras de Alpine

La instalación nativa de Windows se ejecuta desde PowerShell o CMD sin administrador. Git for Windows es opcional para la instalación. Sin él, Claude Code ejecuta los comandos de shell mediante la herramienta de PowerShell. Con Git for Windows, Claude Code usa Git Bash para la herramienta Bash. Las configuraciones de WSL prescinden de Git for Windows. Si Claude Code no encuentra Git Bash, establece CLAUDE_CODE_GIT_BASH_PATH en el archivo de ajustes de usuario ~/.claude/settings.json en C:\Program Files\Git\bin\bash.exe. Esa anulación es solo para Windows cuando Git Bash está instalado y no se encuentra.

La tabla de Windows de Anthropic documenta el aislamiento como no admitido en Windows nativo, admitido en WSL 2 y no admitido en WSL 1. En la vía de WSL, instala y lanza claude dentro de la terminal de WSL. En WSL, una búsqueda que cruza /mnt/c puede devolver menos coincidencias aunque claude doctor muestre Search como OK. Mitigaciones documentadas: búsquedas más estrechas, mantener el proyecto bajo /home/ o ejecutar Windows nativo.

Alpine y otros sistemas musl/uClibc necesitan bash y curl para el comando de instalación, y libgcc, libstdc++ y ripgrep en tiempo de ejecución. Alpine omite bash y curl de forma predeterminada, así que el comando curl documentado falla con not found hasta que esos paquetes están presentes. El ejemplo documentado de Alpine es apk add bash curl libgcc libstdc++ ripgrep. En Alpine, ripgrep está en el repositorio community. Si apk no encuentra ripgrep, añade el repositorio community de esa publicación a /etc/apk/repositories, ejecuta apk update y vuelve a intentar apk add. La URL https://dl-cdn.alpinelinux.org/alpine/v3.22/community de la documentación es un ejemplo para Alpine 3.22. Después de instalar los paquetes, establece USE_BUILTIN_RIPGREP en 0 en la clave env de ~/.claude/settings.json. Esa marca es un interruptor distinto de la ruta de Git Bash de Windows.

Opciones documentadas de configuración en Windows

| Opción | Requiere | Aislamiento | Cuándo usarla |

| — | — | — | — |

| Windows nativo | Nada; Git for Windows es opcional | No admitido | Proyectos y herramientas nativos de Windows |

| WSL 2 | WSL 2 habilitado | Admitido | Cadenas de herramientas de Linux o ejecución de comandos aislada |

| WSL 1 | WSL 1 habilitado | No admitido | Si WSL 2 no está disponible |

~/.claude/settings.json

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

Comprueba el binario y luego inicia sesión

Ejecuta claude --version. Una instalación que funciona imprime un número de versión seguido de (Claude Code). La cadena de ejemplo de Anthropic es 2.1.211 (Claude Code).

claude doctor imprime diagnósticos de solo lectura de la instalación y de los ajustes sin iniciar una sesión, incluidos el estado de la instalación, los errores de validación del archivo de ajustes y las advertencias con correcciones sugeridas. Ejecútalo después de instalar y después de cambiar las marcas de actualización automática. Su informe es un diagnóstico distinto de la línea de versión.

Inicia sesión ejecutando claude y siguiendo las indicaciones del navegador. Si la variable de entorno ANTHROPIC_API_KEY está definida, Claude Code pide una vez que apruebes la clave. Dentro de una sesión en ejecución, escribe /login para cambiar de cuenta. Si tu organización opera una Claude apps gateway autoalojada, el administrador preconfigura la URL de la gateway y /login se abre en la pantalla Cloud gateway para el SSO corporativo.

Si la herramienta Search, las menciones @file, los agentes personalizados o las skills personalizadas no encuentran archivos, instala el paquete ripgrep de tu plataforma y establece USE_BUILTIN_RIPGREP en 0 en la clave env de ~/.claude/settings.json. Confirma en claude doctor que Search muestra la ruta del sistema en lugar de OK (bundled).

claude --version

Salida de ejemplo: 2.1.211 (Claude Code)

Inicio rápido de Claude Code

Problemas de búsqueda y descubrimiento

Actualización automática, canales, versiones mínimas y marcas para detener las actualizaciones

Las instalaciones nativas buscan actualizaciones al arrancar y de forma periódica mientras se ejecutan. Las actualizaciones se descargan en segundo plano y surten efecto la próxima vez que inicias Claude Code. claude update se aplica de inmediato. Una actualización nativa correcta informa Successfully updated from <old version> to version <new version>. Una instalación nativa que ya está al día informa Claude Code is up to date (<version>). En una instalación de Homebrew, WinGet o apk que ya está al día, claude update informa Claude is up to date!.

autoUpdatesChannel es latest de forma predeterminada, o stable (normalmente de alrededor de una semana, y omite las publicaciones con regresiones importantes). Se establece en /config → Auto-update channel, o en el archivo de ajustes de usuario ~/.claude/settings.json. Homebrew elige el canal por el nombre del cask y no por este ajuste: claude-code sigue stable y claude-code@latest sigue latest.

minimumVersion es un suelo: las actualizaciones automáticas en segundo plano y claude update rechazan cualquier versión por debajo. Con ese suelo establecido, pasar a stable deja en su sitio una compilación latest más nueva. Cambiar de latest a stable mediante /config te pregunta si quieres quedarte en la versión actual o permitir la bajada. Elegir quedarse establece minimumVersion en la versión actual. Volver a latest borra ese suelo. Añade minimumVersion en ~/.claude/settings.json para fijar un suelo tú mismo; la página de setup de Anthropic usa 2.1.100 como valor de ejemplo, y tú fijas el suelo que quieras. Los ajustes administrados requiredMinimumVersion y requiredMaximumVersion hacen que Claude Code se niegue a arrancar fuera de un rango de versiones, y las actualizaciones respetan el techo de requiredMaximumVersion.

Establece DISABLE_AUTOUPDATER en 1 en la clave env de ~/.claude/settings.json para detener las comprobaciones en segundo plano. claude update y claude install siguen funcionando. En una instalación nativa o de npm, claude doctor debe mostrar Auto-updates como disabled (set by env: DISABLE_AUTOUPDATER). DISABLE_UPDATES bloquea todas las vías de actualización, incluidas las manuales.

Las instalaciones de Homebrew, WinGet, apt, dnf y apk no se actualizan solas de forma predeterminada. Establece CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 para que Claude Code ejecute la actualización de Homebrew o WinGet en segundo plano y muestre un aviso de reinicio si tiene éxito. En WinGet la actualización puede fallar mientras Claude Code se está ejecutando porque Windows bloquea el ejecutable; entonces Claude Code muestra el comando manual. apt, dnf y apk siguen necesitando una actualización manual porque esos comandos requieren privilegios elevados. Anthropic documenta un problema conocido: Claude Code puede avisarte de una actualización antes de que esa versión esté disponible en Homebrew, WinGet, apt, dnf o apk. Si una actualización falla, espera e inténtalo más tarde.

A partir de v2.1.207, la actualización automática y claude update dejan en su sitio un lanzador personalizado en ~/.local/bin/claude. Antes de esa versión, el actualizador sustituía un lanzador personalizado por su propio symlink en cada actualización. Para que el instalador nativo vuelva a gestionar el lanzador, elimina ~/.local/bin/claude y ejecuta claude update.

A partir de 2.1.89 cada publicación incluye un manifest.json firmado con GPG de sumas SHA256. Importa la clave desde https://downloads.claude.ai/keys/claude-code.asc y confirma la huella 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE. Los binarios de macOS están firmados por Anthropic PBC y notariados por Apple. Los binarios de Windows están firmados por Anthropic, PBC. Los binarios de Linux no llevan firma de código individual; usa el manifiesto o la clave del repositorio apt, dnf o apk.

~/.claude/settings.json

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

Desinstala con el mismo método y luego decide qué hacer con la configuración

Quita Claude Code con el mismo método que usaste para instalarlo. La lista de abajo corresponde a cada instalador. Si claude sigue ejecutándose después, Anthropic dice que es probable que haya una segunda instalación o un alias de shell residual de un instalador anterior. Usa Check for conflicting installations en la página Troubleshoot installation.

Los ajustes de usuario están en ~/.claude y ~/.claude.json. Los ajustes del proyecto están en .claude y .mcp.json del repositorio. Los servidores MCP (Model Context Protocol) son herramientas adicionales que Claude Code carga desde esos archivos de configuración. Borrar esas rutas elimina los ajustes, las herramientas permitidas, las configuraciones de servidores MCP y el historial de sesiones. La extensión de VS Code, el complemento de JetBrains y la aplicación Desktop vuelven a crear ~/.claude si siguen instalados.

La página del changelog se genera a partir de CHANGELOG.md en GitHub. Comprueba lo que tienes con claude --version.

  • Nativo en macOS, Linux, WSL: rm -f ~/.local/bin/claude y rm -rf ~/.local/share/claude
  • PowerShell nativo de Windows: Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force y después Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
  • brew uninstall --cask claude-code
  • brew uninstall --cask claude-code@latest
  • winget uninstall Anthropic.ClaudeCode
  • sudo apt remove claude-code y después sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc
  • sudo dnf remove claude-code y después sudo rm /etc/yum.repos.d/claude-code.repo
  • apk del claude-code, después sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories, después rm /etc/apk/keys/claude-code.rsa.pub
  • npm uninstall -g @anthropic-ai/claude-code
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Elige el instalador que corresponda a tu sistema operativo, ejecuta claude --version y claude doctor, inicia sesión con claude y usa ese mismo método para las actualizaciones y la desinstalación.

Fuentes