Guía de desinstalación de Claude Code

Proceso completo de desinstalación de Claude Code, incluyendo la limpieza de archivos de configuración, variables de entorno y datos de caché.

Verificación antes de desinstalar

Antes de comenzar la desinstalación, se recomienda hacer una copia de seguridad de los archivos de configuración y datos del proyecto importantes.

Verificación del método de instalación

Primer paso: Verificar instalación global

bash
npm ls -g @anthropic-ai/claude-code

Segundo paso: Verificar instalación local

bash
npm ls @anthropic-ai/claude-code

Tercer paso: Verificar ruta de instalación

bash
# Ver ruta de instalación del paquete global
npm root -g

# Ver ubicación del archivo ejecutable de Claude Code
which claude
# o en Windows usar
where claude

Desinstalar Claude Code

Método 1: Desinstalación npm (Recomendado)

# Desinstalar Claude Code instalado globalmente
npm uninstall -g @anthropic-ai/claude-code

# Verificar desinstalación
claude --version
# Debería mostrar "command not found" o error similar

Método 2: Eliminación manual (si falla la desinstalación npm)

# Eliminar directorio de instalación global
rm -rf ~/.npm/lib/node_modules/@anthropic-ai/claude-code
rm -rf /usr/local/lib/node_modules/@anthropic-ai/claude-code

# Eliminar enlace del archivo ejecutable
rm -f /usr/local/bin/claude

# Eliminar directorio de datos del usuario
rm -rf ~/.claude-code
rm -rf ~/.config/claude-code

Limpieza de archivos de configuración y caché

Limpieza de variables de entorno

Sistema macOS/Linux

bash
# Editar archivo de configuración, eliminar variables de entorno relacionadas
nano ~/.bashrc
nano ~/.bash_profile
nano ~/.zshrc

# Eliminar las siguientes líneas:
# export ANTHROPIC_AUTH_TOKEN=...
# export ANTHROPIC_BASE_URL=...

# Recargar configuración
source ~/.bashrc
source ~/.bash_profile
source ~/.zshrc

Sistema Windows

Método 1: Interfaz gráfica

  1. Hacer clic derecho en "Este equipo" → "Propiedades"
  2. Hacer clic en "Configuración avanzada del sistema"
  3. En la ventana "Propiedades del sistema" hacer clic en "Variables de entorno"
  4. Buscar y eliminar en variables de usuario y variables del sistema:
    • ANTHROPIC_AUTH_TOKEN
    • ANTHROPIC_BASE_URL
  5. Hacer clic en "Aceptar" para guardar

Método 2: PowerShell

PowerShell (Administrador)
# Eliminar variables de entorno de usuario
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "User")

# Eliminar variables de entorno del sistema (requiere permisos de administrador)
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "Machine")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "Machine")

Limpieza de archivos de configuración del proyecto

Verificar y eliminar la configuración relacionada con Claude Code en el proyecto:

bash
# Buscar archivos de configuración en el proyecto
find . -name ".claude*" -type f
find . -name "claude.config.*" -type f

# Eliminar los archivos de configuración encontrados
rm -f .claude-settings.json
rm -f claude.config.js
rm -f claude.config.json

Limpieza de datos de caché

# Limpiar datos relacionados con Claude Code en la caché npm
npm cache clean --force

# Limpiar directorio de caché del usuario
rm -rf ~/.cache/claude-code
rm -rf /tmp/claude-*

# Limpiar archivos de registro
rm -rf ~/.local/share/claude-code/logs

Verificación de desinstalación

Después de completar la desinstalación, ejecutar los siguientes comandos para verificar la limpieza completa:

bash
# Verificar que el comando no existe
claude --version
# Debería mostrar "command not found"

# Verificar que las variables de entorno se han limpiado
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL
# Debería estar vacío

# Verificar archivos residuales
ls -la ~/.claude* 2>/dev/null || echo "No Claude files found"
ls -la ~/.config/claude* 2>/dev/null || echo "No Claude config found"

Desinstalación de dependencias relacionadas (Opcional)

Si ya no necesitas Node.js u otras herramientas relacionadas, también puedes desinstalarlas:

Desinstalar Node.js

# Si se instaló a través de Homebrew
brew uninstall node

# Eliminación manual (si se instaló a través del paquete de instalación oficial)
sudo rm -rf /usr/local/{bin/{node,npm},lib/node_modules/npm,lib/node,share/man/*/node.*}

Preguntas frecuentes

Pregunta 1: El comando todavía existe

Posibles causas:

  • Caché de la variable de entorno PATH
  • Múltiples ubicaciones de instalación

Solución:

bash
# Recargar variables de entorno
source ~/.bashrc

# O reiniciar el terminal
exit
# Volver a abrir el terminal

# Verificar todas las ubicaciones de instalación posibles
which -a claude
whereis claude

Pregunta 2: Permisos insuficientes para eliminar archivos

Solución:

bash
# macOS/Linux usar sudo
sudo rm -rf /usr/local/lib/node_modules/@anthropic-ai/claude-code

# Windows ejecutar PowerShell como administrador
# Hacer clic derecho en PowerShell → "Ejecutar como administrador"

Pregunta 3: Variables de entorno no limpiadas

Solución:

bash
# Verificar todos los archivos de configuración posibles
grep -r "ANTHROPIC" ~/.*rc ~/.*profile 2>/dev/null
grep -r "claude" ~/.*rc ~/.*profile 2>/dev/null

# Editar manualmente el archivo de configuración encontrado
nano ~/.bashrc  # Eliminar líneas relacionadas

Preparación para reinstalación

Si más adelante necesitas reinstalar Claude Code:

  1. Asegúrate de que la versión de Node.js ≥ 18.0
  2. Limpia la caché npm: npm cache clean --force
  3. Reinstala siguiendo la documentación de instalación

Después de completar los pasos anteriores, Claude Code debería estar completamente desinstalado de tu sistema.

Con la IA: innovación sin límites y oportunidades infinitas
Acerca de
Funciones
Documentación
Precios
Contáctanos
Términos y políticas
Términos de uso
Política de privacidad
Ley de transacciones comerciales específicas