Qiskit 설치 방법 2026｜무료로 양자컴퓨터 회로 만들고 첫 실행까지 따라하기

Qiskit은 양자회로를 직접 만들고 실행할 수 있는 오픈소스 SDK입니다. 앞서 포스팅한 이론들과 실제 실험의 적용을 위해 Python 설치부터 Qiskit 설치, 첫 양자회로 실행까지 Windows 기준으로 하나씩 따라해봅니다.

양자컴퓨터 실험글에서 자주 등장하는 프로그램이 바로 Qiskit입니다. 그런데 처음 접하면 어디에서 다운로드해야 하는지, 별도의 프로그램을 설치해야 하는지, 코드는 어디에서 실행해야 하는지부터 헷갈릴 수 있습니다.

Qiskit은 일반적인 Windows 프로그램처럼 설치파일 하나를 내려받아 실행하는 방식이 아닙니다. 먼저 Python 실행환경을 준비한 뒤 Python 패키지 관리도구인 pip를 이용해 설치합니다. 이번 글에서는 아무것도 설치하지 않은 Windows PC를 기준으로 Qiskit을 설치하고 실제 양자회로 하나를 실행하는 단계까지 진행해보겠습니다.

이 글에서 직접 해볼 것

Qiskit이 어떤 도구인지 확인하기
공식 다운로드·설치 페이지 찾기
Python 설치 여부 확인하기
Qiskit 전용 가상환경 만들기
Qiskit 설치하기
설치된 버전 확인하기
첫 양자회로 만들기
로컬 환경에서 회로를 1,000번 실행하기
이후 Qiskit Aer와 실제 IBM QPU 실험으로 연결하기

Qiskit이란?

Qiskit은 양자회로를 만들고 변환하고 실행하기 위한 오픈소스 SDK입니다. Python 코드로 큐비트와 양자게이트를 배치하고 회로를 구성할 수 있으며, 시뮬레이터나 실제 양자컴퓨터에서 실행할 수 있도록 회로를 준비하는 데 사용됩니다.

처음 시작할 때는 복잡하게 생각할 필요가 없습니다. Qiskit을 “Python으로 양자회로를 만드는 도구상자” 정도로 이해하면 충분합니다.

하고 싶은 일	사용하는 도구
양자회로 만들기	Qiskit
H, X, CNOT 같은 게이트 배치	Qiskit
회로를 하드웨어에 맞게 변환	Qiskit Transpiler
이상적인 로컬 회로 실행	Qiskit의 StatevectorSampler 등
노이즈를 넣어 시뮬레이션	Qiskit Aer
실제 IBM 양자컴퓨터 실행	IBM Quantum Platform 연동

Qiskit은 어디에서 다운로드할까?

여기서 가장 먼저 알아둘 점이 있습니다. Qiskit 자체를 설치하는 exe 파일을 찾을 필요는 없습니다. Python을 설치한 다음 터미널에서 Qiskit 패키지를 내려받는 방식입니다.

처음 설치할 때 필요한 공식 페이지

Python 공식 다운로드 페이지 — PC에 Python이 없다면 가장 먼저 방문합니다.
IBM Quantum 공식 Qiskit 설치 가이드 — Qiskit의 공식 설치 절차를 확인할 수 있습니다.
Qiskit 공식 PyPI 배포 페이지 — 현재 배포 버전과 Python 요구사항을 확인할 수 있습니다.
Qiskit 공식 GitHub — 실제 오픈소스 코드와 릴리스 정보를 볼 수 있습니다.
IBM Quantum Platform — 나중에 실제 IBM QPU를 사용할 때 연결합니다.

2026년 9월 4일 확인 기준으로 PyPI에서 제공되는 최신 Qiskit 버전은 2.5.2이며 Python 3.10 이상이 필요합니다. 버전은 계속 변경될 수 있으므로 설치할 때는 위 PyPI 페이지에서 현재 버전을 함께 확인하는 것이 좋습니다.

Python pip Qiskit 순서로 양자컴퓨팅 개발환경을 설치하는 구조 — Python을 준비한 뒤 pip로 Qiskit을 설치하고 양자회로를 실행합니다.

1단계: Python이 설치되어 있는지 확인하기

Windows 검색에서 PowerShell을 실행합니다. 검은색 또는 파란색 명령창이 열리면 아래 명령어를 입력합니다.

python --version

Python이 정상적으로 설치되어 있다면 다음처럼 버전 번호가 표시됩니다.

Python 3.x.x

명령어를 찾을 수 없다는 메시지가 나오면 위의 Python 공식 다운로드 페이지에서 Python을 먼저 설치합니다. 설치가 끝난 뒤 PowerShell을 완전히 닫고 다시 실행한 후 같은 명령어를 입력합니다.

※ Python이 설치되어있지 않은 경우 PowerShell에 아래 명령문을 입력합니다.

winget install Python.Python.3.12

2단계: Qiskit 전용 폴더 만들기

