Omniscio

OmniscioGuidesUninstall Claude Code

Uninstall Claude Code

Claude Code comes off with the same tool that installed it, and there is no uninstaller to run. A native install is two commands. Homebrew, WinGet, npm, apt, dnf and apk each have one of their own.

This page gives Anthropic's removal commands for every install method, the separate step that clears your settings and history, what that step costs, and how to find a second copy that keeps answering after the first is gone.

Last checked against Anthropic's setup documentation on November 16, 2026. By the Omniscio team. Updated .

Find out how it was installed

Every removal command below belongs to one install method, so identify yours first. Open a terminal to do it: on a Mac press Command and Space, type Terminal and press Enter; on Windows open PowerShell from the Start menu. Anthropic's terminal guide walks through both.

On macOS and Linux:

which -a claude

A native install is a symlink at ~/.local/bin/claude into ~/.local/share/claude/versions/. On Windows, run where.exe claude in PowerShell to list every copy on PATH. In the same window, Test-Path "$env:USERPROFILE\.local\bin\claude.exe" answers for the native one on its own.

Anthropic's troubleshooting page gives three locations a claude binary can come from: the native installer, a legacy local npm install in ~/.claude/local/, and a global npm install that npm -g ls @anthropic-ai/claude-code reports.

Read the answer that way. A line naming ~/.local/bin/claude is the native installer. A path inside Homebrew's folders is the cask. An entry from the npm command is an npm install.

Source: the Check for conflicting installations section of Anthropic's install troubleshooting page, read November 16, 2026.

Remove a native install

The native installer leaves two things behind on macOS, Linux and WSL: the launcher and the folder that holds each installed version. Anthropic removes both with these two commands:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

On Windows the same two paths are removed from PowerShell:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Neither command touches ~/.claude, which is where your settings and history live. That is the next decision on this page, not part of the removal.

Source: the Uninstall a native installation section of Anthropic's setup page, read November 16, 2026.

Remove a Homebrew, WinGet or npm install

Use the same package manager that installed it. Homebrew removes whichever cask you added, so the name has to match:

brew uninstall --cask claude-code

If you installed claude-code@latest, run brew uninstall --cask claude-code@latest instead. On Windows, WinGet removes its own package:

winget uninstall Anthropic.ClaudeCode

npm removes a global install with one line. Anthropic also lists the legacy local install at ~/.claude/local, which npm does not manage and you delete as a folder:

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/local

On Windows that last line is Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local". Anthropic recommends keeping the native install and removing every other copy.

Sources: the Uninstall with Homebrew, WinGet and npm sections of Anthropic's setup page, and the conflicting-installations section of the install troubleshooting page, read November 16, 2026.

Remove a Linux package manager install

apt, dnf and apk installs take two steps each: remove the package, then remove the repository you added. The second step is what stops your system checking a repository for a program you no longer run.

On Debian or Ubuntu, the package and its two files go together:

sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

On Fedora or RHEL, the repository is the single file you wrote:

sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo

On Alpine, the repository line is edited out of apk's list and the key is deleted. These are Anthropic's commands as written; they change system files, so on most systems you will need to run them as root or prefix each with sudo:

apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pub

Source: the Uninstall with apt, dnf, or apk section of Anthropic's setup page, read November 16, 2026.

If claude still runs afterwards

Anthropic names two causes for a command that answers after you removed it: you have a second installation, or an older installer left a shell alias behind.

The check is the one at the top of this page. which -a claude on macOS and Linux, or where.exe claude on Windows, lists every copy your shell can still reach.

A leftover alias hides in your shell configuration. Search ~/.zshrc, ~/.bashrc or ~/.bash_profile for a line mentioning claude, and on PowerShell look in your profile. Delete the line, then open a new terminal.

Repeat the matching removal command until the check finds nothing: on macOS and Linux that is a line saying claude not found, and on Windows the "Could not find files" line. A terminal that was already open when you removed the program keeps its old PATH, so a fresh window is the honest test.

Sources: the Uninstall section of Anthropic's setup page for the two causes, and the conflicting-installations section of its install troubleshooting page for the three locations, read November 16, 2026. The Zsh, Bash and profile file names are Anthropic's from that page's PATH section; the PowerShell profile is not a path Anthropic names as a PATH location.

Remove your settings and history

This step is optional, and there is no undo. Anthropic's warning is explicit: removing these files deletes your settings, allowed tools, MCP server configurations and session history.

