No uninstall documentation for the native Claud Code build (Windows)
Status Fixed / completed
Maintainer reply ✓ Yes — sarahdeaton
Workaround ✓ Mentioned in thread ↓
Activity 15 comments · opened Aug 31, 2025 · closed Jan 6, 2026
💡 Likely answer: A maintainer (sarahdeaton, collaborator)
responded on this thread — see the highlighted reply below.
Environment
- Claude CLI version: 1.0.98
- Operating System: Windows 11
Bug Description
While installing Claud Code is easy (irm https://claude.ai/install.ps1 | iex), there's no documented way to uninstall it when it was installed that way.
I tried to return to the npm version (reasons not relevant here) by just deleting ~/.claude and ~/.local folders and then installing the npm version, but that only leads to the errors:
● Directory C:\Users\<user>\.local\bin does not exist
● Claude command not found at C:\Users\<user>\.local\bin\claude.exe
Neither the AI agent on the antropic page not Claude itself can help with this and I can't see it anywhere in the docs either.
Expected Behavior
It would be nice to have a way to actually uninstall Claud Code native. Or if there is one, have it documented.
15 Comments
Found 1 possible duplicate issue:
This issue will be automatically closed as a duplicate in 3 days.
🤖 Generated with Claude Code
In the other issue, the suggested fix was deleting the .local folder.
This did not work for me as stated above.
Besides, it does not address the main point that this is undocumented.
Did you ever figure this out? I am trying to remove this as well because it just keeps freezing on me. I just get a message like:
npm uninstall -g @anthropic-ai/claude-code
up to date in 291ms
And it never uninstalls.
Unfortunately not, my workaround is to use Claude Code in WSL instead. But I still really don't know how to get rid of the broken Windows installation.
+1 to having a dedicated uninstall command/script with proper docs for each installation method.
In my case, things broke pretty badly:
My npm install failed to auto-update for some reason in the middle of session, and the
claudecommand just disappeared completely from my system.I then tried the native binary installation, hoping it would be more stable. Instead, my local setup started throwing random errors some related to npm, some related to the binary because both installations were being detected at once.
When I tried to clean things up:
As a temporary workaround, I ended up writing my own uninstaller script to wipe out both npm and native-binary installs so I could start fresh:
https://github.com/burakdede/claude-code-uninstaller
@burakdede this issue is for windows, your script doesn't support windows
@BenNewman100 you can run into this on any system where you run
claude installsince the installer finds and deletes the previous executable.It would be safer if claude install didn't touch your working executable and instead told you to prepend ~/.local/bin to your PATH.
Still no documentation found for uninstalling claude code in windows
@BenNewman100, @burakdede's script does support Windows through WSL. However, if you don't have WSL (or other bash support) or are uncomfortable with it, I have added a PowerShell version. I also sent him a PR if he wants to merge it back to his main branch.
Here is the PowerShell Version:
https://github.com/ericburcham/claude-code-uninstaller
This issue has been inactive for 30 days. If the issue is still occurring, please comment to let us know. Otherwise, this issue will be automatically closed in 30 days for housekeeping purposes.
Yup still no documentation for native build
On Fri, 26 Dec, 2025, 3:40 pm github-actions[bot], @.***>
wrote:
Hi. If you installed Claude CLI on Mac through the sh script, you can run:
sudo rm -rf $(which claude)That did the trick on my case and I can no longer run the "claude" command.
Edit: Before running the rm -rf command, run "which claude" and locate the binary route, just in case it deletes something that must not.
Thanks for reporting! We've added documentation instructions to the Set up Claude Code page: https://code.claude.com/docs/en/setup#uninstall-claude-code
Let us know if you run into any issues with these instructions.
I’ve updated my project to bring parity with the new uninstall steps and will point folks to your docs first. I’ll keep the script around for anyone (myself included) who prefers a single command (with backups) or needs to run it in CI, but it’s great to finally have an official path.
_Small DX suggestion_: it might help to open the uninstall section with a quick “what do I have installed?” checklist (
command -v claude,npm list -g @anthropic-ai/claude-code,brew list claude-code,claude --version). That would make it easier for users to know which block applies to them.This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.