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

Si la instalación falla o no puede iniciar sesión, encuentre su error a continuación. Para problemas en tiempo de ejecución después de que Claude Code esté funcionando, consulte Solución de problemas. Para problemas de configuración como configuraciones que no se aplican o hooks que no se disparan, consulte Depurar su configuración.

Encuentre su error

Haga coincidir el mensaje de error o síntoma que está viendo con una solución:

Lo que ve	Solución
`command not found: claude` o `'claude' is not recognized`	Corrija su PATH
`syntax error near unexpected token '<'`	El script de instalación devuelve HTML
`curl: (22) The requested URL returned error: 403`	El script de instalación devolvió 403
`curl: (23)` o `curl: (56) Failure writing output to destination`	Verifique la conectividad o use un instalador alternativo
`Killed` durante la instalación en Linux, o `Installation was killed before it could finish (exit code 137)`	Libere memoria o agregue espacio de intercambio
`Raw mode is not supported` durante la instalación	Vuelva a ejecutar el instalador
`TLS connect error` o `SSL/TLS secure channel`	Actualice los certificados CA
`Failed to fetch version` o no puede alcanzar el servidor de descarga	Verifique la configuración de red y proxy
`irm is not recognized` o `&& is not valid`	Use el comando correcto para su shell
`Cask 'claude-code' is unavailable: No Cask with this name exists`	Actualice Homebrew
`'bash' is not recognized as the name of a cmdlet`	Use el comando del instalador de Windows
`A parameter cannot be found that matches parameter name 'fsSL'`	Use el comando del instalador de Windows
`Claude Code on Windows requires either Git for Windows (for bash) or PowerShell`	Instale un shell
`Claude Code does not support 32-bit Windows`	Abra Windows PowerShell, no la entrada x86
`The process cannot access the file ... because it is being used by another process`	Borre la carpeta de descargas e intente de nuevo
`Error loading shared library`	Variante binaria incorrecta para su sistema
`Illegal instruction`	Desajuste de arquitectura o conjunto de instrucciones de CPU
`cannot execute binary file: Exec format error` en WSL	Regresión binaria nativa de WSL1
El instalador de PowerShell se completa pero `claude` no se encuentra o muestra una versión anterior	Agregue el directorio de instalación a su PATH, luego abra una nueva terminal
`dyld: Symbol not found`, `dyld: cannot load`, o `Abort trap` en macOS	Incompatibilidad binaria
`claude update` se cuelga después de `Checking for updates`, o `claude doctor` se cuelga sin salida	Mueva el directorio en una ruta de configuración de shell
`Invoke-Expression` o `iex` errores de análisis citando etiquetas HTML o CSS, o `ParserError` con `ParseException`	El script de instalación devuelve HTML
`running scripts is disabled on this system` o `PSSecurityException`	Permita que los shims de npm se ejecuten
`Error: claude native binary not installed`	Complete la instalación de npm
`npm error code ENOTEMPTY` durante la actualización o reinstalación	Elimine el directorio de paquete sobrante
En Windows, el comando de instalación imprime texto de script y nada se instala	Ejecute el comando de instalación completo
`App unavailable in region`	Claude Code no está disponible en su país. Consulte países admitidos.
`unable to get local issuer certificate`	Configure certificados CA corporativos
`OAuth error` u `403 Forbidden`	Corrija la autenticación
`Unable to connect to Anthropic services` durante la configuración	Consulte Unable to connect to Anthropic services en la referencia de errores
`Could not load the default credentials` o `Could not load credentials from any providers`	Credenciales de Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry
`ChainedTokenCredential authentication failed` o `CredentialUnavailableError`	Credenciales de Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry
`API Error: 500`, `529 Overloaded`, `429`, u otros errores 4xx y 5xx no listados arriba	Consulte la referencia de errores

Si su problema no está listado, trabaje a través de las verificaciones de diagnóstico a continuación para reducir la causa.

Si prefiere omitir la terminal por completo, la aplicación de escritorio Claude Code le permite instalar y usar Claude Code a través de una interfaz gráfica. Descárguela para macOS o Windows y comience a codificar sin ninguna configuración de línea de comandos. En Linux, instale la aplicación con apt siguiendo las instrucciones de instalación de Linux.

Ejecute verificaciones de diagnóstico

Verifique la conectividad de red

El instalador descarga desde downloads.claude.ai. Verifique que pueda alcanzarlo:

macOS/Linux
Windows PowerShell

curl -sI https://downloads.claude.ai/claude-code-releases/latest

curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest

PowerShell crea un alias de curl a Invoke-WebRequest, que rechaza los indicadores -sI, así que llame a curl.exe explícitamente.

Alcanzó el servidor si la primera línea muestra un estado 200. Verá HTTP/2 200 en macOS y Linux, e HTTP/1.1 200 OK desde curl.exe incluido con Windows. Otros resultados apuntan a la causa:

403: generalmente un proxy o filtro de red bloqueando el host, o Claude Code no está disponible en su región
5xx: generalmente un problema temporal del servicio; espere unos minutos e intente de nuevo

Si no ve salida, Could not resolve host, o un tiempo de espera de conexión, su red está bloqueando la conexión. Las causas comunes incluyen:

Firewalls corporativos o proxies bloqueando downloads.claude.ai
Restricciones de red regional: intente una VPN o red alternativa
Problemas de TLS/SSL: actualice los certificados CA de su sistema, o verifique si HTTPS_PROXY está configurado

Si está detrás de un proxy corporativo, establezca HTTPS_PROXY y HTTP_PROXY en la dirección de su proxy antes de instalar. Pregunte a su equipo de TI por la URL del proxy si no la conoce, o verifique la configuración del proxy de su navegador. Este ejemplo establece ambas variables de proxy, luego ejecuta el instalador a través de su proxy:

macOS/Linux
Windows PowerShell

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash

$env:HTTP_PROXY = 'http://proxy.example.com:8080'
$env:HTTPS_PROXY = 'http://proxy.example.com:8080'
irm https://claude.ai/install.ps1 | iex

Verifique su PATH

Si la instalación fue exitosa pero obtiene un error command not found o not recognized al ejecutar claude, el directorio de instalación no está en su PATH. Su shell busca programas en directorios listados en PATH, y el instalador coloca claude en ~/.local/bin/claude en macOS/Linux o %USERPROFILE%\.local\bin\claude.exe en Windows.

La extensión de VS Code no coloca claude en esta ubicación. Agrupa una copia privada de la CLI dentro del directorio de la extensión para su propio panel de chat y no la agrega a PATH. Si solo ha instalado la extensión, ~/.local/bin/claude no existirá. Ejecute la instalación independiente para usar claude desde una terminal, luego continúe a continuación.

Verifique si el directorio de instalación está en su PATH listando sus entradas de PATH y filtrando por local/bin:

