Claude Codeのアンインストール完全ガイド動機別の手順と残骸の消し方

そもそも今、本当にアンインストールが必要か

「消したい」と思った理由によって最適な対応は変わり、動作不具合が理由なら削除せずに解決できる場合がある。まずは自分の動機を4パターンのどれに当てはまるか確認してほしい。

①動作不具合・エラーが解消しない: コマンドが動かない、応答がおかしいといった不具合が続いている場合、まず原因を切り分けると、削除より早く解決することが多い。原因の分類は本記事では扱わないため、Claude Codeのエラー対処ガイドで確認してほしい。なお、削除作業中に起きるエラー(権限不足やプロセス起動中など)はこれとは別の話で、そちらは本記事のH2-6で扱う。
②PCの入れ替え・環境移行: 新しい端末に移す、あるいは古い端末から消したいだけであれば、この記事のH2-3以降の手順をそのまま使える。
③使うのをやめる(完全撤退): しばらく使わないと決めたなら、CLI本体だけでなく設定ファイルやキャッシュまで消すかどうかの判断が必要になる。
④チャット版(claude.ai)とCLI版を混同して間違って入れた: この場合は削除対象を取り違えやすいので、先にH2-5(デスクトップアプリ・拡張機能の削除)を確認してから作業すると安全だ。

使いこなせずに離脱しかけている場合は、非エンジニア向けのつまずきポイントを先に見ておくと判断しやすい。

自分の環境ではどの方法でClaude Codeが入っているか

削除コマンドは導入方式によって異なるため、まず自分がどの方式で入れたかを特定する必要がある。npm経由・ネイティブインストーラー・Homebrew・WinGetのいずれかであることが多い。

どの方式を選ぶべきかという比較はインストールガイドに譲り、ここでは「今の自分の環境がどれに当たるか」を見分けることだけに絞る。

確認軸	npm経由	ネイティブインストーラー	Homebrew(Mac)	WinGet(Windows)
確認コマンドの例	`npm list -g @anthropic-ai/claude-code`	`which claude`(Mac/Linux)、`where claude`(Windows)でパスを確認	`brew list --formula \| grep claude`	`winget list --id Anthropic.ClaudeCode`
インストール先の目安	npmのグローバルディレクトリ配下	単独の実行ファイルとして配置されていることが多い	Homebrewのセラー配下	Program Files配下が一般的
見分けの決め手	Node.jsやnpmを使って導入した記憶がある	インストールスクリプトを直接実行した記憶がある	`brew install`した記憶がある	`winget install`した記憶がある

バージョンによって実際の配置場所が変わることがあるため、上記のコマンドで表示される実際のパスを優先して確認してほしい。ここで特定した方式を、次のH2-3でそのまま使う。

導入方式別にCLIをアンインストールするには(OS別)

特定した導入方式に応じたコマンドを実行すれば、CLI本体は削除できる。削除前には実行中のセッションを保存し、プロセスを終了しておくことが前提になる。

まず共通の事前確認として、ターミナルやコマンドプロンプトでClaude Codeが起動していないかを確認する。作業中のセッションがあれば、必要な内容を保存してから閉じておく。

npm経由の場合(Windows/Mac/Linux共通)

npm uninstall -g @anthropic-ai/claude-code

ネイティブインストーラー経由の場合(Mac/Linux)

インストール時に案内されたアンインストール用のコマンドやスクリプトがあれば、それを優先して使う。見当たらない場合は、H2-2で確認したパスにある実行ファイルを直接削除する。

sudo rm -f /usr/local/bin/claude

Homebrew経由の場合(Mac)

brew uninstall claude-code

WinGet経由の場合(Windows)

winget uninstall --id Anthropic.ClaudeCode

Windows固有の導入ルート(WSL経由かネイティブかなど)で迷う場合は、Windows向けガイドで導入方式ごとの違いを確認しておくと、削除時のコマンド選びでも迷いにくい。

設定ファイル・キャッシュ・認証情報まで完全に消すには

CLI本体を削除しただけでは、設定ファイルやキャッシュ、認証情報は端末に残る。多くの場合、ホームディレクトリ配下の.claudeというディレクトリに設定・キャッシュ・認証トークンがまとめて置かれている。

rm -rf ~/.claude

Windowsの場合は、ユーザープロファイル配下の対応するディレクトリを確認し、エクスプローラーまたはPowerShellのRemove-Itemで削除する。

