To uninstall Claude Code, first identify how it was installed. Then remove it through the same installer or package manager.
For example, use Homebrew if you installed it with Homebrew, WinGet if you installed it with WinGet, or npm if you installed the global npm package.
Removing the program does not automatically delete your settings, sessions, project history, editor extensions, or MCP configurations. Delete those files separately only when you want a complete reset.
Quick Answer: Find every Claude Code installation, remove each one through its original installation method, uninstall editor integrations separately, and erase stored data only when you want a complete cleanup.
What Does Uninstalling Claude Code Remove?
A standard uninstall removes the Claude Code command-line program. It does not normally delete your projects, settings, or local session history.
You can choose from four levels of removal:
- Sign out: Disconnect your account while keeping Claude Code installed.
- Standard uninstall: Remove the terminal program but preserve settings and sessions.
- Project cleanup: Remove Claude Code history and state associated with one project.
- Complete uninstall: Remove the program, editor integrations, settings, credentials, sessions, and caches.
Choose the smallest option that solves your problem. A full cleanup is unnecessary when you only need to repair or reinstall Claude Code.
Before You Uninstall Claude Code
Identify every Claude Code installation before removing anything. A computer may contain more than one copy. For example, a Mac may have both native and Homebrew installations. A Windows computer may have one copy in Windows and another inside WSL.
Check the location of the active Claude Code program and review the package managers used on your system. Look for native, Homebrew, WinGet, npm, apt, dnf, or apk installations.
If multiple copies exist, remove each unwanted version separately.
How to Uninstall Claude Code From Mac
On macOS, Claude Code may have been installed with the native installer, Homebrew, or npm.
-
Remove a Native Mac Installation
Delete the Claude Code launcher from your local executable folder. Then remove the downloaded Claude Code version files from the local application-data folder.
This removes the command-line program but normally keeps your settings and session history.
-
Uninstall Claude Code With Homebrew
Open Terminal and check whether the stable or latest Claude Code Homebrew package is installed.
Use Homebrew’s uninstall function with the exact package name displayed on your computer. The stable and latest release channels may use different package names.
After removal, check whether the Claude Code command still works. If it does, another native or npm installation may remain.
-
Remove an npm Installation on Mac
Use npm’s global uninstall function for the Claude Code package. After removing it, check the command location again. Another Homebrew or native copy may still be active.
How to Uninstall Claude Code on Windows 11
Windows users may have installed Claude Code through the native PowerShell installer, WinGet, npm, or WSL.
Close Claude Code, Visual Studio Code, JetBrains IDEs, and any terminals that may still be using the program before uninstalling it.
-
How to Uninstall Claude Code With PowerShell
For a native Windows installation, remove the Claude Code executable from the local user binary folder. Then delete its downloaded version files from the local share directory.
This removes the program but keeps shared settings and session data.
-
Remove Claude Code With WinGet
Open PowerShell or Windows Terminal and use WinGet to uninstall the Anthropic Claude Code package.
Afterward, check the installed WinGet package list to confirm that it has been removed.
-
How to Uninstall Claude Code From Windows Terminal
When Claude Code was installed with npm, use npm’s global uninstall option in PowerShell, Command Prompt, or Windows Terminal. Do not delete the entire global npm folder. It may contain other command-line programs.
If Claude Code still opens afterward, check for a native installation, a WinGet package, or another npm environment.
How to Uninstall Claude Code on Ubuntu
Ubuntu users may have installed Claude Code through the native installer, apt, or npm.
-
Remove a Native Ubuntu Installation
Delete the Claude Code launcher and downloaded version files from your local user directories. This leaves your main configuration and session history in place.
-
Remove Claude Code Installed With apt
Use apt to remove the Claude Code package. For a complete package-manager cleanup, also remove the Claude Code software repository and its signing key. Refresh the Ubuntu package index afterward.
-
Remove an npm Installation on Ubuntu
Use npm’s global uninstall function for the Claude Code package. Open a new terminal and confirm that the Claude Code command is no longer available.
How to Uninstall Claude Code on Fedora, RHEL, or Alpine
Use the package manager that originally installed Claude Code. On Fedora or RHEL, remove the package through dnf. You may also remove the Claude Code repository file when you no longer plan to reinstall it through that source.
To remove a package on Alpine Linux, use the apk command. Additionally, you should delete the Claude Code repository entry and signing key to ensure a complete cleanup of the package manager.
How to Uninstall Claude Code From WSL
Treat WSL as a separate Linux system. Open the WSL distribution where Claude Code is installed. Then remove it using the matching Linux installation method, such as native installation, npm, or apt.
Removing Claude Code from Windows does not remove the WSL copy. Removing it inside WSL does not remove the native Windows installation.
Make sure to check both environments to confirm that Claude Code continues to function properly after it has been uninstalled from one location.
How to Remove Claude Code Access Without Uninstalling