macOS/Linux
Windows PowerShell
Windows CMD

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

Si esto imprime /Users/you/.local/bin o /home/you/.local/bin, el directorio está en su PATH y puede saltar a Verifique instalaciones conflictivas. Si no hay salida, agréguelo a su configuración de shell.Para Zsh, el predeterminado en macOS:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Para Bash, el predeterminado en la mayoría de distribuciones de Linux:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Alternativamente, cierre y vuelva a abrir su terminal.Para otros shells como fish o Nushell, agregue ~/.local/bin a su PATH usando la sintaxis de configuración propia de su shell, luego reinicie su terminal.Verifique que la corrección funcionó:

claude --version

$env:PATH -split ';' | Select-String '\.local\\bin'

Si no hay salida, agregue el directorio de instalación a su PATH de usuario:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Reinicie su terminal para que el cambio surta efecto.Verifique que la corrección funcionó:

claude --version

echo %PATH% | findstr /i "local\bin"

Si no hay salida, abra Configuración del sistema, vaya a Variables de entorno, y agregue %USERPROFILE%\.local\bin a su variable PATH de usuario. Reinicie su terminal.Verifique que la corrección funcionó:

claude --version

Verifique instalaciones conflictivas

Múltiples instalaciones de Claude Code pueden causar desajustes de versión o comportamiento inesperado. Verifique qué está instalado:

macOS/Linux
Windows PowerShell

Liste todos los binarios claude encontrados en su PATH:

which -a claude

Si esto no imprime nada, ningún claude está en su PATH aún. Vuelva a Verifique su PATH.Verifique las tres ubicaciones de donde puede venir un binario claude. ~/.local/bin/claude es el instalador nativo, ~/.claude/local/ es una instalación npm local heredada creada por versiones anteriores de Claude Code, y la lista npm global muestra una instalación -g:

ls -la ~/.local/bin/claude

Una instalación nativa muestra un enlace simbólico en ~/.local/share/claude/versions/. Un script o un enlace simbólico que creó usted mismo en esta ruta es un iniciador personalizado, que la actualización automática deja en su lugar.Si algún comando ls imprime No such file or directory, eso no es un error. Significa que nada está instalado en esa ubicación, así que continúe con la siguiente verificación.

ls -la ~/.claude/local/

npm -g ls @anthropic-ai/claude-code 2>/dev/null

Liste todos los binarios claude encontrados en su PATH:

where.exe claude

Verifique si el instalador nativo colocó un binario:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

Si encuentra múltiples instalaciones, mantenga solo una. La instalación nativa en ~/.local/bin/claude en macOS/Linux o %USERPROFILE%\.local\bin\claude.exe en Windows es recomendada. Elimine las extras: Desinstale una instalación npm global:

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

Elimine la instalación npm local heredada:

macOS/Linux
Windows PowerShell

rm -rf ~/.claude/local

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"

Elimine una instalación de Homebrew en macOS. Si instaló el cask claude-code@latest, sustituya ese nombre:

brew uninstall --cask claude-code

Elimine una instalación de WinGet en Windows:

winget uninstall Anthropic.ClaudeCode

Verifique permisos de directorio

El instalador necesita acceso de escritura a ~/.local/bin/ y ~/.claude/ en macOS y Linux. En Windows la ubicación de instalación está bajo %USERPROFILE%, que es escribible por su usuario de forma predeterminada, por lo que esta sección rara vez se aplica allí. Verifique si los directorios son escribibles:

test -w ~/.local/bin && echo "writable" || echo "not writable"
test -w ~/.claude && echo "writable" || echo "not writable"

Si algún directorio no es escribible, cree el directorio de instalación y establezca su usuario como propietario:

sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

Verifique que el binario funciona

Si claude --version imprime una versión pero claude se bloquea o cuelga al iniciar, ejecute estas verificaciones para reducir la causa. Si claude --version dice comando no encontrado, vaya a Verifique su PATH primero; los comandos a continuación asumen que claude está en su PATH. Confirme que el binario existe y es ejecutable:

macOS/Linux
Windows PowerShell

ls -la "$(command -v claude)"

Get-Command claude | Select-Object Source

En Linux, verifique bibliotecas compartidas faltantes. Si ldd muestra bibliotecas faltantes, es posible que deba instalar paquetes del sistema. En Alpine Linux y otras distribuciones basadas en musl, consulte Configuración de Alpine Linux.

ldd "$(command -v claude)" | grep "not found"

Confirme que el binario puede ejecutarse:

claude --version

Problemas comunes de instalación

Estos son los problemas de instalación más frecuentes y sus soluciones.

El script de instalación devuelve HTML en lugar de un script de shell

Al ejecutar el comando de instalación, puede ver uno de estos errores:

bash: line 1: syntax error near unexpected token `<'
bash: line 1: `<!DOCTYPE html>'

En PowerShell, el mismo problema aparece como errores de análisis que apuntan a la página devuelta, con iex intentando ejecutar HTML y CSS como PowerShell:

