Resumen rápido: Desinstalar Claude Code requiere diferentes pasos dependiendo de tu método de instalación (instalador nativo, npm o Homebrew). Para desinstalar una instalación nativa, ejecuta el comando `claude uninstall` en tu terminal (disponible en Windows, macOS y Linux). Todos los métodos requieren eliminar manualmente los archivos de configuración de `~/.claude/` para asegurar una desinstalación completa.
¿Necesitas eliminar Claude Code de tu sistema? El proceso de desinstalación no es tan sencillo como debería. El método varía drásticamente según cómo hayas instalado originalmente la herramienta.
Esto es lo que hace que sea complicado: Claude Code se puede instalar a través de instaladores nativos, npm, Homebrew u otros gestores de paquetes. Cada método deja atrás diferentes artefactos.
Identifica tu Método de Instalación Primero
Antes de desinstalar, determina cómo se instaló Claude Code en tu sistema. Ejecuta este comando en tu terminal:
| claude --version |
Comprueba estas ubicaciones de instalación comunes:
- Instalador nativo (Windows): Archivos de programa o AppData
- Instalador nativo (macOS): Carpeta Aplicaciones
- Instalación de npm: `~/.npm-global/bin/`
- Homebrew: `/usr/local/bin/` o `/opt/homebrew/bin/`
Desinstalar a través del Instalador Nativo
Para instalaciones en Windows utilizando el script de PowerShell ( `irm claude.ai/install.ps1 | iex`), el proceso difiere de las aplicaciones estándar.
Windows 10/11:
- Abre Configuración > Aplicaciones > Aplicaciones instaladas
- Busca "Claude Code"
- Haz clic en los tres puntos y selecciona Desinstalar
- Confirma la eliminación
macOS:
- Abre Finder y navega a Aplicaciones
- Localiza Claude Code
- Arrastra a la Papelera o haz clic derecho y selecciona Mover a la Papelera
- Vacía la Papelera para completar la eliminación
Según los problemas de GitHub (#6920), algunos usuarios informan que el instalador nativo de Windows carece de documentación para desinstalar. Si Claude Code no aparece en tu lista de aplicaciones estándar, necesitarás métodos de eliminación alternativos.
Eliminar a través de Gestores de Paquetes
Para instalaciones de npm, ejecuta estos comandos:
| npm uninstall -g @anthropic-ai/claude-code rm -f $HOME/.npm-global/bin/claude |
Para Homebrew en macOS:
| brew uninstall --cask claude-code |
Las discusiones de la comunidad en Reddit confirman que las instalaciones de gestores de paquetes a menudo dejan archivos de configuración. El comando de desinstalación elimina el binario pero no tu configuración.
Eliminar Archivos de Configuración
Este paso es crucial. El desinstalador no elimina tus archivos de configuración, lo que puede causar problemas si reinstalas más tarde.
Elimina estos directorios y archivos manualmente:
| rm -rf ~/.claude/ rm ~/.claude.json rm -rf ~/.local/share/claude rm -f $HOME/.local/bin/claude rm -rf $HOME/.bun/bin/../install/global/node_modules/@anthropic-ai |
En Windows, elimina estas carpetas:
- %USERPROFILE%\.claude\
- %APPDATA%\Claude\
- %LOCALAPPDATA%\Claude\
Verificar la Eliminación Completa
Después de desinstalar, confirma que Claude Code ha desaparecido:
| which claude claude --version |
Ambos comandos deberían devolver "command not found" (comando no encontrado) o errores similares. Si aún se ejecutan, revisa tu variable PATH para ver referencias restantes.
Obtén Créditos de IA y Descuentos de Software en un Solo Lugar
Si sigues trabajando con herramientas de IA después de eliminar Claude Code, Get AI Perks puede ser un siguiente paso práctico. Recopila créditos para startups y descuentos de software para herramientas de IA y nube en un solo lugar. Brinda a los fundadores acceso a más de 200 ventajas, incluidas ofertas de Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom y otras. La plataforma también incluye condiciones de las ventajas, orientación para la aprobación e instrucciones paso a paso para reclamar cada oferta.
¿Buscas Créditos de Claude o Anthropic?
Consulta Get AI Perks para:
- encontrar créditos y descuentos de herramientas de IA en un solo lugar
- revisar las condiciones de las ventajas antes de solicitar
- acceder a guías para reclamar ofertas para startups
👉 Visita Get AI Perks para explorar las ventajas disponibles de Claude, Anthropic y otros softwares de IA.
Problemas Comunes de Desinstalación
Según el informe de errores de GitHub #11789, algunos usuarios en Linux informaron no poder desinstalar sin una cuenta de pago activa, aunque esto parece ser un problema específico de la plataforma.
Si te enfrentas a este problema, omite el desinstalador estándar y elimina manualmente los archivos y directorios de la aplicación enumerados anteriormente. Esto elimina Claude Code sin requerir autenticación.
Otro problema: los servidores y plugins MCP deshabilitados permanecen en tu sistema. Para eliminar servidores MCP, usa el comando `claude mcp remove [nombre-del-servidor]`.
Preguntas Frecuentes
¿Necesito una cuenta activa para desinstalar Claude Code?
No. Si bien algunos usuarios de Linux informaron errores de autenticación al usar 'claude uninstall', la eliminación manual de archivos elimina Claude Code sin verificación de cuenta. Elimina directamente los archivos de la aplicación y los directorios de configuración.
¿La desinstalación eliminará la configuración de mis proyectos?
La eliminación manual de `~/.claude/` eliminará la configuración a nivel de usuario. Sin embargo, los directorios `.claude/` a nivel de proyecto que se hayan comprometido en git no se eliminan automáticamente y deben eliminarse manualmente.
¿Puedo reinstalar después de desinstalar?
Absolutamente. La reinstalación funciona normalmente después de una eliminación completa. Eliminar los archivos de configuración asegura una instalación limpia sin conflictos de configuraciones anteriores.
¿Qué sucede con los servidores MCP después de desinstalar?
Los servidores MCP persisten en tu configuración incluso cuando están deshabilitados. Elimina manualmente la configuración de MCP de `~/.claude/` para eliminarlos por completo, ya que la interfaz de usuario no proporciona una opción de desinstalación.
¿Se requieren derechos de administrador en Windows para desinstalar?
Normalmente sí, especialmente para instalaciones a nivel de sistema. Las instalaciones a nivel de usuario pueden no requerir elevación, pero la limpieza de la configuración en directorios del sistema necesita acceso de administrador.
¿Cómo desinstalo en WSL2?
Las instalaciones de WSL2 siguen los procedimientos de desinstalación de Linux. Utiliza el método del gestor de paquetes o elimina manualmente los archivos del sistema de archivos de Linux, no del lado de Windows.
¿Por qué la desinstalación no elimina todos los archivos?
Los desinstaladores estándar conservan los datos de configuración del usuario para una posible reinstalación. Esta es una práctica común pero requiere una limpieza manual para una eliminación completa.
