Windows에서 Git Bash 사용하기

macOS와 Linux에서 터미널을 열면 bash 또는 zsh를 얻어요 : 온라인에서 찾을 수 있는 99%의 튜토리얼과 같은 문법이에요. Windows는 다르죠 : 기본으로 PowerShell이 있는데, 이 문법과 명령어는 호환되지 않아요. 편하게 쓰는 방법은 Git Bash를 설치하는 거예요. Windows에서 표준 bash 셸을 제공해줘요.

PowerShell 대신 Git Bash를 쓰는 이유

PowerShell은 매우 강력하지만 자체 규칙이 있어요 : $ 접두사 변수, == 대신 -eq 연산자, 체이닝 && 없음(PowerShell 5.1), pipe 문법도 달라요. macOS나 Linux용 튜토리얼을 따라가면 PowerShell에서는 그대로 작동하지 않아요.

Git Bash가 이 문제를 해결해줘요 : Git for Windows와 함께 무료로 제공되는 미니 Unix 환경이에요. bash와 기본 Unix 도구들(grep, sed, awk, curl 등)을 사용할 수 있어요.

Git Bash 설치하기

$1. git-scm.com/download/win에서 .exe 다운로드2. 설치 프로그램 실행, 기본값으로 설치3. 설치 후 시작 메뉴에 "Git Bash" 나타남

Git Bash를 열어요. 프롬프트가 bloki@DESKTOP MINGW64 ~처럼 보이면 : Linux처럼 bash 셸에 있는 거예요.

bash인지 확인하기

$echo $SHELL

/usr/bin/bash(또는 유사한 경로)가 보이면 bash에 있는 거예요. 정확해요.

알아두어야 할 Windows 함정 세 가지

1. 절대 경로

Git Bash에서 절대 경로를 두 가지 방식으로 쓸 수 있어요 :

$cd /c/Users/bloki/Desktop
cd "C:\Users\bloki\Desktop"

둘 다 작동해요. /c/... 형식(슬래시)이 보통 더 편해요 : \를 이스케이프할 필요가 없고, 스크립트에서 복사-붙여넣기도 안정적이에요.

2. cd는 도구 호출 사이에 유지되지 않아요

편집기, 외부 스크립트, 또는 Claude Code 같은 도구가 bash를 여러 번 실행하면, 한 명령어에서 한 cd는 다음 명령어에서 보이지 않아요. 각 호출은 원래 폴더에서 시작해요.

해결 방법 : 서브셸이나 &&로 같은 명령어 안에서 체이닝해요.

$(cd tools/stats && uv run python -m cli.inject)

3. 아포스트로피가 있는 Python heredoc

interpreter에 Python 코드를 heredoc으로 pipe할 수 있어요 :

$

Python에 문자열 안에 아포스트로피가 없는 한 잘 작동해요. 아포스트로피가 있으면 Windows의 Git Bash에서 unexpected EOF 오류가 발생해요. 이 경우 스크립트를 .py 파일로 작성하고 일반적으로 실행하세요. heredoc으로 pipe하지 말고요.