Claude Codeを完全にアンインストールする方法 — インストール方法の見分け方から設定ファイル削除、再インストールまで【2026年版】
Claude Codeのアンインストール手順を、ネイティブ/Homebrew/WinGet/apt/npmのインストール方法別に公式ドキュメントベースで整理。消したはずのclaudeコマンドが動き続ける原因、設定ファイル削除の注意点、クリーン再インストールが効くケースまで解説する。
エンジニアのゆとです。
Claude Codeを一度きれいに消したくなる瞬間が、たまにある。nvmで複数のNode.jsバージョンを切り替えているうちにnpm install -gを2回3回とやり直してしまった、Windowsでネイティブ版とWSL版を両方入れて訳がわからなくなった、あるいは単に「一度まっさらに戻してから入れ直したい」という気分のときもある。
厄介なのは、Claude Codeのインストール方法がネイティブインストーラー・Homebrew・WinGet・apt/dnf/apk・npmと5種類以上あって、それぞれ消し方が違うことだ。しかも複数の方法を併用していると、片方だけ消してもclaudeコマンドが平然と動き続けて「あれ、消えてない」と混乱する。この記事では、公式ドキュメントの記述をベースに「自分がどの方法で入れたかを特定する」ところから「本当に消えたか確認する」ところまで、抜け漏れなく順番に整理する。
まず結論 — 症状別のアンインストール方針
| 状況 | やるべきこと |
|---|---|
| どうやってインストールしたか覚えていない | which -a claudeで全パスを洗い出してから消す |
ネイティブインストーラー（curl | bashやirm | iex）で入れた | ~/.local/bin/claudeと~/.local/share/claudeを削除 |
| Homebrew / WinGetで入れた | brew uninstallまたはwinget uninstallのパッケージマネージャーコマンドを使う |
npmで入れた（npm install -g） | npm uninstall -g @anthropic-ai/claude-code |
消したはずなのにclaudeが動く | 複数インストールの競合か、シェルのエイリアス残存を疑う |
| VS Code拡張機能・Desktopアプリも使っていた | CLI本体とは別に、それぞれ個別にアンインストールが必要 |
Step 1: 自分がどの方法でインストールしたかを特定する
一番最初につまずくのがここだ。「アンインストールしたい」と思っても、そもそも自分がネイティブインストーラーで入れたのか、npmで入れたのか、あるいは両方入れてしまっているのか覚えていない人が大半だと思う。公式ドキュメントのトラブルシューティングページには、この特定作業のための手順がそのまま載っている。
macOS・Linux・WSLの場合、まずclaudeという名前のバイナリがPATH上のどこに存在するかを全部洗い出す。
which -a claude何も出力されない場合は、そもそもPATH上にclaudeがない状態だ。次に、claudeが生成されうる3つの場所を個別に確認する。
# ネイティブインストーラーの実体（バージョンディレクトリへのシンボリックリンクになっているのが正常）
ls -la ~/.local/bin/claude
# 旧バージョンが作成していたレガシーなローカルnpmインストール
ls -la ~/.claude/local/
# npmグローバルインストール
npm -g ls @anthropic-ai/claude-code 2>/dev/nullNo such file or directoryと出た項目は「そこには何も入っていない」という意味で、エラーではない。逆に何か出力された項目が、自分が実際に使っているインストール経路になる。2つ以上該当した場合は、それぞれのインストール方法に対応した削除コマンドを両方実行する必要がある。
Windowsの場合はPowerShellで同様の確認を行う。
Get-Command claude -All | Select-Object Source
Step 2: インストール方法別のアンインストールコマンド
Step 1で特定できたら、対応する方法でCLI本体を削除する。
ネイティブインストール（curl | bash、irm | iexで入れた場合）
バイナリとバージョンディレクトリを削除する。
# macOS / Linux / WSL
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude# Windows PowerShell
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -ForceHomebrew
安定版cask（claude-code）と最新版cask（claude-code@latest）のどちらを入れたかで、削除コマンドが微妙に変わる。brew list --cask | grep claudeで確認してから実行するのが確実だ。
# 安定版caskをインストールしていた場合
brew uninstall --cask claude-code
# 最新版caskをインストールしていた場合
brew uninstall --cask claude-code@latestWinGet
winget uninstall Anthropic.ClaudeCodeapt / dnf / apk（Debian, Fedora/RHEL, Alpine）
パッケージ本体に加えて、リポジトリ設定ファイルも一緒に消しておく。これを忘れると、次にapt updateをかけたときに存在しないリポジトリを参照し続けてエラーが出る。
# apt（Debian / Ubuntu）
sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc
# dnf（Fedora / RHEL）
sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo
# apk（Alpine）
apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pubnpm
npm uninstall -g @anthropic-ai/claude-codesudo npm install -gで入れてしまっていた場合、削除もsudoが必要になることがある。権限エラーが出たらsudo npm uninstall -g @anthropic-ai/claude-codeを試す。
Step 3: 設定ファイル・認証情報・キャッシュを削除する
CLI本体を消しても、~/.claude/ディレクトリと~/.claude.jsonは残る。ここには許可したツールの一覧、MCPサーバーの設定、セッション履歴が全部入っている。
# macOS / Linux / WSL — ユーザー設定と状態を削除
rm -rf ~/.claude
rm ~/.claude.json
# プロジェクト固有の設定を削除（該当のプロジェクトディレクトリで実行）
rm -rf .claude
rm -f .mcp.json# Windows PowerShell
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Forceここで一つ注意点がある。~/.claude/を消すと、許可済みツールのリストやMCPサーバー設定、CLAUDE.mdの参照履歴なども全部リセットされる。単にバージョンを入れ替えたいだけなら、この工程は不要だ。設定ファイルの破損が疑われる場合や、完全にまっさらな状態から始めたい場合にだけ実行すればいい。
Step 4: VS Code拡張機能・JetBrainsプラグイン・Desktopアプリは個別に消す
見落としがちなのがここだ。VS Code拡張機能・JetBrainsプラグイン・Claude Desktopアプリは、それぞれ独自に~/.claude/へ書き込みを行う。CLI本体と設定ファイルを消しても、これらのどれかがまだインストールされたままだと、次にそれらを起動した瞬間に~/.claude/ディレクトリが自動的に再作成されてしまう。
「アンインストールしたのに設定ファイルがまた生えてくる」という現象の正体はだいたいこれだ。Claude Codeを完全に削除したい場合は、設定ファイルを消す前に、以下を先に個別アンインストールしておく必要がある。
- VS Code拡張機能（拡張機能タブから「Claude Code」を検索してアンインストール）
- JetBrains系プラグイン（Settings → Plugins から削除）
- Claude Desktopアプリ（OS標準のアプリ削除機能を使う）
Step 5: 消したはずなのにclaudeが動く3つの原因
CLI本体と設定ファイルを消したのに、ターミナルでclaudeと打つとまだ何か反応する——このパターンでハマる人は多い。原因は主に3つに絞られる。
原因1: 複数のインストール方法が併用されていた
Step 1の確認を一度で終わらせず、which -a claudeをもう一度実行してみる。ネイティブインストールとnpmグローバルインストールが両方残っていると、片方だけ消してももう片方が反応する。全部の出力が空になるまで、該当するアンインストールコマンドを繰り返す。
原因2: シェルの設定ファイルに古いエイリアスが残っている
過去のバージョンをインストールしたときに、シェルの設定ファイル（~/.zshrc、~/.bashrcなど）にclaudeのエイリアスやPATH追記が残っているケースがある。該当のファイルを開いてclaudeで検索し、手動で該当行を削除する。
原因3（Windows限定）: Claude Desktopのclaude.exeがPATHの優先順位で勝っている
古いバージョンのClaude Desktopをインストールしていた場合、WindowsAppsディレクトリに登録されたClaude.exeがCLIよりPATH優先順位で先に来てしまい、claudeと打つとCLIではなくDesktopアプリが起動することがある。この場合はCLIが壊れているわけではなく、Claude Desktopを最新版に更新すれば解消する。
Step 6: 本当に消えたか確認する
全工程が終わったら、最後に検証する。
which -a claude
claude --versionwhich -a claudeが何も出力せず、claude --versionがcommand not found（Windowsなら'claude' is not recognized）になれば、アンインストールは完了している。
そもそも「アンインストール」が正解とは限らない
ここまで手順を説明してきたが、実は多くの不調は完全アンインストールしなくても直る。アンインストール→再インストールという重い手順を踏む前に、まず軽い手当てで直らないか切り分けたほうがいい。
| 症状 | まず試すこと | 効かなければ |
|---|---|---|
| バージョンが古いまま更新されない | claude updateを手動実行 | ダウングレード・バージョン固定の設定を見直す |
| Node.jsのバージョンエラーが出続ける | PATH解決の問題を切り分ける | それでも直らなければ再インストール |
| 認証・ログインが通らない | /logoutしてから再ログイン | 再インストールは最終手段 |
| 通信が途中で切れる、接続エラーが出る | プロキシ・ネットワーク設定を確認 | 設定ファイルの破損を疑って再インストール |
軽い手当てを一通り試してもダメだった場合、あるいは設定ファイル自体が壊れている疑いが強い場合にだけ、今回の完全アンインストール→クリーン再インストールが有効な手段になる。バージョン管理でハマっている場合は、こちらの記事も合わせて参考にしてほしい。
クリーン再インストールの手順
Step 1〜6でアンインストールが完了したら、公式のインストールコマンドで入れ直す。
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iexインストール後はclaude --versionでバージョンを確認し、claude doctorでインストール状態と設定ファイルの健全性をチェックしておくと安心だ。
claude doctorWindows環境で複数の選択肢に迷う場合は、こちらの記事でネイティブ・WSL・Git Bashの違いを整理している。
FAQ
アンインストールすると、MCPサーバーの設定やCLAUDE.mdの参照履歴はどうなる?
~/.claude/と~/.claude.jsonを削除すると、許可済みツールのリスト・MCPサーバー設定・セッション履歴はすべて消える。プロジェクト固有の.claude/と.mcp.jsonも同様だ。CLAUDE.mdファイル自体はプロジェクトの通常のファイルなので削除されないが、Claude Code側の「読み込み履歴」的な状態はリセットされる。バージョンの入れ替えだけが目的なら、設定ファイルの削除工程はスキップしていい。
npmとネイティブインストーラー、両方使ったことがある場合はどうすればいい?
which -a claudeで両方のパスが表示されるはずなので、npm uninstall -g @anthropic-ai/claude-codeとネイティブインストーラーの削除コマンド（rm -f ~/.local/bin/claudeなど）の両方を実行する。片方だけ消すと、もう片方が動き続けて「消えていない」と誤認する原因になる。
VS Code拡張機能だけ削除して、CLI本体は残したい場合は?
問題ない。VS Code拡張機能タブから「Claude Code」をアンインストールすれば、CLI本体（claudeコマンド）には影響しない。逆にCLI本体だけ消してVS Code拡張機能を残していると、拡張機能が~/.claude/を再生成し続けるので、両方を完全に消したい場合はStep 4の順番（拡張機能→設定ファイルの順）を守ることが重要になる。
まとめ
Claude Codeのアンインストールが「消したはずなのに消えていない」状態になる理由は、だいたい次の3つに集約される。インストール方法が複数あって片方しか消していない、VS Code拡張機能やDesktopアプリが設定ファイルを再生成している、シェルの設定ファイルに古いエイリアスが残っている——このいずれかだ。
which -a claudeで現状を特定してから、対応する方法で本体・設定ファイル・関連アプリを順番に消していけば、迷わず完了できる。そしてこの記事の手順を全部使う前に、まずclaude updateや/logoutのような軽い手当てで直らないかを確認したほうが、たいていの場合は早い。
