Cursor에서 GitHub에 최초로 커밋 & 푸시하는 방법
Cursor(커서)는 VS Code 기반의 AI 코드 에디터로, GitHub 연동 또한 매우 자연스럽습니다. 이 글에서는 로컬 프로젝트를 Cursor에서 GitHub 저장소에 최초로 커밋하고 푸시하는 전체 과정을 초보자도 그대로 따라 할 수 있도록 정리했습니다.
1️⃣ Cursor에서 프로젝트 열기
- Cursor 실행
- File → Open Folder
- GitHub에 올릴 프로젝트 루트 폴더 선택
2️⃣ Git 초기화 (최초 1회)
Cursor 터미널을 열고 아래 명령어를 실행합니다.
git init이 명령어를 실행하면 .git 디렉터리가 생성되며, 해당 프로젝트가 Git 관리 대상이 됩니다.
3️⃣ .gitignore 파일 생성 (강력 추천)
루트 디렉터리에 .gitignore 파일을 생성합니다.
# Python
__pycache__/
*.pyc
.venv/
.env
# Node
node_modules/
# OS
.DS_Store
Thumbs.db
# IDE
.vscode/
.idea/
불필요한 파일을 커밋하지 않기 위해 반드시 설정하는 것이 좋습니다.
4️⃣ GitHub에서 원격 저장소 생성
- GitHub 접속
- New repository 클릭
- Repository name 입력
- Initialize with README / .gitignore / License 체크 ❌
- Create repository
생성 후 제공되는 저장소 주소를 복사합니다.
https://github.com/계정명/저장소명.git
5️⃣ 원격 저장소 연결
git remote add origin https://github.com/계정명/저장소명.git
정상 연결 여부 확인:
git remote -v6️⃣ 첫 커밋 생성
변경 파일 확인
git status전체 파일 스테이징
git add .커밋 생성
git commit -m "initial commit"7️⃣ 브랜치 이름 main으로 설정
GitHub 기본 브랜치는 main 이므로 아래 명령을 실행합니다.
git branch -M main8️⃣ GitHub로 최초 푸시
git push -u origin main
-u 옵션은 최초 1회만 필요하며, 이후부터는 git push 만으로 푸시가 가능합니다.
9️⃣ GitHub 인증 오류 해결 방법
❌ 비밀번호 로그인 불가
GitHub는 비밀번호 인증을 더 이상 지원하지 않습니다.
✅ 방법 1: Personal Access Token (권장)
- GitHub → Settings → Developer settings
- Personal access tokens (classic)
- repo 권한 체크
- 토큰 생성 및 복사
로그인 시:
- Username: GitHub 아이디
- Password: 생성한 토큰
✅ 방법 2: SSH 방식 (개발자 추천)
ssh-keygen -t ed25519
cat ~/.ssh/id_ed25519.pub
출력된 키를 GitHub → SSH Keys에 등록 후 remote 주소 변경:
git remote set-url origin git@github.com:계정명/저장소명.git
🔥 Cursor에서 Git GUI 사용 팁
- 좌측 Source Control (Git 아이콘) 클릭
- 변경 파일 확인
- 커밋 메시지 입력
- Commit / Push 버튼으로 작업 가능
단, 최초 설정은 터미널 방식이 가장 안정적입니다.
✅ 전체 명령어 요약
git init
git add .
git commit -m "initial commit"
git branch -M main
git remote add origin https://github.com/계정명/저장소명.git
git push -u origin main
이제 Cursor에서 GitHub 연동을 완료했습니다 🎉 다음 단계로는 브랜치 전략, 자동 커밋, PR 생성까지 확장할 수 있습니다.