byteforce

CPN 한국어 자습서 · Introduction to Model Context Protocol

준비물 · 컴패니언

UV 설치 가이드

Companion — UV CLI 설치 (원문: docs.astral.sh/uv)

이 코스는 Python 프로젝트를 UV로 관리합니다. 이 페이지만 보고 설치를 끝낼 수 있도록 한국어로 정리했습니다. 명령은 2026년 6월 기준이며, 최신·세부 사항은 하단 원문을 참고하세요.

이 장에서 배우는 것What you'll learn

약 5분
1

UV가 무엇인지

2

내 OS에 맞는 설치 명령

3

설치가 잘 됐는지 확인

4

업데이트·제거

5

문제가 생겼을 때

6

원문(영어) 위치

UV란?

What is UV

UV는 Rust로 만든 아주 빠른 Python 패키지·프로젝트 매니저입니다.

기존에 따로 쓰던 pip(패키지 설치)·venv(가상환경)·pyenv(파이썬 버전 관리) 같은 도구의 역할을 하나로 묶어 줍니다. 이 코스에서는 프로젝트 생성·의존성 설치·실행을 전부 UV로 합니다(예: uv run main.py).

설치하기

Install

내 운영체제 탭을 골라 명령을 복사해 실행하세요. 둘 중 하나면 충분합니다 — 표준 설치 스크립트(가장 간단) 또는 평소 쓰는 패키지 매니저.

PowerShell을 열고 아래 한 줄을 붙여넣어 실행하세요. 설치 스크립트를 인터넷에서 받아 실행하기 위해 실행 정책을 잠시 우회합니다.

Windows · PowerShell
# PowerShell에 그대로 붙여넣고 실행
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

터미널을 열고 아래 명령을 붙여넣어 실행하세요.

macOS · Linux · 터미널
# 터미널에 붙여넣고 실행 (curl)
curl -LsSf https://astral.sh/uv/install.sh | sh

# curl이 없으면 wget 사용
wget -qO- https://astral.sh/uv/install.sh | sh

이미 패키지 매니저를 쓰고 있다면 그걸로 설치해도 됩니다.

· Python(pip): pip install uv  (격리 설치 권장: pipx install uv)
· macOS Homebrew: brew install uv
· Windows WinGet: winget install --id=astral-sh.uv -e
· Windows Scoop: scoop install main/uv

설치 확인

Verify

설치 후 터미널(또는 PowerShell)을 한 번 새로 열고 버전을 확인합니다.

설치 확인
# 터미널/PowerShell을 새로 연 뒤
uv --version
# → uv 0.x.x 처럼 버전이 나오면 성공

버전이 안 나오면? 거의 항상 두 가지입니다. ① 설치 후 터미널을 새로 열지 않았거나(PATH가 아직 갱신 안 됨) → 터미널을 완전히 닫았다 다시 여세요. ② 그래도 안 되면 컴퓨터를 한 번 재시작한 뒤 다시 uv --version.

업데이트와 제거

Update & remove
업데이트 · 제거
# 표준 스크립트로 설치했다면 스스로 업데이트
uv self update

# pip로 설치했다면
pip install --upgrade uv

제거는 uv·uvx 실행 파일을 지우면 됩니다(보통 ~/.local/bin/). 자세한 제거 절차는 원문을 참고하세요.

원문(영어): 설치 방법·옵션의 가장 최신 정보는 UV 공식 문서에 있습니다 — docs.astral.sh/uv. 이 페이지의 명령은 2026년 6월 기준으로 정리한 것입니다. 더 깊은 내용은 UV·MCP 공식문서 한국어 미러에서 볼 수 있습니다.