Git 저장소를 새로 만들거나 기존 프로젝트를 다른 원격 저장소에 연결하려고 할 때, git remote add origin [주소] 명령어를 입력했는데 "remote origin already exists" 오류가 뜨는 경우가 있습니다. 이 오류는 이름 그대로 이미 origin이라는 원격 저장소 연결이 설정되어 있어서 새로 추가할 수 없다는 뜻입니다. 해결 방법은 간단합니다. 기존 연결을 끊고 다시 추가하면 되는데, 실제로 해보면 10초면 충분합니다.
이 오류가 왜 발생할까
Git은 하나의 로컬 저장소에 여러 개의 원격 저장소를 연결할 수 있지만, 기본 원격 저장소를 가리키는 이름인 origin은 하나만 존재할 수 있습니다. 프로젝트를 클론(clone) 받았거나 이전에 이미 git remote add origin 명령어를 실행한 적이 있다면, 같은 이름으로 또 추가하려고 할 때 이 오류가 발생합니다.
흔히 발생하는 상황은 다음과 같습니다.
- GitHub에서 새 저장소를 만들고 기존 로컬 폴더를 연결하려고 할 때
- 회사 저장소에서 개인 저장소로 원격 주소를 바꾸려고 할 때
- 이미 원격 연결이 된 프로젝트를 복사해서 다른 저장소에 올리려고 할 때
이 경우 기존 origin 연결을 제거하고 새로운 주소로 다시 추가하면 문제가 해결됩니다.
remote origin already exists 해결하는 실제 명령어
해결 과정은 크게 세 단계로 나뉩니다. 터미널(또는 명령 프롬프트)을 열고 프로젝트 폴더로 이동한 뒤 아래 명령어를 순서대로 입력하면 됩니다.
1. 기존 origin 연결 제거
git remote remove origin
이 명령어는 현재 로컬 저장소에 설정된 origin이라는 이름의 원격 저장소 연결을 삭제합니다. 만약 origin이 아닌 다른 이름으로 연결되어 있다면 git remote -v로 확인 후 해당 이름을 넣으면 됩니다.
2. 새로운 원격 저장소 추가
git remote add origin [새로운 레포지토리 주소]
여기서 [새로운 레포지토리 주소]는 GitHub에서 생성한 저장소의 URL을 입력합니다. HTTPS 주소와 SSH 주소 둘 다 사용 가능하지만, 처음 연결하는 경우라면 HTTPS 주소가 접근성이 좋습니다.
3. 연결 확인
git remote -v
이 명령어를 입력하면 현재 연결된 원격 저장소 목록이 출력됩니다. 방금 추가한 origin 주소가 정상적으로 표시되면 연결이 완료된 것입니다.
이후 코드를 푸시할 때는 git push -u origin master(또는 main) 명령어를 사용하면 됩니다. 참고로 최근 GitHub 기본 브랜치 이름은 main이므로, 프로젝트 생성 시 설정한 브랜치 이름에 맞춰 입력하는 것이 좋습니다.
연결을 끊지 않고 주소만 바꾸는 방법
git remote remove origin을 실행하면 기존 연결 정보가 완전히 삭제됩니다. 하지만 단순히 원격 저장소 주소만 변경하고 싶다면, 삭제 후 추가하는 대신 한 번에 주소를 바꾸는 명령어도 있습니다.
git remote set-url origin [새로운 레포지토리 주소]
이 명령어는 기존 origin 연결을 유지한 채 URL만 교체합니다. 연결 자체를 유지하면서 주소만 바꾸고 싶을 때 유용하며, remove와 add를 두 번 입력할 필요가 없어 더 빠르게 처리할 수 있습니다. 다만 원격 저장소 자체를 완전히 다른 곳으로 옮기는 경우라면 remove 후 add 방식이 더 확실합니다.
자주 묻는 질문
Q. git remote remove origin을 했는데 permission denied 오류가 나요
프로젝트 폴더에 쓰기 권한이 없거나 Git 저장소가 아닌 일반 폴더에서 명령어를 실행했을 가능성이 높습니다. git status 명령어로 Git 저장소인지 먼저 확인해 보세요.
Q. 브랜치 이름이 master가 아니라 main인데 어떻게 하나요
git push -u origin main처럼 본인이 사용하는 브랜치 이름을 입력하면 됩니다. 현재 브랜치 이름은 git branch로 확인할 수 있습니다.
Q. remote add 후에 로그인 창이 뜨는데 어떻게 하나요
GitHub 계정 인증을 요구하는 화면입니다. "Sign in with your browser" 버튼을 클릭해 브라우저에서 로그인하거나, 터미널에 사용자 이름과 토큰을 직접 입력하면 됩니다. 참고로 2021년 8월부터 GitHub는 비밀번호 인증을 지원하지 않으므로, Personal Access Token을 사용해야 합니다.
이 오류는 Git을 사용하면서 한 번쯤은 마주치는 흔한 상황입니다. 원격 저장소 연결 구조만 이해하고 있으면 명령어 두세 줄로 간단히 해결할 수 있으니, 당황하지 말고 위 방법을 순서대로 따라 해 보시기 바랍니다.