Claude Code 용량 문제 해결: .claude 폴더와 WSL2를 D드라이브로 옮기는 법


Claude Code D드라이브 이전 완전 가이드 — C드라이브 용량 부족 해결 2026

Claude Code를 제대로 쓰다 보면 어느 순간 C드라이브 경고가 뜬다. WSL2(Windows Subsystem for Linux 2)의 Ubuntu 가상 디스크, Claude Code 프로젝트 데이터, Claude 데스크탑 앱 캐시가 기본적으로 C드라이브에 쌓이기 때문이다. SSD 용량이 256GB인 노트북이라면 몇 달 사용 후 금방 한계에 달한다. 해결책은 명확하다 — 처음부터 D드라이브에 자리를 잡거나, 지금 당장 이전해버리는 것이다.

이 글은 실제 작업을 직접 진행하며 정리한 3가지 이전 방법을 단계별로 설명한다. 각 방법은 독립적으로 적용할 수 있으며, 상황에 맞게 골라 쓰면 된다.

왜 D드라이브로 옮겨야 하는가

Claude Code와 관련한 데이터가 C드라이브에 얼마나 쌓이는지 먼저 파악해야 한다.

WSL2 Ubuntu 가상 디스크
위치%LOCALAPPDATA%\Packages\...\ext4.vhdx
크기5~30GB+

Claude Code 데이터 (.claude)
위치C:\Users\사용자명\.claude
크기수백MB~수GB

Claude 데스크탑 앱 데이터
위치%APPDATA%\Claude
크기수십~수백MB

Node.js / npm 패키지 (WSL 내부)
위치WSL Ubuntu 가상 디스크 내부
크기수백MB+

⚠️

WSL2의 ext4.vhdx 가상 디스크는 한 번 커지면 자동으로 줄지 않는다. Claude Code 세션을 여러 번 사용할수록 WSL 가상 디스크가 점점 커지기 때문에, 처음부터 D드라이브에 위치시키는 것이 가장 효율적이다.

방법 1 — WSL2 Ubuntu째로 D드라이브에 설치

가장 근본적인 해결책이다. WSL2 Ubuntu 자체를 D드라이브에 이전하면 그 안에 설치되는 Claude Code(WSL)도 자동으로 D드라이브를 사용한다. 기존에 Ubuntu가 설치되어 있다면 내보내기(export) 후 재등록(import)하는 방식으로 이전한다.

ℹ️

아래 작업은 PowerShell(관리자) 또는 Windows Terminal(관리자)에서 실행한다. WSL2가 아직 설치되지 않았다면 먼저 wsl --install --no-distribution으로 WSL2 커널만 설치한다.
1
Ubuntu 설치 (아직 없다면)
Microsoft Store 또는 명령어로 Ubuntu를 설치한다. 이 시점에는 C드라이브에 임시로 설치된다.

PowerShell (관리자)
# WSL2 커널 설치 (이미 있으면 건너뜀)
wsl –install –no-distribution

# Ubuntu 설치
wsl –install -d Ubuntu

2
D드라이브에 저장 폴더 생성
이전할 대상 폴더를 미리 만들어둔다.

PowerShell (관리자)
mkdir D:\WSL\Ubuntu
3
Ubuntu를 tar 파일로 내보내기 (Export)
현재 C드라이브의 Ubuntu를 백업 파일로 추출한다. 용량에 따라 수 분 소요된다.

PowerShell (관리자)
wsl –export Ubuntu D:\WSL\ubuntu-backup.tar
4
기존 Ubuntu 등록 해제 (Unregister)
C드라이브의 Ubuntu 등록을 해제한다. 이 단계에서 C드라이브의 ext4.vhdx가 삭제된다.

🚨

주의: --unregister는 해당 WSL 배포판의 모든 데이터를 삭제한다. 반드시 export가 완료된 것을 확인한 후 실행한다.
PowerShell (관리자)
wsl –unregister Ubuntu
5
D드라이브에 Ubuntu 재등록 (Import)
내보낸 tar 파일을 D드라이브의 새 위치로 가져온다. 완료 후 D:\WSL\Ubuntu\ext4.vhdx 파일이 생성된다.

PowerShell (관리자)
wsl –import Ubuntu D:\WSL\Ubuntu D:\WSL\ubuntu-backup.tar
6
Claude Code(WSL) 설치 및 PATH 설정
WSL Ubuntu 내부에서 Claude Code를 설치하고, 명령어 경로를 등록한다.

WSL Ubuntu 내부 (bash)
# Claude Code 설치
curl -fsSL https://claude.ai/install.sh | bash

# PATH 영구 등록
echo ‘export PATH=”$HOME/.local/bin:$PATH”‘ >> ~/.bashrc
source ~/.bashrc

# 설치 확인
claude –version

이 방법으로 WSL Ubuntu 가상 디스크 전체가 D드라이브에 위치하게 된다. Claude Code(WSL)가 사용하는 모든 데이터(프로젝트 캐시, npm 패키지 등)가 D드라이브를 사용한다.

방법 2 — Windows 네이티브 Claude Code 설치 후 데이터 D드라이브 이전

WSL 없이 Windows에서 직접 Claude Code를 사용하는 경우에 해당한다. 설치 자체는 C드라이브에 두되, 데이터 폴더(.claude)만 D드라이브로 옮기고 심볼릭 링크로 연결하는 방식이다.

