설치형 도구 처음 실행하기 (윈도우 기준)

README에 검은 상자 속 명령어만 잔뜩 있다면 '설치해서 쓰는 도구'예요. 겁낼 필요 없어요. 대부분 터미널 열기 → 필요한 프로그램 설치 → 명령어 복사·붙여넣기 세 단계면 돼요.

1단계. 터미널 열기

1. 윈도우 키를 누르고 터미널 또는 PowerShell을 검색해 실행해요.
2. 특정 폴더에서 열고 싶으면, 탐색기에서 그 폴더를 연 뒤 빈 곳을 오른쪽 클릭 → 터미널에서 열기를 눌러요.
3. 명령어는 복사한 뒤 터미널에서 오른쪽 클릭(또는 Ctrl+V)으로 붙여 넣고 Enter를 누르면 돼요.

2단계. 자주 필요한 프로그램 설치

Python (파이썬)

명령어에 pip, python이 보이면 필요해요. python.org에서 받고, 설치 첫 화면의 'Add python.exe to PATH'에 꼭 체크하세요.

Node.js (노드)

명령어에 npm, npx가 보이면 필요해요. nodejs.org에서 LTS 버전을 받으세요.

Git (깃)

명령어에 git clone이 보이면 필요해요. git-scm.com에서 받으세요.

3단계. 자주 보는 명령어 뜻

cd 폴더이름

그 폴더로 들어가요. (예: cd Downloads)

pip install 이름

파이썬 도구를 설치해요.

npm install / npm i

Node.js 도구에 필요한 부품을 설치해요.

npx 이름

Node.js 도구를 설치 없이 바로 실행해요.

python 파일.py

파이썬 프로그램을 실행해요.

Ctrl + C

실행 중인 프로그램을 멈춰요.

오류가 나면

1. 오류 메시지의 마지막 몇 줄을 복사해요.
2. 저장소의 Issues에서 같은 오류를 검색해 보세요. 이미 해결 방법이 있는 경우가 많아요.
3. AI 챗봇에 오류 메시지와 README 설치 부분을 함께 붙여 넣고 물어보면 대부분 풀려요.