Sign out when you want to disconnect your account but keep Claude Code installed.
Open Claude Code and use its logout option. The next time you start the program, it will ask you to authenticate again.
Third-party cloud providers may use separate credentials, profiles, or environment settings. Remove or rotate those credentials through the relevant provider.
Signing out does not remove the program, project files, or local history.
How to Remove Claude Code From Visual Studio Code
The Visual Studio Code extension must be removed separately from the standalone terminal installation.
Open the Extensions panel, search for Claude Code, and select Uninstall.
The extension may contain its own Claude Code components. Removing the standalone terminal program does not always remove the extension.
Claude Code may also reinstall the editor extension when launched inside Visual Studio Code. Turn off automatic IDE extension installation in the Claude Code settings when you do not want this behavior.
-
Delete Visual Studio Code Extension Data
Deleting extension data removes stored settings and cached information associated with the Claude Code extension.
Perform this step when you want a complete extension reset. A normal extension uninstall is enough for most users.
The storage location differs between macOS, Windows, and Linux. Open the Visual Studio Code user-data directory for your operating system and remove the Claude Code extension storage folder.
How to Remove Claude Code From JetBrains IDEs
Open the IDE settings and select Plugins. Find Claude Code under the installed plugins, select Uninstall, and restart the IDE.
The JetBrains plugin and the standalone Claude Code command-line program are separate components. Remove the terminal installation separately when you no longer need it.
How to Uninstall Claude Code Completely
A complete uninstall removes the program and its stored local data. Before continuing, remember that a full cleanup can remove:
- User settings
- Allowed-tool rules
- Authentication information
- MCP server configurations
- Plugins and hooks
- Session transcripts
- Prompt history
- File checkpoints
- Cached project state
Remove editor integrations before deleting shared Claude Code data. Otherwise, an editor or desktop integration may recreate some files when it starts again.
-
Back Up Claude Code Data
Create a backup of your Claude Code user folder and main configuration file before deleting them.
Also check your project directories for Claude-specific files and folders. These may include project instructions, permissions, hooks, agents, MCP settings, and team-shared configuration.
Check version control before deleting project-level files. Some may be tracked and shared with other developers.
-
Delete All Claude Code User Data
To erase Claude Code, remove its main user-data directory and configuration file from your home folder.
On Windows, these files are usually stored in your user profile directory. On macOS, Linux, and WSL, they are usually stored in your home directory.
This action may permanently remove local sessions, settings, credentials, permissions, prompt history, and cached data.
-
Delete Project-Level Claude Code Configuration
Open the intended project directory and remove its Claude-specific configuration folder and MCP configuration file.
Do not delete project-level files without reviewing them first. They may contain instructions or settings shared with your team.
Removing Claude Code configuration does not normally delete the project’s source code files.
How to Delete Claude Code Data for One Project
Use Claude Code’s project cleanup feature when you want to remove local data associated with one repository without resetting every project.
Preview the cleanup before confirming it.
A project cleanup may remove:
- Local transcripts
- Task lists
- Debug logs
- File-edit history
- Prompt-history entries
- Cached project state
- The project’s local Claude Code record
This option is safer than deleting the entire Claude Code user-data folder when only one project needs to be reset.
Where Is Claude Code History Stored?
Claude Code stores local session transcripts in its user-data directory, under a projects folder.
Each project can have separate session files. Claude Code may also store prompt history, file snapshots, logs, caches, settings, agents, plugins, hooks, and other application data in the same main directory.
On Windows, the folder is normally located inside your user profile. On macOS, Linux, and WSL, it is normally located inside your home directory.
Local transcript retention may depend on your Claude Code settings and version.
How to Verify That Claude Code Was Removed
Open a new terminal after uninstalling Claude Code. Then try to locate or start the Claude Code command. If the command is not found, the active terminal installation has probably been removed.
Also check the package manager that originally installed it:
- Homebrew on macOS
- WinGet on Windows
- npm on any supported platform
- apt on Ubuntu or Debian
- dnf on Fedora or RHEL
- apk on Alpine Linux
Check Visual Studio Code and JetBrains separately to confirm that their extensions or plugins have also been removed.
Why Does Claude Code Still Work After Uninstalling It?
Another installation is probably still available.
Common causes include:
- Native and npm versions both are installed.
- Homebrew and native copies exist on the same Mac.
- Windows and WSL each contain a separate installation.
- A shell alias still points to Claude Code.
- A Node version manager has another global npm package directory.
- The Visual Studio Code extension remains installed.
- The current terminal has cached the old command location.
Open a new terminal and search for every Claude Code executable. Remove each unwanted copy through the installer that owns it.
How to Reinstall Claude Code CLI

Reinstalling Claude Code can fix corrupted files, failed updates, and command-path conflicts.
Use only one installation method for each operating-system environment.
Choose the official native installer, Homebrew, WinGet, npm, or the supported Linux package manager. After installation, verify the installed version and run Claude Code’s diagnostic check.
To keep your sessions and settings during reinstallation, retain your existing user-data folder.
Conclusion
To uninstall Claude Code safely, identify how it was installed and remove it using the same installer or package manager. Check native installations separately for Homebrew, WinGet, npm, apt, dnf, apk, Windows, and WSL, as multiple copies may exist.
Keep the Claude Code user data directory to preserve your settings, sessions, and project history for future reinstalls. Only delete it when you require a complete reset.
Flexlab provides professional technical support for installing, configuring, troubleshooting, and maintaining development tools such as Claude Code. If your team is encountering installation conflicts, environmental issues, or integration problems, please let us know.
FAQs
1. How do I uninstall Claude Code completely?
Remove Claude Code using the same installer or package manager used to install it. Then uninstall any VS Code or JetBrains integrations and delete the Claude Code user-data directory only if you also want to erase settings, sessions, credentials, and cached project data.
2. Does uninstalling Claude Code delete my projects or chat history?
No. A standard uninstall removes the Claude Code program but does not normally delete source-code projects or locally stored session history. Your history remains until you manually remove Claude Code’s user-data files or run a project-specific cleanup.
3 . Why does Claude Code still work after I uninstall it?
Another installation may still exist on your system. Check for separate native, Homebrew, WinGet, npm, Linux, Windows, or WSL copies. You may also need to open a new terminal because the current shell can retain the old command location.









