Miniconda(파이썬 가상환경), Zed(에디터), Claude Code(AI 코딩 도우미) 세 가지를 설치하여 파이썬 개발환경을 구축하는 방법을 다루고 있습니다. 윈도우 11에서 순서대로 설치하고, 간단히 동작을 확인한 뒤, 필요 없어졌을 때 세 가지를 모두 완전히 제거하는 방법까지 다루고 있습니다.

2026.4.24 최초작성

윈도우에서 Miniconda + Zed + Claude Code 설치부터 완전 삭제까지

1단계. Miniconda 설치

1-1. 설치 파일 다운로드

공식 다운로드 페이지로 이동합니다. ( 아나콘다 공식 홈페이지에서 다운로드를 클릭하면 로그인을 요구하지만 작은 글씨로 Skip Registration란게 있어 아래 링크로 이동합니다. )

주소: https://www.anaconda.com/download/success

페이지 하단의 Miniconda Installers 섹션에서 Windows 64-bit 설치 파일(Miniconda3-latest-Windows-x86_64.exe)을 다운로드합니다.

1-2. 설치 진행

다운로드한 .exe 파일을 더블클릭해 실행합니다. 설치 마법사에서 모두 디폴트 값으로 두고 진행하면 됩니다.

1-3. 설치 확인

시작 메뉴에서 Anaconda Prompt (miniconda3)를 검색해 실행합니다. 프롬프트 앞에 (base)가 표시되면 정상입니다.

(base) C:\Users\사용자명>

지금 상태로는 Anaconda Prompt 안에서만 conda 명령이 동작합니다. 명령 프롬프트(cmd)에서 conda –version을 치면 “내부 또는 외부 명령이 아닙니다” 오류가 납니다. 이후 Zed 내장 터미널에서도 conda 명령을 쓰려면 이 터미널은 일반 명령 프롬프트로 동작하기 때문에 다음 초기화 단계가 필요합니다.

다음을 실행합니다.

conda init cmd.exe

이 명령은 conda.exe 하나만 들어있는 condabin 폴더를 PATH에 추가해줍니다. 시스템 Python이나 다른 도구와 충돌할 일이 없습니다. (이게 설치 시 “Add to PATH” 체크와 다른 이유입니다. “Add to PATH”는 python, pip까지 전부 전역 노출시키지만, conda init은 conda 명령만 노출시킵니다.)

설정 후 명령 프롬프트를 닫았다가 다시 엽니다. 새 명령 프롬프트에서 conda –version이 동작하면 성공입니다. 이제 Zed 내장 터미널에서도 같은 방식으로 사용할 수 있습니다.

1-5. 테스트용 파이썬 가상환경 만들기

이후 Zed에서 사용할 Python 3.11 환경을 하나 만들어둡니다. 새로 연 명령 프롬프트(또는 Anaconda Prompt)에서 다음을 실행합니다.

conda create -n devenv python=3.11
conda activate devenv
python –version

Python 3.11.x가 출력되면 됩니다. conda deactivate로 파이썬 가상환경에서 빠져나올 수 있습니다.

2단계. Zed 에디터 설치

Zed는 Rust로 작성된 GPU 가속 고성능 에디터입니다. 2025년 말부터 윈도우 네이티브 빌드가 안정화되어 별도의 빌드 과정 없이 바로 설치할 수 있습니다.

2-1. 설치 파일 다운로드 및 설치

https://zed.dev/download 접속
Windows 항목에서 다운로드
받은 설치 파일을 실행하고 안내에 따라 진행

설치 후 시작 메뉴에 Zed가 추가됩니다.

2-2. 최초 실행

시작 메뉴에서 Zed를 실행합니다. 첫 실행 시 화면이 검게 보이거나 렌더링이 이상하다면 GPU 드라이버 문제일 수 있습니다. 이 경우 Intel/AMD/NVIDIA 공식 사이트에서 최신 그래픽 드라이버를 설치하면 해결됩니다.

