Cursor AI와 GitHub를 완벽하게 연동하는 7단계 가이드

 Cursor AI로 코딩을 시작하셨군요! 코드를 작성하는 것만큼 중요한 게 바로 '안전하게 보관하는 것'이죠. 공들여 만든 코드가 컴퓨터 고장으로 날아가거나, 이전 버전으로 되돌리고 싶을 때 대책이 없다면 정말 아찔할 거예요.

초보자분들도 막힘없이 따라 하실 수 있도록, Cursor AI와 GitHub를 완벽하게 연동하는 7단계 가이드를 SEO 최적화 버전으로 정리해 드립니다.

🚀 Cursor AI 코드를 GitHub에 저장해야 하는 이유

• 버전 관리: 실수로 코드를 망쳤을 때 언제든 과거로 돌아갈 수 있습니다.

• 동기화: 집, 카페, 사무실 어디서든 최신 코드를 불러와 작업할 수 있습니다.

• 협업: 다른 사람과 코드를 공유하고 함께 수정하기 편리합니다.

[1단계] GitHub 계정 생성 및 활성화

가장 먼저 코드를 담을 '온라인 창고' 계정이 필요합니다.

1. GitHub 홈페이지 접속 후 'Sign up' 클릭.

2. 이메일, 비밀번호, 사용자 이름(ID) 입력. (ID는 영문, 숫자, 하이픈만 가능!)

3. 입력한 이메일함에서 인증 메일을 확인하여 계정을 활성화합니다.

[2단계] 나만의 코드 저장소(Repository) 만들기

계정을 만들었다면 프로젝트를 담을 폴더(저장소)를 생성해야 합니다.

• New repository: 우측 상단 + 버튼 클릭 후 선택.

• Repository name: 프로젝트 성격에 맞는 이름 입력 (예: my-first-cursor-project).

• Public/Private: 남들에게 보여주기 싫다면 'Private'을 선택하세요.

• 중요: 초보자라면 README, .gitignore 등의 옵션은 체크하지 않은 빈 상태로 만드는 것이 충돌 방지에 좋습니다.

💡 팁: 저장소를 만든 후 화면에 나오는 HTTPS URL(https://github.com/아이디/저장소.git)을 미리 복사해 두세요!

[3단계] 내 컴퓨터에 Git 설치하기

GitHub는 웹 서비스고, Git은 내 컴퓨터에서 코드를 관리하는 실제 도구입니다.

• Windows: Git 공식 사이트에서 EXE 파일을 받아 설치하세요. (기본 설정으로 진행)

• macOS: 터미널을 열고 git --version을 입력하세요. 설치가 안 되어 있다면 xcode-select --install로 설치할 수 있습니다.

[4단계] 보안 인증을 위한 액세스 토큰(PAT) 발급

2021년부터 GitHub는 보안을 위해 비밀번호 대신 '개인 액세스 토큰'을 사용합니다. 이게 없으면 코드를 올릴 수 없으니 꼭 설정해야 합니다.

1. GitHub 상단 프로필 클릭 → Settings → Developer settings.

2. Personal access tokens → Tokens (classic) 선택.

3. Generate new token (classic) 클릭.

4. Note에 'Cursor-Token'이라 적고, 'repo' 항목에 체크합니다.

5. 생성된 토큰 문자열(ghp_...)을 반드시 복사해서 메모장에 저장하세요. (다시 볼 수 없습니다!)

[5단계] Cursor AI에서 저장소 불러오기 (Clone)

이제 Cursor AI 에디터와 GitHub를 연결할 차례입니다.

1. Cursor AI 실행 후 Ctrl + Shift + P (Mac은 Cmd + Shift + P) 입력.

2. "Git: Clone" 검색 후 선택.

3. 2단계에서 복사한 GitHub 저장소 URL을 붙여넣습니다.

4. 코드를 저장할 로컬 폴더를 지정하면 다운로드가 시작됩니다.

[6단계] 코드 작성 및 첫 번째 '커밋(Commit)'

'커밋'은 현재까지의 작업물을 로컬 저장소에 기록하는 행위입니다.

1. 파일을 수정하거나 새로 만듭니다 (예: main.py).

2. 왼쪽 '소스 제어(Source Control)' 아이콘(분기 모양)을 클릭합니다.

3. 변경 파일 옆의 + 아이콘을 눌러 '스테이징(Stage)' 상태로 만듭니다.

4. 상단 입력란에 커밋 메시지 (예: First Commit)를 적고 체크(✔) 버튼을 누릅니다.

[7단계] GitHub로 '푸시(Push)'하여 업로드 완료!

커밋은 내 컴퓨터에만 저장된 상태입니다. 이를 GitHub 웹사이트로 쏘아 올리는 것이 '푸시'입니다.

1. Cursor AI 하단 터미널( Ctrl + ` )을 엽니다.

2. 다음 명령어를 입력합니다:

   Bash

   git push origin main
   

3. 인증 창이 뜨면 사용자 이름과 4단계에서 만든 토큰을 비밀번호 칸에 입력하세요.

4. GitHub 사이트에서 새로고침을 하면 내 코드가 올라온 것을 확인할 수 있습니다! 🎉

📌 요약 및 주의사항