Cómo desinstalar Claude Code: Guía completa de eliminación (2026)

Desinstala Claude Code en 2 comandos. Guía completa para la eliminación de npm, limpieza de configuración, macOS, Linux, Windows. Además, cómo conservar tus créditos gratuitos de Anthropic.

Claude CodeUninstall Claude CodeRemove Claude CodeClaude CLIAI Perks
Andrew
Andrew
AI Perks Team
10,660•

Quick Answer

Ejecuta `npm uninstall -g @anthropic-ai/claude-code` para eliminar Claude Code globalmente. Luego, elimina la carpeta de configuración en `~/.claude` para limpiar la configuración, los tokens de autenticación y el historial de comandos. Funciona en macOS, Linux y Windows. Mantén tus créditos de API de Anthropic activos para otras herramientas en getaiperks.com.

AI Perks

AI Perks ofrece acceso a descuentos exclusivos, créditos y ofertas en herramientas de IA, servicios en la nube y APIs para ayudar a startups y desarrolladores a ahorrar dinero.

AI Perks Cards

Cómo Desinstalar Claude Code: El Proceso Completo

Para desinstalar Claude Code por completo, ejecuta npm uninstall -g @anthropic-ai/claude-code en tu terminal, luego elimina el directorio de configuración en ~/.claude. Esto elimina el binario, tus tokens de autenticación, comandos personalizados, agentes e historial de comandos.

Si estás cambiando a una herramienta de codificación de IA diferente pero aún necesitas acceso a la API de Claude, AI Perks te mantiene conectado a $1,000-$25,000+ en créditos gratuitos de Anthropic que funcionan con cualquier herramienta: Cursor, Devin Desktop (anteriormente Windsurf), aplicaciones personalizadas o tu próxima configuración.


Los mejores créditos de IA para startups

Solicita directamente a través de estos programas verificados.

Por Qué los Desarrolladores Desinstalan Claude Code

Hay varias razones comunes:

  • Cambio de herramientas - Pasar a Cursor, Devin Desktop (anteriormente Windsurf), Codex u otro asistente de codificación
  • Reinstalación desde cero - Solucionar una instalación rota con una pizarra limpia
  • Liberar espacio en disco - Eliminar paquetes npm globales no utilizados
  • Preocupaciones de privacidad - Borrar todos los tokens de autenticación e historial almacenados localmente
  • Limpieza de múltiples máquinas - Eliminar de máquinas que ya no usas

Sea cual sea tu motivo, el proceso de desinstalación es el mismo. Y si alguna vez regresas, reinstalarlo toma un solo comando.


Paso 1: Desinstalar el Paquete Claude Code

Abre tu terminal y ejecuta:

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

Esto elimina el paquete npm global y el comando claude de tu PATH. La desinstalación tarda aproximadamente 5 segundos.

Verifica que funcionó:

claude --version

Si ves command not found: claude, la desinstalación fue exitosa. Si la versión todavía se imprime, es posible que tengas múltiples instalaciones: salta a la sección de solución de problemas.


Los mejores créditos de IA para startups

Solicita directamente a través de estos programas verificados.

Paso 2: Eliminar la Configuración y los Datos de Claude Code

La desinstalación de npm elimina el binario, pero los archivos de configuración, tokens de autenticación, comandos personalizados e historial persisten en tu directorio de inicio. Para borrar Claude Code por completo:

macOS / Linux

rm -rf ~/.claude
rm -rf ~/.claude.json

Windows (PowerShell)

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

¿Qué Vive en ~/.claude?

Archivo / CarpetaContenido
settings.jsonPermisos, hooks, variables de entorno
agents/Definiciones de subagentes personalizados
commands/Comandos de barra personalizados
skills/Definiciones de habilidades
projects/Historial de sesiones y memoria por proyecto
auth/Claves API y tokens OAuth
mcp.jsonConfiguraciones del servidor MCP

Antes de eliminar, considera hacer una copia de seguridad de ~/.claude si deseas restaurar tu configuración más tarde:

cp -r ~/.claude ~/claude-backup-$(date +%Y%m%d)

Paso 3: Eliminar Tokens de Autenticación (Opcional pero Recomendado)

Claude Code almacena tokens OAuth en el llavero de tu sistema. Para revocarlos completamente:

macOS

security delete-generic-password -s "claude-code"

Linux

secret-tool clear service claude-code

Windows