iex : At line:1 char:2310
+ ... igin="anonymous"/><script type="text/javascript">!function(o,c){var n ...
Missing argument in parameter list.
...

La redacción varía según la versión de PowerShell e idioma del sistema: puede ver Missing expression after unary operator '--' o un ParserError con ParseException en su lugar. Las etiquetas HTML o CSS en el texto entrecomillado identifican este fallo. Si descarga con -OutFile install.ps1 en su lugar, el archivo guardado es la misma página web, por lo que eso tampoco ayuda. Dependiendo de cómo se enrutó la solicitud, en su lugar puede ver un 403 sin cuerpo HTML:

curl: (22) The requested URL returned error: 403

Todos estos significan que la URL de instalación devolvió una página HTML o un estado de error en lugar del script de instalación. Si la página HTML dice “App unavailable in region”, Claude Code no está disponible en su país. Consulte países admitidos. Un 403 desnudo sin cuerpo a menudo tiene la misma causa, pero también puede provenir de un proxy corporativo o firewall que bloquea la descarga. Si está en un país admitido y aún ve el 403, trabaje a través de Verifique la conectividad de red antes de intentar los instaladores alternativos a continuación, ya que esos alcanzan los mismos hosts. De lo contrario, esto puede ocurrir debido a problemas de red, enrutamiento regional o una interrupción temporal del servicio. Soluciones:

Use un método de instalación alternativo: En macOS, instale a través de Homebrew:
brew install --cask claude-code
En Windows, instale a través de WinGet:
winget install Anthropic.ClaudeCode
Luego ejecute claude --version para confirmar: el comando imprime un número de versión como 2.1.211 (Claude Code). Si el shell reporta que claude no se encuentra, abra una nueva ventana de terminal e intente nuevamente: la sesión desde la que instaló mantiene su antiguo PATH.
Reintente después de unos minutos: el problema suele ser temporal. Espere e intente el comando original nuevamente.

`command not found: claude` después de la instalación

La instalación finalizó pero claude no funciona. El error exacto varía según la plataforma:

Plataforma	Mensaje de error
macOS	`zsh: command not found: claude`
Linux	`bash: claude: command not found`
Windows CMD	`'claude' is not recognized as an internal or external command`
PowerShell	`claude : The term 'claude' is not recognized as the name of a cmdlet`

Esto significa que el directorio de instalación no está en la ruta de búsqueda de su shell. Consulte Verifique su PATH para la corrección en cada plataforma.

`curl: (56) Failure writing output to destination`

El comando curl ... | bash descarga el script y lo canaliza a Bash para su ejecución. Este error, y el relacionado curl: (23) Failure writing output to destination, significa que Bash no recibió el script completo. El código de salida 56 indica que la descarga en sí fue interrumpida, y el código de salida 23 indica que curl no pudo escribir lo que recibió en la tubería, generalmente porque Bash salió temprano. Soluciones:

Verifique la estabilidad de la red: Los binarios de Claude Code se alojan en downloads.claude.ai. Pruebe que pueda alcanzarlo:
curl -sI https://downloads.claude.ai/claude-code-releases/latest
Una línea HTTP/2 200 significa que alcanzó el servidor y el fallo original probablemente fue intermitente; reintente el comando de instalación. Otros resultados apuntan a la causa:
- 403: generalmente un proxy o filtro de red bloqueando el host, o Claude Code no está disponible en su región
- 5xx: generalmente un problema temporal del servicio; espere unos minutos e intente nuevamente
- Could not resolve host o un tiempo de espera de conexión: su red está bloqueando la descarga
Intente un método de instalación alternativo: En macOS:
brew install --cask claude-code
En Windows:
winget install Anthropic.ClaudeCode
Luego ejecute claude --version para confirmar: el comando imprime un número de versión como 2.1.211 (Claude Code). Si el shell reporta que claude no se encuentra, abra una nueva ventana de terminal e intente nuevamente: la sesión desde la que instaló mantiene su antiguo PATH.

Cask de Homebrew no disponible u obsoleto

Homebrew reporta Error: Cask 'claude-code' is unavailable: No Cask with this name exists cuando su copia local del índice de cask de Homebrew es anterior a la publicación del cask. Actualice el índice e intente nuevamente:

brew update
brew install --cask claude-code

Si Homebrew instala una versión anterior de Claude Code de la que espera, el mismo índice obsoleto suele ser la causa. El cask claude-code rastrea el canal estable y típicamente está aproximadamente una semana detrás de la última versión; para la versión más reciente ejecute brew install --cask claude-code@latest en su lugar. Consulte Configurar canal de versión para la diferencia entre los dos casks.

Errores de conexión TLS o SSL

Errores como curl: (35) TLS connect error, schannel: next InitializeSecurityContext failed, o el Could not establish trust relationship for the SSL/TLS secure channel de PowerShell indican fallos de protocolo de enlace TLS. Soluciones:

Actualice sus certificados CA del sistema: En Ubuntu/Debian:
sudo apt-get update && sudo apt-get install ca-certificates
En macOS, el curl del sistema usa el almacén de confianza de Keychain; actualizar macOS en sí actualiza los certificados raíz.

En Windows, habilite TLS 1.2 en PowerShell antes de ejecutar el instalador:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

Verifique la interferencia de proxy o firewall: los proxies corporativos que realizan inspección TLS pueden causar estos errores, incluidos unable to get local issuer certificate y SELF_SIGNED_CERT_IN_CHAIN. Para el paso de instalación, haga que la descarga de instalación confíe en el CA corporativo:
- macOS/Linux
- Windows PowerShell
curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash
El instalador de PowerShell descarga a través de .NET, que valida TLS contra el almacén de certificados de Windows. Pida a su equipo de TI que agregue el certificado CA del proxy al almacén de Windows si aún no está allí, luego ejecute el instalador:
irm https://claude.ai/install.ps1 | iex
Para Claude Code en sí una vez instalado, establezca NODE_EXTRA_CA_CERTS para que las solicitudes de API confíen en el mismo paquete:
- macOS/Linux
- Windows PowerShell
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
$env:NODE_EXTRA_CA_CERTS = 'C:\path\to\corporate-ca.pem'
Pida a su equipo de TI el archivo de certificado si no lo tiene. También puede intentar en una conexión directa para confirmar que el proxy es la causa.
En Windows, solucione verificaciones de revocación bloqueadas. Los errores CRYPT_E_NO_REVOCATION_CHECK (0x80092012) y CRYPT_E_REVOCATION_OFFLINE (0x80092013) significan que curl alcanzó el servidor pero su red bloquea la búsqueda de revocación de certificados, que es común detrás de firewalls corporativos. Si el comando que falla es el curl que descarga install.cmd, ejecútelo nuevamente desde un símbolo del sistema con --ssl-revoke-best-effort agregado:
curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Cuando las descargas propias del script encuentran los mismos errores, las reintenta con verificación de revocación de mejor esfuerzo automáticamente, por lo que la bandera solo es necesaria en el comando que ejecuta usted mismo. La verificación de mejor esfuerzo tolera un servidor de revocación inaccesible pero aún rechaza un certificado que se sabe que está revocado, coincidiendo con cómo los navegadores manejan la revocación. También puede evitar completamente la verificación de revocación de curl ejecutando el instalador de PowerShell desde PowerShell, que descarga a través de .NET y no falla cuando el servidor de revocación es inaccesible:
irm https://claude.ai/install.ps1 | iex
También puede instalar con winget install Anthropic.ClaudeCode, que evita curl por completo.

`Failed to fetch version from downloads.claude.ai`

El instalador no pudo alcanzar el servidor de descarga. Esto típicamente significa que downloads.claude.ai está bloqueado en su red. Consulte Verifique la conectividad de red.

Comando de instalación incorrecto en Windows

Si ve 'irm' is not recognized, The token '&&' is not valid, A parameter cannot be found that matches parameter name 'fsSL', o 'bash' is not recognized as the name of a cmdlet, copió el comando de instalación para un shell o sistema operativo diferente. Si el comando imprime el texto del script en lugar de instalar algo, ejecutó solo parte del mismo.

irm no reconocido: está en CMD, no en PowerShell. Tiene dos opciones: Abra PowerShell buscando “PowerShell” en el menú Inicio, luego ejecute el comando de instalación original:
irm https://claude.ai/install.ps1 | iex
O permanezca en CMD y use el instalador de CMD en su lugar:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
&& no válido: está en PowerShell pero ejecutó el comando del instalador de CMD. Use el instalador de PowerShell:
irm https://claude.ai/install.ps1 | iex
A parameter cannot be found that matches parameter name 'fsSL': ejecutó el instalador de macOS/Linux curl -fsSL ... | bash en Windows PowerShell, donde curl es un alias para Invoke-WebRequest y rechaza los indicadores -fsSL. Use el instalador de PowerShell en su lugar:
irm https://claude.ai/install.ps1 | iex
bash no reconocido: ejecutó el instalador de macOS/Linux en Windows. Use el instalador de PowerShell en su lugar:
irm https://claude.ai/install.ps1 | iex
El comando imprime texto del script en lugar de instalar: ejecutó la mitad de descarga del comando sin la parte que lo ejecuta. irm https://claude.ai/install.ps1 por sí solo imprime el script descargado en la terminal. Canalícelo a iex para ejecutarlo:
irm https://claude.ai/install.ps1 | iex
En CMD, curl -fsSL https://claude.ai/install.cmd sin -o imprime el script por lotes en lugar de guardarlo. Ejecute el comando completo:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Cualquiera que sea el instalador que use, confirme que funcionó: abra una nueva terminal y ejecute claude --version, que imprime un número de versión como 2.1.211 (Claude Code).

`running scripts is disabled on this system`

Instalar o ejecutar Claude Code a través de npm en Windows puede fallar con un SecurityError:

npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.
...
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException

El mismo error nombra claude.ps1 cuando ejecuta claude después de una instalación de npm. La política de ejecución de PowerShell está bloqueando los scripts de lanzador .ps1 que npm crea para sus comandos. La política se aplica a archivos de script, por lo que no afecta al instalador de PowerShell irm https://claude.ai/install.ps1 | iex, que ejecuta el texto descargado directamente. Soluciones:

Permita scripts creados localmente para su usuario, luego intente nuevamente:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Llame al lanzador .cmd en su lugar: npm.cmd y claude.cmd hacen el mismo trabajo, y la política no los cubre.
Use el instalador de PowerShell en lugar de npm. Instala un binario en lugar de un script .ps1.

`The process cannot access the file` durante la instalación en Windows

Si el instalador de PowerShell falla con Failed to download binary: The process cannot access the file ... because it is being used by another process, el instalador no pudo escribir en %USERPROFILE%\.claude\downloads. Esto generalmente significa que un intento de instalación anterior aún se está ejecutando, o el software antivirus está escaneando un binario descargado parcialmente en esa carpeta. Cierre cualquier otra ventana de PowerShell ejecutando el instalador y espere a que los escaneos de antivirus liberen el archivo. Luego elimine la carpeta de descargas y ejecute el instalador nuevamente:

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

La instalación se cuelga en servidores Linux con poca memoria

Un mensaje Killed durante la instalación generalmente significa que el asesino de falta de memoria (OOM) de Linux terminó el paso claude install porque el sistema se quedó sin memoria libre. Esto es común en VPS pequeños e instancias en la nube. El script de instalación reporta la causa y sale con código 137. En este ejemplo, el número de línea e ID de proceso varían según la versión y ejecución:

Setting up Claude Code...
bash: line 183: 34803 Killed    "$binary_path" install ${TARGET:+"$TARGET"}
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

La instalación necesita aproximadamente 512 MB de memoria libre, y ejecutar Claude Code necesita más. Consulte los requisitos del sistema. Soluciones:

Agregue espacio de intercambio si su servidor tiene RAM limitada. El intercambio usa espacio en disco como memoria de desbordamiento, permitiendo que la instalación se complete incluso con RAM física baja. Cree un archivo de intercambio de 2 GB y habilítelo:
sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile
Luego reintente la instalación:
curl -fsSL https://claude.ai/install.sh | bash
Cierre otros procesos para liberar memoria antes de instalar.
Use una instancia más grande si es posible. Claude Code requiere al menos 4 GB de RAM.

La instalación se cuelga en Docker

Al instalar Claude Code en un contenedor Docker, instalar como root en / puede causar cuelgues. Soluciones:

Establezca un directorio de trabajo antes de ejecutar el instalador. Cuando se ejecuta desde /, el instalador escanea todo el sistema de archivos, lo que causa un uso excesivo de memoria. Establecer WORKDIR limita el escaneo a un directorio pequeño:
WORKDIR /tmp RUN curl -fsSL https://claude.ai/install.sh | bash
Aumente la memoria de Docker si usa Docker Desktop. Los contenedores de compilación comparten la memoria asignada a la máquina virtual de Docker Desktop, así que abra Settings > Resources en Docker Desktop, aumente el límite de memoria, y reejecutar la compilación.

`Raw mode is not supported` durante la instalación

Cuando la configuración administrada por servidor de su organización incluye cambios que necesitan aprobación de seguridad, las versiones de Claude Code anteriores a 2.1.246 intentan mostrar el diálogo de aprobación durante claude install. El diálogo necesita una terminal en stdin. Cuando el instalador ejecuta claude install desde una tubería, como curl -fsSL https://claude.ai/install.sh | bash hace, stdin es la tubería en lugar de una terminal, por lo que la instalación falla con un error que contiene Raw mode is not supported. Claude Code v2.1.246 y posterior no muestran el diálogo durante claude install o claude update. El comando se ejecuta con la configuración que aprobó por última vez, y Claude Code muestra el diálogo en su próxima sesión interactiva. Si la configuración de inicio de su organización espera la obtención de configuración, como cuando establece forceRemoteSettingsRefresh, el diálogo aún aparece durante estos comandos, y una ejecución de instalación desde una tubería aún falla. En todas las demás configuraciones, reejecutar el instalador supera este error, porque el script ejecuta el comando install de la versión más reciente incluso cuando le pide que instale una versión anterior. Reejecute el comando para su plataforma:

macOS/Linux
Windows PowerShell

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

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

claude --version imprime la versión que la reejecución instaló.

`claude update` o `claude doctor` se cuelga

claude update y claude doctor escanean sus archivos de configuración de shell para un alias claude obsoleto: ~/.zshrc, ~/.bashrc, y ~/.config/fish/config.fish, más en macOS el primero de ~/.bash_profile, ~/.bash_login, o ~/.profile que existe. Si establece ZDOTDIR, el archivo Zsh es $ZDOTDIR/.zshrc en su lugar. Cuando una de esas rutas es un directorio, Claude Code la omite y ambos comandos se completan normalmente. Antes de v2.1.214, un directorio en una de esas rutas hacía que ambos comandos se cuelguen y dejaba la sección de diagnósticos del sistema de /status en blanco. claude doctor se colgaba sin salida; claude update se colgaba justo después de imprimir Checking for updates. Si encuentra el cuelgue en una versión anterior, encuentre el directorio. En la salida de este comando, una línea que comienza con d marca esa ruta como un directorio. Una línea No such file or directory significa que nada existe en esa ruta y no es la causa:

ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish

Mueva el directorio a un lado, o actualice a v2.1.214 o posterior. Dado que claude update se cuelga en las versiones afectadas, actualice reejecutando el script de instalación en su lugar.

Claude Desktop anula el comando `claude` en Windows

Si instaló una versión anterior de Claude Desktop, puede registrar un Claude.exe en el directorio WindowsApps que toma prioridad de PATH sobre Claude Code CLI. Ejecutar claude abre la aplicación de escritorio en lugar de la CLI. Actualice Claude Desktop a la versión más reciente para corregir este problema.

Claude Code en Windows requiere Git para Windows (para bash) o PowerShell

Git para Windows es opcional. Claude Code usa la herramienta PowerShell cuando Git Bash está ausente, por lo que este error significa que ninguno de los dos shells fue encontrado. Si PowerShell falta de su PATH, su ubicación predeterminada es C:\Windows\System32\WindowsPowerShell\v1.0\. Agregue ese directorio a su PATH, o instale PowerShell 7, que proporciona pwsh. Para instalar Git para Windows en su lugar, descárguelo desde git-scm.com/downloads/win. Durante la configuración, seleccione “Add to PATH.” Reinicie su terminal después de instalar. Instalarlo habilita la herramienta Bash, útil cuando se trabaja con scripts y herramientas basadas en Bash. Si Git ya está instalado pero Claude Code no puede encontrarlo, compare su ubicación contra los lugares que Claude Code verifica. Cuando CLAUDE_CODE_GIT_BASH_PATH no está establecido, Claude Code busca bash.exe en este orden:

Las ubicaciones de instalación predeterminadas C:\Program Files\Git y C:\Program Files (x86)\Git.
El git en su PATH, usando el bin\bash.exe de esa instalación de Git.

En el paso 2, Claude Code omite un git que se encuentra en la carpeta desde la que lanzó Claude Code, o debajo de ella en una ruta que contiene node_modules o una carpeta de entorno virtual como .venv o env, por ejemplo C:\dev\env\myproject\Git cuando lanzó desde C:\dev\env\myproject. Esto evita que Claude Code ejecute un ejecutable que un proyecto colocó allí. Si su Git está en una ubicación como esa, apunte CLAUDE_CODE_GIT_BASH_PATH a él. Para apuntar Claude Code a una instalación específica de Git, encuéntrela ejecutando where.exe git en PowerShell, luego establezca la ruta bin\bash.exe de esa instalación como CLAUDE_CODE_GIT_BASH_PATH en su archivo settings.json:

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

Si CLAUDE_CODE_GIT_BASH_PATH está establecido en la ruta correcta y el archivo existe pero Claude Code aún no lo usa, verifique primero el nombre del archivo. Claude Code acepta solo un archivo nombrado bash.exe, sh.exe, bash, o sh; con cualquier otro nombre, como el lanzador git-bash.exe de Git para Windows, ignora la variable y auto-detecta Git Bash como si no estuviera establecida, registrando una advertencia visible con --debug. Una ruta que no existe obtiene el mismo fallback y advertencia. Antes de v2.1.219, Claude Code usaba cualquier archivo existente como shell sin verificar su nombre, y salía al inicio con Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path cuando la ruta no existía. Si el nombre del archivo es correcto, el software de seguridad de punto final como AppLocker, políticas de restricción de software de Directiva de grupo, o agentes EDR pueden estar interfiriendo. Pida a su equipo de TI que agregue a la lista blanca claude.exe y los procesos que genera, incluidos cmd.exe y bash.exe, en su política de protección de punto final.

Claude Code no admite Windows de 32 bits

Windows incluye dos entradas de PowerShell en el menú Inicio: Windows PowerShell y Windows PowerShell (x86). La entrada x86 se ejecuta como un proceso de 32 bits y desencadena este error incluso en una máquina de 64 bits. Para verificar en qué caso está, ejecute esto en la misma ventana que produjo el error:

[Environment]::Is64BitOperatingSystem

Si esto imprime True, su sistema operativo está bien. Cierre la ventana, abra Windows PowerShell sin el sufijo x86, y ejecute el comando de instalación nuevamente. Si esto imprime False, está en una edición de Windows de 32 bits. Claude Code requiere un sistema operativo de 64 bits. Consulte los requisitos del sistema.

Desajuste binario musl o glibc de Linux

Si ve errores sobre bibliotecas compartidas faltantes como libstdc++.so.6 o libgcc_s.so.1 después de la instalación, el instalador puede haber descargado la variante binaria incorrecta para su sistema.

Error loading shared library libstdc++.so.6: No such file or directory

Esto puede ocurrir en sistemas basados en glibc que tienen paquetes de compilación cruzada musl instalados, causando que el instalador detecte incorrectamente el sistema como musl. Soluciones:

Verifique qué libc usa su sistema:
ldd --version 2>&1 | head -1
La salida que menciona GNU libc o GLIBC significa glibc. La salida que menciona musl significa musl.
Si está en glibc pero obtuvo el binario musl, elimine la instalación y reinstale. También puede descargar manualmente el binario correcto usando el manifiesto en https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json. Presente un problema de GitHub con la salida de ldd --version y ls /lib/libc.musl*.
Si realmente está en musl, como Alpine Linux, instale los paquetes requeridos:
apk add libgcc libstdc++ ripgrep
En Alpine, ripgrep está en el repositorio de comunidad. Si apk reporta que el paquete falta, consulte Configuración de Alpine Linux.

`Illegal instruction`

Si ejecutar claude o el instalador imprime Illegal instruction, el binario nativo usa instrucciones de CPU que su procesador no admite. Hay dos causas distintas. Desajuste de arquitectura. El instalador descargó el binario incorrecto, por ejemplo x86 en un servidor ARM. Verifique con uname -m en macOS o Linux, o $env:PROCESSOR_ARCHITECTURE en PowerShell. Si el resultado no coincide con el binario que recibió, presente un problema de GitHub con la salida. Conjunto de instrucciones AVX faltante. Si su arquitectura es correcta pero aún ve Illegal instruction, su CPU probablemente carece de AVX u otra instrucción que requiere el binario. Esto afecta aproximadamente a procesadores Intel y AMD anteriores a 2013, y máquinas virtuales donde el hipervisor no pasa AVX al invitado. En un VPS o VM, ejecute grep -m1 -ow avx /proc/cpuinfo; un resultado vacío significa que AVX no está disponible para el invitado. No hay solución de binario nativo; siga el problema #50384 para el estado, e incluya su modelo de CPU de grep -m1 "model name" /proc/cpuinfo en Linux o sysctl -n machdep.cpu.brand_string en macOS al reportar. Los métodos de instalación alternativos descargan el mismo binario nativo y no resolverán ninguna de las causas.

`dyld: cannot load` en macOS

Si ve dyld: Symbol not found, dyld: cannot load, o Abort trap: 6 durante la instalación, el binario es incompatible con su versión de macOS o hardware. Un error Symbol not found que hace referencia a libicucore significa que su versión de macOS es más antigua que la que admite el binario:

dyld: Symbol not found: _ubrk_clone
  Referenced from: claude-darwin-x64 (which was built for Mac OS X 13.0)
  Expected in: /usr/lib/libicucore.A.dylib

El cargador puede en su lugar rechazar los comandos de carga del binario, lo que también significa que su versión de macOS es demasiado antigua:

dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)
Abort trap: 6