Qiskit 실습파일이 다른 Python 프로젝트와 섞이지 않도록 별도 폴더를 하나 만드는 것이 편합니다. 파일 탐색기에서 작업할 위치를 먼저 열고 주소 표시줄에 powershell을 입력해 창을 여세요. 아래 명령은 현재 위치에 qiskit-practice 폴더를 만듭니다. 이미 폴더가 있다면 mkdir 명령은 생략하고 cd 명령만 실행합니다.

mkdir qiskit-practice
cd qiskit-practice
pwd

3단계: 가상환경 만들기

Python 가상환경은 Qiskit과 관련 패키지를 별도의 공간에 설치하는 기능입니다. 다른 Python 프로그램과 패키지 버전이 충돌하는 일을 줄일 수 있기 때문에 처음부터 사용하는 것이 좋습니다.

python -m venv .venv

PowerShell에서는 다음 명령으로 가상환경을 활성화합니다.

.\.venv\Scripts\Activate.ps1

명령창 왼쪽에 (.venv)가 표시되면 활성화된 것입니다.

PowerShell의 스크립트 실행 설정 때문에 활성화되지 않는다면 파일 탐색기에서 같은 qiskit-practice 폴더를 열고 주소 표시줄에 cmd를 입력하세요. 열린 명령 프롬프트에서 아래 명령으로 활성화한 뒤 설치를 이어갈 수 있습니다.

.venv\Scripts\activate.bat

4단계: Qiskit 설치하기

가상환경이 활성화된 상태에서 먼저 pip를 업데이트합니다.

python -m pip install --upgrade pip

이제 Qiskit을 설치합니다.

python -m pip install qiskit

다운로드와 설치가 끝날 때까지 잠시 기다립니다. 인터넷 연결환경에 따라 필요한 패키지를 함께 내려받기 때문에 처음 설치할 때는 시간이 조금 걸릴 수 있습니다.

Windows에서 Python 가상환경 생성 후 Qiskit을 설치하는 단계 — 가상환경을 만든 뒤 Qiskit을 설치하면 다른 Python 프로젝트와 패키지 충돌을 줄일 수 있습니다.

5단계: Qiskit이 제대로 설치됐는지 확인하기

아래 명령어를 그대로 입력합니다.

python -c "import qiskit; print(qiskit.__version__)"

오류 없이 숫자가 출력된다면 Qiskit 설치가 완료된 것입니다. 버전 번호는 설치 시점에 따라 달라질 수 있습니다.

설치된 패키지 정보를 조금 더 자세히 보고 싶다면 다음 명령도 사용할 수 있습니다.

python -m pip show qiskit

6단계: 첫 번째 양자회로 파일 만들기

이제 설치만 하고 끝내지 않고 실제 회로를 실행해보겠습니다. 메모장이나 VS Code 등 원하는 편집기를 열고 아래 코드를 입력합니다.

from qiskit import QuantumCircuit
from qiskit.primitives import StatevectorSampler

# 큐비트 1개짜리 회로 생성
qc = QuantumCircuit(1)

# |0> 상태를 |1> 상태로 변경
qc.x(0)

# 측정 추가
qc.measure_all()

# 로컬 이상적 시뮬레이터 실행
sampler = StatevectorSampler()

result = sampler.run(
    [qc],
    shots=1000
).result()

counts = result[0].data.meas.get_counts()

print(qc.draw())
print(counts)

파일은 앞서 만든 qiskit-practice 폴더에 다음 이름으로 저장합니다. 메모장을 사용한다면 파일 형식을 ‘모든 파일’로 선택하고 UTF-8로 저장하세요. 파일 이름 뒤에 .txt가 붙지 않았는지 확인합니다.

first_qiskit.py

7단계: 첫 Qiskit 회로 실행하기

PowerShell에서 파일을 저장한 폴더에 있는지 확인한 다음 아래 명령을 실행합니다.

python first_qiskit.py

이번 회로는 |0⟩ 상태에 X 게이트를 적용해 항상 |1⟩을 만든 뒤 측정합니다. 이상적인 로컬 실행환경에서 1,000번 실행하면 다음과 같은 결과를 확인할 수 있습니다.

{'1': 1000}

여기까지 출력됐다면 Python 설치 → Qiskit 설치 → 회로 생성 → 게이트 적용 → 측정 → 실행 → 결과 확인까지 한 번에 성공한 것입니다.

코드에서 어떤 일이 일어난 걸까?

코드	역할
QuantumCircuit(1)	큐비트 1개짜리 회로 생성
qc.x(0)	0번 큐비트에 X 게이트 적용
qc.measure_all()	큐비트를 측정하도록 설정
StatevectorSampler()	로컬에서 이상적인 양자회로 실행
shots=1000	같은 회로를 1,000회 측정
get_counts()	각 결과가 몇 번 나왔는지 집계

X 게이트를 H 게이트로 바꾸면 어떻게 될까?

Qiskit 설치가 정상적으로 끝났다면 바로 간단한 양자 확률실험으로 확장할 수 있습니다.

기존 코드의:

qc.x(0)

부분을 다음과 같이 바꿉니다.

qc.h(0)

H 게이트는 |0⟩ 상태의 큐비트를 중첩상태로 만들기 때문에 1,000회 측정하면 0과 1이 대략 절반씩 나타납니다. 실행할 때마다 정확한 횟수는 조금씩 달라질 수 있습니다.

