Claude Code 재설치: 완전 삭제부터 순서대로

Claude Code 재설치는 그냥 다시 설치하는 것만으로 끝나지 않습니다. 남아 있는 설정 폴더와 오래된 실행 파일이 문제를 계속 만들기 때문입니다. 삭제 전 백업할 것, 지워야 할 위치, 설치 후 확인 순서를 맥과 윈도우로 나눠 정리했습니다.

Claude Code 재설치는 "지우고 다시 깔기"만으로 끝나지 않는 경우가 많습니다. 이 글에서는 설정과 로그인 정보를 어디까지 남기고 어디까지 지워야 하는지, 맥과 윈도우에서 각각 어떤 폴더를 확인해야 하는지를 순서대로 다룹니다.

특히 조심할 부분은 삭제 순서입니다. 설정 폴더를 먼저 날려버리고 나면 로그인을 다시 해야 하고, 그동안 쌓아둔 프로젝트별 지시사항까지 사라집니다.

반대로 프로그램만 지우고 설정을 그대로 두면, 재설치해도 똑같은 증상이 반복될 수 있습니다. 그래서 "무엇을 지우는가"보다 "어떤 순서로 지우는가"가 더 중요합니다.

목차

1. 먼저 알아야 할 두 덩어리
2. 지우기 전에 백업할 것
3. 맥과 리눅스에서 삭제하는 순서
4. 윈도우에서 확인할 위치
5. 다시 설치하고 확인하기

먼저 알아야 할 두 덩어리

Claude Code는 크게 실행 파일과 설정 폴더라는 두 덩어리로 나뉩니다. 재설치가 실패하는 이유는 일부 환경에서는 이 둘 중 하나만 정리했기 때문입니다.

Claude Code는 Anthropic이 제공하는 터미널용 코딩 도구입니다. 터미널은 검은 화면에 명령어를 직접 입력하는 프로그램이고, 여기서 claude라고 치면 실행됩니다.

덩어리	하는 일	지우면 어떻게 되나
실행 파일	claude 명령어 자체	명령어가 사라짐. 재설치로 복구
설정 폴더	로그인 정보, 프로젝트별 지시사항, 권한 설정	로그인·설정을 처음부터 다시 해야 함

집으로 비유하면 실행 파일은 가전제품이고, 설정 폴더는 그 집에 쌓인 살림입니다. 가전만 바꾸면 되는 상황인데 살림까지 다 버리면 손해입니다.

증상 확인
   ↓
설정 백업 (복사만)
   ↓
실행 파일 삭제
   ↓
잔여 파일 확인
   ↓
재설치 → 버전 확인
   ↓
그래도 안 되면 설정 폴더 정리

이 순서를 지키면 되돌릴 수 있는 선택부터 시도하게 됩니다.

지우기 전에 백업할 것

삭제 전에 설정 폴더를 다른 이름으로 복사해 두는 것이 가장 안전한 준비입니다. 지우는 게 아니라 복사입니다.

사용자 홈 폴더 안의 .claude 폴더가 그 대상입니다. 점(.)으로 시작하는 폴더는 숨김 처리라서 파일 탐색기나 Finder에서 기본적으로 보이지 않습니다.

• 맥: Finder에서 Cmd + Shift + . 를 누르면 숨김 파일이 보입니다
• 윈도우: 탐색기 상단 "보기" 메뉴에서 "숨긴 항목" 체크

여기에 프로젝트별 지시사항 파일(보통 CLAUDE.md)이나 권한 허용 목록이 들어 있습니다. 예를 들어 블로그 원고를 정리하는 폴더에서 "말투는 이렇게, 파일은 이 폴더에만" 같은 규칙을 적어뒀다면 그게 여기 저장됩니다.

💡 백업은 폴더 전체를 .claude_backup 같은 이름으로 복사해 두는 것으로 충분합니다. 나중에 필요한 파일만 골라 되돌리면 됩니다.

맥과 리눅스에서 삭제하는 순서

터미널을 열고 아래 명령을 순서대로 입력합니다. 맥은 Spotlight(Cmd + Space)에서 "터미널"을 검색하면 나옵니다.

claude --version
which claude

첫 줄은 현재 설치된 버전을 보여주고, 둘째 줄은 그 claude 명령어가 실제로 어느 위치의 파일인지 알려줍니다. 이 위치를 메모해 두세요. 나중에 잔여 파일을 찾을 때 씁니다.

npm으로 설치했다면 아래처럼 제거합니다. npm은 Node.js(자바스크립트를 실행시켜주는 엔진)에 딸려 오는 프로그램 설치 관리자입니다.

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

-g는 "컴퓨터 전체에 설치된 것"을 뜻합니다. 이 명령은 전역 설치된 Claude Code 패키지를 제거합니다.

제거 후 다시 확인합니다.

which claude

아무것도 안 나오면 정상입니다. 그런데도 경로가 계속 나오면 다른 방식으로 설치된 사본이 남아 있다는 뜻입니다. 대표적으로 홈 폴더 안의 .local/bin 또는 .claude 안에 실행 파일이 따로 있는 경우가 있습니다.

ls -al ~/.local/bin | grep claude

이 명령은 해당 폴더에서 claude라는 이름이 들어간 항목만 걸러서 보여줍니다. 찾았다면 그 파일을 삭제하고 which claude를 다시 확인합니다.