Soluciones:

Verifique su versión de macOS: Claude Code requiere macOS 13.0 o posterior. Abra el menú Apple y seleccione Acerca de esta Mac para verificar su versión.
Actualice macOS si está en una versión anterior. El binario usa comandos de carga y bibliotecas del sistema que las versiones anteriores de macOS no admiten. Los métodos de instalación alternativos como Homebrew descargan el mismo binario y no resolverán este error.

`Exec format error` en WSL1

Si ejecutar claude en WSL imprime cannot execute binary file: Exec format error, está en WSL1 y está experimentando una regresión binaria nativa conocida rastreada en el problema #38788. Los encabezados del programa del binario cambiaron de una manera que el cargador de WSL1 no puede manejar. La corrección más limpia es convertir su distribución a WSL2 desde PowerShell:

wsl --set-version <DistroName> 2

Si necesita permanecer en WSL1, invoque el binario a través del enlazador dinámico. Agregue esta función a ~/.bashrc dentro de WSL, reemplazando la ruta si su directorio de inicio es diferente:

claude() {
  /lib64/ld-linux-x86-64.so.2 "$(readlink -f "$HOME/.local/bin/claude")" "$@"
}

Luego ejecute source ~/.bashrc e intente claude nuevamente.

Errores de instalación de npm en WSL

