맥북에 Zed, Miniconda, Claude Code를 설치하는 방법을 다룹니다.
Visual Studio Code 대안을 찾다가 zed가 맥북에서 한글입력이 문제 없는걸 발견했네요.
.
2026. 4. 15 최초작성
.
.
맥북에서 Zed + Miniconda + Claude Code 설치 가이드
사전 준비
- macOS 10.15 (Catalina) 이상
- Homebrew 설치 (아래에서 안내)
- Claude 유료 계정 (Pro, Max, Team, 또는 Enterprise) — 무료 플랜은 Claude Code 사용 불가
- 디폴트 브라우저에 Claude 로그인
.
Homebrew가 설치되어 있지 않다면 터미널을 열고 아래 명령을 실행합니다.
/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)”
.
Apple Silicon(M1/M2/M3/M4) 맥인 경우 설치 완료 후 Next steps: 다음에 안내되는 명령들을 실행하여 PATH에 Homebrew를 추가합니다.
==> Next steps:
– Run these commands in your terminal to add Homebrew to your PATH:
echo >> /Users/webnautes/.zprofile
echo ‘eval “$(/opt/homebrew/bin/brew shellenv zsh)”‘ >> /Users/webnautes/.zprofile
eval “$(/opt/homebrew/bin/brew shellenv zsh)”
.
.
1단계: Zed 에디터 설치
1-1. Homebrew로 설치
brew install –cask zed
.
1-2. Zed 실행 확인
command + Space를 누른 후, “zed”를 검색하여 실행합니다. Zed 에디터 창이 열리면 설치 성공입니다.
.
.
2단계: Miniconda 설치
2-1. Homebrew로 설치
brew install –cask miniconda
.
다음 명령을 실행후 터미널을 새로 열어줘야 합니다.
conda init zsh
.
2-2. 테스트용 가상환경 생성
conda create -n test_env python=3.12
.
.
3단계: Claude Code 설치
3-1. 네이티브 인스톨러로 설치
curl -fsSL https://claude.ai/install.sh | sh
.
3-2. 로그인
claude
.
처음 실행하면 브라우저가 열리며 로그인 안내가 나옵니다. Claude 유료 계정으로 로그인합니다. 이용약관에 동의하면 Claude Code CLI가 실행됩니다. 마지막에 클로드에서 현재 폴더를 작업폴더로 신뢰할지 물어볼때 종료하면 됩니다.
.
.
4단계: Zed에서 Claude Code 사용하기
Zed에는 ACP(Agent Client Protocol)를 통해 Claude Code를 에이전트 패널에서 사용하는 방법도 있지만, 이 가이드에서는 Zed 내장 터미널에서 Claude Code CLI를 직접 사용하는 방식을 안내합니다.
에이전트 패널(Claude Agent)은 아직 베타 단계로 /compact, Plan 모드, 모델 전환 등 Claude Code의 핵심 기능을 지원하지 않으며, 컨텍스트 윈도우 초과 시 대응 수단이 없습니다. 반면 터미널 CLI는 모든 기능을 완전히 사용할 수 있고, Zed의 내장 터미널에서 실행하면 에디터와 나란히 작업할 수 있어 실용적입니다.
.
4-1. 프로젝트 폴더 준비
Zed에는 새 폴더를 생성하면서 여는 기능이 없으므로, 터미널에서 먼저 폴더를 만든 뒤 Zed로 엽니다.
mkdir ~/test_project
zed ~/test_project
.
4-2. Zed 내장 터미널에서 Claude Code 실행
먼저 Claude Code로 Python 파일을 생성합니다. Claude Code는 Python 환경과 무관하게 동작하므로 conda 환경 설정 없이 바로 실행할 수 있습니다. Toolchain 설정은 Python 파일이 프로젝트에 존재해야 Zed가 Python 환경을 인식하므로, 파일 생성 후에 진행합니다.
.
메뉴에서 View > Terminal을 선택하여 내장 터미널을 엽니다.
.
터미널에서 Claude Code를 실행합니다.
claude
.
Claude Code가 실행되면 다음과 같이 요청합니다.
1부터 10까지의 합을 구하고 결과를 출력하는 Python 스크립트를 만들어줘. 파일명은 sum_test.py로 해줘.
.
Claude Code가 sum_test.py 파일을 생성합니다. 왼쪽 파일 탐색기에서 sum_test.py를 클릭하여 에디터에서 코드를 확인합니다.
.
4-3. Python Toolchain 설정 (conda 환경 연동)
Python 파일이 프로젝트에 생성되었으므로 이제 Zed가 Python 환경을 인식합니다. conda 환경을 Toolchain으로 설정하면 Task Runner에서 해당 환경의 Python 인터프리터가 사용됩니다.
- Zed 하단 상태바에서 Python 버전이 표시된 부분을 클릭합니다(또는 Ctrl Command Palette에서 python: select toolchain을 검색).
- 사용 가능한 Python 환경 목록이 표시됩니다.
- test_env 환경을 선택합니다.
.
4-4. Python 코드 실행 — Task Runner 사용
Zed에는 Task Runner가 내장되어 있어, 별도의 터미널 조작 없이 에디터에서 바로 코드를 실행할 수 있습니다.
- sum_test.py를 에디터에서 엽니다.
- ⌘ + Shift + P 를 누르고 task: spawn을 입력한 뒤 Enter를 누릅니다.
- 목록에서 현재 파일 이름이 적힌 run 항목을 선택합니다.
- Zed 하단에 실행 결과(55)가 출력되면 성공입니다.
.
삭제 방법
삭제 순서 주의: Homebrew로 설치한 도구들을 brew uninstall로 제거해야 하므로, Homebrew는 반드시 가장 마지막에 삭제합니다. 아래 순서를 따라주세요.
1. 테스트 리소스 삭제
가이드 진행 중 생성한 테스트 폴더와 conda 환경을 먼저 정리합니다.
conda deactivate
conda remove -n test_env –all -y
rm -rf ~/test_project
.
2. Claude Code 삭제
네이티브 인스톨러로 설치한 경우:
claude uninstall
.
Homebrew로 설치한 경우:
brew uninstall –cask claude-code
.
Claude Code의 설정 파일도 삭제하려면:
rm -rf ~/.claude
.
3. Miniconda 삭제
brew uninstall –cask miniconda
.
Homebrew로 설치한 경우 주 설치 경로는 /opt/homebrew/Caskroom/miniconda/이며, brew uninstall로 해당 디렉토리가 제거됩니다. 추가로 남은 설정 파일을 정리합니다.
rm -rf ~/.conda
rm -rf ~/.condarc
.
~/.zshrc 파일을 열어 conda가 추가한 초기화 블록을 삭제합니다. 아래 명령으로 파일을 엽니다.
open -a TextEdit ~/.zshrc
.
# >>> conda initialize >>> 부터 # <<< conda initialize <<< 까지의 블록을 찾아 삭제한 뒤 저장합니다.
.
4. Zed 삭제
brew uninstall –cask zed
.
설정 파일도 함께 삭제하려면 아래 명령을 추가로 실행합니다.
rm -rf ~/.config/zed
rm -rf ~/Library/Application\ Support/Zed
rm -rf ~/Library/Caches/Zed
rm -rf ~/Library/Logs/Zed
rm -rf ~/Library/Saved\ Application\ State/dev.zed.Zed.savedState
.
CLI 심볼릭 링크도 제거합니다.
rm -f /usr/local/bin/zed
.
5. Homebrew 삭제
Homebrew로 설치한 모든 도구를 제거한 후, 마지막으로 Homebrew 자체를 삭제합니다.
/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)”
.
실행하면 삭제될 파일 목록이 표시되고 확인을 묻습니다. y를 입력하고 Mac 로그인 비밀번호를 입력하면 삭제가 진행됩니다.
삭제 완료 후, Homebrew가 쉘 프로필에 추가한 설정도 제거해야 합니다. ~/.zprofile 파일을 열어 Homebrew 관련 라인을 삭제합니다.
open -a TextEdit ~/.zprofile
.
아래와 같은 라인을 찾아 삭제합니다.
eval “$(/opt/homebrew/bin/brew shellenv)”
.
참고: Intel 맥인 경우 eval “$(/usr/local/bin/brew shellenv)”로 되어 있을 수 있습니다.
.
Homebrew 삭제 스크립트 실행 후 일부 디렉토리가 남아 있다는 메시지가 표시될 수 있습니다. 이 경우 안내된 경로를 수동으로 삭제합니다.
# Apple Silicon 맥인 경우
sudo rm -rf /opt/homebrew
# Intel 맥인 경우
# sudo rm -rf /usr/local/Homebrew
# sudo rm -rf /usr/local/Caskroom
# sudo rm -rf /usr/local/Cellar