Claude Code 제거 가이드

구성 파일, 환경 변수 및 캐시 데이터 정리를 포함한 완전한 Claude Code 제거 프로세스입니다.

제거 전 확인

제거를 시작하기 전에 중요한 구성 파일과 프로젝트 데이터를 백업하는 것이 좋습니다.

설치 방법 확인

첫 번째 단계: 전역 설치 확인

bash
npm ls -g @anthropic-ai/claude-code

두 번째 단계: 로컬 설치 확인

bash
npm ls @anthropic-ai/claude-code

세 번째 단계: 설치 경로 확인

bash
# 전역 패키지 설치 경로 확인
npm root -g

# Claude Code 실행 파일 위치 확인
which claude
# 또는 Windows에서 사용
where claude

Claude Code 제거

방법 1: npm 제거 (권장)

# 전역으로 설치된 Claude Code 제거
npm uninstall -g @anthropic-ai/claude-code

# 제거 확인
claude --version
# "command not found" 또는 유사한 오류가 표시되어야 함

방법 2: 수동 삭제 (npm 제거 실패 시)

# 전역 설치 디렉토리 삭제
rm -rf ~/.npm/lib/node_modules/@anthropic-ai/claude-code
rm -rf /usr/local/lib/node_modules/@anthropic-ai/claude-code

# 실행 파일 링크 삭제
rm -f /usr/local/bin/claude

# 사용자 데이터 디렉토리 삭제
rm -rf ~/.claude-code
rm -rf ~/.config/claude-code

구성 파일 및 캐시 정리

환경 변수 정리

macOS/Linux 시스템

bash
# 구성 파일 편집, 관련 환경 변수 삭제
nano ~/.bashrc
nano ~/.bash_profile
nano ~/.zshrc

# 다음 줄 삭제:
# export ANTHROPIC_AUTH_TOKEN=...
# export ANTHROPIC_BASE_URL=...

# 구성 다시 로드
source ~/.bashrc
source ~/.bash_profile
source ~/.zshrc

Windows 시스템

방법 1: 그래픽 인터페이스

  1. "내 PC" 마우스 오른쪽 클릭 → "속성"
  2. "고급 시스템 설정" 클릭
  3. "시스템 속성" 창에서 "환경 변수" 클릭
  4. 사용자 변수 및 시스템 변수에서 찾아서 삭제:
    • ANTHROPIC_AUTH_TOKEN
    • ANTHROPIC_BASE_URL
  5. "확인"을 클릭하여 저장

방법 2: PowerShell

PowerShell (관리자)
# 사용자 환경 변수 삭제
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "User")

# 시스템 환경 변수 삭제 (관리자 권한 필요)
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "Machine")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "Machine")

프로젝트 구성 파일 정리

프로젝트에서 Claude Code 관련 구성 확인 및 삭제:

bash
# 프로젝트에서 구성 파일 찾기
find . -name ".claude*" -type f
find . -name "claude.config.*" -type f

# 찾은 구성 파일 삭제
rm -f .claude-settings.json
rm -f claude.config.js
rm -f claude.config.json

캐시 데이터 정리

# npm 캐시에서 Claude Code 관련 데이터 정리
npm cache clean --force

# 사용자 캐시 디렉토리 정리
rm -rf ~/.cache/claude-code
rm -rf /tmp/claude-*

# 로그 파일 정리
rm -rf ~/.local/share/claude-code/logs

제거 확인

제거 완료 후 다음 명령을 실행하여 완전히 정리되었는지 확인:

bash
# 명령이 존재하지 않는지 확인
claude --version
# "command not found"가 표시되어야 함

# 환경 변수가 정리되었는지 확인
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL
# 비어 있어야 함

# 남은 파일 확인
ls -la ~/.claude* 2>/dev/null || echo "No Claude files found"
ls -la ~/.config/claude* 2>/dev/null || echo "No Claude config found"

관련 종속성 제거 (선택 사항)

더 이상 Node.js 또는 기타 관련 도구가 필요하지 않은 경우 함께 제거할 수 있습니다:

Node.js 제거

# Homebrew를 통해 설치한 경우
brew uninstall node

# 수동 삭제 (공식 설치 패키지를 통해 설치한 경우)
sudo rm -rf /usr/local/{bin/{node,npm},lib/node_modules/npm,lib/node,share/man/*/node.*}

자주 묻는 질문

질문 1: 명령이 여전히 존재함

가능한 원인:

  • PATH 환경 변수 캐시
  • 여러 설치 위치

해결 방법:

bash
# 환경 변수 다시 로드
source ~/.bashrc

# 또는 터미널 재시작
exit
# 터미널 다시 열기

# 가능한 모든 설치 위치 확인
which -a claude
whereis claude

질문 2: 파일 삭제 권한 부족

해결 방법:

bash
# macOS/Linux sudo 사용
sudo rm -rf /usr/local/lib/node_modules/@anthropic-ai/claude-code

# Windows 관리자 권한으로 PowerShell 실행
# PowerShell 마우스 오른쪽 클릭 → "관리자 권한으로 실행"

질문 3: 환경 변수가 정리되지 않음

해결 방법:

bash
# 가능한 모든 구성 파일 확인
grep -r "ANTHROPIC" ~/.*rc ~/.*profile 2>/dev/null
grep -r "claude" ~/.*rc ~/.*profile 2>/dev/null

# 찾은 구성 파일 수동 편집
nano ~/.bashrc  # 관련 줄 삭제

재설치 준비

나중에 Claude Code를 다시 설치해야 하는 경우:

  1. Node.js 버전 ≥ 18.0인지 확인
  2. npm 캐시 정리: npm cache clean --force
  3. 설치 문서에 따라 재설치

위 단계를 완료하면 Claude Code가 시스템에서 완전히 제거된 것입니다.

AI와 함께 무한한 혁신, 끝없는 기회
소개
기능 특성
사용 문서
가격 플랜
연락하기
약관 및 정책
이용 약관
개인정보 약관
특정 상거래법