Estos problemas se aplican si instaló Claude Code con npm install -g dentro de WSL. Si usó el instalador nativo, omita esta sección. Problemas de detección de SO o plataforma. Si npm reporta un desajuste de plataforma durante la instalación, WSL probablemente está recogiendo el npm de Windows. Ejecute npm config set os linux primero, luego instale con npm install -g @anthropic-ai/claude-code --force. No use sudo. exec: node: not found al ejecutar claude. Su entorno WSL probablemente está usando la instalación de Node.js de Windows. Confirme con which npm y which node: las rutas que comienzan con /mnt/c/ son binarios de Windows, mientras que las rutas de Linux comienzan con /usr/. Para corregir esto, instale Node a través del administrador de paquetes de su distribución de Linux o a través de nvm. Conflictos de versión de nvm. Si tiene nvm instalado tanto en WSL como en Windows, cambiar versiones de Node en WSL puede romper porque WSL importa el PATH de Windows de forma predeterminada y el nvm de Windows toma prioridad. La causa más común es que nvm no está cargado en su shell. Agregue el cargador de nvm a ~/.bashrc o ~/.zshrc:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

O cárguelo en su sesión actual:

source ~/.nvm/nvm.sh

Si nvm está cargado pero las rutas de Windows aún toman prioridad, anteponga explícitamente su ruta de Node de Linux:

export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"

Evite deshabilitar la importación de PATH de Windows a través de appendWindowsPath = false ya que esto rompe la capacidad de llamar ejecutables de Windows desde WSL. De manera similar, evite desinstalar Node.js de Windows si lo usa para desarrollo de Windows.

Errores de permisos durante la instalación

Si el instalador nativo falla con errores de permisos, el directorio de destino puede no ser escribible. Consulte Verifique permisos de directorio. Si instaló previamente con npm y está experimentando errores de permisos específicos de npm, cambie al instalador nativo:

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

Binario nativo no encontrado después de la instalación de npm

El paquete npm @anthropic-ai/claude-code descarga el binario nativo como una dependencia opcional por plataforma, como @anthropic-ai/claude-code-darwin-arm64. npm luego ejecuta el script de postinstalación del paquete, que copia ese binario en su lugar como el comando claude; hasta que se ejecute, claude es un script de marcador de posición. Si se omite el paso de descarga o postinstalación, el marcador de posición permanece en su lugar, y ejecutar claude en macOS y Linux imprime:

Error: claude native binary not installed.

Either postinstall did not run (--ignore-scripts, some pnpm configs)
or the platform-native optional dependency was not downloaded
(--omit=optional).

Run the postinstall manually (adjust path for local vs global install):
  node node_modules/@anthropic-ai/claude-code/install.cjs

Or reinstall without --ignore-scripts / --omit=optional.

En Windows, bin/claude.exe es ese mismo marcador de posición de script de shell en lugar de un ejecutable real, por lo que PowerShell y CMD reportan que no pueden ejecutar el archivo en lugar de imprimir este mensaje. Verifique las siguientes causas:

Las dependencias opcionales están deshabilitadas. Elimine --omit=optional de su comando de instalación de npm, --no-optional de pnpm, o --ignore-optional de yarn, y verifique que .npmrc no establezca optional=false. Luego reinstale. El binario nativo se entrega solo como una dependencia opcional, por lo que no hay alternativa de JavaScript si se omite, y ejecutar install.cjs nuevamente no puede colocar un binario que nunca fue descargado.
Los scripts de instalación están deshabilitados. --ignore-scripts y algunas configuraciones de pnpm omiten el paso de postinstalación pero aún descargan el paquete de plataforma. Ejecute node node_modules/@anthropic-ai/claude-code/install.cjs como sugiere el mensaje, o reinstale sin la bandera. Si postinstalación no puede ejecutarse en su entorno en absoluto, node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs encuentra el paquete descargado e lo lanza, al costo de un proceso Node adicional en cada inicio. Si el contenedor imprime Could not find native binary package en su lugar, el paquete de plataforma nunca fue descargado, así que primero corrija la causa de dependencias opcionales anterior.
Plataforma no admitida. Los binarios precompilados se publican para darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64, y win32-arm64. Claude Code no envía un binario para otras plataformas; consulte los requisitos del sistema. En FreeBSD, el instalador reporta la plataforma como no admitida. Antes de v2.1.205, trataba FreeBSD como Linux y descargaba un binario que no podía ejecutarse.
El espejo npm corporativo carece de los paquetes de plataforma. Asegúrese de que su registro refleje los ocho paquetes @anthropic-ai/claude-code-* de plataforma además del paquete meta.

Error `ENOTEMPTY` de npm durante actualización o reinstalación

Cuando ejecuta npm install -g @anthropic-ai/claude-code sobre una instalación existente, npm puede fallar mientras mueve el directorio del paquete antiguo a un lado:

npm error code ENOTEMPTY
npm error syscall rename
npm error path /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/claude-code
npm error dest /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/.claude-code-tVWAnUUt
npm error errno -39
npm error ENOTEMPTY: directory not empty, rename '...'