Zed를 닫은 뒤 다시 실행되지 않을 때: 현재 Windows 버전 Zed에는 창을 닫아도 zed.exe 프로세스가 백그라운드에 남아있는 버그가 있습니다. 이 상태에서 다시 실행하면 아무 반응이 없습니다. Ctrl + Shift + Esc로 작업 관리자를 열어 세부 정보 탭에서 zed.exe 프로세스를 모두 선택해 작업 끝내기 한 뒤 다시 실행하면 정상적으로 뜹니다.

사전 테스트시 최초 zed 실행한 걸 종료후 다시 zed 실행시 아무것도 안보이는 현상이 있었는데 zed.exe 프로세스를 모두 종료하고 실행한 이후론 같은 문제가 또 발생하지 않았습니다.

2-3. 내장 터미널 셸을 명령 프롬프트로 고정

Zed 내장 터미널을 이 글의 흐름과 맞춰 명령 프롬프트(cmd)로 고정합니다. Settings Editor에서 간단히 바꿀 수 있습니다.

Ctrl + ,로 Settings Editor를 엽니다.
상단 검색창에 shell을 입력합니다.
Terminal › Shell 항목에서 Program을 선택하고 값으로 cmd.exe를 입력합니다.

변경 즉시 저장되며, 이후 새로 여는 Zed 내장 터미널은 명령 프롬프트로 뜹니다.

3단계. Claude Code 설치

Claude Code는 Anthropic의 터미널 기반 AI 코딩 도우미입니다. 과거에는 WSL이 필수였지만, 현재는 윈도우 네이티브 설치가 가능합니다.

3-1. 사전 준비

Claude Code 설치에 앞서 두 가지를 준비합니다.

1) Git for Windows 설치

Claude Code는 네이티브 윈도우 환경에서 내부적으로 Git Bash를 이용해 명령을 실행하기 때문에 Git for Windows가 반드시 설치되어 있어야 합니다. WSL을 사용하는 경우라면 필요 없습니다.

다운로드: https://git-scm.com/downloads/win
설치 시 기본값으로 진행하면 됩니다.

2) 크롬 설치 및 기본 브라우저 설정

Claude Code 최초 실행 시 로그인을 위해 브라우저가 자동으로 열립니다. 이때 기본 브라우저에서 Claude 계정이 이미 로그인되어 있는 상태여야 인증이 매끄럽게 진행됩니다. 본 글에서는 크롬을 기본 브라우저로 사용하는 것으로 가정합니다.

다운로드: https://www.google.com/chrome/
설치 후 설정 → 앱 → 기본 앱 → Google Chrome으로 이동해 상단의 기본값으로 설정 버튼을 누릅니다. (Windows 11은 크롬 설치만으로는 기본 브라우저가 바뀌지 않습니다.)
크롬을 실행해 https://claude.ai 에 접속한 뒤 Claude 계정으로 로그인해둡니다.

3-2. Claude Code 설치 및 로그인

명령 프롬프트를 일반 권한으로 엽니다(관리자 권한 필요 없음). 이 창에서 설치부터 로그인까지 한 번에 진행합니다.

1) 설치 스크립트 실행

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

설치 스크립트를 받아 실행한 뒤 자동으로 삭제합니다. 성공하면 다음과 같은 메시지가 출력됩니다.

✓ Claude Code successfully installed!
Version: 2.x.xx
Location: C:\Users\<사용자명>\.local\bin\claude.exe

2) PATH 등록 후 명령 프롬프트 재시작

설치된 claude.exe는 %USERPROFILE%\.local\bin에 놓이지만, 이 경로가 PATH에 자동 등록되지 않아 바로 실행되지 않을 수 있습니다. 다음 명령으로 사용자 PATH에 추가합니다. 이 방식은 간단하지만 나중에 제거하기가 곤란하니 원치 않으면 시스템의 환경 변수에 추가하는 방식을 진행하세요.

setx PATH “%PATH%;%USERPROFILE%\.local\bin”

setx는 변경이 새 프로세스에만 적용되므로, 반드시 현재 명령 프롬프트 창을 완전히 닫고 새 창을 엽니다. 새 창에서 설치가 잘 됐는지 확인합니다.

claude –version

버전이 표시되면 성공입니다.

3) 최초 실행 및 로그인