Abre Administrador de credenciales > Credenciales de Windows > elimina cualquier entrada que contenga "claude-code" o "anthropic".

También puedes revocar las claves API directamente desde tu Consola de Anthropic.


Los mejores créditos de IA para startups

Solicita directamente a través de estos programas verificados.

Paso 4: Limpiar Alias de Shell y Entradas de PATH

Si agregaste alias personalizados de Claude Code o entradas de PATH a la configuración de tu shell, elimínalos:

Bash

Edita ~/.bashrc y ~/.bash_profile:

nano ~/.bashrc

Busca y elimina cualquier línea como:

alias cc="claude"
export CLAUDE_API_KEY="..."
export PATH="$PATH:/path/to/claude"

Zsh

Edita ~/.zshrc:

nano ~/.zshrc

Elimina el mismo tipo de líneas.

Fish

Edita ~/.config/fish/config.fish:

nano ~/.config/fish/config.fish

Recarga tu shell después de editar:

source ~/.zshrc  # o ~/.bashrc, etc

Solución de Problemas de Desinstalación

Problema: El comando "claude" todavía funciona después de la desinstalación

Probablemente tengas múltiples instalaciones. Verifica todos los prefijos de npm:

which claude
which -a claude  # Lista todas las coincidencias

Para cada ruta devuelta, desinstala manualmente:

npm uninstall -g @anthropic-ai/claude-code --prefix /path/to/install

Problema: Permiso denegado durante la desinstalación

Agrega sudo (macOS/Linux) o ejecuta PowerShell como Administrador (Windows):

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

Problema: No se puede eliminar la carpeta ~/.claude

Es posible que algunos archivos estén bloqueados por un proceso activo de Claude Code. Primero, finaliza cualquier proceso activo:

pkill -f claude

Luego, vuelve a intentar la eliminación.

Problema: La desinstalación funcionó pero Claude todavía aparece en la lista de npm

Borra la caché de npm y reconstruye el registro:

npm cache clean --force
npm list -g --depth=0

Los mejores créditos de IA para startups

Solicita directamente a través de estos programas verificados.

Qué Hacer Con Tus Créditos de API de Anthropic Después de Desinstalar

Aquí hay algo que los desarrolladores pasan por alto: desinstalar Claude Code no cancela tus créditos de API de Anthropic. Tu cuenta de Anthropic, claves API y saldo de crédito permanecen activos.

Aún puedes usar esos créditos con:

  • Cursor - Agrega tu clave API de Anthropic en la configuración
  • Devin Desktop (anteriormente Windsurf) - Configura Claude como tu proveedor de modelos. Cognition renombró Windsurf a Devin Desktop y retiró el agente Cascade en julio de 2026, y windsurf.com ahora redirige a devin.ai/desktop
  • Cline / Roo Code - Usa la API de Anthropic directamente
  • Aplicaciones personalizadas - Cualquier código que llame al SDK de Anthropic
  • Claude Desktop - Chat de Claude sin navegador
  • Claude.ai web - La misma cuenta, interfaz diferente

Si tienes créditos gratuitos de Anthropic de AI Perks, seguirán funcionando en todas estas herramientas. Los créditos están vinculados a tu cuenta de Anthropic, no a la CLI de Claude Code.


Créditos Gratuitos de Anthropic Funcionan Con Cualquier Herramienta de Codificación de IA

La mayoría de los desarrolladores no se dan cuenta de que pueden acumular $1,000-$25,000+ en créditos gratuitos de API de Claude a través de programas que funcionan con cualquier herramienta a la que cambien:

Programa de CréditosCréditos DisponiblesCómo Obtener
Anthropic Claude (Directo)$1,000 - $25,000Guía de AI Perks
AWS Activate (Bedrock - Claude)$1,000 - $100,000Guía de AI Perks
Google Cloud Vertex (Claude)$1,000 - $25,000Guía de AI Perks
Microsoft Founders Hub$500 - $1,000Guía de AI Perks
Programas de Socios VC$1,000 - $5,000Guía de AI Perks

Potencial total: $4,500 - $156,000+ en créditos gratuitos de Claude

Ya sea que cambies a Cursor, estés creando tu propio agente de codificación o simplemente conserves Claude como modelo de respaldo, AI Perks mantiene tu factura de IA en cero.


Los mejores créditos de IA para startups

Solicita directamente a través de estos programas verificados.

Paso a Paso: Desinstalación Limpia + Conserva Tus Créditos

Paso 1: Guarda Tu Clave API de Anthropic

