Claude Code는 알고 있는데 Github는 왜 써야 하나요?

Claude Code와 함께 문서 작성을 하려면 문서 파일이 내 컴퓨터 로컬에 있어야 합니다.

'로컬'이라는 의미는 Google Docs, Notion 처럼 클라우드 서비스에 올라간 문서가 아니라 내 컴퓨터에 직접 저장된 파일이라는 뜻입니다.

Google Drive를 쓰면 내가 편집한 내용을 다른 사람도 다같이 동시에 볼 수 있죠? Github가 그와 비슷한 역할을 하지만 Google Drive처럼 실시간 반영되진 않습니다.

Git과 Github의 차이점이 무엇인가요?

이름이 비슷해서 같은 것처럼 느껴지지만, Git과 GitHub는 서로 다른 역할을 해요.

	Git	GitHub
한 줄 설명	내 컴퓨터에서 파일의 변경 이력을 관리해주는 도구	Git으로 관리하는 파일을 인터넷에 올려서 팀원과 공유하는 서비스
비유	내 컴퓨터에 설치된 한글(HWP) 프로그램	문서를 팀원과 공유하는 Google Drive
어디서 동작?	내 컴퓨터 안에서	인터넷(웹사이트)에서

쉽게 정리하면 이래요:

Git = 내 컴퓨터에서 "누가, 언제, 무엇을 바꿨는지" 기록해주는 프로그램
GitHub = 그 기록을 인터넷에 올려서 팀원들과 함께 볼 수 있게 해주는 웹사이트

우리 팀에서는 Git으로 Vault 문서의 변경 이력을 관리하고, GitHub에 올려서 팀원 모두가 같은 문서를 공유하고 있어요.

Git 설치하기

Vault를 내려받고 최신 문서를 가져오려면 내 컴퓨터에 Git이 설치되어 있어야 해요. 아래 단계를 따라 설치해 주세요.

macOS

macOS에는 Git이 이미 포함되어 있는 경우가 많아요. 먼저 설치 여부를 확인해 볼게요.

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

Command(⌘) + Space를 눌러 Spotlight 검색창을 열어요.
iTerm이라고 입력한 뒤 Enter를 눌러요.
아래 명령어를 입력하고 Enter를 눌러요.

1git --version

git version 2.xx.x 같은 숫자가 나오면 이미 설치되어 있는 거예요! 다음 섹션으로 넘어가면 돼요.
command not found 같은 메시지가 나오면 아직 설치가 안 된 거예요. 2단계로 진행해 주세요.

2단계: Git 설치하기

가장 쉬운 방법은 Xcode Command Line Tools를 설치하는 거예요.

1xcode-select --install

팝업 창이 뜨면 설치 버튼을 눌러주세요. 설치에 몇 분 정도 걸릴 수 있어요.

3단계: 설치 확인하기

설치가 끝나면 다시 한번 확인해 볼게요.

1git --version

git version 2.xx.x 같은 숫자가 나오면 설치 완료예요!

Windows

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

키보드에서 Windows 키를 눌러요.
cmd라고 입력한 뒤 명령 프롬프트를 클릭해요.
아래 명령어를 입력하고 Enter를 눌러요.

1git --version

git version 2.xx.x 같은 숫자가 나오면 이미 설치되어 있는 거예요!
'git'은(는) 내부 또는 외부 명령... 메시지가 나오면 2단계로 진행해 주세요.

2단계: 설치 파일 내려받기

웹 브라우저에서 **https://git-scm.com/download/win**으로 이동해요.
페이지에 접속하면 자동으로 설치 파일이 내려받아져요. 자동으로 시작되지 않으면 Click here to download manually를 클릭해 주세요.

3단계: 설치하기

내려받은 설치 파일(Git-2.xx.x-64-bit.exe)을 더블클릭해요.
설치 화면이 나오면 모든 옵션을 기본값 그대로 두고 Next를 계속 눌러요.
마지막에 Install을 누르고 설치가 끝나면 Finish를 눌러요.

설치 중간에 여러 옵션이 나오지만, 기본값 그대로 진행하면 돼요. 아무것도 바꿀 필요 없어요.

4단계: 설치 확인하기

명령 프롬프트를 껐다가 다시 열고, 아래 명령어를 입력해요.

1git --version

git version 2.xx.x 같은 숫자가 나오면 설치 완료예요!

Github의 버전 관리 방식 이해하기

Vault 문서를 읽다 보면 "커밋", "브랜치", "pull" 같은 단어를 만나게 돼요. 처음엔 낯설 수 있지만, 하나씩 알아보면 생각보다 간단해요.

커밋이란?

게임을 하다가 세이브하는 것과 같아요.

파일의 특정 시점 상태를 저장하는 행위를 **커밋(commit)**이라고 해요.
한 번 커밋하면 "누가, 언제, 무엇을 바꿨는지"가 기록으로 남아요.
세이브 포인트가 여러 개 쌓이듯이, 커밋도 하나하나 쌓여서 문서의 변경 이력이 만들어져요.

예를 들어 "미연님이 3월 17일에 PRD 문서의 목표 섹션을 수정했다"는 기록이 커밋 하나로 남는 거예요.

브랜치란?

원본 문서를 건드리지 않고 별도 공간에서 작업하는 방식이에요.

비유하자면, 원본 문서는 그대로 두고 포스트잇에 초안을 먼저 써보는 것과 비슷해요.
초안이 확정되면 원본에 반영하고, 마음에 안 들면 포스트잇만 떼어버리면 돼요.
GitHub에서는 이 "원본"을 main 브랜치라고 불러요.

읽기 사용자로서 기억할 것은 하나예요:

main 브랜치 = 최종 확정본이에요. main에 있는 문서가 가장 최신의 공식 버전이에요.

pull이란?

다른 사람이 올린 최신 변경사항을 내 컴퓨터에 내려받는 것이에요.

Google Drive에서는 누군가 파일을 수정하면 자동으로 내 화면에도 반영되죠?
Git은 다르게 동작해요. 내가 직접 **"가져와!"**라고 명령해야 최신 내용이 내 컴퓨터에 반영돼요.
이 "가져와!" 명령이 바로 pull이에요.

언제 pull을 해야 하나요?

Vault에서 문서를 열기 전에 항상 pull을 먼저 해주세요!

pull을 하지 않으면 다른 사람이 이미 업데이트한 내용을 보지 못하고, 예전 버전의 문서를 보게 될 수 있어요.

macOS

iTerm(터미널)을 열어요.
Vault 폴더로 이동해요.

1cd ~/Documents/sokind-knowledge-vault

아래 명령어를 입력하고 Enter를 눌러요.

1git pull

Windows

명령 프롬프트를 열어요.
Vault 폴더로 이동해요.

1cd %USERPROFILE%\Documents\sokind-knowledge-vault

아래 명령어를 입력하고 Enter를 눌러요.

1git pull

혹시 Vault 폴더를 다른 곳에 내려받았다면, cd 뒤의 경로를 실제 저장 위치로 바꿔주세요.