Estos diez problemas representan la gran mayoría de tickets de soporte relacionados con la instalación y autenticación de Claude Code. Cada entrada incluye la solución más confiable.
1. claude: command not found inmediatamente después de instalar.
El instalador agregó claude a tu PATH, pero tu shell actual aún no lo ha detectado. Abre una nueva terminal, o ejecuta source ~/.zshrc (o ~/.bashrc). En Windows, cierra y reabre PowerShell.
2. npm install falla con EACCES / permiso denegado.
Esto generalmente significa que la instalación se ejecutó con sudo, o tu directorio global de npm es propiedad de root. No uses sudo. En su lugar, usa el instalador curl, o corrige el prefijo de npm con npm config set prefix ~/.npm-global y agrega ese directorio bin a tu PATH.
3. "Node version not supported" o bloqueo silencioso al iniciar.
Claude Code requiere Node 18 o posterior. Verifica tu versión con node -v. Si es más antigua, instala una versión actual mediante nvm install --lts, o usa el instalador curl, que incluye su propio runtime y evita este problema completamente.
4. WSL: claude ejecuta el Node de Windows en lugar del Node de Linux.
El PATH de Windows se filtra en WSL y anula nvm. Antepón tu node de Linux a PATH en ~/.bashrc: export PATH="$HOME/.nvm/versions/node/$(nvm current)/bin:$PATH"
5. El instalador se cuelga o falla detrás de una red corporativa.
El host de descarga (storage.googleapis.com) probablemente está bloqueado. Configura tu proxy primero con export HTTPS_PROXY=http://your-proxy:port, luego vuelve a ejecutar el instalador. Si eso no es posible, pide a tu equipo de TI el paquete sin conexión.
6. SELF_SIGNED_CERT_IN_CHAIN u otros errores de TLS.
Tu empresa inyecta su propio certificado. Apunta Node al bundle de CA corporativo: export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem Agrégalo a tu perfil de shell para que persista.
7. /login abre un navegador pero la terminal nunca termina ("Waiting for authentication…").
Esto generalmente significa que la devolución de llamada de localhost está bloqueada, lo cual es común en SSH remoto, en devcontainers, o detrás de un firewall estricto. Usa el flujo manual en su lugar: copia la URL impresa en la terminal, completa el inicio de sesión en cualquier navegador, luego pega el código devuelto nuevamente en la terminal.
8. "Not authenticated" aunque hayas configurado ANTHROPIC_API_KEY.
Hay tres causas comunes: la clave se exportó en un shell diferente (ejecuta echo $ANTHROPIC_API_KEY para verificar), ejecutaste previamente /login y la sesión de OAuth tiene prioridad (ejecuta /logout primero), o la clave es una clave de Console pero tu organización requiere inicio de sesión SSO en su lugar.
9. Bedrock / Vertex: "Could not load credentials."
Claude Code utiliza los SDK estándar del proveedor, por lo que la solución es la misma que para cualquier herramienta de CLI de AWS/GCP. Para Bedrock, confirma que aws sts get-caller-identity funciona y que AWS_REGION está configurado en una región donde tu modelo está habilitado. Para Vertex, confirma que gcloud auth application-default login se ha ejecutado y que GOOGLE_CLOUD_PROJECT está configurado.
10. Se instaló y autenticó, pero cada solicitud genera un error 403 / "model not available."
Tu cuenta existe pero no tiene acceso al modelo que Claude Code está solicitando. Para asientos Enterprise, confirma que tu asiento está activo en la configuración de administrador de tu organización. En Bedrock o Vertex, confirma que el modelo Claude específico está habilitado en esa región o proyecto. Como solución rápida, ejecuta /model y selecciona un modelo al que sabes que tienes acceso.
¿Aún atrapado?
Ejecuta claude doctor desde tu shell normal (no desde dentro de una sesión de Claude). Imprime un informe de diagnóstico que puedes adjuntar a un ticket de soporte.