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 con 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
Author Avatar
Andrew
AI Perks Team
7,862

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 completamente Claude Code, ejecuta npm uninstall -g @anthropic-ai/claude-code en tu terminal, y 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 con créditos gratuitos de Anthropic de $1,000-$25,000+ que funcionan con cualquier herramienta: Cursor, Windsurf, aplicaciones personalizadas o tu próxima configuración.


Ahorra tu presupuesto en créditos de IA

Buscar ofertas para
OpenAI
OpenAI,
Anthropic
Anthropic,
Lovable
Lovable,
Notion
Notion

Promociona tu SaaS

Llega a más de 90.000 fundadores en todo el mundo que buscan herramientas como la tuya

Aplicar ahora

Por Qué los Desarrolladores Desinstalan Claude Code

Hay varias razones comunes:

  • Cambio de herramientas - Pasar a Cursor, Windsurf, Codex u otro asistente de codificación
  • Reinstalación limpia - 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 en múltiples máquinas - Eliminar de máquinas que ya no utilizas

Cualquiera que sea tu razón, el proceso de desinstalación es el mismo. Y si alguna vez vuelves, reinstalarlo requiere un solo comando.


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

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 toma aproximadamente 5 segundos.

Verifica que funcionó:

claude --version

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


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, los tokens de autenticación, los comandos personalizados y el historial persisten en tu directorio de inicio. Para borrar completamente Claude Code:

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 / CarpetaContenidos
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 claves API directamente desde tu Consola de Anthropic.


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" sigue funcionando 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, intenta eliminar de nuevo.

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

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
  • Windsurf - Configura Claude como tu proveedor de modelos
  • 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
  • Web de Claude.ai - 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 IA

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

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

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

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


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 necesitarás para cualquier herramienta futura.

Paso 2: Desinstala Claude Code

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

Paso 3: Elimina Configuración y Datos

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

Paso 4: Limpia Configuraciones de 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 tu cuenta. La desinstalación de la CLI solo elimina la herramienta local.

¿Perderé mis comandos y agentes personalizados 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. Revisa el Administrador de Credenciales en busca de tokens de Anthropic almacenados.

¿Desinstalar Claude Code elimina mi historial de chat?

El historial de sesiones locales 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 integrado claude uninstall. Usa npm uninstall -g @anthropic-ai/claude-code para eliminar el paquete globalmente. El comando npm es el método oficial soportado.

¿Debo desinstalar Claude Code si me estoy cambiando a Cursor?

No necesariamente. Muchos desarrolladores ejecutan ambos. Cursor usa 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.


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

Desinstalar Claude Code no significa renunciar a Claude. AI Perks asegura que sigas teniendo acceso a créditos gratuitos de Anthropic de $1,000-$25,000+ que potencian Claude en cualquier herramienta: Cursor, 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 más de $50,000 en financiación
  • Más de 200 beneficios adicionales para startups más allá de los créditos de IA
  • Programas de crédito 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.