No uninstall documentation for the native Claud Code build (Windows)

Status Fixed / completed
Maintainer reply ✓ Yes — sarahdeaton
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.

View original on GitHub ↗

15 Comments

github-actions[bot] · 12 months ago

Found 1 possible duplicate issue:

  1. https://github.com/anthropics/claude-code/issues/6349

This issue will be automatically closed as a duplicate in 3 days.

  • If your issue is a duplicate, please close it and 👍 the existing issue instead
  • To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

eikowagenknecht · 12 months ago

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.

smcneece · 11 months ago
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.

eikowagenknecht · 11 months ago

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.

burakdede · 11 months ago

+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 claude command 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:

  • npm uninstall ... didn’t work → kept failing with ENOTEMPTY and other errors.
  • Native binary uninstall → couldn’t find any dedicated uninstall command or documentation.

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

BenNewman100 · 10 months ago

@burakdede this issue is for windows, your script doesn't support windows

danneu · 9 months ago

@BenNewman100 you can run into this on any system where you run claude install since the installer finds and deletes the previous executable.

$ which claude
/home/dan/.npm-global/bin/claude

$ ls /home/dan/.npm-global/bin
claude

$ claude install
Native installation exists but ~/.local/bin is not in your PATH

$ claude
claude: command not found

$ ls /home/dan/.npm-global/bin
(empty)

It would be safer if claude install didn't touch your working executable and instead told you to prepend ~/.local/bin to your PATH.

varadan13 · 9 months ago

Still no documentation found for uninstalling claude code in windows

ericburcham · 9 months ago

@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

github-actions[bot] · 8 months ago

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.

varadan13 · 8 months ago

Yup still no documentation for native build

On Fri, 26 Dec, 2025, 3:40 pm github-actions[bot], @.***>
wrote:

github-actions[bot] left a comment (anthropics/claude-code#6920) <https://github.com/anthropics/claude-code/issues/6920#issuecomment-3692630413> 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. — Reply to this email directly, view it on GitHub <https://github.com/anthropics/claude-code/issues/6920#issuecomment-3692630413>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AQWEV67KGJQ55VCTNNHRNQL4DUCRVAVCNFSM6AAAAACFIMV72WVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTMOJSGYZTANBRGM> . You are receiving this because you are subscribed to this thread.Message ID: @.***>
realrodri · 8 months ago

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.

sarahdeaton collaborator · 7 months ago

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.

burakdede · 7 months ago

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.

github-actions[bot] · 7 months ago

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.