Antes de borrar ~/.claude, copia tu clave API de ~/.claude/auth/ o de la Consola de Anthropic. La querrás para cualquier herramienta futura.

Paso 2: Desinstala Claude Code

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

Paso 3: Elimina la Configuración y los Datos

rm -rf ~/.claude ~/.claude.json

Paso 4: Limpia la Configuración del Shell

Elimina alias y exportaciones de ~/.zshrc, ~/.bashrc.

Paso 5: Mantén Tus Créditos Gratuitos Activos

Suscríbete a AI Perks para mantener el acceso a programas de créditos gratuitos de Anthropic que funcionan con cualquier herramienta que uses a continuación.


Preguntas Frecuentes

¿Desinstalar Claude Code cancela mi suscripción a Claude Pro o Max?

No. Las suscripciones se facturan a través de tu cuenta de Anthropic, no de la CLI. Para cancelar Pro o Max, inicia sesión en claude.ai y administra tu suscripción en la configuración de la cuenta. La desinstalación de la CLI solo elimina la herramienta local.

¿Perderé mis comandos personalizados y agentes de Claude Code?

Sí, si eliminas ~/.claude. Haz una copia de seguridad de la carpeta primero si deseas conservar tus comandos personalizados, agentes, habilidades y configuraciones de servidor MCP. Puedes restaurarlos copiando la copia de seguridad de vuelta a ~/.claude después de reinstalar.

¿Puedo reinstalar Claude Code después de desinstalar?

Sí. Simplemente ejecuta npm install -g @anthropic-ai/claude-code@latest y autentícate de nuevo. Tus créditos de Anthropic y tu cuenta permanecen activos. Con créditos gratuitos de AI Perks, puedes reconstruir tu configuración sin costo alguno.

¿Cómo desinstalo Claude Code específicamente en Windows?

Abre PowerShell como Administrador y ejecuta npm uninstall -g @anthropic-ai/claude-code. Luego, elimina las carpetas %USERPROFILE%\.claude y %USERPROFILE%\.claude.json. Verifica el Administrador de credenciales en busca de tokens de Anthropic almacenados.

¿Desinstalar Claude Code elimina mi historial de chat?

El historial de sesiones local en ~/.claude/projects/ se elimina si eliminas la carpeta de configuración. El historial sincronizado en la nube (si está habilitado) permanece en tu cuenta de Anthropic. Los chats web en claude.ai son completamente separados y no se ven afectados.

¿Cuál es la diferencia entre claude uninstall y npm uninstall?

No existe un comando claude uninstall integrado. Usa npm uninstall -g @anthropic-ai/claude-code para eliminar el paquete globalmente. El comando npm es el método oficial compatible.

¿Debo desinstalar Claude Code si cambio a Cursor?

No necesariamente. Muchos desarrolladores ejecutan ambos. Cursor utiliza Claude como una opción de modelo y funciona junto con la CLI. Si el espacio en disco y el desorden no son un problema, puedes mantener ambos instalados y usar el que mejor se adapte a la tarea. Los créditos gratuitos de Anthropic a través de AI Perks funcionan con ambas herramientas.


Los mejores créditos de IA para startups

Solicita directamente a través de estos programas verificados.

¿Cambiando de Herramientas? Mantén Tus Créditos Gratuitos Activos

Desinstalar Claude Code no significa renunciar a Claude. AI Perks asegura que mantengas el acceso a $1,000-$25,000+ en créditos gratuitos de Anthropic que potencian Claude en cualquier herramienta: Cursor, Devin Desktop (anteriormente Windsurf), tus propias aplicaciones o lo que sea que uses a continuación.

  • Guías paso a paso para la solicitud de créditos
  • Estrategias de acumulación para una carrera de $50,000+
  • Más de 200 beneficios adicionales para startups más allá de los créditos de IA
  • Programas de créditos que te siguen a través de las herramientas

Suscríbete en getaiperks.com →


Desinstala Claude Code en 2 comandos. Mantén tus créditos gratuitos de Anthropic para siempre en getaiperks.com.

AI Perks

AI Perks ofrece acceso a descuentos exclusivos, créditos y ofertas en herramientas de IA, servicios en la nube y APIs para ayudar a startups y desarrolladores a ahorrar dinero.

AI Perks Cards

This content is for informational purposes only and may contain inaccuracies. Credit programs, amounts, and eligibility requirements change frequently. Always verify details directly with the provider.