Git remote 삭제 연결된 원격 저장소 끊고 새로운 주소 등록하기를 주제로 하나씩 따라 하면서 해보겠습니다. 기존 원격 저장소와의 연결을 깔끔하게 끊고 새 주소를 바로 등록하는 방법, 어렵지 않아요!
왜 원격 저장소 연결을 삭제하고 새로 등록해야 할까요?
프로젝트를 다른 위치로 옮기거나 깃허브 계정을 새로 바꿀 때, 기존 연결이 꼬여서 push가 잘 안 되는 경우가 많습니다. 이럴 때 기존 커밋 기록은 그대로 두고 원격 연결만 새로 연결하면 훨씬 깔끔하게 해결할 수 있어요. .git 폴더를 건드리지 않아도 돼서 커밋 내역 걱정도 덜고, 저장소 주소 변경할 때 아주 편리합니다.
먼저 현재 원격 저장소 주소는 어떻게 확인하나요?
터미널에서 작업하시는 프로젝트 폴더로 가신 다음 git remote -v 명령어를 입력해 보세요. 그럼 origin 같은 이름으로 연결된 원격 주소가 fetch와 push 모두 보여집니다. 아무것도 안 나오면 원격 연결이 없는 상태입니다.
| 명령어 | 결과 예시 |
|---|---|
git remote -v |
origin https://github.com/olduser/oldrepo.git (fetch) origin https://github.com/olduser/oldrepo.git (push) |
SSH 쓰는 경우는 git@github.com:olduser/oldrepo.git 같은 형식으로 나오니 참고하세요.
기존 Git remote는 어떻게 삭제하나요?
원격 저장소와의 연결을 끊으려면 git remote remove origin 또는 git remote rm origin 명령어를 쓰면 됩니다. 여기서 origin은 연결된 이름에 따라 달라질 수 있어요. 이렇게 하면 로컬에 등록된 원격 주소만 삭제되고 실제 저장소는 건드리지 않으니 걱정 안 하셔도 됩니다.
주의! 원격 추적 브랜치 정보도 같이 삭제되니, 나중에 다시 git push -u origin main 같은 업스트림 설정을 해주셔야 합니다.
다시 git remote -v를 쳐서 아무것도 나오지 않으면 삭제가 성공한 거예요. 커밋 내역은 건드리지 않습니다.
새로운 원격 저장소 주소 등록은 어떻게 해야 하나요?
새 GitHub 저장소를 만들었다면, 복사한 주소를 통해 git remote add origin https://github.com/newuser/newrepo.git 같이 입력해 주세요. SSH 주소면 git@github.com:newuser/newrepo.git 형식도 가능합니다.
| 주소 방식 | 명령어 예 |
|---|---|
| HTTPS | git remote add origin https://github.com/newuser/newrepo.git |
| SSH | git remote add origin git@github.com:newuser/newrepo.git |
다시 git remote -v로 등록된 새 주소가 제대로 나오는지 확인하면 완료입니다.
삭제 없이 바로 원격 주소를 변경할 수도 있나요?
네, git remote set-url origin https://github.com/newuser/newrepo.git 명령어를 쓰면 기존 등록된 이름(origin)을 유지하면서 주소를 바로 바꿀 수 있습니다. 깔끔하고 빠르게 바꾸고 싶을 때 유용해요. 확인은 항상 git remote -v로 하시면 됩니다.
새 연결 후에는 어떻게 테스트하나요?
주소 변경이 끝나고 나면 git push -u origin main (혹은 master 브랜치)로 첫 푸시를 해 보세요. -u 옵션은 최초 업스트림을 설정해 다음부터는 간단히 git push로 가능합니다. 만약 인증 에러가 뜬다면 토큰이나 SSH 키 설정을 점검해 주세요.
그리고 git pull origin main으로 원격 저장소 데이터를 잘 받아오는지도 확인하면 안심이고요.
실제로 이런 과정을 언제 써볼까요?
예를 들어, 구글에서 만든 저장소를 GitHub로 옮길 때 이 과정을 거치면 됩니다. 기존 원격 삭제 후 새 저장소 생성 → 새 주소 등록 → 푸시. 이렇게 하면 100개가 넘는 커밋도 걱정 없이 그대로 옮겨집니다. 이름을 바꿀 때는 git remote rename origin upstream 명령도 활용할 수 있어요. 여러 저장소를 한 프로젝트에서 관리할 때 특히 편리합니다.
자주 겪는 실수와 해결 팁은 무엇인가요?
- “remote origin already exists” 오류: 기존 원격을 먼저 삭제하세요.
- 푸시가 거부될 때: 새 저장소가 빈 상태여야 하고,
git push -u origin main명령을 쓰세요. - 브랜치 이름 안 맞을 때:
git branch -M main으로 변경 후 푸시하세요. - 권한 문제: 새 토큰을 만들거나 SSH 키를 다시 등록하세요.
이 몇 가지만 숙지해도 대부분 문제를 금방 해결할 수 있습니다.
Git remote 삭제 연결된 원격 저장소 끊고 새로운 주소 등록하기 1분 Q&A
git remote 삭제 명령어가 뭐예요?
git remote remove origin 또는 git remote rm origin 이요.
새 주소 등록은 어떻게 하나요?
git remote add origin 새 URL 치면 돼요.
삭제 없이 주소만 바꿀 수 있나요?
네, git remote set-url origin 새 URL 써요.
이 순서대로 해 보시면 Git remote 삭제 연결된 원격 저장소 끊고 새로운 주소 등록하기가 전혀 어렵지 않으실 거예요. 직접 해 보시고 궁금한 점 있으면 댓글 남겨 주세요!