터미널을 다시 열어야 합니다

삭제나 설치 후에는 터미널 창을 완전히 닫고 새로 열어야 합니다. 터미널은 실행될 때 명령어 위치 목록을 기억해 두기 때문에, 파일을 지워도 이전 기억이 남아 엉뚱한 결과가 나옵니다.

윈도우에서 확인할 위치

윈도우는 설치 방식이 두 갈래라서 어느 쪽으로 깔았는지부터 확인해야 합니다. PowerShell(윈도우의 명령 입력 프로그램)을 열고 아래를 입력합니다.

where.exe claude

where.exe는 명령어의 실제 파일 위치를 찾아 줍니다. 결과 경로가 어디를 가리키는지가 판단 기준입니다.

결과 경로에 들어 있는 단서	설치 방식	제거 위치
AppData\Roaming\npm	윈도우에 직접 npm 설치	PowerShell에서 npm 제거
\\wsl$ 또는 /home/사용자	WSL(윈도우 안의 리눅스) 안에 설치	WSL 터미널에서 제거
여러 줄이 동시에 나옴	중복 설치	양쪽 다 정리 필요

WSL은 윈도우 안에서 리눅스를 돌리는 기능입니다. 개발 도구를 깔다 보면 본인도 모르게 WSL 쪽에 설치되는 일이 있어서, 윈도우에서 지웠는데 명령어가 계속 살아 있는 상황이 생깁니다.

제거 명령 자체는 맥과 같습니다.

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

여러 줄이 동시에 나왔다면 각 환경에서 따로 제거해야 합니다. 이 중복이 재설치 후에도 옛 버전이 실행되는 흔한 원인입니다.

다시 설치하고 확인하기

재설치는 제거와 대칭입니다. 아래 명령으로 최신 버전을 다시 받습니다.

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

설치가 끝나면 터미널을 새로 열고 버전을 확인합니다.

claude --version

npm 공식 페이지 기준으로 Claude Code CLI의 최신 버전은 2.1.224입니다(이 글 작성 시점). 여기서 나오는 숫자가 눈에 띄게 낮다면 옛 사본이 여전히 먼저 잡히고 있다는 신호입니다.

확인 체크리스트:

• ☐claude --version이 정상 출력되는가
• ☐나오는 버전이 npm 최신 버전과 비슷한 수준인가
• ☐which claude(윈도우는 where.exe claude) 결과가 한 줄인가
• ☐실제 프로젝트 폴더에서 claude를 실행해 응답하는가
• ☐백업해 둔 CLAUDE.md를 프로젝트로 되돌렸는가

마지막 항목은 잊기 쉽습니다. 재설치 자체는 잘 됐는데 "예전처럼 안 알아듣는다"고 느끼는 경우, 프로젝트 지시사항 파일이 사라진 것일 수 있습니다.

자주 막히는 부분

가장 잦은 막힘은 권한 오류와 잔여 경로 두 가지입니다. 증상별로 다르게 접근해야 합니다.

권한 오류(permission denied)가 뜰 때. npm이 시스템 폴더에 쓰려다 막힌 상황입니다. 이때 sudo(관리자 권한으로 실행)를 붙여 억지로 넘기는 방법이 일부 환경에서는 검색되지만, 관리자 권한으로 설치된 파일이 남아 다음 재설치에서 또 막히는 원인이 됩니다. npm이 사용자 폴더에 설치하도록 설정을 바꾸는 쪽이 뒤탈이 적습니다.

제거했는데 명령어가 살아 있을 때. 일부 환경에서는 중복 설치입니다. 위의 which / where.exe로 경로를 전부 확인하고, 나온 위치를 하나씩 정리합니다.

설치는 됐는데 로그인이 안 될 때. 이때 설정 폴더 정리가 마지막 카드입니다. 백업을 떠둔 상태에서 .claude 폴더를 다른 이름으로 옮기고 실행하면, Claude Code가 새 설정을 만들면서 로그인을 다시 요청합니다.

증상	먼저 볼 곳	하지 말 것
command not found	터미널 재시작, 설치 경로	무작정 재설치 반복
버전이 안 올라감	중복 설치 경로	최신 버전만 다시 install
permission denied	npm 설치 위치 설정	sudo로 밀어넣기
로그인 실패	.claude 폴더 초기화	백업 없이 삭제

막히면 여기부터 확인

재설치의 핵심은 결국 which claude 한 줄입니다. 이 결과가 한 줄로 깔끔하게 나오는 상태를 만드는 것이 목표이고, 나머지는 그걸 위한 과정입니다.

그리고 설정 폴더는 마지막에 손대는 것이 좋습니다. 실행 파일은 언제든 다시 받을 수 있지만, 프로젝트별로 쌓아둔 지시사항은 되돌리기 번거롭습니다.

버전 번호나 설치 요구사항은 계속 바뀝니다. 명령어가 통하지 않으면 npm의 @anthropic-ai/claude-code 페이지와 Anthropic 공식 문서에서 현재 권장 설치 방식을 먼저 확인하는 편이 빠릅니다.

함께 보면 좋은 글

• Claude Code 대안 5가지 비교: Cursor, Aider, Cline, Copilot 정리
• Claude Code 무료 vs Pro vs Max, 어디까지 공짜로 되나
• Claude Code 업데이트하는 법 — 최신 버전 확인과 수동 업데이트