La línea npm error path nombra el directorio que npm no pudo mover. Elimine ese directorio y cualquier directorio .claude-code-* sobrante junto a él, que ejecuciones interrumpidas anteriores pueden dejar atrás. Los comandos a continuación encuentran su directorio de paquete global con npm root -g; si el directorio que la línea npm error path nombra no está bajo el directorio que npm root -g imprime, por ejemplo porque cambió versiones de Node con nvm, elimine los directorios que el error nombra en su lugar:

macOS/Linux
Windows PowerShell

rm -rf "$(npm root -g)/@anthropic-ai/claude-code"

Luego elimine cualquier directorio temporal sobrante. Si zsh imprime no matches found, no había ninguno para eliminar:

rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*

Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"

Luego reinstale:

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

Confirme con claude --version, que imprime un número de versión como 2.1.211 (Claude Code). Estas secciones abordan fallos de inicio de sesión, errores de OAuth y problemas de tokens. Cuando el inicio de sesión falla y la causa no es obvia, una reautenticación limpia resuelve la mayoría de los casos:

Ejecute /logout para cerrar sesión completamente
Cierre Claude Code
Reinicie con claude y complete el proceso de autenticación nuevamente

Si el navegador no se abre automáticamente durante el inicio de sesión, presione c para copiar la URL de OAuth a su portapapeles, luego péguelo en un navegador manualmente. Esto también funciona cuando la URL se envuelve en varias líneas en una terminal estrecha o SSH y no se puede hacer clic directamente.

Error de OAuth: Código inválido

Si ve OAuth error: Invalid code. Please make sure the full code was copied, el código de inicio de sesión expiró o fue truncado durante la copia y pegado. Soluciones:

Presione Intro para reintentar y complete el inicio de sesión rápidamente después de que se abra el navegador
Escriba c para copiar la URL completa si el navegador no se abre automáticamente
Si usa una sesión remota/SSH, el navegador puede abrirse en la máquina incorrecta. Copie la URL mostrada en la terminal y ábrala en su navegador local en su lugar.

Si ve API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}} después de iniciar sesión:

Usuarios de Claude Pro/Max: verifique que su suscripción esté activa en claude.ai/settings
Usuarios de Anthropic Console: confirme que su cuenta tiene el rol “Claude Code” o “Developer”. Los administradores asignan esto en Anthropic Console bajo Settings → Members.
Detrás de un proxy: los proxies corporativos pueden interferir con las solicitudes de API. Consulte configuración de red para la configuración de proxy.

Esta organización ha sido deshabilitada con una suscripción activa

Si ve API Error: 400 ... "This organization has been disabled" a pesar de tener una suscripción activa de Claude, una variable de entorno ANTHROPIC_API_KEY está anulando su suscripción. Esto comúnmente ocurre cuando una clave API antigua de un empleador anterior o proyecto anterior aún está configurada en su perfil de shell. Cuando ANTHROPIC_API_KEY está presente y lo ha aprobado, Claude Code usa esa clave en lugar de las credenciales de OAuth de su suscripción. En modo no interactivo con la bandera -p, la clave siempre se usa cuando está presente. Consulte precedencia de autenticación para el orden de resolución completo. Para usar su suscripción en su lugar, desestablezca la variable de entorno y elimínela de su perfil de shell:

macOS/Linux
Windows PowerShell

unset ANTHROPIC_API_KEY
claude

Remove-Item Env:ANTHROPIC_API_KEY
claude

Verifique ~/.zshrc, ~/.bashrc, o ~/.profile para líneas export ANTHROPIC_API_KEY=... y elimínelas para hacer el cambio permanente. En Windows, verifique su perfil de PowerShell en $PROFILE y sus variables de entorno de usuario para ANTHROPIC_API_KEY. Ejecute /status dentro de Claude Code para confirmar qué método de autenticación está activo. Cuando Claude Code se ejecuta en WSL2, en una máquina remota a través de SSH, o dentro de un contenedor, el navegador generalmente se abre en un host diferente y su redirección no puede alcanzar el servidor de devolución de llamada local de Claude Code. Después de que inicie sesión, el navegador muestra un código de inicio de sesión en lugar de redirigirse automáticamente. Pegue ese código en la terminal en el indicador Paste code here if prompted para completar el inicio de sesión. Si el navegador no se abre en absoluto desde WSL2, establezca la variable de entorno BROWSER en la ruta de su navegador de Windows:

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

Alternativamente, presione c en el indicador de inicio de sesión interactivo para copiar la URL de OAuth, o copie la URL que claude auth login imprime, y ábrala en un navegador en su máquina local. Si pegar el código en el indicador interactivo no hace nada, el enlace de pegado de su terminal probablemente no está llegando al campo de entrada. Intente el atajo de pegado alternativo de su terminal, a menudo clic derecho o Shift+Insert en Windows Terminal, o use claude auth login en su lugar, que lee el código pegado desde la entrada estándar:

claude auth login

Esta alternativa también se aplica en Windows nativo o cualquier terminal donde pegar en el indicador interactivo falla.

No ha iniciado sesión o el token ha expirado

Si Claude Code le solicita que inicie sesión nuevamente después de una sesión, su token de OAuth puede haber expirado. Ejecute /login para reautenticarse. Si esto ocurre frecuentemente, verifique que su reloj del sistema sea preciso, ya que la validación de tokens depende de marcas de tiempo correctas. Las sesiones paralelas en una máquina comparten un inicio de sesión guardado y coordinan su renovación para que solo un proceso actualice el token a la vez. Antes de v2.1.211, despertar la máquina del sueño podría causar que dos sesiones se renovaran con el mismo token, lo que revocaba el inicio de sesión guardado e indicaba a cada sesión abierta que iniciara sesión nuevamente de una vez. En macOS, Claude Code guarda credenciales en el Keychain de inicio de sesión. Cuando el Keychain rechaza la escritura, como cuando está bloqueado en una sesión SSH o su contraseña está fuera de sincronización con su contraseña de cuenta, Claude Code guarda su inicio de sesión en el archivo de texto plano ~/.claude/.credentials.json en su lugar. Un inicio de sesión de Console que crea una clave API falla hasta que el Keychain sea escribible nuevamente. Para hacer que el Keychain sea escribible nuevamente y mover su inicio de sesión de vuelta al Keychain cifrado:

Verifique el acceso a Keychain

Ejecute claude doctor para verificar el acceso a Keychain. Cuando el Keychain rechaza escrituras, el informe enumera una advertencia que comienza con macOS Keychain is not writable, seguida de una corrección sugerida. Cuando el informe no enumera ninguna advertencia de Keychain, el Keychain es escribible y puede pasar al último paso.

Desbloquee el Keychain

security unlock-keychain ~/Library/Keychains/login.keychain-db

Ingrese su contraseña de Keychain cuando el comando la solicite, luego ejecute claude doctor nuevamente. Cuando el desbloqueo funcionó, el informe ya no enumera la advertencia de Keychain.

