Git remote origin 변경 방법: 저장소 주소 바뀌었을 때 수정 순서

저장소 주소가 바뀌면 로컬 프로젝트의 origin URL도 함께 수정해야 합니다.

GitHub 저장소 이름을 바꾸거나, 개인 계정에서 조직 계정으로 옮기거나, HTTPS 주소를 SSH 주소로 바꾸면 로컬 프로젝트의 origin 주소가 예전 주소를 계속 바라볼 수 있습니다. 이 상태에서는 git pull, git fetch, git push가 실패하거나 엉뚱한 저장소로 연결될 수 있습니다.

해결 순서는 현재 주소 확인, 새 주소로 변경, 연결 테스트 순서로 보면 됩니다. 먼저 git remote -v로 기존 주소를 확인하고, git remote set-url origin 새주소로 바꾼 뒤, git fetch origin까지 실행해 실제로 연결되는지 확인합니다.

git remote -v
git remote set-url origin 새_저장소_URL
git remote -v
git fetch origin

Git remote origin 변경이 필요한 상황

origin은 보통 로컬 Git 저장소가 연결된 기본 원격 저장소 이름입니다. 저장소 주소가 바뀌었는데 로컬 설정을 수정하지 않으면 Git은 예전 주소로 계속 접근합니다.

변경 전 먼저 확인할 명령어

바로 주소를 바꾸기 전에 현재 로컬 저장소가 어떤 원격 저장소를 바라보고 있는지 확인해야 합니다. 특히 회사 저장소, 개인 저장소, fork 저장소를 함께 쓰는 경우에는 이 단계가 중요합니다.

1. 현재 remote 목록 확인

git remote -v

예상 출력은 아래처럼 fetch와 push 주소가 함께 나옵니다.

origin  https://github.com/old-owner/old-repo.git (fetch)
origin  https://github.com/old-owner/old-repo.git (push)

2. 현재 브랜치와 변경 사항 확인

remote 주소를 바꾼다고 작업 파일이 삭제되지는 않습니다. 다만 다른 저장소로 잘못 push하지 않도록 현재 브랜치와 수정 상태는 먼저 확인해 두는 편이 좋습니다.

git branch --show-current
git status

git status에서 수정 중인 파일이 많다면 먼저 커밋하거나, 의도한 변경인지 확인한 뒤 remote URL을 바꾸는 것이 좋습니다.

Git remote origin 주소 변경 순서

기존 origin이 이미 있고 주소만 바꾸는 상황이라면 git remote set-url을 사용합니다. 저장소를 다시 clone할 필요는 없습니다.

1. HTTPS 주소로 변경

git remote set-url origin https://github.com/OWNER/REPOSITORY.git

예를 들어 저장소가 old-owner/old-repo에서 new-owner/new-repo로 옮겨졌다면 아래처럼 주소만 새 저장소 기준으로 바꾸면 됩니다.

git remote set-url origin https://github.com/new-owner/new-repo.git

2. SSH 주소로 변경

git remote set-url origin git@github.com:OWNER/REPOSITORY.git

SSH 주소로 바꾸면 비밀번호 대신 SSH 키를 기준으로 인증합니다. SSH 키가 등록되어 있지 않으면 Permission denied (publickey) 오류가 날 수 있습니다.

3. 변경 결과 확인

git remote -v

출력에서 origin의 fetch와 push 주소가 새 저장소 주소로 바뀌었는지 확인합니다.

origin  https://github.com/new-owner/new-repo.git (fetch)
origin  https://github.com/new-owner/new-repo.git (push)

변경 후 fetch와 push까지 확인하기

URL만 바뀌었다고 끝내기보다 실제로 새 저장소와 통신되는지 확인해야 합니다. 가장 먼저 fetch로 원격 브랜치 정보를 받아옵니다.

git fetch origin

에러가 없다면 현재 브랜치가 원격 브랜치와 잘 연결되어 있는지 확인합니다.

git branch -vv

새 저장소에 처음 push하는 브랜치라면 아래처럼 upstream을 함께 지정할 수 있습니다.

git push -u origin main

기본 브랜치가 master인 저장소라면 main 대신 master를 사용합니다. 현재 브랜치 이름은 git branch --show-current로 먼저 확인하면 됩니다.

주소를 바꾼 뒤에는 git remote -v와 git fetch origin으로 실제 연결 여부를 확인합니다.

자주 나오는 오류와 해결 방법

fatal: No such remote 'origin'

이 오류는 수정하려는 origin이라는 remote 이름이 없을 때 발생합니다. 이 경우에는 set-url이 아니라 add로 새 remote를 추가해야 합니다.

git remote add origin https://github.com/OWNER/REPOSITORY.git
git remote -v

Repository not found

주소가 틀렸거나, 저장소 권한이 없거나, private 저장소 인증이 실패했을 때 나올 수 있습니다. GitHub의 저장소 페이지에서 Code 버튼을 눌러 HTTPS 또는 SSH 주소를 다시 복사한 뒤 바꾸는 것이 안전합니다.

git remote set-url origin 복사한_새_URL
git fetch origin

Permission denied (publickey)

SSH 주소로 바꾼 직후 이 오류가 나온다면 remote URL보다 SSH 인증 설정을 먼저 봐야 합니다. SSH 키가 생성되어 있는지, GitHub 계정에 등록되어 있는지, 여러 계정을 쓴다면 ~/.ssh/config가 맞는지 확인합니다.

push는 다른 곳으로 보내고 싶을 때

일반적으로 fetch와 push 주소는 같은 저장소를 가리키는 것이 이해하기 쉽습니다. 다만 특별한 배포 흐름에서는 push URL만 따로 지정할 수 있습니다.

git remote get-url origin
git remote get-url --push origin

git remote set-url --push origin git@github.com:OWNER/REPOSITORY.git

초보자라면 fetch와 push 주소를 다르게 두기보다 origin과 upstream을 분리하는 방식이 더 안전합니다.

Windows, Mac, Linux에서 다른 점

Git remote URL을 바꾸는 명령어 자체는 Windows, Mac, Linux에서 거의 같습니다. 차이는 터미널 환경과 인증 방식에서 주로 발생합니다.

VSCode에서 Git 작업을 주로 한다면 터미널에서 먼저 remote URL을 바꾼 뒤 VSCode의 Source Control 화면을 새로고침하면 됩니다. Git 기본 작업 흐름이 헷갈린다면 VSCode Git 커밋·푸시·브랜치 기본 흐름을 함께 확인하면 좋습니다.

실수 방지 체크리스트

공식 자료로 더 확인하기

기본 변경은 set-url 하나로 끝나지만, push URL 분리나 HTTPS·SSH 전환이 들어가면 옵션을 잘못 쓰기 쉽습니다. 세부 옵션은 Git과 GitHub 공식 문서에서 한 번 더 확인해 두면 좋습니다.

함께 보면 좋은 글

자주 묻는 질문

Git remote origin을 바꿀 때는 새 주소 입력보다 변경 전 주소 확인과 변경 후 연결 테스트가 더 중요합니다.