Git 처음 설정하기: 이름·이메일·기본 브랜치·SSH 키

Git을 설치하고 나면 바로 코드를 저장하고 싶어지지만, 그 전에 한 번만 해두면 두고두고 편한 설정이 있습니다. 바로 “나는 누구인가”를 Git에 알려주는 일입니다. Git은 변경 사항을 저장(커밋)할 때마다 누가 했는지를 함께 기록하기 때문에, 이 정보가 비어 있으면 경고가 뜨거나 커밋이 막힐 수 있습니다.

이 글에서는 설치 확인부터 이름·이메일·기본 브랜치 설정, 첫 저장소를 만드는 개념, 그리고 원격 저장소와 안전하게 연결하는 SSH 키 흐름까지 순서대로 짚어 봅니다.

먼저 Git이 설치됐는지 확인하기

설정에 들어가기 전에, Git이 제대로 깔렸는지부터 확인합니다.

git --version

버전 정보가 한 줄 출력되면 설치가 된 것입니다. 명령을 찾을 수 없다는 메시지가 나오면 아직 설치가 안 됐거나 경로 인식이 안 된 상태이니, 운영체제에 맞는 설치를 먼저 끝내야 합니다.

이름과 이메일 설정하기

Git은 커밋마다 작성자의 이름과 이메일을 함께 남깁니다. 아래 두 줄로 이 값을 정합니다.

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

따옴표 안의 값은 본인 것으로 바꾸면 됩니다. 잘 설정됐는지는 다음 명령으로 확인할 수 있습니다.

git config --global --list

—global이 뜻하는 것

위 명령에 붙은 --global은 “이 컴퓨터의 내 계정 전체에 적용한다”는 의미입니다. 한 번만 설정해 두면 이후 만드는 모든 저장소가 이 값을 기본으로 씁니다.

• --global 을 붙이면: 사용자 계정 전체의 기본값이 됩니다.
• --global 을 빼고 저장소 폴더 안에서 실행하면: 그 저장소에만 적용됩니다.

대부분의 입문자는 우선 --global로 한 번 정해 두는 것으로 충분합니다. 회사 계정과 개인 계정을 한 컴퓨터에서 나눠 써야 한다면, 그때 저장소별 설정을 따로 둘 수 있다는 점만 기억해 두면 됩니다.

기본 브랜치 이름 정하기

새 저장소를 만들면 첫 브랜치가 자동으로 생깁니다. 이 기본 브랜치의 이름을 미리 정해 둘 수 있습니다.

git config --global init.defaultBranch main

이렇게 해 두면 앞으로 만드는 저장소의 첫 브랜치가 main이라는 이름으로 시작합니다. 이름 자체는 취향과 협업 규칙에 따라 달라질 수 있으니, 함께 일하는 곳이 있다면 그쪽 관례를 따르는 편이 좋습니다.

첫 저장소 만들기 개념

설정을 마쳤다면 이제 실제 저장소를 만들 수 있습니다. 프로젝트로 쓸 폴더로 이동한 뒤 아래 명령을 실행합니다.

git init

이 명령은 현재 폴더를 Git이 관리하는 저장소로 바꿉니다. 이 순간부터 그 폴더 안의 변경 사항을 기록할 수 있게 되고, 앞서 정한 이름·이메일이 커밋에 함께 남게 됩니다. 변경을 기록으로 확정하는 것이 커밋이며, 처음엔 git add 로 기록할 파일을 고르고 git commit 으로 확정한다는 큰 흐름만 알아 두면 충분합니다.

SSH 키로 원격 저장소와 연결하기

코드를 GitHub 같은 원격 저장소에 올리려면, 내 컴퓨터가 그 서비스에 “나는 권한이 있는 사람”임을 증명해야 합니다. 이때 매번 비밀번호를 치는 대신, 더 안전하고 편한 방식이 SSH 키입니다.

SSH 키는 한 쌍이다

SSH 키는 항상 **비밀키(private)**와 공개키(public) 두 개가 한 쌍으로 만들어집니다.

• 비밀키 — 내 컴퓨터에만 두는 열쇠입니다. 절대 외부에 공유하면 안 됩니다.
• 공개키 — 원격 서비스에 등록하는, 공개해도 되는 자물쇠 짝입니다.

원격 서비스에 등록된 공개키와 내 비밀키가 한 쌍으로 맞을 때만 연결이 허용됩니다. 비밀번호를 주고받지 않으므로 더 안전합니다.

키 생성하기

키 한 쌍은 아래 명령으로 만듭니다.

ssh-keygen -t ed25519 -C "you@example.com"

-C 뒤의 값은 키를 알아보기 쉽게 적는 메모이며, 보통 이메일을 넣습니다. 명령을 실행하면 저장 위치와 암호 구문(passphrase)을 물어봅니다. 위치는 기본값을 그대로 써도 되고, 암호 구문은 키를 한 번 더 보호하는 비밀번호이니 정해 두면 더 안전합니다. ed25519 가 권장되는 방식이지만, 환경에 따라 다른 방식이 필요할 수도 있으니 애매하면 공식 문서를 확인하세요.

공개키를 원격 서비스에 등록하기

키를 만들면 보통 홈 폴더 아래 .ssh 폴더에 비밀키와 .pub 으로 끝나는 공개키가 생깁니다. 등록할 때는 공개키의 내용이 필요합니다.

cat ~/.ssh/id_ed25519.pub

이 명령으로 출력된 한 줄 전체를 복사한 뒤, 사용하는 원격 서비스의 설정 화면에서 “SSH 키 추가” 항목에 붙여 넣습니다. 등록 메뉴의 정확한 위치와 이름은 서비스마다 다르므로, 해당 서비스의 공식 문서를 확인하는 것을 권합니다. 핵심 흐름은 공개키만 등록하고 비밀키는 내 컴퓨터에 둔다는 것입니다.

초보자가 자주 막히는 부분

• 이름·이메일 없이 커밋 시도 — 설정을 건너뛰고 바로 커밋하면 작성자 정보가 없다는 경고가 나올 수 있습니다.
• 따옴표 빠뜨림 — 이름에 공백이 있는데 따옴표로 감싸지 않으면 값이 잘려 들어갈 수 있습니다.
• —global의 범위 오해 — --global은 폴더 단위가 아니라 사용자 계정 전체에 적용된다는 점을 헷갈리기 쉽습니다.
• 비밀키를 등록하려 함 — 원격 서비스에는 .pub 공개키만 등록합니다. 비밀키를 올리면 안 됩니다.
• 설정 확인을 안 함 — 값이 제대로 들어갔는지 git config --global --list로 한 번 확인하지 않아 오타를 늦게 발견하는 경우가 있습니다.

정리

Git의 첫 설정은 길어 보이지만 사실 명령 몇 줄로 끝납니다. 이름과 이메일을 정해 두면 커밋 기록이 깔끔하게 남고, 기본 브랜치 이름까지 미리 정해 두면 새 저장소를 만들 때마다 신경 쓸 일이 줄어듭니다. 여기에 SSH 키 한 쌍을 만들고 공개키만 원격 서비스에 등록해 두면, 비밀번호 없이도 안전하게 코드를 주고받을 수 있습니다. 한 번 해두면 오래가는 설정이니, 코드를 본격적으로 다루기 전에 마무리해 두는 것을 권합니다.