Resincronice la contraseña de Keychain si desbloquear no ayuda

Abra Keychain Access, seleccione el keychain login, y elija Edit > Change Password for Keychain “login” para resincronizarlo con su contraseña de cuenta. Luego ejecute claude doctor nuevamente. Continúe al siguiente paso una vez que el informe ya no enumere la advertencia de Keychain.

Cierre sesión e inicie sesión nuevamente

Una vez que el Keychain sea escribible nuevamente, Claude Code mueve las credenciales de vuelta la próxima vez que escribe una credencial. Para forzarlo ahora, ejecute /logout y luego /login. Cerrar sesión elimina todas las credenciales almacenadas, incluido el contenido del archivo de texto plano, los inicios de sesión guardados del servidor MCP y los valores sensibles del plugin, así que espere reautorizar servidores MCP e ingresar nuevamente los secretos del plugin después. Iniciar sesión nuevamente almacena su inicio de sesión en el Keychain.

Las credenciales de Bedrock, Agent Platform o Foundry no se cargan

Si configuró Claude Code para usar un proveedor en la nube y ve Could not load credentials from any providers en Amazon Bedrock, Could not load the default credentials en Google Cloud’s Agent Platform, o ChainedTokenCredential authentication failed en Microsoft Foundry, su CLI del proveedor en la nube probablemente no está autenticado en el shell actual. Para Amazon Bedrock, confirme que sus credenciales de AWS son válidas:

aws sts get-caller-identity

Para Google Cloud’s Agent Platform, confirme que ANTHROPIC_VERTEX_PROJECT_ID y CLOUD_ML_REGION están configurados en su shell, luego establezca credenciales predeterminadas de aplicación:

gcloud auth application-default login

Para Microsoft Foundry, confirme que ANTHROPIC_FOUNDRY_API_KEY está configurado, o inicie sesión con la CLI de Azure para que la cadena de credenciales predeterminada pueda encontrar su cuenta:

az login

Si las credenciales funcionan en su terminal pero no en la extensión de VS Code o JetBrains, el proceso del IDE probablemente no heredó su entorno de shell. Establezca las variables de entorno del proveedor en la configuración propia del IDE, o inicie el IDE desde una terminal donde ya estén exportadas. Consulte Amazon Bedrock, Google Cloud’s Agent Platform, o Microsoft Foundry para la configuración completa del proveedor.

Aún atrapado

Si ninguno de los anteriores resuelve su problema:

Verifique el repositorio de GitHub para problemas conocidos, o abra uno nuevo con su sistema operativo, el comando de instalación que ejecutó, y la salida de error completa
Si claude --version funciona pero algo más está mal, ejecute claude doctor para un informe de diagnóstico automatizado
Si puede iniciar una sesión, use /feedback dentro de Claude Code para reportar el problema
Si el problema es con su cuenta en lugar de la instalación, como un bucle de inicio de sesión, una suscripción que no se reconoce, u una organización deshabilitada, contacte al soporte de Anthropic: inicie sesión en claude.ai (Usuarios de Console: platform.claude.com), haga clic en sus iniciales en la esquina inferior izquierda, y seleccione Obtener ayuda. Consulte Cómo obtener soporte para el flujo completo.

​Encuentre su error

​Ejecute verificaciones de diagnóstico

​Verifique la conectividad de red

​Verifique su PATH

​Verifique instalaciones conflictivas

​Verifique permisos de directorio

​Verifique que el binario funciona

​Problemas comunes de instalación

​El script de instalación devuelve HTML en lugar de un script de shell

​command not found: claude después de la instalación

​curl: (56) Failure writing output to destination

​Cask de Homebrew no disponible u obsoleto

​Errores de conexión TLS o SSL

​Failed to fetch version from downloads.claude.ai

​Comando de instalación incorrecto en Windows

​running scripts is disabled on this system

​The process cannot access the file durante la instalación en Windows

​La instalación se cuelga en servidores Linux con poca memoria

​La instalación se cuelga en Docker

​Raw mode is not supported durante la instalación

​claude update o claude doctor se cuelga

​Claude Desktop anula el comando claude en Windows

​Claude Code en Windows requiere Git para Windows (para bash) o PowerShell

​Claude Code no admite Windows de 32 bits

​Desajuste binario musl o glibc de Linux

​Illegal instruction

​dyld: cannot load en macOS

​Exec format error en WSL1

​Errores de instalación de npm en WSL

​Errores de permisos durante la instalación

​Binario nativo no encontrado después de la instalación de npm

​Error ENOTEMPTY de npm durante actualización o reinstalación

​Inicio de sesión y autenticación

​Reinicie su inicio de sesión

​Error de OAuth: Código inválido

​403 Forbidden después del inicio de sesión

​Esta organización ha sido deshabilitada con una suscripción activa

​El inicio de sesión de OAuth falla en WSL2, SSH o contenedores

​No ha iniciado sesión o el token ha expirado

​Las credenciales de Bedrock, Agent Platform o Foundry no se cargan

​Aún atrapado

Encuentre su error

Ejecute verificaciones de diagnóstico

Verifique la conectividad de red

Verifique su PATH

Verifique instalaciones conflictivas

Verifique permisos de directorio

Verifique que el binario funciona

Problemas comunes de instalación

El script de instalación devuelve HTML en lugar de un script de shell

`command not found: claude` después de la instalación

`curl: (56) Failure writing output to destination`

Cask de Homebrew no disponible u obsoleto

Errores de conexión TLS o SSL

`Failed to fetch version from downloads.claude.ai`

Comando de instalación incorrecto en Windows

`running scripts is disabled on this system`

`The process cannot access the file` durante la instalación en Windows

La instalación se cuelga en servidores Linux con poca memoria

La instalación se cuelga en Docker

`Raw mode is not supported` durante la instalación

`claude update` o `claude doctor` se cuelga

Claude Desktop anula el comando `claude` en Windows

Claude Code en Windows requiere Git para Windows (para bash) o PowerShell

Claude Code no admite Windows de 32 bits

Desajuste binario musl o glibc de Linux

`Illegal instruction`

`dyld: cannot load` en macOS

`Exec format error` en WSL1

Errores de instalación de npm en WSL

Errores de permisos durante la instalación

Binario nativo no encontrado después de la instalación de npm

Error `ENOTEMPTY` de npm durante actualización o reinstalación

Inicio de sesión y autenticación

Reinicie su inicio de sesión

Error de OAuth: Código inválido

403 Forbidden después del inicio de sesión

Esta organización ha sido deshabilitada con una suscripción activa

El inicio de sesión de OAuth falla en WSL2, SSH o contenedores

No ha iniciado sesión o el token ha expirado

Las credenciales de Bedrock, Agent Platform o Foundry no se cargan

Aún atrapado