1
winget으로 Claude Code 설치
Windows 패키지 관리자(winget)를 사용해 Claude Code를 설치한다.

PowerShell (관리자)
winget install Anthropic.ClaudeCode
2
D드라이브에 데이터 폴더 생성 및 .claude 폴더 이동
기존 .claude 폴더를 D드라이브로 옮긴다. Claude Code가 실행 중이라면 먼저 종료한다.

PowerShell (관리자)
# D드라이브에 저장 경로 생성
mkdir D:\ClaudeData

# 기존 .claude 폴더를 D드라이브로 이동
Move-Item $env:USERPROFILE\.claude D:\ClaudeData\.claude

3
심볼릭 링크 생성
원래 위치에 심볼릭 링크를 만들어 Claude Code가 기존 경로로 접근해도 D드라이브 데이터를 사용하도록 한다.

PowerShell (관리자)
New-Item -ItemType Junction -Path $env:USERPROFILE\.claude -Target D:\ClaudeData\.claude
ℹ️

심볼릭 링크(Junction)란 원래 경로에서 다른 경로로 투명하게 연결해주는 폴더 단축키다. Claude Code는 여전히 C:\Users\사용자명\.claude를 읽지만 실제 데이터는 D:\ClaudeData\.claude에 저장된다.

방법 3 — Claude 데스크탑 앱 데이터 D드라이브로 이전

Claude 데스크탑 앱(Cowork 포함)은 %APPDATA%\Claude에 설정 파일, 대화 캐시, 플러그인 데이터 등을 저장한다. 이 폴더 역시 같은 방식으로 D드라이브로 이전할 수 있다.

1
Claude 앱 완전 종료
시스템 트레이에서 Claude를 우클릭 후 종료한다. 백그라운드 프로세스까지 완전히 닫혀야 한다.

2
앱 데이터 폴더 D드라이브로 이동
%APPDATA%\Claude 폴더 전체를 D드라이브의 새 위치로 이동한다.

PowerShell (관리자)
# 대상 폴더 생성 (없으면)
mkdir D:\ClaudeData\Desktop

# 앱 데이터 이동
Move-Item $env:APPDATA\Claude D:\ClaudeData\Desktop

3
심볼릭 링크 생성
앱이 기존 경로를 참조하므로 같은 위치에 심볼릭 링크를 생성한다.

PowerShell (관리자)
New-Item -ItemType Junction -Path $env:APPDATA\Claude -Target D:\ClaudeData\Desktop
4
Claude 앱 재실행 후 정상 작동 확인
Claude 데스크탑 앱을 다시 실행해 기존 설정과 플러그인이 그대로 유지되는지 확인한다.

어디에 무엇이 있는가

3가지 방법을 모두 적용했을 때의 최종 파일 배치다.

WSL Ubuntu 가상 디스크
D:\WSL\Ubuntu\
ext4.vhdx 파일이 이 위치에 생성됨

Claude Code (WSL)
D:\WSL\Ubuntu 내부
~/.local/bin/claude

Claude Code 데이터 (.claude)
D:\ClaudeData\.claude
C드라이브 경로는 Junction으로 연결

Claude 데스크탑 앱 데이터
D:\ClaudeData\Desktop
%APPDATA%\Claude는 Junction으로 연결

이 구성 이후 Claude Code와 데스크탑 앱은 정확히 동일하게 작동하며, C드라이브에는 실제 데이터 대신 심볼릭 링크만 남는다. C드라이브 여유 공간이 즉시 회복된다.

어떤 방법을 선택할까 — 상황별 가이드

🤔 지금 나의 상황은?
WSL로 Claude Code 사용 중
방법 1 권장
WSL Ubuntu 자체를 D드라이브로 이전 → 가장 근본적 해결

Windows 네이티브로 Claude Code 사용
방법 2 권장
.claude 폴더만 이전 + Junction 연결

Claude 데스크탑 앱만 사용
방법 3만 적용
%APPDATA%\Claude 이전으로 충분

✅ 심볼릭 링크(Junction)의 장점
  • 앱이 경로 변경을 인식하지 못해 설정 호환성 완벽 유지
  • Windows 탐색기에서 기존 경로로도 접근 가능
  • 되돌리기 쉬움 (링크 삭제 후 폴더 복원)
  • 앱 업데이트 후에도 별도 재설정 불필요
⚠️ 주의할 점
  • 반드시 PowerShell을 관리자 권한으로 실행해야 함
  • 이동 전 Claude Code / 앱을 완전히 종료해야 함
  • D드라이브가 분리되면 앱이 실행되지 않을 수 있음
  • WSL export는 시간이 걸림 (용량 따라 5~20분)

한 줄 정리

Claude Code를 WSL로 쓴다면 Ubuntu째로 D드라이브에 이전하는 것이 가장 깔끔하다. Windows 네이티브 사용자라면 .claude 폴더 이전 + Junction 링크로 C드라이브를 비울 수 있다. 어느 방법이든 심볼릭 링크를 사용하는 한, Claude Code와 데스크탑 앱은 경로 변경을 전혀 인식하지 못하고 그대로 동작한다.

💡

이전 후 백업 파일 정리: WSL 방법 1을 사용했다면 이전 후 D:\WSL\ubuntu-backup.tar 파일은 이전이 정상 확인된 뒤에 삭제해도 된다. 혹시 모를 롤백을 위해 며칠간 보관해두는 것을 권장한다.

댓글 남기기