Git 설치하고 사용하는 법 - 기본 명령어부터 GitHub 연동까지 완벽 가이드

2026-10-29 · 개발 · –

안녕하세요, 우리들의 주파수 구독자 여러분! 코드를 저장하고 버전을 관리하려면 가장 먼저 배워야 하는 도구가 바로 Git입니다. “git 설치했는데 이제 뭘 해야 하죠”, “GitHub에 어떻게 올려요”라는 질문을 정말 많이 받는데, 오늘은 설치부터 기본 명령어, SSH 키로 GitHub 연동까지 한 번에 끝내는 가이드를 준비했습니다.

1. Git이란? 왜 써야 하나요

Git은 파일의 변경 이력을 기록하고 관리하는 버전 관리 시스템입니다. 코드를 수정하다가 예전 버전으로 되돌리거나, 여러 사람이 동시에 같은 프로젝트를 작업하거나, 실험적인 기능을 “브랜치”로 따로 만들어 테스트할 때 반드시 필요합니다.

Git: 내 컴퓨터(로컬)에서 버전을 관리하는 프로그램 자체
GitHub: Git 저장소를 인터넷에 올려 백업·공유·협업할 수 있는 서비스

둘은 별개입니다. Git만 설치해도 로컬에서는 버전 관리가 되지만, 다른 컴퓨터에서 접근하거나 포트폴리오로 공개하려면 GitHub 같은 원격 저장소가 필요합니다.

2. 윈도우에 Git 설치하기

2.1 설치 파일 다운로드

git-scm.com 접속
Windows 버튼 클릭 → 자동으로 64비트 설치 파일(Git-x.xx.x-64-bit.exe) 다운로드 시작
다운로드된 파일 실행

2.2 설치 마법사 진행

대부분의 화면은 기본값 그대로 Next를 눌러도 됩니다. 신경 써야 할 화면은 두 곳입니다.

Adjusting your PATH environment: “Git from the command line and also from 3rd-party software” 선택 (기본값). 이 옵션을 선택해야 cmd, PowerShell 어디서든 git 명령어를 쓸 수 있습니다.
Choosing the default editor: 처음이라면 “Use Visual Studio Code as Git’s default editor”(VS Code가 설치된 경우) 또는 기본값인 Vim 대신 Notepad로 바꿔도 무방합니다. Vim은 처음 보면 종료 방법부터 헷갈립니다.

나머지는 Next → Next → Install로 진행하면 5분 내로 끝납니다.

2.3 설치 확인

설치가 끝나면 시작 메뉴에서 Git Bash를 검색해 실행합니다. 검은 터미널 창이 뜨면 아래 명령어로 버전을 확인합니다.

git --version

git version 2.4x.x.windows.1 같은 문구가 나오면 설치가 정상적으로 끝난 것입니다.

3. 최초 설정 (이름·이메일 등록)

Git은 커밋(변경 기록)마다 “누가 했는지”를 기록합니다. 설치 후 딱 한 번만 설정하면 됩니다.

git config --global user.name "본인 이름 또는 닉네임"
git config --global user.email "본인이메일@example.com"

여기 입력하는 이메일은 GitHub에 가입한 이메일과 동일하게 맞춰두는 것을 추천합니다. 다르면 커밋 기록이 GitHub 프로필에 제대로 연결되지 않습니다.

설정이 잘 됐는지 확인하려면:

git config --global --list

4. 기본 명령어 총정리

처음에는 아래 표에 있는 명령어만 알아도 충분합니다.

명령어	기능
`git init`	현재 폴더를 Git 저장소로 초기화
`git clone <주소>`	원격 저장소를 통째로 내 컴퓨터로 복제
`git status`	변경된 파일 목록 확인
`git add <파일명>` / `git add .`	변경 사항을 커밋 대상으로 등록(스테이징)
`git commit -m "메시지"`	등록된 변경 사항을 하나의 기록으로 저장
`git log`	커밋 기록(히스토리) 확인
`git push`	로컬 커밋을 원격 저장소(GitHub)에 업로드
`git pull`	원격 저장소의 최신 내용을 내 컴퓨터로 받아오기
`git branch`	브랜치 목록 확인
`git switch <브랜치명>`	다른 브랜치로 이동
`git merge <브랜치명>`	다른 브랜치의 내용을 현재 브랜치에 합치기

4.1 가장 흔한 작업 흐름

새 프로젝트 폴더에서 Git을 처음 시작할 때는 아래 순서를 그대로 따라가면 됩니다.

cd 내프로젝트폴더
git init
git add .
git commit -m "첫 커밋"

이미 있는 GitHub 저장소를 받아오고 싶다면 init 대신 clone만 쓰면 됩니다.

git clone https://github.com/계정명/저장소명.git

5. GitHub 연동하기 (SSH 키 등록)

GitHub는 2026년 현재 비밀번호로 직접 push하는 방식을 막아두었습니다. SSH 키 또는 개인 액세스 토큰(PAT) 중 하나가 꼭 필요한데, 한 번 등록해두면 이후 계속 재사용할 수 있는 SSH 키 방식이 가장 편합니다.

