여러 Git 계정을 내 디바이스에서 사용해야 할 때

Git 계정을 추가하는 방법

나는 Git 계정을 두 개 쓴다. 하나는 업무용이고, 다른 하나는 개인용이다. 여러 Git 계정을 내 디바이스에서 사용해야 할 때, 계정을 추가하는 방법은 쉽다.

[키 생성 → SSH 등록 → Config 설정] 이라는 세 가지 단계만 밟으면 된다.

1. 키 생성

# 1. 키 생성 (이메일 주소 변경 / 파일명 구분 필수)
ssh-keygen -t ed25519 -C "your-email@example.com" -f ~/.ssh/id_ed25519_new_account

# 2. 공개키(Public Key) 내용 복사 (macOS 기준)
pbcopy < ~/.ssh/id_ed25519_new_account.pub

2. SSH 등록

• 복사한 키를 [GitHub 로그인 → Settings → SSH and GPG keys → New SSH Key]에 붙여 넣는다.

3. Config 설정

# 1. ~/.ssh 로 이동 
cd ~/.ssh 

# 2. config 파일을 편집기로 열기 
vim config 

• 아래 형식을 참고해 새 계정을 추가한다.

# New GitHub Account
Host new-github.com # 앞으로 git clone/remote에 사용할 별칭
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_new_account
    IdentitiesOnly yes # 다른 키와 충돌 방지 (필수)

새 계정을 프로젝트에서 사용하는 방법

~/.ssh/config 파일에서 새 계정에 정의한 Git의 Host 별칭은 new-github.com 이므로, (1) 새로 클론할 때나 (2) 기존 프로젝트의 계정을 변경할 때 아래와 같이 사용할 수 있다.

1. 새로 클론할 때

git clone git@new-github.com:username/repo-name.git

2. 기존 프로젝트 계정을 변경할 때

git remote set-url origin git@new-github.com:username/repo-name.git

• 기존에 클론한 프로젝트가 있고 그 안에서 git push 했을 때 “Please make sure you have the correct access rights and the repository exists.” 같은 문구가 보인다면, 항상 git remote -v 로 원격 저장소 주소가 올바르게 지정되어 있는지 확인해야 한다.
• 올바른데 에러가 나는 경우에는 ssh -T git@new-github.com으로 SSH 연결과 키 작동 여부를 테스트 해보고, 사용해야 할 계정이 아니라면 ~/.ssh/config 파일에서 IdentitiesOnly 항목이 두 계정 모두에 할당되어 있는지 확인한다.

3. (옵션) 글로벌 계정과 꼬이지 않고 싶다면

• 로컬 커밋 작성자를 따로 격리하면 된다.
• 해당 프로젝트 안에서 이름과 이메을을 아래와 같이 수동으로 지정한다.

git config local user.name "New Name"
git config local user.email "your-email@example.com"