Claude Codeアンインストールの手順 — brew・npm・Windows別コマンドと残存ファイル
Claude Codeをネイティブ・Homebrew・npm・apt/dnf/apk・WinGet別にアンインストールする手順と、~/.claudeなど残存ファイルの消し方、複数インストールが衝突する場合の見分け方をまとめます。
Claude Codeを消すコマンドは、入れた方式で決まります。uninstallというサブコマンドは無く、方式ごとに次のとおりです。
| 入れた方式 | 消すコマンド |
|---|---|
Homebrew(brew install --cask claude-code) | 消すコマンドbrew uninstall --cask claude-code |
Homebrew(claude-code@latest) | 消すコマンドbrew uninstall --cask claude-code@latest |
| npm | 消すコマンドnpm uninstall -g @anthropic-ai/claude-code |
| Windows(WinGet) | 消すコマンドwinget uninstall Anthropic.ClaudeCode |
| Windows・macOS・Linuxのネイティブ | 消すコマンド後述の方式別コマンド |
| apt・dnf・apk(Linux) | 消すコマンドsudo apt remove claude-code など |
brew uninstall claudeは別物のカスク(Claude Desktopアプリ)を指します。Claude Codeのカスク名はclaude-code(最新版に追従する場合はclaude-code@latest)です。プラグインだけ消したい場合は、プラグインの削除に進んでください。
Claude Codeを完全に削除する場面
バイナリを消すだけなら数十秒の作業ですが、「完全アンインストール」まで踏み込む場面は限られます。よくあるのは次の3つの場面です。
- 開発機を手放す前に、APIキーやMCPサーバー設定を残さないようにしたい
- インストール方式をnpmからネイティブインストーラーに切り替えたい
- 設定ファイルの破損が疑われる不具合を、クリーンインストールで切り分けたい
どこまで消すかは目的で決まります。迷ったら、次の2択のどちらに当たるかを先に決めてください。
どこまで消すか
バイナリだけ消す
実行ファイルとバージョン管理ファイルだけを消します。~/.claudeは残るので、再インストール後も許可済みツールやMCPサーバー構成、セッション履歴をそのまま使えます。ディスク容量を空けたい場合や、npmからネイティブへ移る場合はこちらで足ります。
設定ごと消す
バイナリに加えて~/.claudeと~/.claude.jsonも消します。許可済みツール・MCPサーバー構成・セッション履歴は戻せません。端末を手放す場合のほか、壊れた設定をクリーンインストールで切り分けたい場合もこちらです。
入っている方式を先に特定する
コマンドはインストール方式ごとに違うので、最初にwhich -a claude(Windowsはwhere.exe claude)で場所を見ます。ネイティブインストーラーで入れた環境では、claudeはバージョン別のバイナリへのシンボリックリンクです。v2.1.287のmacOSで確認した出力は次のとおりです(ホームは~に置き換えています)。
$ claude --version
2.1.287 (Claude Code)
$ ls -la ~/.local/bin/claude
lrwxr-xr-x 1 user staff 48 ~/.local/bin/claude -> ~/.local/share/claude/versions/2.1.287
$ ls ~/.local/share/claude
ClaudeCode.app versionsリンク先が~/.local/share/claude/versions/の下ならネイティブです。Homebrewやnpmで入れた場合は、パスが/opt/homebrew/binやnpmのグローバル領域を指します。複数が併存している場合は、後述の衝突の見分け方に進んでください。
なお、claude uninstallというサブコマンドはありません。v2.1.287でclaude --helpのコマンド一覧を見ると、installとdoctorはあってもuninstallは出てきません。claude uninstall --helpを打っても個別のヘルプは出ず、通常のヘルプが表示されました。削除は方式ごとのコマンドで行います。
方式別のアンインストールコマンド
自分が使った方式に対応するコマンドを実行します。バイナリと関連ファイルが削除され、claudeコマンドは使えなくなります。
| インストール方式 | アンインストールコマンド |
|---|---|
| ネイティブインストーラー | アンインストールコマンドrm -f ~/.local/bin/claude rm -rf ~/.local/share/claude |
| Homebrew(stableカスク) | アンインストールコマンドbrew uninstall --cask claude-code |
| Homebrew(latestカスク) | アンインストールコマンドbrew uninstall --cask claude-code@latest |
| WinGet | アンインストールコマンドwinget uninstall Anthropic.ClaudeCode |
| npm(グローバル) | アンインストールコマンドnpm uninstall -g @anthropic-ai/claude-code |
| apt | アンインストールコマンドsudo apt remove claude-code |
| dnf | アンインストールコマンドsudo dnf remove claude-code |
| apk | アンインストールコマンドapk del claude-code |
ネイティブインストーラーで入れた場合、macOS・Linux・WSLでは次の2行で完了します。
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claudeWindowsでネイティブインストーラーを使った場合は、PowerShellで次を実行します。
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -ForceLinuxのパッケージマネージャーはリポジトリ設定も消す
apt・dnf・apkはパッケージを消してもリポジトリの登録が残ります。パッケージ削除のあとに、登録ファイルも片付けます。
# 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.pubapkはリポジトリ行の削除にsedを使う点が他と違います。/etc/apk/repositoriesを書き換えるコマンドなので、実行前に自分の環境の行が一致するか確認してください。
完全削除は順番で事故が減る
設定まで消す場合は、順序を間違えると「消したのに戻ってきた」状態になります。IDE側が先に残っていると~/.claudeが再作成されるためです。
完全削除の順序
- 1
ログアウトする
claude auth logout(または/logout)でサインアウトします。認証情報を残したまま端末を手放す事態を避けられます。 - 2
IDE拡張・プラグイン・Desktopアプリを削除する
これらが残っていると、次の起動で
~/.claudeが作り直されます。 - 3
バイナリを消す
前の節の方式別コマンドを使います。
- 4
設定ディレクトリを消す
~/.claudeと~/.claude.jsonが対象です。先にプロジェクト単位で足りるかを検討します。 - 5
インストール時の作業ディレクトリを確認する
~/.local/state/claudeと~/.cache/claudeが残っていないかを見ます。
~/.claudeを丸ごと消さずに、プロジェクト単位で消す
設定ファイルの削除は戻せません。過去のセッションが溜まりすぎただけなら、全部消さずに済む手段があります。v2.1.287にはclaude project purgeがあり、プロジェクト1件分のローカル状態だけを消せます。
$ claude project purge --help
Usage: claude project purge [options] [path]
Delete all Claude Code state for a project (transcripts, tasks, file history,
config entry)
Options:
--all Purge state for every project (mutually exclusive with
[path])
--dry-run List what would be deleted without deleting anything
-h, --help Display help for command
-i, --interactive Prompt for each item before deleting
-y, --yes Skip confirmation prompt--dry-runを付けると、削除せずに対象だけを表示します。状態の無いディレクトリで試すと、次のエラーを出して終了コード1で止まります。
$ claude project purge ~/work/some-dir --dry-run
No Claude Code project state found for ~/work/some-dir under ~/.claude.削除対象はプロジェクトのトランスクリプトと自動メモリ、タスク、デバッグログ、ファイル編集履歴、history.jsonlの該当行、~/.claude.json内のそのプロジェクトの項目です。shell-snapshots/とbackups/はプロジェクト単位ではないので触りません。backups/には旧スナップショットが最大5つ残り、順に入れ替わります。
貼り付けた画像や各セッションのscratchpadは、~/.claudeではなく一時ディレクトリにあるため、purgeでは消えません。画像はcleanupPeriodDaysを過ぎると自動の掃除で消えます。purge済みセッションのscratchpadは、自分で消すかOSが一時ディレクトリを片付けるまで残ります。
--allを付けると全プロジェクトを対象にし、history.jsonlは行の絞り込みではなくファイルごと消えます。端末を手放すときに近い状態にしたいが、認証や設定は残したい、という中間の選択肢になります。~/.claude.jsonと~/.claude/settings.json、~/.claude/plugins/は認証・設定・導入済みプラグインを持つので、手で消さないよう注意書きがあります。
設定・認証情報・残存ファイルを消す
purgeでは足りず、設定ごと消す場合のコマンドです。バイナリを削除しただけでは~/.claudeディレクトリと~/.claude.jsonファイルが残ります。
# ユーザー設定と状態を削除
rm -rf ~/.claude
rm ~/.claude.json
# プロジェクト固有の設定を削除(プロジェクトディレクトリで実行)
rm -rf .claude
rm -f .mcp.jsonWindows(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" -ForceCLAUDE_CONFIG_DIRを設定している環境では、設定・セッション履歴・プラグインが~/.claudeではなく、その変数が指すディレクトリに置かれます。複数アカウントを別ディレクトリで使い分けている場合は、アカウントの数だけ削除が必要です。~/.claudeだけ消しても、別のディレクトリの分は残ります。
インストール時に作られる作業ディレクトリ
ネイティブインストーラーはバイナリのほかに、ロックファイルとステージング用のディレクトリも作ります。macOS・Linuxで作られるのは3つです。~/.local/state/claudeにはロックファイル、~/.cache/claudeには取得途中のダウンロードが入ります。~/.claude/downloads/は、ダウンロードしたバイナリの置き場です。公式のアンインストール手順はこの3つに触れていません。上のv2.1.287の環境では、~/.local/state/claudeにlocksが、~/.cache/claudeに空のstagingがありました。XDG_DATA_HOME・XDG_STATE_HOME・XDG_CACHE_HOMEを設定している場合、~/.localと~/.cacheの代わりにそちらが使われます。
ログイン情報は~/.claudeを消しても残ることがある
認証情報の保存先はOSで違い、ここを取り違えると「設定を消したのにログインが残る」状態になります。
- macOS: 通常はKeychainに保存されます。Keychainが書き込みを拒否した場合(SSHセッションでロックされている場合など)だけ、
~/.claude/.credentials.jsonに保存されます - Linux:
~/.claude/.credentials.json(ファイルモード0600)です - Windows:
%USERPROFILE%\.claude\.credentials.jsonです
つまりLinuxとWindowsでは~/.claudeを消せばログイン情報も消えますが、macOSでは通常Keychainのエントリが別に残ります。CLAUDE_CONFIG_DIRを設定している場合は、.credentials.jsonもそのディレクトリの下に置かれ、Keychainのエントリもそのディレクトリごとに別になります。
端末を手放す前にclaude auth logout(または/logout)でサインアウトしておくと、認証情報を残したまま渡す事態を避けられます。Keychainのエントリまで消えるかどうかは、公式の説明に書かれていません。claude authの下にはlogin・logout・statusがあり、v2.1.287のclaude auth logout --helpはオプションなしの1行説明だけを返しました。
複数インストールが衝突しているときの見分け方
上記のコマンドを実行してもclaudeが動き続ける場合、2つ目のインストールか、古いインストーラーが残した別名(エイリアス)が残っています。claudeバイナリが来ている可能性がある場所は3か所です。ネイティブインストーラーの~/.local/bin/claude、古いバージョンが作る~/.claude/local/のレガシーローカルnpmインストール、npmグローバルインストールの一覧です。
which -a claude
ls -la ~/.local/bin/claude
ls -la ~/.claude/local/
npm -g ls @anthropic-ai/claude-code 2>/dev/nulllsがNo such file or directoryを返しても異常ではなく、その場所に何も入っていないという意味です。ネイティブインストールなら~/.local/bin/claudeは~/.local/share/claude/versions/へのシンボリックリンクになります。自分で作ったスクリプトやリンクがここにある場合は独自のランチャー扱いになり、自動更新はそれを書き換えません。
複数見つかったら、公式の案内に従ってmacOS・Linuxでは~/.local/bin/claudeのネイティブインストールを残し、他を削除します。HomebrewやWinGetで入れたものも、前の表のコマンドで余分な分を消せます。レガシーのローカルnpmインストールは次のコマンドで消せます。
npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/localWindowsでも考え方は同じで、where.exe claudeで一覧を確認し、%USERPROFILE%\.local\bin\claude.exeのネイティブインストールを残して他を削除します。レガシーのローカルnpmインストールが残っている場合は、PowerShellで次を実行します。
npm uninstall -g @anthropic-ai/claude-code
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"VS Code拡張・JetBrainsプラグイン・Desktopアプリの扱い
VS Code拡張・JetBrainsプラグイン・Desktopアプリはいずれも独自に~/.claudeへ書き込みます。CLIだけアンインストールしても、これらのどれかが入ったままだと、次回起動時に~/.claudeディレクトリが再作成されます。完全に消したい場合は、CLIより先にこれらを削除します。
VS Code拡張はCLIとは別物として動きます。拡張はチャットパネル用にCLIの独立したコピーを内蔵していて、これはシェルのPATHには加わりません。which -a claudeでは拡張の内蔵CLIが出てこず、スタンドアロンCLIを消しても拡張のパネルは動き続けます。逆に拡張だけ消しても、ターミナルのclaudeコマンドは影響を受けません。
削除は、拡張機能ビュー(Cmd+Shift+XまたはCtrl+Shift+X)で「Claude Code」を検索し、Uninstallを押します。ただし、VS Codeの統合ターミナルでclaudeを実行すると、Claude Codeが拡張を自動で入れ直します。拡張を消したままにするには、次のどれかを設定します。
/configのAuto-install IDE extensionをオフにする- 設定キー
autoInstallIdeExtensionをfalseにする - 環境変数
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALLを1にする
拡張の保存データまで消してすべての設定をリセットする場合は、OS別のストレージディレクトリを削除します。
# macOS
rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code
# Linux
rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-codeWindowsでは、PowerShellで次を実行します。
Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"JetBrains系IDEは、IDEの設定でプラグイン管理を開き、Claude Codeプラグインを無効化またはアンインストールします。Desktopアプリは、macOSなら「アプリケーション」フォルダからゴミ箱へ、Windowsなら「アプリと機能」から消す、通常のアプリ削除の手順です。
プラグインだけを消すには
Claude Code本体は残し、導入済みのプラグインだけを外すこともできます。セッション内で/plugin uninstallを実行すると管理パネルが開き、Installedタブから削除できます。シェルからはclaude plugin uninstallで消せます。
claude plugin uninstall formatter@your-org --scope projectプロジェクトの.claude/settings.jsonで有効化されたプラグインを消そうとすると、「自分だけ無効にする」(y)か「全員分を削除する」(u)かを聞かれます。前者は.claude/settings.local.jsonにfalseを書くだけで、プロジェクトには入ったままです。
アンインストールしても消えないもの
ローカルのアンインストールが影響するのは、手元の端末のバイナリと設定ファイルだけです。次の2つは別枠で管理されます。
端末の外に残るもの
アカウントとサブスクリプション
Claude Codeを削除しても契約はそのまま続きます。課金を止めるには、Claudeのサブスクリプション解約手順から別途手続きをします。
サーバー側の会話データ
保持期間は、Free・Pro・Maxでモデル改善への利用を許可していれば5年、許可していなければ30日です。Team・Enterprise・APIは標準で30日で、ゼロデータリテンションは対象アカウントだけが使えます。
保持期間の設定を変えたい場合の入口は、claude.aiのsettings/data-privacy-controlsです。Claude Code on the webのセッションは、サイドバーまたはセッションのメニューから個別に削除でき、削除するとイベントデータも消えます。
別の経路で残るものもあります。/feedback・/bug・/shareで送ったトランスクリプトは、ローカルを消しても5年間保持されます。セッション評価のあとの確認画面で「Yes」を選んで共有したものは、最長6か月です。どちらも自分で送信を選んだときだけ生じます。ローカルのトランスクリプトを短くしたい場合は、cleanupPeriodDaysで保持日数を変えられます(既定は30日)。
よくあるつまずきと対処
アンインストールしたはずなのにclaudeが動く: 前述の3か所を確認し、複数インストールが併存していないかを見ます。古いインストーラーが作ったシェルのエイリアスが~/.zshrc・~/.bashrc・~/.config/fish/config.fishに残っている場合もあります。macOSでは~/.bash_profile、~/.bash_login、~/.profileのうち最初に存在する1つも対象です。ZDOTDIRを設定しているなら、Zshの設定は$ZDOTDIR/.zshrcです。これらのシェル設定ファイルをclaudeという文字列で検索します。見つけたaliasやexport PATHの行は手で削除し、シェルの再起動かsourceで反映します。
設定ファイルの削除でPermission deniedになる: ~/.local/bin/や~/.claude/への書き込み権限が無いと発生します。test -w ~/.claude && echo writableで書き込み可否を確認し、権限が無ければ所有者をls -ldで見てから対処します。
アンインストール後に再インストールしても不具合が直らない: バイナリだけ消して~/.claudeを残したままだと、壊れた設定がそのまま再利用されます。設定ファイルが読み込めない場合の挙動は、設定ページに書かれています。壊れた~/.claude.jsonは~/.claude/backups/.claude.json.corrupted.<timestamp>へ退避されます。そのうえで、終了して手で直すか、既定にリセットするかを聞かれます。切り分けが目的なら、設定ごと消したクリーンインストールを試し、Claude Codeインストールエラーの切り分けチェックリストで原因を確認してください。
再インストール後に前の設定を戻したい: ~/.claudeを消していなければ、そのまま使えます。消した場合、~/.claude/backups/の.claude.json.backup.<timestamp>(最新5つ)も一緒に消えているため、戻せません。CLAUDE.mdやMCPサーバー定義は作り直しになります。
よくある質問
WSLでアンインストールすると、Windows側のインストールにも影響しますか
WSL内はLinux向けの手順(rm -f ~/.local/bin/claude等)、WindowsネイティブはPowerShellの手順と、削除コマンドが別々に用意されています。両方に入れている場合は、それぞれの環境で個別にアンインストールコマンドを実行します。
まとめ
バイナリの削除と設定の削除は別の判断です。容量や方式の切り替えが目的なら前者だけで足り、端末を手放すなら、claude auth logoutでサインアウトしてから~/.claudeと~/.claude.jsonまで消します。インストール手順そのものを見直したい場合はClaude Code install完全ガイドにまとめています。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。