Git을 사용하다 보면 처음 프로젝트를 올릴 때 git remote add origin 저장소주소 명령어를 입력하는데, 이때 "error: remote origin already exists" 오류가 뜨는 경우가 있습니다. 이미 origin이라는 이름으로 원격 저장소가 연결되어 있는데 새로 추가하려고 해서 생기는 문제입니다. 이 오류는 명령어 하나로 간단히 해결할 수 있는데, 기존 연결을 끊고 다시 추가하면 됩니다.
remote origin already exists 오류가 나는 이유
로컬 Git 저장소에 이미 원격 저장소가 등록되어 있는데, 같은 이름(origin)으로 다른 저장소를 추가하려고 할 때 이 오류가 발생합니다. Git은 기본적으로 origin이라는 이름의 원격 저장소를 하나만 허용하기 때문입니다.
이런 상황은 보통 두 가지 경우에 자주 생깁니다.
- 이미 GitHub에서 저장소를 만들어 로컬과 연결해 둔 상태에서, 새로 만든 저장소로 변경하려고 할 때
- 다른 사람의 프로젝트를 클론(clone) 받은 뒤, 그 저장소를 자신의 GitHub 저장소로 바꿔서 푸시하려고 할 때
기존 원격 저장소 연결 해제하기
오류를 해결하려면 먼저 기존에 연결된 origin을 제거해야 합니다. 터미널(또는 명령 프롬프트)에서 다음 명령어를 입력합니다.
git remote remove origin
입력 후 git remote -v 명령어로 현재 연결된 원격 저장소가 없는지 확인할 수 있습니다. 아무것도 출력되지 않으면 연결이 정상적으로 해제된 것입니다.
새 원격 저장소 추가하고 푸시하기
연결을 해제했으면 이제 새로 연결할 GitHub 저장소 주소를 추가합니다. GitHub 저장소 페이지에서 주소를 복사한 뒤 아래 명령어를 실행합니다.
git remote add origin https://github.com/사용자이름/저장소이름.git
추가가 완료되면 git remote -v로 다시 한번 확인해 보세요. origin이 새 주소로 연결된 것을 볼 수 있습니다.
이제 소스 코드를 푸시하면 됩니다.
git push -u origin master
브랜치 이름이 master가 아닌 main이라면 git push -u origin main으로 입력하면 됩니다. 푸시 과정에서 GitHub 로그인 창이 뜰 수 있는데, 브라우저에서 인증하거나 토큰을 입력하면 정상적으로 진행됩니다.
origin을 유지한 채 다른 이름으로 추가하는 방법
상황에 따라 기존 origin 연결을 유지하면서 다른 원격 저장소를 추가하고 싶을 수도 있습니다. 이때는 origin이 아닌 다른 이름으로 추가하면 됩니다.
git remote add upstream https://github.com/다른저장소주소.git
이렇게 하면 기존 origin과 별개로 upstream이라는 이름의 원격 저장소가 추가됩니다. 여러 원격 저장소를 동시에 운영해야 할 때 유용한 방법입니다.
Q. git remote remove origin 명령어를 입력해도 오류가 나요
원격 저장소가 실제로 존재하지 않는데 삭제를 시도하면 "error: could not remove config section 'remote.origin'" 같은 메시지가 나올 수 있습니다. 이 경우 git remote -v로 현재 연결 상태를 먼저 확인해 보세요. 아무것도 없다면 이미 연결이 해제된 상태이므로 바로 새 저장소를 추가하면 됩니다.
Q. git push 할 때 로그인하라는 창이 계속 떠요
GitHub에서 비밀번호 인증 방식을 더 이상 지원하지 않아서 생기는 문제입니다. Personal Access Token을 발급받아 비밀번호 자리에 입력하거나, GitHub CLI를 이용해 인증하면 해결됩니다. 저장소 주소를 HTTPS 대신 SSH 방식으로 바꿔서 연결하는 방법도 있습니다.
Q. 클론 받은 프로젝트인데 이 방법을 써도 되나요
네, 클론 받은 저장소도 같은 방식으로 해결할 수 있습니다. 클론 받은 프로젝트는 보통 origin이 원본 저장소로 이미 연결되어 있습니다. git remote remove origin으로 기존 연결을 끊은 뒤, 자신의 저장소 주소를 추가하면 됩니다.