keepcalculator

06 Numbers and Powers

How to Uninstall Claude Code on macOS

Card No. 06·71984 · Updated · Standard formula, shown below

Uninstalling Claude Code from a Mac involves removing the CLI tool, its configuration files, and any cached data. This guide walks you through each step to ensure a complete removal.

What Is Claude Code?

Claude Code is Anthropic’s command-line interface (CLI) tool that lets developers interact with Claude AI models directly from their terminal. It’s designed for coding assistance, allowing users to ask questions, generate code, review code, and debug issues without leaving the terminal environment.

The tool is typically installed via npm (Node Package Manager) or as a native binary. Understanding how it was installed is crucial for proper removal, as different installation methods leave different traces on your system.

Prerequisites Before Uninstalling

Before you begin the uninstallation process, consider backing up any configuration or conversation history you might want later. Claude Code stores session data and preferences in specific directories that will be deleted during removal.

Also, ensure you have administrative privileges on your Mac, as some files may require elevated permissions to delete. You can check your current user permissions by running whoami in the terminal.

Step-by-Step Uninstallation Process

The uninstallation process varies slightly depending on how you installed Claude Code. Here are the most common methods:

If Installed via npm

For npm installations, use the following command to uninstall the global package:

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

If you installed it as a project dependency, navigate to your project directory and run npm uninstall @anthropic-ai/claude-code.

If Installed via Native Binary

For installations using the native installer script, you’ll need to manually remove the binary. First, locate it using:

which claude

This typically returns something like /usr/local/bin/claude. Remove it with:

rm $(which claude)

Removing Configuration Files and Cache

Claude Code stores user configuration and cached data in the ~/.claude directory. To remove these files completely:

rm -rf ~/.claude

Additionally, check for any related files in your home directory:

ls -la ~ | grep claude

Look for files like .claude.json or .claude_history and remove them as well. On newer versions, you might also find data in ~/Library/Application Support/claude-code or ~/Library/Caches/claude-code.

Verifying Complete Removal

After performing the steps above, verify that Claude Code has been completely removed. Run the following commands to check:

which claude

This should return nothing. Also try running claude --version to confirm the command is no longer recognized. If you still see references, search for any remaining files:

find / -name "*claude*" 2>/dev/null | grep -v Library

This comprehensive search will help you locate any leftover files that need manual removal.

Common Issues and Troubleshooting

Some users encounter permission errors when trying to delete certain files. If you receive a “Permission denied” error, use sudo before the removal command:

sudo rm -rf ~/.claude

If the npm uninstall command fails, you might need to clean the npm cache first:

npm cache clean --force

Then retry the uninstallation. For persistent issues, check if Claude Code is running as a background process and kill it before attempting removal.

Frequently Asked Questions

Will uninstalling Claude Code affect my other projects?

No, uninstalling Claude Code only removes the tool itself and its configuration files. Your code projects remain untouched. However, if you had Claude Code as a dependency in a specific project, you should run the uninstall command within that project directory to update the package.json file properly.

Do I need to uninstall Node.js as well?

No, Node.js is a separate runtime that may be used by other applications. Only remove the Claude Code package itself. If you want to check whether other packages depend on Node.js, you can list your globally installed packages with npm list -g.

How do I reinstall Claude Code after uninstalling?

To reinstall, simply run the installation command again. For npm: npm install -g @anthropic-ai/claude-code. For the native installer, use the official installation script from Anthropic's documentation. Your previous configuration will not be restored unless you backed it up.

Does uninstalling remove my API usage data?

No, uninstalling the local tool does not delete your usage history or billing data from Anthropic's servers. That information remains associated with your account. If you want to delete your account data entirely, you'll need to contact Anthropic support directly.

What if I get a "command not found" error after uninstalling?

This is actually a good sign—it means the uninstallation was successful. The error indicates that the system no longer recognizes the claude command. If you still see the command working, you may have multiple installations or the PATH variable might still reference an old location.

Can I uninstall Claude Code without using the terminal?

While it's possible to manually delete files using Finder, the terminal method is recommended because it ensures all related files are removed. If you prefer a GUI approach, navigate to ~/.claude in Finder and delete it, then remove any other files you find using Spotlight search for "claude".

Related

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.

More cards in this drawer

The whole Numbers and Powers drawer →