이 간단한 변경만으로 이 블로그에서 진행했던 동전 던지기, 랜덤 선택, 반복측정 실험의 기본 구조를 직접 만들어볼 수 있습니다.

Qiskit에서 X 게이트와 H 게이트를 적용해 측정 결과를 확인하는 첫 양자회로 — X 게이트로 설치를 확인한 뒤 H 게이트를 사용하면 확률적인 양자측정까지 바로 실습할 수 있습니다.

Jupyter Notebook에서 사용하고 싶다면

Python 파일 대신 셀 단위로 코드를 실행하고 결과를 바로 확인하고 싶다면 Jupyter Notebook을 함께 설치할 수 있습니다.

python -m pip install jupyter

설치 후 다음 명령으로 실행합니다.

python -m notebook

회로를 이미지 형태로 그리는 기능까지 사용할 계획이라면 시각화 관련 패키지도 함께 설치할 수 있습니다.

python -m pip install "qiskit[visualization]" matplotlib

설치하다 오류가 나면 먼저 확인할 것

문제	먼저 확인할 내용
python 명령을 찾을 수 없음	Python 설치 여부와 터미널 재실행 확인
No module named qiskit	현재 가상환경에서 Qiskit을 설치했는지 확인
pip와 python 위치가 다름	pip 대신 python -m pip 형태 사용
PowerShell에서 가상환경 활성화 실패	Command Prompt에서 activate.bat 사용
인터넷의 오래된 Qiskit 코드가 실행되지 않음	현재 Qiskit 공식 문서의 API와 비교

특히 오래된 Qiskit 강의나 블로그에서는 현재 버전과 다른 API를 사용하는 코드가 남아 있을 수 있습니다. 설치는 최신 Qiskit으로 했는데 인터넷에서 찾은 오래된 코드를 그대로 복사하면 import 단계부터 오류가 날 수 있으므로 공식 문서의 현재 Quickstart와 비교하는 것이 좋습니다.

Qiskit, Qiskit Aer, IBM Quantum은 무엇이 다를까?

도구	주로 하는 일	처음 사용하는 순서
Qiskit	양자회로 작성·변환·기본 실행	가장 먼저
Qiskit Aer	고성능 시뮬레이션·노이즈 실험	Qiskit 다음
IBM Quantum Platform	실제 IBM QPU 실행	로컬 실습 후
Google Colab	브라우저에서 Python·Qiskit 실행	PC 설치가 부담스러울 때
Jupyter Notebook	코드와 결과를 셀 단위로 실행	반복 실습할 때

Qiskit을 설치했다면 이 실험부터 해보자

설치를 마쳤다면 프로그램을 설치한 것만으로 끝내지 말고 실제 회로를 바꿔보는 것이 가장 빠른 학습방법입니다.

양자컴퓨터로 가위바위보 10,000번 뽑아보니? Qiskit 공정성 실험 — 여러 측정결과를 실제 선택 문제에 적용
오늘 점심 뭐 먹지? 양자회로로 메뉴 4개 중 하나를 골라봤다 — 2큐비트 결과를 네 가지 선택지로 연결
양자컴퓨터도 시간이 지나면 기억을 잃을까? T1 노이즈 실험 — Qiskit Aer 노이즈 실습으로 확장
양자컴퓨터 1,000번 실행하면 매번 50:50일까? — 로컬 시뮬레이션을 실제 IBM QPU 실행으로 확장

처음에는 이번 글의 X 게이트 회로처럼 결과가 분명한 회로로 설치 여부를 확인하고, 그 다음 H 게이트와 여러 큐비트를 추가하는 순서가 좋습니다. 이후 Qiskit Aer에서 노이즈를 넣고, 마지막으로 실제 QPU를 실행하면 이 블로그의 실험글을 그대로 따라가기 쉬워집니다.

이번 글에서 완료한 것

Qiskit이 별도 데스크톱 프로그램이 아니라 Python SDK라는 점을 확인했습니다.
공식 Python 다운로드 페이지와 Qiskit 설치 페이지를 확인했습니다.
Qiskit 전용 가상환경을 만들었습니다.
pip를 이용해 Qiskit을 설치했습니다.
설치된 Qiskit 버전을 확인했습니다.
큐비트 하나와 X 게이트로 첫 양자회로를 만들었습니다.
회로를 1,000회 실행하고 결과를 확인했습니다.
H 게이트로 바꾸면 확률적인 양자실험으로 확장할 수 있다는 점을 확인했습니다.

다음 단계에서는 Qiskit만 설치한 환경에서 한 단계 더 나아가 Qiskit Aer를 설치하고, 실제 양자컴퓨터에서 발생할 수 있는 오류와 노이즈를 PC에서 직접 만들어보는 방법을 살펴보겠습니다.

공식 참고자료 및 다운로드

※ Qiskit과 Python의 최신 버전 및 지원환경은 변경될 수 있습니다. 설치 시 위 공식 문서와 PyPI 페이지에서 현재 요구사항을 함께 확인하는 것을 권장합니다.