새로 연 명령 프롬프트에서 다음을 실행합니다.

claude

테마 설정 화면이 먼저 보이는데 zed의 UI는 흰색 계열이라 밝은 테마가 어울리는 것 같습니다.

별 무리 없이 진행할 수 있지만 헷갈린다면 본 글 상단에 추가한 유튜브 영상을 참고하세요.

인증 단계에서 디폴트 웹브라우저가 자동으로 열리면서 Anthropic 계정 인증을 요구합니다. Claude 구독자는 해당 계정으로 로그인하면 됩니다.

로그인이 끝나면 현재 디렉토리를 신뢰할 건지 물어보는데 No 선택하고 종료합니다.

4) 설치 상태 점검 (문제 발생 시)

설치나 설정에 문제가 있을 때는 다음 진단 명령이 유용합니다.

claude doctor

설치 방법, 버전, PATH 설정, Git Bash 경로 등을 한 번에 확인해줍니다.

4단계. Zed에서 Claude Code로 코드 생성하고 실행하기

설치가 끝났으니 실제로 세 도구를 함께 써봅니다. Zed 안에서 Claude Code를 실행해 파이썬 코드를 만들게 하고, 그 코드를 Zed의 태스크 기능으로 바로 실행합니다.

4-1. 프로젝트 폴더 준비 및 환경 연결

1) 프로젝트 폴더 생성

Zed를 실행하고 Ctrl + O로 Open Folder 대화상자를 연 뒤, 원하는 위치에 새 폴더 버튼으로 폴더를 만들고 선택합니다.

2) 빈 파이썬 파일 만들기

파이썬 가상환경을 변경할 수 있는 toolchain selector는 Python 파일이 열려있을 때 활성화되므로, 먼저 빈 .py 파일을 하나 만듭니다. 왼쪽 프로젝트 패널 위에서 우클릭 → New File을 누르고 main.py로 저장합니다.

3) toolchain 선택

명령 팔레트(Ctrl + Shift + P)를 열고 toolchain: select를 실행합니다. 앞서 만든 devenv 환경을 목록에서 선택합니다.

환경이 목록에 안 보인다면? Zed를 재시작하거나, 창 안의 Add toolchain 버튼으로 인터프리터 경로를 직접 지정합니다. 경로는 보통 C:\Users\<사용자명>\miniconda3\envs\devenv\python.exe입니다.

4) 내장 터미널 열고 환경 확인

