깃허브 사용법, 비개발자가 소스코드 받는 순서와 용어표
깃허브 사용법을 비개발자 기준으로 정리했습니다. 저장소 · 커밋 · 풀 리퀘스트 등 용어 8개, 회사 조직 계정에 저장소를 만들고 개발사를 초대하는 순서, 권한 단계표, 납품 확인 항목 8개, 일이 끝난 뒤 권한 정리 순서를 담았습니다.

깃허브 사용법을 비개발자 기준으로 줄이면 세 가지입니다 — 소스코드를 보관하는 저장소, 누가 언제 무엇을 고쳤는지 남는 수정 기록, 누가 보고 고칠 수 있는지 정하는 권한입니다. 외주 개발이라면 회사 이름의 조직(Organization) 계정에 저장소를 만들고 개발사를 외부 협업자로 초대해 두면, 납품과 인수인계 때 저장소를 옮길 필요 없이 권한만 정리하면 됩니다. 깃허브(GitHub)는 깃(Git)이라는 수정 기록 도구로 만든 기록을 온라인에 올려 여러 사람이 함께 쓰는 서비스입니다.
깃허브 사용법, 비개발자는 어떤 용어부터 알면 되나요
개발사와 이야기할 때 자주 나오는 용어 여덟 개입니다.
| 용어 | 뜻 | 비개발자가 쓰는 때 |
|---|---|---|
| 저장소(Repository) | 프로젝트 하나의 코드와 수정 기록을 담는 보관함 | 납품물을 받을 곳을 정할 때 |
| 커밋(Commit) | 수정 한 번을 기록한 단위, 날짜 · 작성자 · 설명이 붙음 | 무엇이 언제 바뀌었는지 볼 때 |
| 브랜치(Branch) | 본래 코드에서 갈라져 따로 작업하는 갈래 | 기능별 작업이 어디까지 왔는지 볼 때 |
| 풀 리퀘스트(Pull request) | 브랜치의 수정을 본래 코드에 합쳐 달라는 요청, 검토 의견이 함께 남음 | 수정 내용을 확인하고 의견을 남길 때 |
| 이슈(Issue) | 할 일 · 오류 · 요청을 적는 게시물, 번호가 붙음 | 수정 요청을 번호로 관리할 때 |
| 릴리스(Release) · 태그(Tag) | 특정 시점의 코드에 붙인 이름표와 그 묶음 | 납품 시점을 v1.0처럼 남길 때 |
| 조직(Organization) | 여러 사람이 저장소를 함께 소유 · 관리하는 단체 계정 | 저장소를 회사 소유로 만들 때 |
| 외부 협업자(Outside collaborator) | 조직 구성원은 아니지만 일부 저장소에 접근하는 사람 | 개발사를 초대할 때 |
회사 소유 저장소는 어떤 순서로 만드나요
- 회사 메일로 계정 만들기 — 조직은 개인 계정에서 만들므로, 담당자 계정을 회사 메일로 만들고 2단계 인증을 켭니다.
- 조직 만들기 — 오른쪽 위 프로필 사진 → Settings → Organizations → New organization 순서로 만듭니다. 무료 요금제로도 비공개 저장소를 개수 제한 없이 만들 수 있습니다.
- 소유자 두 명 지정 — 깃허브 문서는 조직 소유자(Owner)를 최소한으로 두되 두 명보다 적게 두지 않도록 권합니다. 담당자 한 명이 자리를 비워도 관리가 이어집니다.
- 비공개 저장소 만들기 — 조직 아래에 Private으로 만듭니다. 주소가 github.com/(조직 이름)/(저장소 이름) 모양이면 회사 소유입니다.
- 개발사 초대 — 개발사 인원을 저장소별 외부 협업자로 초대하고 아래 표의 권한을 고릅니다. 조직이 2단계 인증을 요구하면 외부 협업자도 2단계 인증을 켜야 초대를 수락할 수 있습니다.
- 개발사 계정에 이미 저장소가 있다면 이전 — 저장소를 조직으로 옮기면(Transfer) 이슈 · 풀 리퀘스트 · 위키가 함께 옮겨지고 커밋 기록도 유지됩니다. 옮기는 사람은 대상 조직에서 저장소를 만들 권한이 있어야 하고, 원래 소유자는 옮겨진 저장소에 협업자로 추가되므로 이전 뒤 권한을 다시 정합니다.
| 권한 | 할 수 있는 일 | 맞는 사람 |
|---|---|---|
| Read | 코드 보기 · 내려받기, 이슈 열기 | 검수 · 기획 담당 |
| Triage | 이슈 · 풀 리퀘스트 정리, 코드 수정은 못 함 | 일정 · 요청 관리 담당 |
| Write | 코드 올리기, 풀 리퀘스트 승인 | 개발사 개발자 |
| Maintain | 민감하거나 되돌리기 어려운 작업을 뺀 저장소 관리 | 개발사 책임자 |
| Admin | 보안 설정 · 저장소 삭제 · 접근 권한 관리까지 전부 | 회사 담당자 |
조직 소유자는 조직의 모든 저장소에 Admin 권한을 갖습니다. 개발사에는 Write나 Maintain을 주고, 사람을 들이고 내보내는 Admin은 회사 쪽에 둡니다.
납품 때 깃허브에서 무엇을 확인하나요
납품 확인은 깃허브 사용법 가운데 비개발자가 직접 하는 일입니다. 아래 여덟 가지는 저장소 화면의 메뉴만 열어 보면 확인할 수 있습니다.
| 확인 항목 | 어디서 보나 | 기준 |
|---|---|---|
| 1. 저장소 소유 | 저장소 주소 앞부분 | 회사 조직 이름 |
| 2. 최신 코드 합침 | Pull requests 메뉴 | 납품 범위의 풀 리퀘스트가 모두 합쳐짐(Merged) |
| 3. 납품 시점 표시 | Releases · Tags | v1.0 같은 릴리스가 납품일에 만들어짐 |
| 4. 설치 · 실행 방법 | 저장소 첫 화면의 README | 다른 개발자가 따라 하면 실행되는 순서 |
| 5. 설정 값 목록 | README 또는 별도 문서 | 서버 주소 · 외부 서비스 키 같은 설정의 이름 목록, 실제 값은 저장소 밖에서 따로 전달 |
| 6. 수정 기록 | Commits 메뉴 | 개발 기간의 커밋 기록이 남아 있음 |
| 7. 외부 라이브러리 | 패키지 목록 파일 | 쓴 라이브러리 이름과 라이선스 목록 |
| 8. 남은 일 | Issues 메뉴 | 열린 이슈가 하자보수와 다음 개발로 나뉘어 있음 |
소스코드 권리를 누구에게 두는지는 소프트웨어 개발 계약서 글에서 정리했습니다. 깃허브는 그 조항을 실제로 이행하는 자리라, 계약서에 "납품은 회사 조직 저장소에 릴리스로 남긴다"처럼 한 문장을 넣어 두면 검수 기준이 하나로 정해집니다.
개발사와 일이 끝나면 권한은 어떻게 정리하나요
같은 개발사가 유지보수를 이어서 맡으면 권한을 그대로 두고, 끝나면 아래 순서로 정리합니다. 정리 시점은 유지보수 범위를 정할 때 함께 적어 두세요.
- 외부 협업자 권한 낮추기 · 해제 — 저장소 설정의 접근 관리 화면에서 Write를 Read로 낮추거나 해제합니다.
- 배포 키 확인 — 배포 키(deploy key)는 저장소에 붙이는 접속 열쇠입니다. 깃허브 문서는 그 개인 키를 가진 사람이 조직에서 빠진 뒤에도 저장소를 읽거나 쓸 수 있다고 안내하므로, 쓰지 않는 키는 지웁니다.
- 시크릿 · 웹훅 점검 — 저장소에 넣어 둔 비밀 값(시크릿)과 다른 서비스로 알림을 보내는 웹훅은 저장소를 옮긴 뒤에도 그대로 남습니다. 목록을 열어 지금 쓰는 것만 남깁니다.
- 깃허브 밖의 열쇠 교체 — 서버 · 클라우드 · 외부 서비스의 비밀번호와 키는 깃허브 권한과 별개이므로, 개발사가 쓰던 값은 새로 바꿉니다.
자주 묻는 질문
깃허브는 유료인가요?
개인 계정과 조직 모두 무료 요금제가 있습니다. 무료 조직은 협업자 수와 비공개 저장소 개수에 제한이 없지만 비공개 저장소에서는 일부 기능만 쓸 수 있고, 보호 브랜치 · 필수 리뷰어 같은 기능은 유료 요금제(GitHub Team)에서 비공개 저장소에 쓸 수 있습니다. 유료 요금제에서는 비공개 저장소의 외부 협업자도 유료 사용자 수에 들어갑니다. 금액은 깃허브 요금 안내에서 확인하세요 — 공식 안내 기준이며 바뀔 수 있습니다.
압축 파일로만 받아도 되나요?
받을 수는 있지만 커밋 기록이 빠져, 어떤 수정이 언제 왜 들어갔는지 나중에 찾을 수 없습니다. 저장소로 받으면 다음 개발사가 이어받을 때도 기록을 그대로 넘길 수 있습니다.
개발을 모르는데 커밋 기록을 어떻게 보나요?
저장소 화면의 커밋 목록에서 날짜 · 작성자 · 설명을 읽으면 됩니다. 커밋 설명에 이슈 번호를 넣기로 개발사와 정해 두면, 요청 하나에 어떤 수정이 붙었는지 번호로 이어서 볼 수 있습니다.
개발사가 깃랩 같은 다른 서비스를 쓰면 어떻게 하나요?
서비스 이름이 달라도 원칙은 같습니다 — 회사 계정이 저장소를 소유하고, 개발사는 초대받아 일하고, 납품 시점을 태그로 남기고, 일이 끝나면 권한을 정리합니다. 메뉴 이름과 요금은 그 서비스의 공식 문서로 확인하세요.
오늘 할 일
회사 메일로 깃허브 조직을 하나 만들고 소유자 두 명을 지정하세요.
이어서 읽기 — 오픈소스 라이선스, 상업 사용 비교표와 납품 때 받을 것