「完全に消す」ことにこだわるべきかどうかは、削除の目的によって変わる。端末を譲渡・売却する、あるいは機密性の高いプロジェクトで使っていた場合は、認証トークンや設定ファイルまで確実に削除しておく価値がある。一方で単に入れ直したいだけなら、.claudeディレクトリを残しておくことで、再インストール後に設定を引き継げて手間が省ける。設定ファイルの具体的な項目はsettings.jsonの解説記事で扱っている。

デスクトップアプリやVS Code拡張機能の「残骸」はどう削除するか

デスクトップアプリやVS Code拡張機能は、CLI本体とは別のソフトウェアとして動いている。そのため、H2-3の手順でCLIを削除しても、これらは自動的には消えず、それぞれ個別に削除作業が必要になる。

デスクトップアプリを入れている場合は、OS標準の「アプリと機能」(Windows)や「アプリケーション」フォルダ(Mac)から通常のアプリと同じ手順でアンインストールする。

VS Code拡張機能を入れている場合は、拡張機能パネルから該当の拡張機能を検索し、無効化または削除する。細かい手順はVS Code拡張機能ガイドで個別に解説している。

削除できない・エラーが出るときはどうするか

アンインストール作業中に権限エラーやコマンド未検出が出た場合、主な原因として権限不足・プロセスの起動中・PATHの残留の3つが考えられる。

ここで扱うのは削除作業そのものが失敗するケース(権限不足、プロセスが起動中で削除できない、コマンドが認識されないなど)に限る。そもそもの動作不具合の原因切り分けについてはH2-1で触れたとおりだ。

権限エラーが出る場合

Mac/Linuxではsudoを付けて実行する。Windowsでは管理者権限でPowerShellやコマンドプロンプトを開き直してから実行する。

「プロセスが使用中」で削除できない場合

Claude Codeが起動したままだと、実行ファイルや設定ファイルがロックされて削除できないことがある。以下のようにプロセスを確認し、必要であれば終了させてから再度削除を試す。

# Mac/Linux
ps aux | grep claude
kill <プロセスID>

# Windows
Get-Process claude
Stop-Process -Id <プロセスID>

削除したはずなのにコマンドが認識され続ける場合

シェルの設定ファイル(.zshrcや.bashrcなど)やWindowsの環境変数にPATHの記述が残っていることが原因であることが多い。該当する記述を見つけて削除し、ターミナルを開き直すと反映される。

アンインストール後、APIキーや利用料金はどうなるか

端末からCLIやアプリを削除しても、Anthropicアカウント側の契約や課金は自動的には止まらない。ローカルの削除とアカウント側の管理は別々の仕組みだからだ。

サブスクリプションを解約したい場合や、APIキーを無効化したい場合は、それぞれAnthropicアカウントの設定画面から個別に操作する必要がある。個人プランで契約している場合と、法人契約や企業でのチーム利用として管理者が別にいる場合とでは、解約や無効化の手続きを行える立場が異なることもあるため、自分がどちらの契約下にあるかをまず確認しておくとよい。具体的な料金体系や解約手順の詳細は料金ガイド、APIキーの管理についてはAPIキー管理ガイドにまとめている。

再インストールしたくなったらどうするか

環境を移行した後や、時間をおいて再挑戦したくなった場合は、インストールガイドの手順に沿って入れ直せばよい。

1点だけ判断が必要なのは、以前使っていたCLAUDE.mdなどのプロジェクト設定を引き継ぐかどうかだ。H2-4で.claudeディレクトリを残していた場合は設定がそのまま引き継がれるが、削除していた場合は改めて書き直す必要がある。プロジェクトごとのルールの書き方に迷うなら、CLAUDE.mdの書き方ガイドがヒントになる。

まとめ

ここまでの手順で、CLI本体・設定ファイル・デスクトップアプリや拡張機能の残骸まで、動機に合わせて必要な範囲を削除できる状態になったはずだ。

H2-1で確認したとおり、動作不具合や「使いこなせない」ことが動機だった場合、削除だけが選択肢とは限らない。操作方法や運用ルールの理解が不足していただけで、時間をかければ解決できた可能性も残っている。もし独学で試行錯誤するのに不安が残るなら、月額1,980円から参加できる学習コミュニティ「AI駆動ラボ」で、実際に手を動かしながら生成AIのツールを使えるようになるところから学び直す道もある。