Claude Code 삭제하는 법: macOS·Linux·Windows 완전 제거 가이드
Claude Code를 삭제하고 싶은데 어떻게 해야 할지 모르겠다면 이 글이 딱 맞습니다. npm 명령어 1개로 패키지를 제거하고, 설정 파일까지 깔끔하게 지우는 전체 과정을 운영체제별로 정리했습니다. 삭제 후 계정·크레딧 유지 여부까지 한 번에 확인하세요.
Claude Code 삭제, 핵심부터 말하면
결론부터 말하면 Claude Code 삭제는 두 단계로 끝납니다.
npm uninstall -g @anthropic-ai/claude-code— 패키지 제거~/.claude폴더 삭제 — 설정·인증·기록 제거
이 두 가지를 모두 해야 완전한 제거입니다. npm 명령만 실행하면 패키지는 지워지지만, 인증 토큰·명령 기록·커스텀 에이전트 설정은 로컬에 그대로 남습니다.
Claude Code를 삭제하는 주요 이유
Claude Code를 제거하는 상황은 크게 다섯 가지로 나뉩니다.
- 다른 도구로 전환 — Cursor, Windsurf, Cline 등으로 갈아타는 경우
- 설치 오류 수정 — 깨진 설치를 깔끔하게 초기화한 뒤 재설치
- 디스크 용량 확보 — 쓰지 않는 전역 npm 패키지 정리
- 개인정보 보호 — 로컬에 저장된 인증 토큰·기록 완전 삭제
- 멀티 컴퓨터 정리 — 더 이상 사용하지 않는 기기에서 제거
이유가 무엇이든 제거 절차는 동일합니다.
1단계 — npm 패키지 제거 (전 운영체제 공통)
터미널을 열고 아래 명령어를 실행합니다.
npm uninstall -g @anthropic-ai/claude-code
# 제거 확인
claude --version
command not found: claude가 출력되면 성공입니다. 버전 번호가 계속 나온다면 Claude Code가 여러 경로에 설치된 것이니, 아래 문제 해결 섹션을 참고하세요.
2단계 — 설정 폴더 삭제 (데이터 완전 제거)
npm 제거만으로는 아래 데이터가 그대로 남습니다.
| 경로 | 내용 |
|---|---|
settings.json | 권한·환경변수·훅 설정 |
agents/ | 커스텀 서브에이전트 정의 |
commands/ | 커스텀 슬래시 명령 |
projects/ | 프로젝트별 세션 기록 |
auth/ | API 키·OAuth 토큰 |
mcp.json | MCP 서버 설정 |
완전히 지우려면 운영체제에 맞는 명령을 실행합니다.
macOS / Linux
# 삭제 전 백업이 필요하다면 (선택)
cp -r ~/.claude ~/claude-backup-$(date +%Y%m%d)
# 설정 폴더 완전 삭제
rm -rf ~/.claude
rm -rf ~/.claude.json
Windows (PowerShell — 관리자 권한으로 실행)
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude"
Remove-Item -Force "$env:USERPROFILE\.claude.json"
커스텀 명령·에이전트·MCP 서버 설정을 나중에 복원하고 싶다면 삭제 전 반드시 백업하세요.
3단계 — 인증 토큰 삭제 (선택 권장)
Claude Code는 시스템 키체인에 OAuth 토큰을 별도로 저장합니다. 완전히 정리하려면 운영체제별로 다음을 실행합니다.
macOS
security delete-generic-password -s "claude-code"
Linux
secret-tool clear service claude-code
Windows
자격 증명 관리자 → Windows 자격 증명으로 이동해서 claude-code 또는 anthropic이 포함된 항목을 직접 삭제합니다.
API 키 자체를 무효화하려면 Anthropic 콘솔 → API Keys에서 해당 키를 삭제하면 됩니다.
4단계 — 셸 설정 정리 (별칭·환경변수 제거)
.zshrc, .bashrc, .bash_profile에 Claude Code 관련 설정을 직접 추가했다면 편집기로 열어서 아래 형태의 줄을 찾아 삭제합니다.
# 아래와 같은 줄을 찾아 삭제
alias cc="claude"
export CLAUDE_API_KEY="sk-ant-..."
export PATH="$PATH:/path/to/claude"
# 편집 후 셸 다시 불러오기
source ~/.zshrc # Zsh 사용 시
source ~/.bashrc # Bash 사용 시
Fish 셸은 ~/.config/fish/config.fish를 편집합니다.
자주 겪는 문제 해결
삭제했는데도 claude 명령이 작동해요
여러 경로에 중복 설치된 경우입니다. 설치 위치를 모두 확인한 뒤 각각 제거합니다.
# 설치 위치 전체 확인
which -a claude
# 경로별 개별 제거
npm uninstall -g @anthropic-ai/claude-code --prefix /해당/경로
권한 거부(Permission denied) 오류가 나요
# macOS·Linux: sudo 추가
sudo npm uninstall -g @anthropic-ai/claude-code
Windows는 PowerShell을 관리자 권한으로 실행한 뒤 같은 명령을 실행합니다.
~/.claude 폴더를 삭제할 수 없어요
Claude Code 프로세스가 파일을 점유하고 있을 수 있습니다.
# 프로세스 종료 후 재시도
pkill -f claude
rm -rf ~/.claude
npm 목록에 Claude가 계속 보여요
# 캐시 비우기 후 확인
npm cache clean --force
npm list -g --depth=0
Claude Code 삭제 후 계정·크레딧은 어떻게 되나요?
삭제해도 Anthropic 계정, API 크레딧, 구독은 유지됩니다. CLI 제거는 로컬 도구만 지우는 것이므로 걱정하지 않아도 됩니다.
삭제 후에도 같은 Anthropic 계정으로 다음 도구들을 그대로 사용할 수 있습니다.
- Cursor — 설정에서 Anthropic API 키 입력
- Windsurf — Claude를 모델 제공자로 설정
- Cline / Roo Code — Anthropic API 직접 연결
- Claude.ai 웹 — 동일 계정, 브라우저로 접속
Claude Pro·Max 구독을 해지하려면 CLI가 아닌 claude.ai 계정 설정에서 직접 취소해야 합니다.
다시 설치하고 싶다면
언제든지 아래 명령 하나로 재설치할 수 있습니다.
npm install -g @anthropic-ai/claude-code@latest
백업해둔 ~/.claude 폴더가 있다면 복원해서 기존 설정을 그대로 이어받을 수 있습니다.
정리
Claude Code 삭제는 복잡하지 않습니다. npm으로 패키지를 제거하고, ~/.claude 폴더를 삭제하면 완전히 정리됩니다. 인증 토큰과 셸 설정까지 정리하면 시스템에 아무 흔적도 남지 않습니다. 삭제 후에도 Anthropic 계정과 크레딧은 그대로 유지되니 다른 도구로 부담 없이 이동할 수 있습니다.