Nothing here makes a copy for you. If you want to keep your settings or history, copy the ~/.claude folder somewhere else first: in Finder press Command, Shift and G, paste ~/.claude, and drag the folder to your Desktop. On Windows the same folder is %USERPROFILE%\.claude.

On macOS, Linux and WSL, delete the user files from your home folder. These two lines affect every project on the machine:

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

A project can also hold its own settings. These two lines only touch the folder you are in, so change into that project first with cd path/to/the/project, and never run them from your home folder.

If you are unsure which folder that is, skip this pair. It removes a project's settings only, and the two commands above already removed yours.

rm -rf .claude
rm -f .mcp.json

On Windows the user files are these two, run in PowerShell:

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

The project pair is the same idea: change into the project folder first with cd path\to\the\project, then run these two. Never run them from your home folder.

Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force

The folder can come back. Anthropic says the VS Code extension, the JetBrains plugin and the Claude desktop app all write to ~/.claude, and any of them recreates it the next time it runs. Uninstall those first if you want it gone for good.

Source: the Remove configuration files section of Anthropic's setup page, including its warning and its note about the three apps, read November 16, 2026. The advice to take a copy first is ours, in one sentence, and asserts nothing about the vendor.

Reinstalling later, and running several sessions

Putting it back is the same route you installed with. The Mac guide and the Linux guide each cover every install route, and Claude Code on Windows covers the Windows ones.

If you kept ~/.claude, your settings are still there for the next install. If you deleted it, they are gone, and you start again from the defaults.

Whether deleting the folder signs you out depends on the system. Anthropic says macOS keeps your login in the Keychain, the Mac's own password store, and only puts it in the folder when the Keychain cannot be written. Linux and Windows always keep it in the folder, so there the saved login goes with it.

Source: the credential-management section of Anthropic's authentication page, read November 16, 2026.

You can also stop using it without removing it. claude auth logout signs you out and leaves the program in place, which is the smaller step when you are not sure yet.

Omniscio, the desktop app we make for running many Claude Code sessions at once, is its own install on Windows, macOS and Linux, so this page's commands do not remove it. It is free with up to 8 projects, and Pro is $20/month or $192/year; neither plan includes an AI allowance.

Its toolchain page explains how it finds and updates the Claude Code binary your sessions use, and the multi-session guide starts there.

Where these answers come from

The release checked here was 2.1.325, the version npm served and claude --version printed on November 16, 2026. The paths have been stable, but the configuration folder is the one part of this page Anthropic changes without changing the uninstall steps, so re-read it before deleting anything you care about.

Common questions

How do I uninstall Claude Code?

Remove it the way you installed it. For a native install on macOS or Linux that is two commands: rm -f ~/.local/bin/claude for the launcher, then rm -rf ~/.local/share/claude for the versions. Homebrew, WinGet, npm and the Linux package managers each have their own uninstall command.

Does uninstalling Claude Code delete my settings and history?

Only if you delete the configuration folder, which is a separate step. The binary and the version folder hold none of it. Anthropic warns that removing the configuration deletes your settings, allowed tools, MCP server configurations and session history, so take a copy first if any of that matters.

Why does claude still run after I uninstalled it?

Anthropic names two causes: a second installation, or a leftover shell alias from an older installer. Another second install is the legacy local npm copy at ~/.claude/local, which is removed by deleting that folder rather than with npm. The conflicting-installations check finds every copy on PATH.

What is left on my computer after the uninstall?

Your settings and conversation history stay in ~/.claude, which Anthropic says also holds transcripts, prompt history, file snapshots, caches and logs. Your account details, app state and personal MCP servers live in ~/.claude.json, plus a .claude folder in any project where you saved project settings. Removing those is optional and separate.

Do I need to remove the VS Code extension or the desktop app too?

Only if you want the configuration folder gone for good. Anthropic says the VS Code extension, the JetBrains plugin and the Claude desktop app all write to ~/.claude, so any one of them recreates the folder the next time it runs. Uninstall them first if you are clearing everything.

Do the package manager uninstalls remove the repository as well?

Not on their own. On apt the second step deletes the repository file and the signing key; on dnf it deletes the repository file, since dnf fetched the key itself; on Alpine it removes the repository line and the key. Skipping it leaves your system pointing at a repository you no longer use.

Removing the tangle of terminals instead

If the thing you want gone is a desktop full of session windows rather than Claude Code itself, Omniscio holds them in one place. The features page lists what it does today.