간단 요약: Claude Code 제거는 설치 방법(네이티브 설치 프로그램, npm 또는 Homebrew)에 따라 다른 단계를 거칩니다. 네이티브 설치를 제거하려면 터미널에서 `claude uninstall` 명령을 실행하세요(Windows, macOS 및 Linux에서 사용 가능). 모든 방법에는 완전한 제거를 위해 `~/.claude/`에서 구성 파일을 수동으로 제거해야 합니다.
시스템에서 Claude Code를 제거해야 합니까? 제거 프로세스는 당연히 그래야 하는 것만큼 간단하지 않습니다. 방법은 도구를 처음 설치한 방법에 따라 크게 달라집니다.
이것이 까다로운 이유는 다음과 같습니다. Claude Code는 네이티브 설치 프로그램, npm, Homebrew 또는 기타 패키지 관리자를 통해 설치될 수 있습니다. 각 방법은 다른 아티팩트를 남깁니다.
먼저 설치 방법을 확인하세요
제거하기 전에 시스템에 Claude Code가 어떻게 설치되었는지 확인하세요. 터미널에서 이 명령을 실행하세요:
| claude –version |
일반적인 설치 위치를 확인하세요:
- 네이티브 설치 프로그램(Windows): Program Files 또는 AppData
- 네이티브 설치 프로그램(macOS): Applications 폴더
- npm 설치: ~/.npm-global/bin/
- Homebrew: /usr/local/bin/ 또는 /opt/homebrew/bin/
네이티브 설치 프로그램을 통해 제거
PowerShell 스크립트(irm claude.ai/install.ps1 | iex)를 사용하는 Windows 설치의 경우 프로세스는 표준 애플리케이션과 다릅니다.
Windows 10/11:
- Settings > Apps > Installed apps 열기
- "Claude Code" 검색
- 세 개의 점을 클릭하고 Uninstall 선택
- 제거 확인
macOS:
- Finder를 열고 Applications로 이동
- Claude Code 찾기
- 휴지통으로 드래그하거나 마우스 오른쪽 버튼을 클릭하고 Move to Trash 선택
- 휴지통을 비워 제거 완료
GitHub 이슈(#6920)에 따르면 일부 사용자는 네이티브 Windows 설치 프로그램에 제거 문서가 없다고 보고했습니다. Claude Code가 표준 애플리케이션 목록에 나타나지 않으면 대안적인 제거 방법을 사용해야 합니다.
패키지 관리자를 통해 제거
npm 설치의 경우 다음 명령을 실행하세요:
| npm uninstall -g @anthropic-ai/claude-code rm -f $HOME/.npm-global/bin/claude |
macOS의 Homebrew의 경우:
| brew uninstall –cask claude-code |
Reddit의 커뮤니티 토론에 따르면 패키지 관리자 설치는 종종 구성 파일을 남깁니다. 제거 명령은 바이너리를 제거하지만 설정을 제거하지는 않습니다.
구성 파일 삭제
이 단계는 중요합니다. 제거 프로그램은 구성 파일을 제거하지 않으므로 나중에 다시 설치할 경우 문제가 발생할 수 있습니다.
이 디렉터리와 파일을 수동으로 제거하세요:
| rm -rf ~/.claude/ rm ~/.claude.json rm -rf ~/.local/share/claude rm -f $HOME/.local/bin/claude rm -rf $HOME/.bun/bin/../install/global/node_modules/@anthropic-ai |
Windows에서는 다음 폴더를 삭제하세요:
- %USERPROFILE%\.claude\
- %APPDATA%\Claude\
- %LOCALAPPDATA%\Claude\
완전한 제거 확인
제거 후 Claude Code가 사라졌는지 확인하세요:
| which claude claude –version |
두 명령 모두 "command not found" 또는 유사한 오류를 반환해야 합니다. 여전히 실행된다면 PATH 변수에서 남아있는 참조를 확인하세요.
AI 크레딧 및 소프트웨어 할인 혜택을 한 곳에서
Claude Code를 제거한 후에도 AI 도구를 계속 사용하고 있다면, Get AI Perks가 실질적인 다음 행선지가 될 수 있습니다. AI 및 클라우드 도구에 대한 스타트업 크레딧과 소프트웨어 할인을 한 곳에 모아 제공합니다. 창립자에게 Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom 등을 포함한 200개 이상의 혜택에 대한 액세스를 제공합니다. 이 플랫폼에는 혜택 조건, 승인 가이드 및 각 오퍼를 청구하는 단계별 지침도 포함되어 있습니다.
Claude 또는 Anthropic 크레딧을 찾고 계신가요?
Get AI Perks를 확인하여 다음을 수행하세요:
- AI 도구 크레딧 및 할인 혜택을 한 곳에서 찾기
- 신청 전에 혜택 조건 검토
- 스타트업 오퍼 청구를 위한 가이드 액세스
👉 Get AI Perks를 방문하여 사용 가능한 Claude, Anthropic 및 기타 AI 소프트웨어 혜택을 찾아보세요.
일반적인 제거 문제
GitHub 버그 보고서 #11789에 따르면 Linux 사용자는 유료 계정이 활성 상태가 아니면 제거할 수 없다고 보고했지만, 이는 플랫폼별 문제로 보입니다.
이 문제가 발생하면 표준 제거 프로그램을 우회하고 위에 나열된 애플리케이션 파일 및 디렉터리를 수동으로 삭제하세요. 이렇게 하면 인증 없이 Claude Code가 제거됩니다.
또 다른 문제: 비활성화된 MCP 서버 및 플러그인이 시스템에 남아 있습니다. MCP 서버를 제거하려면 `claude mcp remove [server-name]` 명령을 사용하세요.
자주 묻는 질문
Claude Code를 제거하기 위해 활성 계정이 필요합니까?
아니요. 일부 Linux 사용자가 'claude uninstall'을 사용할 때 인증 오류를 보고했지만, 수동 파일 삭제는 계정 확인 없이 Claude Code를 제거합니다. 애플리케이션 파일 및 구성 디렉터리를 직접 삭제하세요.
제거하면 프로젝트 설정이 삭제됩니까?
~/.claude/의 수동 제거는 사용자 범위 설정을 삭제합니다. 그러나 git에 커밋된 프로젝트 수준의 .claude/ 디렉터리는 자동으로 삭제되지 않으므로 수동으로 제거해야 합니다.
제거 후 다시 설치할 수 있습니까?
물론입니다. 완전한 제거 후에도 다시 설치는 정상적으로 작동합니다. 구성 파일을 제거하면 이전 설정과의 충돌 없이 깨끗한 설치가 보장됩니다.
제거 후 MCP 서버는 어떻게 됩니까?
MCP 서버는 비활성화되어도 구성에 남아 있습니다. UI에서 제거 옵션을 제공하지 않으므로 완전히 제거하려면 ~/.claude/에서 MCP 구성을 수동으로 삭제하세요.
Windows에서 제거하려면 관리자 권한이 필요합니까?
일반적으로 시스템 전체 설치의 경우 그렇습니다. 사용자 수준 설치는 관리자 권한 상승이 필요하지 않을 수 있지만, 시스템 디렉터리에서의 구성 정리는 관리자 액세스가 필요합니다.
WSL2에서 제거하는 방법은 무엇입니까?
WSL2 설치는 Linux 제거 절차를 따릅니다. 패키지 관리자 방법을 사용하거나 Windows 측이 아닌 Linux 파일 시스템에서 파일을 수동으로 제거하세요.
제거해도 모든 파일이 삭제되지 않는 이유는 무엇입니까?
표준 제거 프로그램은 잠재적인 재설치를 위해 사용자 구성 데이터를 보존합니다. 이것은 일반적인 관행이지만 완전한 제거를 위해서는 수동 정리가 필요합니다.
