우분투에서 Zed와 Miniconda , Claude Code를 설치하고 Python 코드를 작성·실행하는 방법을 설명합니다.
Visual Studio Code의 대안으로 Zed를 사용해보기로 했습니다.
.
2026.4.10 최초작성
ps. 영상으로 찍어보려고 시도하는 와중에 재설치해보는 와중에 zed에서 한글 입력이 제대로 안되는 것을 발견했습니다.
클로드에게 물어보니 고질적인 문제라는 군요.
클로드 코드 사용을 위해 다른 텍스트 편집기에서 한글 입력후 복사해와 붙여넣기해서 사용해봐야 겠어요.
.
우분투 Python 개발 환경: Zed + Miniconda + Claude Code 설치 가이드
Zed는 Rust로 작성된 고성능 오픈소스 코드 에디터로, GPU 가속을 활용하여 매우 빠른 편집 환경을 제공합니다. 전용 GPU 없이 내장 GPU만으로도 동작하므로 대부분의 PC와 노트북에서 사용할 수 있습니다. 이 글에서는 우분투에서 Zed 에디터를 설치하고 Miniconda 가상환경과 연동하여 Python 개발 환경을 구축하는 방법을 단계별로 알아봅니다.
.
.
우선 다음 영상을 보고 한글입력기를 fcitx5로 변경해야합니다. 그래야 zed에서 한글입력이 가능해집니다.
.
.
1. Zed 설치
우분투에서 Zed를 설치하려면 curl 설치가 필요합니다.
sudo apt install curl
.
이제 Zed를 설치합니다.
curl https://zed.dev/install.sh | sh
.
설치 완료 후 다음처럼 zed를 실행할 수 있습니다.
zed
.
.
2. Miniconda 설치
Miniconda는 Anaconda의 경량 버전으로, conda 패키지 매니저와 최소한의 패키지만 포함합니다.
.
우선 wget 설치가 필요합니다.
sudo apt install wget
.
이제 Miniconda 설치를 진행합니다.
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh
.
설치를 진행하면 몇 가지 질문이 나옵니다. 라이선스 동의에서는 Enter로 내용을 스크롤한 뒤 yes를 입력합니다. 설치 경로는 Enter로 기본값을 수락하고, 마지막에 셸 초기화(conda init) 여부를 묻는 질문에도 yes를 입력합니다.
.
설치가 끝나면 터미널을 새로 열어줍니다. 프롬프트 앞에 (base)가 표시되면 정상입니다.
.
이제 프로젝트용 가상환경을 생성합니다. 여기서는 myproject라는 이름으로 Python 3.11 환경을 만들겠습니다.
conda create -n myproject python=3.11
.
.
3. Zed에서 Miniconda 환경 사용하기
Miniconda 설치 시 PATH에 conda 경로가 자동으로 등록되기 때문에, 별도의 설정 없이 Zed가 conda 환경을 바로 인식합니다.
.
3.1 프로젝트 폴더 생성 및 열기
터미널에서 프로젝트 폴더를 만들고 Zed에서 해당 폴더를 엽니다.
mkdir my-project
zed my-project
.
3.2 Python 파일 생성
Zed 왼쪽의 프로젝트 패널에서 프로젝트 폴더를 우클릭하고 “New File”을 선택후 test_numpy.py를 입력후 파일에 다음 코드를 입력후 Ctrl+ S를 눌러 저장합니다.
| import numpy as np a = 3 b = 5 result = np.add(a, b) print(f”{a} + {b} = {result}”) |
.
파일이 생성되면 Zed가 Python 파일을 인식하고, 하단 상태바 오른쪽에 현재 사용 중인 Python 버전이 표시됩니다.
.
3.3 Toolchain Selector로 환경 선택하기
하단 상태바에 표시된 Python 버전을 클릭하면 Toolchain Selector가 열립니다. 명령 팔레트(Ctrl+Shift+P → toolchain: select)로도 접근할 수 있습니다.
Zed가 감지한 conda 환경 목록이 나타나며, 앞서 만든 myproject를 선택합니다. 목록에 없는 환경은 “Add toolchain” 버튼으로 경로를 직접 추가할 수도 있습니다.
.
3.4 numpy 설치
메뉴에서 View → Terminal Panel을 선택하여 터미널을 엽니다. Toolchain Selector에서 환경을 선택했으므로 터미널에 myproject 환경이 자동으로 활성화되어 있습니다. 이제 numpy를 설치합니다.
pip install numpy
.
설치가 완료되면 Zed 에디터에서 numpy에 대한 자동완성과 타입 체크가 바로 동작합니다. 만약 반영되지 않으면 Ctrl+Shift+P → editor: restart language server를 실행합니다.
.
3.5 실행
실행하려면
Ctrl+Shift+P를 누르고 task: spawn 입력 후 Enter를 누릅니다.
.
목록에서 현재 파일이름이 적힌 run항목을 선택하여 실행하면 됩니다.
이후부터는 Ctrl+Shift+R을 사용하면 지금 실행했던 파이썬 코드 파일을 재실행합니다.
.
4. Claude Code 설치
4.1 설치
우분투에서 네이티브 설치 스크립트로 한 줄에 설치할 수 있습니다.
curl -fsSL https://claude.ai/install.sh | bash
.
4.2 인증
프로젝트 디렉토리에서 claude를 실행하면 브라우저가 열리며 로그인 화면이 나타납니다.
claude
.
Claude Pro, Max, Teams, Enterprise 또는 Console(API) 계정이 필요합니다. 무료 Claude.ai 계정으로는 사용할 수 없습니다.
.
5. 완전 제거
5.1 Zed 제거
zed –uninstall
실행하면 설정 파일을 유지할지 삭제할지 묻습니다. 완전 제거를 원하면 삭제를 선택합니다.
.
5.2 Miniconda 제거
Miniconda 디렉토리를 삭제합니다.
rm -rf ~/miniconda3
.
.bashrc에서 conda 관련 설정을 제거합니다. 텍스트 에디터로 ~/.bashrc를 열어 # >>> conda initialize >>>부터 # <<< conda initialize <<<까지의 블록을 삭제합니다.
nano ~/.bashrc
.
저장 후 변경사항을 적용합니다.
source ~/.bashrc
.
5.3 Claude Code 제거
rm -rf ~/.local/bin/claude ~/.local/share/claude
rm -rf ~/.claude
rm -f ~/.claude.json
.
클로드로 자료조사후 진행해보며 수정, 검토및 확인을 했습니다.