Zed 내장 터미널(Ctrl + `)을 새로 엽니다. 프롬프트 앞에 (devenv)가 떠 있으면 자동 활성화가 된 것이고, 없다면 수동으로 활성화합니다.

conda activate devenv

(devenv) 프롬프트가 확인되면 준비 완료입니다.

4-2. pygame 설치

4-1 예제로 만들어볼 파이썬 코드를 실행하기 위해 필요한 pygame을 설치합니다.

pip install pygame

4-3. Claude Code로 코드 생성

같은 터미널에서 Claude Code를 실행합니다.

claude

프롬프트에 다음을 입력하면 클로드 코드가 코드를 작성해줍니다.

pygame을 사용해서 화면 중앙에서 회전하는 삼각형을 그려주는 파이썬 프로그램을 작성해줘.

4-4. Zed 태스크로 파이썬 코드 실행

Zed의 Python 지원은 별도 설정 없이도 현재 파일을 실행하는 태스크를 자동으로 제공합니다.

프로젝트 패널에서 방금 생성된 파일을 클릭해 엽니다.
Ctrl + Shift + P를 눌러 명령 팔레트를 열고 task: spawn을 입력한 뒤 해당 항목을 선택합니다.
목록에서 현재 파일명이 적힌 run 항목(예: run ‘rotating_triangle.py’)을 선택합니다.

창이 열리고 삼각형이 회전하면 성공입니다. 창은 X 버튼으로 닫습니다.

이후부터는 Ctrl + Shift + R만 누르면 방금 실행했던 태스크가 그대로 다시 실행됩니다. 코드를 수정하고 빠르게 결과를 확인할 때 유용합니다.

참고: Zed는 toolchain으로 선택한 devenv 환경의 Python 인터프리터를 태스크에서도 그대로 사용합니다. 즉 pip로 devenv에 설치한 pygame을 별도 설정 없이 바로 import할 수 있습니다.

5단계. 완전 삭제

세 도구 모두 깔끔히 제거하려면 역순(Claude Code → Zed → Miniconda)으로 진행하는 것이 편합니다. 설정 파일과 캐시까지 모두 지웁니다.

5-1. Claude Code 완전 삭제

1) 실행 파일과 데이터 폴더 제거

명령 프롬프트에서 다음을 실행합니다.

del “%USERPROFILE%\.local\bin\claude.exe”
rmdir /s /q “%USERPROFILE%\.local\share\claude”

2) 설정 및 세션 기록 제거

rmdir /s /q “%USERPROFILE%\.claude”
del “%USERPROFILE%\.claude.json”

주의: VS Code 확장, JetBrains 플러그인, Claude Desktop 앱도 ~/.claude/ 폴더를 공유합니다. 이들 중 하나라도 설치되어 있으면 해당 폴더가 다시 생성됩니다. 완전히 제거하려면 관련 확장/앱을 먼저 제거한 뒤 이 폴더를 삭제합니다.

3) PATH에서 .local\bin 제거

설치 때 setx PATH “%PATH%;…”로 추가했다면 지우는 방법이 복잡합니다. 해당 경로가 사용자 PATH에 남아있지만, 실행 파일이 이미 지워졌으므로 그대로 둬도 시스템에 아무 문제가 없습니다

시스템의 환경 변수 PATH에서 추가했다면 다음처럼 진행하면 됩니다.

시스템 속성 → 환경 변수 → 사용자 변수 → Path를 열어 C:\Users\<사용자명>\.local\bin 항목을 선택해 삭제합니다.

5-2. Zed 완전 삭제

1) 프로그램 제거

설정 → 앱 → 설치된 앱에서 Zed 검색 후 제거 클릭. 제거 직후에는 zed.exe 프로세스가 백그라운드에 남아있을 수 있으니, 다음 단계 전에 Ctrl + Shift + Esc로 작업 관리자를 열어 세부 정보 탭에서 zed.exe 프로세스가 있으면 작업 끝내기로 모두 종료합니다.

2) 설정·확장·캐시 폴더 제거

Zed는 사용자 설정(%APPDATA%\Zed)과 확장·캐시(%LOCALAPPDATA%\Zed)를 두 위치에 나눠 저장합니다. 명령 프롬프트에서 다음을 실행합니다.

rmdir /s /q “%APPDATA%\Zed”
rmdir /s /q “%LOCALAPPDATA%\Zed”

5-3. Miniconda 완전 삭제

1) Miniconda 제거

설정 → 앱 → 설치된 앱에서 Miniconda3 검색 후 제거를 누릅니다. 제어판의 “프로그램 추가/제거”에서 해도 동일합니다. 언인스톨러가 conda 초기화 스크립트도 자동으로 되돌려주므로 별도 명령을 실행할 필요는 없습니다.

2) 잔여 폴더 정리

제거 후에도 홈 폴더에 .conda, .condarc 같은 설정 파일이 남을 수 있습니다. 명령 프롬프트(cmd)를 열고 다음을 실행하면 됩니다.

rmdir /s /q “%USERPROFILE%\miniconda3”
rmdir /s /q “%USERPROFILE%\.conda”
del “%USERPROFILE%\.condarc”

없는 항목은 “찾을 수 없다”는 메시지가 뜨는데 무시해도 됩니다.

마치며

클로드로 사전조사한 후, 진행해보며 검토및 수정을 진행했습니다.

세 도구 모두 활발히 업데이트되는 중이라 시간이 지나면 설치 방법이나 UI가 달라질 수 있습니다. 문제가 생기면 각 공식 문서의 최신 가이드를 확인하는 것을 권장합니다.

Miniconda: https://www.anaconda.com/docs/getting-started/miniconda/install
Zed: https://zed.dev/docs/windows
Claude Code: https://code.claude.com/docs/en/setup