npm uninstall claude｜消えない原因と安全な削除手順
Claude Codeをnpmで入れたものの、npm uninstall claudeで消えるのか、コマンドを実行してもclaudeが残るのはなぜかと迷う人は少なくありません。この記事では、実際のパッケージ名、OSや導入経路の見分け方、設定を残す削除と完全に片づける削除の違いを整理します。
npm経由で導入したClaude Codeは、正しいスコープ付きパッケージをグローバルから削除すれば本体を外せます。残る場合はNative版や別のNode環境を確認し、設定ファイルを消すか判断すれば、再起動後まで含めて安全に削除できる。
目次 (17)
- npm uninstall claudeで消すものは何か
- 先に導入経路とインストール範囲を確認する
- npm経由でClaude Codeを削除する手順
- 削除したのにclaudeが動く原因
- npm以外で導入したClaude Codeの削除方法
- Native版
- Homebrew版
- WinGet版
- apt・dnf・apk版
- 設定・認証・履歴まで消す前に
- 削除後の確認チェック
- よくある質問
- npm uninstall claudeだけでは削除できませんか？
- npmで消したのにclaudeが残るのはなぜですか？
- npm uninstallで設定やログイン情報も消えますか？
- Claudeの契約やアカウントも解約されますか？
- 参考にした公式情報
npm uninstall claudeで消すものは何か
npm uninstall claudeと入力したくなりますが、Claude Codeの公式npmパッケージ名は単なるclaudeではありません。正式には@anthropic-ai/claude-codeというスコープ付きパッケージです。また、ターミナルから呼び出す目的で導入する場合は、通常のプロジェクト依存関係ではなくグローバルインストールを使います。
そのため、Claude Codeをnpmでグローバルに導入した人が実行する基本コマンドは次のとおりです。
npm uninstall -g @anthropic-ai/claude-code
-gを付けないと、npmは現在いるプロジェクトのnode_modulesとpackage.jsonを対象にします。逆に、claudeだけを指定すると、Claude Code本体ではなく、ローカルに存在する別パッケージ名を探す動きになります。パッケージ名とインストール範囲を正しく指定することが最初のポイントです。
npm公式の「Uninstalling packages and dependencies」でも、スコープ付きパッケージはnpm uninstall -g <@scope/package_name>、グローバルパッケージは-g付きで削除する形が案内されています。Claude Codeの正式名と導入コマンドは「Claude Code公式セットアップ」で確認できます。
先に導入経路とインストール範囲を確認する
いきなり削除するより、どの場所に何が入っているかを確認すると、削除後にclaudeが残る原因を追いやすくなります。次の順番で確認してください。
- グローバルnpm版を確認するため、
npm -g ls @anthropic-ai/claude-code --depth=0を実行する。パッケージが表示されれば、現在のNode環境にグローバル版があります。 - プロジェクト内のローカル版を確認するため、プロジェクトのルートで
npm ls @anthropic-ai/claude-code --depth=0を実行する。package.jsonに依存関係があれば、グローバル版とは別に管理されています。 - 実際に呼び出される実行ファイルを確認する。macOS・Linux・WSLでは
which -a claude、Windows PowerShellではwhere.exe claudeを使います。 - Node.jsの切り替えツールを使っている場合は、
npm root -gとnpm prefix -gも確認する。nvm、fnm、VoltaなどでNodeのバージョンを切り替えると、同じ-gでも保存先が変わるためです。
確認結果に~/.local/bin/claudeや%USERPROFILE%\\.local\\bin\\claude.exeが出る場合はNative版、Homebrewのパスが出る場合はHomebrew版の可能性があります。npmの一覧にパッケージがなく、別の場所に実行ファイルがあるなら、npmの削除コマンドだけでは足りません。
npm経由でClaude Codeを削除する手順
グローバルnpm版だけを削除するなら、次の流れで進めます。作業中のClaude Codeを閉じてから実行すると、ファイルが使用中になる問題を避けられます。
-
作業中のセッションを終了し、必要な設定やプロジェクト内の変更を保存する。
-
グローバルnpmパッケージを削除する。
npm uninstall -g @anthropic-ai/claude-code -
ローカル版も不要なら、対象プロジェクトのルートでローカルパッケージを削除する。
npm uninstall @anthropic-ai/claude-codeこのコマンドは通常、
package.jsonとpackage-lock.jsonも更新します。依存関係の宣言は残してnode_modulesだけから外したい場合は--no-saveを付けますが、Claude Code自体をプロジェクトから完全に外す目的なら通常は付けません。 -
いったんターミナルを閉じて、新しいターミナルを開く。macOS・Linuxでシェルのコマンドキャッシュを更新したい場合は、
hash -rまたはrehashを実行する。 -
npm -g ls @anthropic-ai/claude-code --depth=0でグローバル一覧を確認し、macOS・Linux・WSLではwhich -a claude、Windowsではwhere.exe claudeで残った実行ファイルを調べる。
Claude Code公式の削除案内でも、npmで導入した場合はこのスコープ付きパッケージに対してnpm uninstall -g @anthropic-ai/claude-codeを実行する形です。sudo npm uninstall -gを付け足す必要はありません。権限エラーが出ても、まずNode.jsの管理方法やnpmのグローバル保存先を確認します。
削除したのにclaudeが動く原因
削除後もclaude --versionが通るなら、npm uninstallが失敗したとは限りません。最も多いのは、別の導入方法で入れたClaude Codeが残っているケースです。公式の「Troubleshoot installation and login」も、複数のインストールや古いエイリアスを確認するよう案内しています。
特に次の原因を順番に切り分けます。
- Node.jsの環境が違う: nvmなどで別バージョンへ切り替えた状態でアンインストールすると、元のNode環境に入っていたパッケージは残ります。各環境で
npm root -gを確認し、インストールした環境に戻して削除します。 - Native版が残っている:
~/.local/bin/claudeやWindowsの.local\\bin\\claude.exeがPATHに残っていると、npm版を消しても実行できます。 - HomebrewまたはWinGet版が残っている: macOSではHomebrew、WindowsではWinGetが別の実行ファイルを管理している可能性があります。
- 古いローカルnpm版が残っている: 旧方式で導入した版は、macOS・Linux・WSLの
~/.claude/local/、Windowsの%USERPROFILE%\\.claude\\local\\に残ることがあります。 - シェルのエイリアスが残っている:
which -a claudeやwhere.exe claudeで実体が見つからないのに動く場合は、シェル設定ファイルやPowerShellプロファイルに別名がないか確認します。
一つの端末に複数のClaude Codeを残すと、バージョンが一致しない、更新先が分からない、削除したつもりのCLIが復活するといった問題が起きます。再利用する予定がなければ導入方法を一つにそろえると管理しやすくなります。
npm以外で導入したClaude Codeの削除方法
実行ファイルの場所がnpmのグローバルディレクトリ外にある場合は、該当する方法だけを使います。複数のコマンドを無関係な環境で実行する必要はありません。
Native版
macOS・Linux・WSLでは、次の2か所を削除します。
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 -Force
Homebrew版
安定版のcaskなら次のコマンド、latest caskなら後者を使います。
brew uninstall --cask claude-code
brew uninstall --cask claude-code@latest
実際にインストールした名前だけを実行してください。確認にはbrew list --cask | grep claudeが使えます。
WinGet版
WindowsでWinGetから入れた場合は、PowerShellまたはコマンドプロンプトで次を実行します。
winget uninstall Anthropic.ClaudeCode
apt・dnf・apk版
Linuxの公式リポジトリ版はnpmではなくOSのパッケージ管理下にあります。Debian・Ubuntu系はsudo apt remove claude-code、Fedora・RHEL系はsudo dnf remove claude-code、Alpine Linuxはapk del claude-codeを使います。公式リポジトリや署名鍵まで不要なら、Claude Code公式セットアップの「Uninstall Claude Code」にある削除手順も確認してください。
設定・認証・履歴まで消す前に
npm uninstall -gが消すのはnpmが管理するパッケージです。Claudeのアカウント、サブスクリプション、ホームディレクトリの設定、プロジェクト固有の設定まで自動で消えるわけではありません。反対に、設定ファイルを削除すると、許可したツール、MCPサーバー設定、セッション履歴なども失われる可能性があります。
削除範囲を決めるときは、次の順番で考えると安全です。
- CLI本体だけを外したいなら、npm版または実際の導入方法に対応するアンインストールコマンドだけを実行し、
~/.claudeや.claudeは残す。 - アカウントを切り替えたいだけなら、アンインストールではなく、先にClaude Code内で
claude auth logoutを実行する。ログアウトは認証解除であり、CLI本体の削除とは別です。 - 設定や履歴も消すと決めたら、必要な
CLAUDE.md、MCP設定、履歴をバックアップしてから削除する。macOS・Linux・WSLのユーザー設定は~/.claudeと~/.claude.json、プロジェクト設定はプロジェクト直下の.claudeと.mcp.jsonが対象です。 - Windowsでは、ユーザー設定を
%USERPROFILE%\\.claudeと%USERPROFILE%\\.claude.json、プロジェクト設定を.claudeと.mcp.jsonとして確認する。PowerShellで再帰削除する場合は、パスを一つずつ確認してから実行する。 - VS Code拡張、JetBrainsプラグイン、Claude Desktopアプリを残したまま共有設定を削除しない。これらが
~/.claudeを再作成することがあるため、完全削除では関連アプリ側も先に整理する。
Anthropicの公式ドキュメントでも、設定ファイルを消す操作は本体のアンインストールとは別に扱われています。まず本体だけを外し、しばらく問題がないことを確認してから設定削除を判断する方法が、取り戻せないデータを増やしにくい進め方です。
削除後の確認チェック
削除が終わったら、次のチェックで「npm版だけが消えた」のか「Claude Code全体が消えた」のかを区別します。
npm -g ls @anthropic-ai/claude-code --depth=0を実行し、グローバルnpm一覧に対象パッケージがないことを確認する。- macOS・Linux・WSLでは
which -a claude、Windowsではwhere.exe claudeを実行し、別の導入元が残っていないか確認する。 - 新しいターミナルで
claude --versionを実行する。CLI全体を削除したなら、コマンドが見つからない状態が正常です。再びバージョンが表示されるなら、表示されたパスを手がかりに別インストールを削除します。 - 設定を残す方針なら
~/.claude、~/.claude.json、プロジェクト内の.claudeと.mcp.jsonを確認し、必要なデータが残っていることを確認する。
確認時に「command not found」や「認識されていません」と表示されても、npmの削除が失敗したという意味ではありません。CLIが存在しないことを示す結果なので、再インストール予定がなければ目的を達成できています。
よくある質問
npm uninstall claudeだけでは削除できませんか？
Claude Codeのnpmパッケージ名は@anthropic-ai/claude-codeで、グローバル導入には-gが必要です。したがって、基本コマンドはnpm uninstall -g @anthropic-ai/claude-codeです。
npmで消したのにclaudeが残るのはなぜですか？
Native、Homebrew、WinGet、旧ローカルnpm版、別のNode.js環境、エイリアスのいずれかが残っている可能性があります。which -a claudeまたはwhere.exe claudeで実体を確認してください。
npm uninstallで設定やログイン情報も消えますか？
通常は消えません。CLI本体と設定・認証・履歴は別管理です。設定まで消す場合は、公式ドキュメントを確認し、必要なファイルをバックアップしてから進めます。
Claudeの契約やアカウントも解約されますか？
されません。npmパッケージの削除はローカルのCLIを外す操作です。Claudeのプランやアカウントを停止・変更したい場合は、Webのアカウント設定から別途手続きします。
参考にした公式情報
- Claude Code公式「Advanced setup」：npm、Native、Homebrew、WinGet、apt・dnf・apkの導入・削除方法。
- Claude Code公式「Troubleshoot installation and login」：複数インストール、旧ローカル版、PATHの確認方法。
- npm公式「Uninstalling packages and dependencies」：ローカル・グローバル・スコープ付きパッケージの削除仕様。
