코드 파일을 고친 뒤 어떤 파일을 커밋할지 헷갈린다면 Lazygit에서 변경 내용부터 확인해 보세요. Git 저장소를 터미널 화면의 파일·브랜치·커밋 영역으로 보여 주고, 선택한 변경 사항을 스테이징해 커밋과 푸시까지 이어갈 수 있습니다. Windows용 무료 ZIP은 제작자 GitHub의 0.66.0 릴리스에서 받을 수 있습니다.
이 글은 Windows x64 파일을 기준으로 설치부터 첫 커밋까지 설명합니다. Lazygit은 Git을 대신 설치해 주는 프로그램이 아닙니다. PC에 Git이 있고, 작업할 폴더가 Git 저장소여야 화면에 변경 파일이 나타납니다.
Lazygit은 어떤 프로그램인가요?
Lazygit은 마우스로 창을 옮겨 다니는 일반 데스크톱 앱이 아니라 터미널 안에서 열리는 Git 화면입니다. 왼쪽에서 파일·브랜치·커밋 목록을 고르고, 오른쪽에서 선택한 항목의 차이를 확인합니다. 여러 파일을 한꺼번에 추가하기 전에 실제 수정된 줄을 보고 결정할 수 있다는 점이 편합니다.
특히 한 파일에는 필요한 수정과 아직 정리하지 못한 수정이 섞여 있을 수 있습니다. 파일 전체가 아닌 일부 변경을 골라 스테이징하거나, 커밋 기록과 현재 브랜치를 확인하는 흐름에 잘 맞습니다. 0.66.0 릴리스는 변경 내용 영역에서 hunk와 줄을 직접 선택하는 방식으로 바뀌었으므로 오래된 데모와 일부 화면 배치가 다를 수 있습니다.
변경 파일, 커밋 입력과 푸시 화면
제작자 GitHub 저장소의 공식 데모에서 가져온 실제 터미널 화면입니다. 파일 목록과 변경 내용, 커밋 입력 및 푸시 진행을 볼 수 있습니다. 데모는 이전 UI이므로 0.66.0에서는 변경 내용 선택 위치가 다를 수 있습니다.
| 제품 | Lazygit |
| 제작 | Lazygit 프로젝트 |
| 배포 | GitHub 공식 릴리스 |
| 대상 | Windows x64 ZIP |
| 조건 | Git 설치·저장소 폴더 |
설치 전에 Git과 저장소부터 확인하기
Lazygit을 열기 전에 Git이 PC에 설치돼 있는지 확인하세요. 터미널에서 git version을 입력하면 Git 명령을 사용할 수 있는지 알 수 있습니다. 버전이 나오지 않는다면 Git을 먼저 설치해야 합니다. Windows x64용 Lazygit ZIP만 받아서는 Git 명령 자체가 생기지 않습니다.
기존 프로젝트라면 .git 폴더가 있는 저장소에서 시작하세요. 새 폴더라면 Git 저장소로 만든 뒤 파일을 추가해야 Files에 변경 내용이 보입니다. 일반 폴더의 문서를 여는 파일 관리 프로그램처럼 쓰는 도구는 아니므로, 실행 위치가 가장 먼저 확인할 부분입니다.
- 터미널에서 git version으로 Git 사용 여부를 확인합니다.
- 작업할 Git 저장소 폴더를 정합니다.
- 저장소 폴더에서 Lazygit을 실행할 준비를 합니다.
Windows x64 ZIP을 받아 실행하기
제작자 GitHub의 v0.66.0 릴리스에는 운영체제와 CPU 종류별 압축 파일이 따로 있습니다. Windows 64비트 PC에서는 lazygit_0.66.0_windows_x86_64.zip을 고르세요. arm64 또는 32-bit 파일과 이름이 비슷하니 마지막 부분까지 확인하는 편이 좋습니다. 이 ZIP은 무료 공개 파일이며 MSI 설치 마법사를 여는 형식이 아닙니다.
압축을 별도 폴더에 풀고 Lazygit 실행 파일을 사용할 수 있게 둡니다. 매번 그 폴더로 이동해 실행하거나, 익숙하다면 실행 파일이 있는 폴더를 PATH에 추가할 수 있습니다. PATH를 바꿨다면 이미 열려 있던 터미널을 닫고 새로 열어야 명령이 잡힐 수 있습니다. Git 저장소 폴더로 이동한 다음 lazygit을 입력해 화면이 열리는지 확인하세요.
- v0.66.0 릴리스에서 windows_x86_64.zip을 고릅니다.
- ZIP을 별도 폴더에 압축 해제합니다.
- Git 저장소 폴더의 터미널에서 lazygit을 실행합니다.
수정 파일과 실제 변경 내용을 살펴보기
화면이 열리면 Files 영역에서 수정한 파일을 선택하세요. 파일 이름만 보고 바로 모두 추가하기보다 오른쪽의 diff를 읽어 실제 바뀐 줄을 확인하는 편이 좋습니다. 새로 만든 파일, 수정한 파일, 이미 스테이징한 파일이 섞여 있으면 커밋에 넣을 범위를 정하기 어렵기 때문입니다.
파일을 선택한 상태에서 스페이스바를 누르면 해당 파일의 스테이징 상태를 바꿀 수 있습니다. 더 작은 범위를 고르고 싶다면 변경 내용 영역으로 이동해 hunk나 줄을 확인하세요. 0.66.0 릴리스 안내에 따르면 이 영역에서 선택한 hunk 또는 줄에 스페이스바를 눌러 스테이징할 수 있습니다. 터미널 폭이 좁아 diff가 잘 안 보이면 창을 넓힌 뒤 다시 확인하세요.
- Files에서 파일을 고르고 오른쪽 diff를 읽습니다.
- 커밋할 파일은 스페이스바로 스테이징합니다.
- 일부 수정만 필요하면 변경 내용 영역에서 해당 hunk·줄을 선택합니다.
커밋을 만들고 푸시 결과 확인하기
필요한 변경만 스테이징됐다면 Files 영역에서 c를 눌러 커밋 메시지를 입력합니다. 메시지는 나중에 기록을 볼 때 무슨 작업을 했는지 알 수 있게 짧고 구체적으로 적으세요. 입력을 마치면 Commits 목록에 새 커밋이 생겼는지 확인합니다. 목록이 그대로라면 메시지 입력을 취소했거나 스테이징한 내용이 없었는지 먼저 봅니다.
원격 저장소가 연결돼 있다면 대문자 P로 현재 브랜치를 푸시할 수 있습니다. 최초 푸시처럼 upstream 설정이 없다면 Lazygit이 연결할 브랜치를 묻는 경우가 있습니다. 화면의 선택지를 확인하고 진행하세요. 작업 완료는 푸시 안내가 닫힌 것만으로 판단하지 말고, 현재 브랜치에 미전송 커밋 표시가 남아 있는지와 원격 저장소의 새 커밋이 보이는지를 확인하면 분명합니다.
- 스테이징한 파일을 확인하고 c로 커밋 메시지를 입력합니다.
- Commits 목록에 방금 만든 커밋이 나타나는지 봅니다.
- 원격 저장소가 있다면 P로 푸시하고 원격 커밋을 확인합니다.
브랜치와 커밋 기록을 한 화면에서 확인하기
여러 사람이 같은 저장소를 쓰거나 기능별 브랜치를 나눠 작업한다면, 커밋 전에 현재 브랜치가 어디인지 확인하는 습관이 도움이 됩니다. Lazygit의 Branches 영역에서는 로컬 브랜치 목록과 선택된 브랜치를 볼 수 있습니다. 저장소 화면이 처음 열렸을 때 이름이 예상과 다르다면 파일을 스테이징하기 전에 작업 위치부터 정리하세요. 다른 브랜치로 전환하려면 목록에서 대상을 선택하고 스페이스바를 누를 수 있지만, 저장하지 않은 변경이 있을 때는 먼저 현재 상태를 확인해야 합니다.
Commits 영역은 이미 만든 기록을 살펴볼 때 씁니다. 새 커밋을 마친 직후 이 목록에 메시지가 추가됐는지 확인하면, 파일만 스테이징한 상태와 실제로 커밋까지 끝낸 상태를 구분할 수 있습니다. 다른 파일이 우연히 함께 들어갔는지 궁금하다면 커밋을 선택해 변경 내용을 다시 보세요. 화면에 많은 정보가 한꺼번에 보이더라도 Files, Branches, Commits 세 영역을 순서대로 읽으면 현재 작업 단계가 분명해집니다.
단축키를 외우려고 멈출 필요는 없습니다. 어느 영역을 선택했는지에 따라 같은 키가 다른 일을 할 수 있으므로, 실행 전 화면 아래 안내와 ? 도움말을 살펴보세요. 특히 변경을 버리거나 브랜치를 바꾸는 동작은 커밋 작업과 성격이 다릅니다. 첫날에는 파일 확인, 스테이징, 커밋, 푸시 네 동작만 익히고 나머지 기능은 필요한 순간에 찾는 편이 쉽습니다.
- 현재 브랜치 이름이 작업하려던 브랜치인지 봅니다.
- 커밋 뒤 Commits 목록에 새 메시지가 추가됐는지 확인합니다.
- 모르는 키는 현재 영역의 ? 도움말에서 확인합니다.
실수하기 쉬운 지점
파일을 잘못 스테이징한 경우에는 커밋 전에 해당 파일이나 변경 범위를 다시 선택해 스테이징을 해제할 수 있습니다. 변경 내용을 아예 버리는 조작과 스테이징 해제는 결과가 다릅니다. 키 설명에 discard라고 보인다면 파일의 작업 내용이 사라질 수 있으므로 확인 없이 누르지 마세요.
다른 브랜치에서 작업한 줄 모르고 커밋하는 일도 흔합니다. 화면의 현재 브랜치 이름을 먼저 보고, 푸시 전에 원격 대상도 한 번 더 살펴보세요. 커밋은 로컬 저장소에 기록하는 단계이고 푸시는 그 기록을 원격으로 보내는 단계입니다. 두 동작을 구분하면 커밋은 됐는데 웹 저장소에서 안 보이는 이유를 찾기 쉽습니다.
- 커밋 전 현재 브랜치와 스테이징 목록을 봅니다.
- 변경을 버리는 명령인지, 스테이징만 해제하는 명령인지 확인합니다.
- 원격에 안 보이면 푸시 여부와 대상 브랜치를 점검합니다.
화면이 열리지 않거나 파일이 안 보일 때
lazygit 명령을 찾을 수 없다고 나오면 압축을 푼 폴더의 실행 파일 위치와 PATH 설정을 확인하세요. 설치 직후라면 새 터미널을 열어 다시 시도하면 해결되는 경우가 있습니다. git 명령 자체를 찾지 못한다면 Lazygit 파일을 다시 받기 전에 Git 설치 상태부터 확인해야 합니다.
프로그램은 열리는데 수정 파일이 없다면 현재 터미널이 어느 폴더에 있는지 확인하세요. 다른 저장소에서 실행했거나 아직 파일을 저장하지 않았다면 기대한 변경 사항이 나타나지 않습니다. 0.66.0과 공식 데모의 패널 배치가 다를 수도 있습니다. 이때는 화면의 ?를 눌러 현재 영역의 키 도움말을 확인하고, 최신 릴리스의 변경 내용 선택 방식을 따르세요.
- 명령 오류면 Git과 Lazygit 실행 파일 위치를 각각 확인합니다.
- 파일이 없다면 현재 저장소 폴더와 파일 저장 여부를 봅니다.
- 키 위치가 다르면 현재 화면의 ? 도움말을 엽니다.
자주 묻는 질문
Lazygit은 무료인가요?
네. 제작자 저장소는 MIT 라이선스를 표시하고, v0.66.0 Windows x64 ZIP을 공개 배포합니다.
Git을 따로 설치해야 하나요?
네. Lazygit은 Git 작업을 보여 주는 터미널 UI입니다. Git 명령이 먼저 동작해야 합니다.
Windows에서는 어떤 파일을 받나요?
일반적인 64비트 Windows PC라면 lazygit_0.66.0_windows_x86_64.zip을 고르세요. ARM PC는 파일 이름의 arm64를 확인해야 합니다.
커밋했는데 GitHub에 보이지 않아요.
커밋은 PC에 먼저 기록됩니다. 원격이 연결돼 있는지 확인한 뒤 P로 현재 브랜치를 푸시하고 원격 브랜치를 확인하세요.
화면에서 키가 기억나지 않으면요?
현재 영역에서 ?를 눌러 키 도움말을 확인하세요. 0.66.0에서는 이전 데모와 변경 내용 선택 위치가 다릅니다.
첫 커밋은 변경 내용 확인부터 시작하세요
Lazygit을 받았다면 Git 저장소에서 화면을 열고 Files의 diff를 천천히 읽어 보세요. 필요한 파일만 스테이징하고 c로 커밋한 다음, 원격 저장소를 쓴다면 P로 푸시하면 됩니다. 파일을 고르는 단계부터 결과 확인까지 한 화면에서 이어갈 수 있다는 것이 이 프로그램의 장점입니다.
공식 자료와 확인일
Lazygit 공식 저장소와 설치 안내 · Lazygit v0.66.0 공식 릴리스 · Lazygit 공식 키 설정표 · Lazygit 공식 UI 데모 | 2026-10-09T01:10:10.045841+00:00
