[Git] GitHub 레포지토리 클론(clone) 방법 (Windows & Linux)

깃허브 고냠미

 

 

 

 

 

 

GitHub은 코드 혹은 파일 내용들을 저장하는 대표적인 저장소이다.

(GitHub에 대해 더 자세히 알고 싶다면 ➡ https://tnqls18513.tistory.com/47)

레포지토리 클론(clone)은 다른 사람 또는 본인의 원격 저장소를 로컬 컴퓨터로 복사하는 과정이다.

이후 수정, 커밋, 푸시 등을 통해 협업하거나 프로젝트 개발을 이어갈 수 있다.

이번 포스팅에서는 Windows와 Linux 환경에서 클론하는 방법을 알아보겠다.😊

 

 

 

 

 

 

🔍 클론이란?

클론(clone)이란?
GitHub에 있는 저장소를 내 컴퓨터에 복사해서 로컬 저장소로 만드는 것

 

📦 원격 저장소(GitHub) → 💻 내 로컬 컴퓨터

git clone [저장소 주소]

 

예:

git clone https://github.com/username/project.git

 

 

 

 

 

 

 

 

🪟 Windows에서 GitHub 클론하기

🧾 사전 준비

✅ Git 설치
➡ 설치 방법: https://tnqls18513.tistory.com/49/#comment22895973
✅ GitHub 계정 (공개 저장소는 계정 없어도 가능)
✅ Git Bash 또는 PowerShell 준비

 

 

 

 

 

 

⚙️ 클론 방법 (HTTPS 방식)

1️⃣ 클론할 GitHub 저장소 접속
2️⃣ <> Code 버튼 클릭 → HTTPS 주소 복사
예: https://github.com/username/project.git

3️⃣ Git Bash 또는 CMD 실행

git clone https://github.com/username/project.git

✅ 완료되면 현재 디렉토리에 project 폴더가 생기고 내용이 복사됨!

 

 

 

 

 

 

 

🔐 (선택) SSH 방식으로 클론

1️⃣ GitHub에 SSH 공개키 등록
2️⃣ SSH 주소 복사:

예: git@github.com:username/project.git

3️⃣ 클론 명령어 실행:

git clone git@github.com:username/project.git

⚠️ SSH는 초기 세팅이 조금 번거롭지만, 비밀번호 없이 푸시할 수 있어 자주 사용된다.

 

 

 

 

 

 

🐧 Linux에서 GitHub 클론하기

🧾 사전 준비

✅ Git 설치

sudo apt install git # Ubuntu/Debian 
sudo yum install git # CentOS

✅ GitHub 계정 (선택)
✅ 터미널 사용 가능

 

 

 

 

 

⚙️ 클론 방법 (HTTPS 방식)

1️⃣ 클론하고 싶은 저장소 접속
2️⃣ 주소 복사:

예: https://github.com/username/project.git

3️⃣ 터미널에서 클론 실행:

git clone https://github.com/username/project.git

 

 

 

 

 

 

 

🔐 SSH 방식으로 클론 (Linux)

SSH 키가 없다면 먼저 생성:

ssh-keygen -t ed25519 -C "you@example.com"

 

공개 키 등록:

cat ~/.ssh/id_ed25519.pub

 

👉 이 키를 GitHub > Settings > SSH Keys에 등록

 

그 후 클론:

git clone git@github.com:username/project.git

 

 

 

 

 

 

 

 

🧰 클론 후 확인할 명령어들

cd project # 클론한 폴더로 이동 
git status # 변경사항 확인 
git remote -v # 연결된 원격 저장소 확인

 

 

 

 

 

 

 

 

💡 자주 발생하는 오류 팁

오류	메세지 원인	해결 방법
Permission denied (publickey)	SSH 키 미등록	GitHub에 공개키 등록
fatal: repository not found	주소 오타 or 권한 없음	저장소 주소 확인 / 권한 확인
인증 팝업	HTTPS 사용 시 로그인 필요	아이디/비번 or Personal Access Token 입력

 

 

 

 

 

 

 

 

 

✅ 마무리

항목	Windows	Linux
기본 클론	Git Bash / PowerShell	터미널
HTTPS	빠르고 간단	빠르고 간단
SSH	인증 자동화 가능	리눅스에 특히 익숙함