5.1 SSH 키 생성

Git Bash에서 실행합니다.

ssh-keygen -t ed25519 -C "본인이메일@example.com"

저장 경로를 물으면 그냥 Enter (기본 경로 ~/.ssh/id_ed25519 사용)
암호(passphrase)를 물으면 비워두고 Enter 두 번 (원할 경우 입력해도 됩니다)

5.2 공개키 복사

cat ~/.ssh/id_ed25519.pub

출력된 ssh-ed25519 AAAA... 로 시작하는 전체 문자열을 복사합니다.

5.3 GitHub에 키 등록

GitHub 로그인 → 우측 상단 프로필 → Settings
좌측 메뉴에서 SSH and GPG keys 클릭
New SSH key 클릭
Title에 아무 이름(예: “내 PC”)을 적고, Key 칸에 복사한 공개키를 붙여넣고 Add SSH key

5.4 연결 테스트

ssh -T [email protected]

Hi 계정명! You've successfully authenticated 메시지가 뜨면 연동 완료입니다. 이제 git clone [email protected]:계정명/저장소명.git 형태(https가 아닌 ssh 주소)로 작업하면 비밀번호나 토큰 입력 없이 push/pull이 됩니다.

6. 어떤 방식으로 쓸까? 도구 비교

명령어가 아직 익숙하지 않다면 GUI 도구를 함께 써도 됩니다.

도구	장점	단점	추천 대상
Git Bash (CLI)	모든 기능 사용 가능, 서버 작업에도 동일하게 적용	명령어를 외워야 함	개발을 계속할 사람
GitHub Desktop	무료, 클릭 몇 번으로 commit/push, 변경 내용 시각화	GitHub 외 플랫폼 지원 약함, 고급 기능 부족	입문자, 간단한 협업
VS Code 내장 Git	코드 편집과 동시에 Git 작업, diff 비교 편리	복잡한 브랜치 작업은 여전히 CLI가 편함	이미 VS Code 쓰는 사람
Sourcetree	브랜치/머지 흐름을 그래프로 시각화	설치 용량 크고 초반 로딩 느림	복잡한 브랜치 전략이 필요한 팀

결론적으로 처음엔 Git Bash로 기본 명령어를 익히고, 복잡한 브랜치 상황을 눈으로 보고 싶을 때 GUI 도구를 보조로 쓰는 조합을 추천합니다.

7. 자주 발생하는 오류 해결 (FAQ)

Q1. `fatal: not a git repository` 오류가 나요

현재 폴더가 Git 저장소로 초기화되지 않았다는 뜻입니다. git init을 실행했는지, 혹은 저장소 폴더 안에서 명령어를 실행하고 있는지 cd로 확인하세요.

Q2. `Permission denied (publickey)` 오류가 나요

SSH 키가 GitHub에 등록되지 않았거나, 등록한 계정과 다른 계정으로 접근하는 경우입니다. 위 5.4단계의 ssh -T [email protected]으로 다시 테스트하고, 안 되면 5.1~5.3을 다시 확인하세요.

Q3. `git push`가 거부돼요 (rejected)

원격 저장소에 내가 받아오지 않은 새로운 커밋이 있을 때 발생합니다. 먼저 git pull로 최신 내용을 받은 뒤 다시 git push를 시도하세요. 충돌(conflict)이 나면 해당 파일을 열어 충돌 표시(<<<<<<<)를 직접 정리한 뒤 git add, git commit을 다시 진행합니다.

Q4. 줄바꿈 관련 경고(`LF will be replaced by CRLF`)가 계속 나와요

윈도우와 맥/리눅스의 줄바꿈 문자가 달라서 나오는 경고일 뿐, 에러는 아닙니다. 신경 쓰지 않아도 되지만, 없애고 싶다면 아래 명령어로 윈도우 환경에 맞게 설정할 수 있습니다.

git config --global core.autocrlf true

Q5. 비밀번호를 쳐도 push가 안 돼요

2026년 기준 GitHub는 계정 비밀번호로 push를 더 이상 허용하지 않습니다. SSH 키(5번 항목) 또는 Settings → Developer settings → Personal access tokens에서 발급한 PAT를 비밀번호 대신 입력해야 합니다.

핵심 요약

Git은 로컬 버전 관리 도구, GitHub은 이를 온라인에 올려 공유하는 서비스로 서로 다른 개념이다.
설치 후 git config --global user.name/email 최초 설정은 필수.
기본 흐름은 add → commit → push, 받아올 때는 pull 하나만 기억하면 된다.
GitHub 연동은 SSH 키 생성(ssh-keygen) → GitHub에 공개키 등록 → ssh -T [email protected]으로 테스트하는 순서.
비밀번호 직접 입력 방식은 막혔으니 SSH 키나 개인 액세스 토큰(PAT)을 사용해야 한다.

처음에는 명령어가 낯설어도 add, commit, push, pull 네 가지만 반복해서 손에 익히면 금방 자연스러워집니다. 오늘 가이드를 따라 직접 저장소 하나를 만들어보시길 추천드립니다!

–

불러오는 중…